- StaticPromptCandidate
- Pemilih
- SurfaceCapabilities
- StaticPromptResponse
- StaticSimplePrompt
- Varian
- StaticContentPrompt
- StaticCardPrompt
- StaticImagePrompt
- StaticLinkPrompt
- OpenUrl
- StaticTablePrompt
- TableColumn
- TableRow
- TableCell
- StaticMediaPrompt
- MediaObject
- MediaImage
- StaticListPrompt
- ListItem
- StaticCollectionPrompt
- CollectionItem
- Saran
- StaticCanvasPrompt
Mewakili daftar kandidat prompt, salah satunya akan dipilih sebagai prompt yang akan ditampilkan sebagai respons terhadap pengguna. Pesan ini dapat dilokalkan.
Representasi JSON | |
---|---|
{
"candidates": [
{
object ( |
Kolom | |
---|---|
candidates[] |
Daftar perintah kandidat yang akan dikirim ke klien. Setiap prompt memiliki pemilih untuk menentukan kapan prompt tersebut dapat digunakan. Pemilih pertama yang cocok dengan permintaan akan dikirim dan sisanya akan diabaikan. |
StaticPromptCandidate
Mewakili kandidat prompt statis.
Representasi JSON | |
---|---|
{ "selector": { object ( |
Kolom | |
---|---|
selector |
Opsional. Kriteria apakah dialog ini cocok dengan permintaan. Jika pemilih kosong, dialog ini akan selalu dipicu. |
promptResponse |
Respons perintah yang terkait dengan pemilih. |
Pemilih
Menentukan kriteria apakah prompt cocok dengan permintaan.
Representasi JSON | |
---|---|
{
"surfaceCapabilities": {
object ( |
Kolom | |
---|---|
surfaceCapabilities |
Kumpulan kemampuan permukaan yang diperlukan. |
SurfaceCapabilities
Menampilkan permukaan yang digunakan pengguna untuk membuat permintaan ke Action.
Representasi JSON | |
---|---|
{
"capabilities": [
enum ( |
Kolom | |
---|---|
capabilities[] |
Wajib. Kemampuan platform yang membuat permintaan ke Action. |
StaticPromptResponse
Mewakili respons terstruktur yang akan dikirim kepada pengguna, seperti teks, ucapan, kartu, data kanvas, chip saran, dll.
Representasi JSON | |
---|---|
{ "firstSimple": { object ( |
Kolom | |
---|---|
firstSimple |
Opsional. Respons suara dan teks saja pertama. |
content |
Opsional. Konten seperti kartu, daftar, atau media yang akan ditampilkan kepada pengguna. |
lastSimple |
Opsional. Suara terakhir dan respons hanya teks. |
suggestions[] |
Opsional. Saran untuk ditampilkan kepada pengguna, yang akan selalu muncul di akhir respons. Jika "tambahkan" pada prompt yang memuatnya adalah "true" judul yang ditentukan di kolom ini akan ditambahkan ke judul yang ditentukan dalam dialog saran yang ditentukan sebelumnya dan nilai duplikat akan dihapus. |
link |
Opsional. Chip saran tambahan yang dapat ditautkan ke aplikasi atau situs terkait. Chip akan dirender dengan judul "Open |
override |
Opsional. Mode untuk menggabungkan pesan ini dengan pesan yang telah ditetapkan sebelumnya. "true" (benar) akan menghapus semua pesan yang ditetapkan sebelumnya (pertama dan terakhir, konten, link saran, dan kanvas) serta menambahkan pesan yang ditentukan dalam prompt ini. "salah" akan menambahkan pesan yang ditentukan dalam prompt ini ke pesan yang ditentukan dalam respons sebelumnya. Menetapkan kolom ini ke "false" juga akan mengaktifkan penambahan ke beberapa kolom di dalam Perintah sederhana, dialog Saran, dan perintah Canvas (bagian dari dialog Konten). Pesan Content dan Link akan selalu ditimpa jika ditentukan dalam perintah. Nilai defaultnya adalah "false". |
canvas |
Respons yang akan digunakan untuk pengalaman kanvas interaktif. |
StaticSimplePrompt
Menampilkan prompt sederhana yang akan dikirim ke pengguna.
Representasi JSON | |
---|---|
{
"variants": [
{
object ( |
Kolom | |
---|---|
variants[] |
Daftar kemungkinan varian. |
Varian
Mewakili varian yang merupakan bagian dari perintah sederhana.
Representasi JSON | |
---|---|
{ "speech": string, "text": string } |
Kolom | |
---|---|
speech |
Opsional. Menunjukkan ucapan yang akan diucapkan kepada pengguna. Dapat berupa SSML atau text to speech. Jika "tambahkan" pada prompt yang memuatnya adalah "true" ucapan yang ditetapkan dalam kolom ini akan ditambahkan ke ucapan perintah Sederhana sebelumnya. |
text |
Opsional. Teks yang akan ditampilkan dalam balon chat. Jika tidak diberikan, rendering tampilan untuk kolom ucapan di atas akan digunakan. Dibatasi hingga 640 karakter. Jika "tambahkan" pada prompt yang memuatnya adalah "true" teks yang ditentukan dalam isian ini akan ditambahkan ke teks prompt Sederhana sebelumnya. |
StaticContentPrompt
Placeholder untuk bagian Konten pada StaticPrompt.
Representasi JSON | |
---|---|
{ // Union field |
Kolom | ||
---|---|---|
Kolom union content . Hanya satu jenis konten yang boleh ditampilkan di Prompt. content hanya dapat berupa salah satu dari berikut: |
||
card |
Kartu dasar. |
|
image |
Gambar. |
|
table |
Kartu tabel. |
|
media |
Respons yang menunjukkan kumpulan media yang akan diputar. |
|
list |
Kartu untuk menyajikan daftar opsi yang dapat dipilih. |
|
collection |
Kartu yang menampilkan daftar opsi yang dapat dipilih. |
StaticCardPrompt
Kartu dasar untuk menampilkan beberapa informasi, misalnya gambar dan/atau teks.
Representasi JSON | |
---|---|
{ "title": string, "subtitle": string, "text": string, "image": { object ( |
Kolom | |
---|---|
title |
Opsional. Keseluruhan judul kartu. |
subtitle |
Opsional. Subtitel kartu. |
text |
Wajib. Teks isi kartu yang diperlukan kecuali ada gambar. Mendukung serangkaian sintaksis markdown terbatas untuk pemformatan. |
image |
Opsional. Banner besar untuk kartu. Tinggi ditetapkan ke 192 dp. |
imageFill |
Opsional. Cara latar belakang gambar akan diisi. |
button |
Opsional. Tombol yang dapat diklik untuk ditampilkan di Kartu. |
StaticImagePrompt
Gambar yang ditampilkan di kartu.
Representasi JSON | |
---|---|
{ "url": string, "alt": string, "height": integer, "width": integer } |
Kolom | |
---|---|
url |
Wajib. URL sumber gambar. Gambar dapat berupa JPG, PNG, dan GIF (animasi dan non-animasi). Misalnya, |
alt |
Wajib. Deskripsi teks dari gambar yang akan digunakan untuk aksesibilitas, misalnya {i>screen reader <i}(pembaca layar). |
height |
Opsional. Tinggi gambar dalam piksel. |
width |
Opsional. Lebar gambar dalam piksel. |
StaticLinkPrompt
Menentukan link yang akan ditampilkan sebagai chip saran dan dapat dibuka oleh pengguna.
Representasi JSON | |
---|---|
{
"name": string,
"open": {
object ( |
Kolom | |
---|---|
name |
Nama tautan |
open |
Menentukan perilaku saat pengguna membuka link. |
OpenUrl
Menentukan perilaku saat pengguna membuka link.
Representasi JSON | |
---|---|
{
"url": string,
"hint": enum ( |
Kolom | |
---|---|
url |
Kolom URL yang dapat berupa: - URL http/https untuk membuka Aplikasi yang Tertaut Aplikasi atau halaman web |
hint |
Menunjukkan petunjuk untuk jenis URL. |
StaticTablePrompt
Kartu tabel untuk menampilkan tabel teks.
Representasi JSON | |
---|---|
{ "title": string, "subtitle": string, "image": { object ( |
Kolom | |
---|---|
title |
Opsional. Judul tabel keseluruhan. Harus disetel jika subtitel disetel. |
subtitle |
Opsional. Subtitel untuk tabel. |
image |
Opsional. Gambar yang terkait dengan tabel. |
columns[] |
Opsional. Header dan perataan kolom. |
rows[] |
Opsional. Data baris pada tabel. Tiga baris pertama dijamin akan ditampilkan, tetapi baris lainnya mungkin dipotong di platform tertentu. Uji dengan simulator guna melihat baris yang akan ditampilkan untuk platform tertentu. Pada platform yang mendukung kemampuan WEB_BROWSER, Anda dapat mengarahkan pengguna ke halaman web yang berisi lebih banyak data. |
button |
Opsional. Tombol. |
TableColumn
Menjelaskan kolom dalam tabel.
Representasi JSON | |
---|---|
{
"header": string,
"align": enum ( |
Kolom | |
---|---|
header |
Teks header untuk kolom. |
align |
Perataan horizontal kolom w.r.t konten. Jika tidak ditentukan, konten akan disejajarkan dengan bagian tepi utama. |
TableRow
Mendeskripsikan baris dalam tabel.
Representasi JSON | |
---|---|
{
"cells": [
{
object ( |
Kolom | |
---|---|
cells[] |
Sel di baris ini. Tiga sel pertama dijamin akan ditampilkan, tetapi sel lainnya mungkin terpotong pada permukaan tertentu. Uji dengan simulator untuk mengetahui sel mana yang akan ditampilkan untuk permukaan tertentu. |
divider |
Menunjukkan apakah harus ada pemisah setelah setiap baris. |
TableCell
Menggambarkan sel dalam baris.
Representasi JSON | |
---|---|
{ "text": string } |
Kolom | |
---|---|
text |
Konten teks dalam sel. |
StaticMediaPrompt
Berisi informasi tentang media, seperti nama, deskripsi, URL, dll. ID berikutnya: 9
Representasi JSON | |
---|---|
{ "mediaType": enum ( |
Kolom | |
---|---|
mediaType |
Jenis media respons ini. |
startOffset |
Offset awal objek media pertama. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
optionalMediaControls[] |
Jenis kontrol media opsional yang dapat didukung sesi respons media ini. Jika disetel, permintaan akan dibuat ke pihak ketiga saat peristiwa media tertentu terjadi. Jika tidak ditetapkan, 3p tetap harus menangani dua jenis kontrol default, FINISHED dan FAILED. |
mediaObjects[] |
Daftar objek media. |
MediaObject
Mewakili satu objek media.
Representasi JSON | |
---|---|
{
"name": string,
"description": string,
"url": string,
"image": {
object ( |
Kolom | |
---|---|
name |
Nama objek media ini. |
description |
Deskripsi objek media ini. |
url |
URL yang mengarah ke konten media. |
image |
Gambar yang akan ditampilkan dengan kartu media. |
MediaImage
Gambar yang akan ditampilkan di dalam MediaPrompt.
Representasi JSON | |
---|---|
{ // Union field |
Kolom | ||
---|---|---|
Kolom union image . Hanya satu jenis MediaImage yang diizinkan. image hanya dapat berupa salah satu dari berikut: |
||
large |
Gambar berukuran besar, seperti sampul album, dll. |
|
icon |
Ikon gambar kecil ditampilkan di sebelah kanan dari judul. Ukurannya diubah menjadi 36x36 dp. |
StaticListPrompt
Kartu untuk menyajikan daftar opsi yang dapat dipilih.
Representasi JSON | |
---|---|
{
"title": string,
"subtitle": string,
"items": [
{
object ( |
Kolom | |
---|---|
title |
Opsional. Judul daftar. |
subtitle |
Opsional. Subtitel daftar. |
items[] |
Wajib. Item daftar. |
ListItem
Item dalam daftar.
Representasi JSON | |
---|---|
{
"key": string,
"title": string,
"description": string,
"image": {
object ( |
Kolom | |
---|---|
key |
Wajib. Kunci NLU yang cocok dengan nama kunci entri dalam jenis terkait. Saat item diketuk, kunci ini akan diposting kembali sebagai parameter opsi pilih. |
title |
Wajib. Judul item. Saat diketuk, teks ini akan diposting kembali ke percakapan kata demi kata seolah-olah pengguna telah mengetiknya. Setiap judul harus unik di antara kumpulan item. |
description |
Opsional. Teks isi item. |
image |
Opsional. Gambar item. |
StaticCollectionPrompt
Kartu untuk menyajikan kumpulan opsi yang dapat dipilih.
Representasi JSON | |
---|---|
{ "title": string, "subtitle": string, "items": [ { object ( |
Kolom | |
---|---|
title |
Opsional. Judul koleksi. |
subtitle |
Opsional. Subtitel koleksi. |
items[] |
Wajib. Item koleksi. |
imageFill |
Opsional. Jenis opsi tampilan gambar. |
CollectionItem
Item dalam koleksi.
Representasi JSON | |
---|---|
{
"key": string,
"title": string,
"description": string,
"image": {
object ( |
Kolom | |
---|---|
key |
Wajib. Kunci NLU yang cocok dengan nama kunci entri di Jenis yang terkait. Saat item diketuk, kunci ini akan diposting kembali sebagai parameter opsi pilih. |
title |
Wajib. Judul item. Saat diketuk, teks ini akan diposting kembali ke percakapan kata demi kata seolah-olah pengguna telah mengetiknya. Setiap judul harus unik di antara kumpulan item. |
description |
Opsional. Teks isi item. |
image |
Opsional. Gambar item. |
Saran
Mewakili chip saran, yaitu elemen UI yang ditampilkan kepada pengguna untuk memudahkan.
Representasi JSON | |
---|---|
{ "title": string } |
Kolom | |
---|---|
title |
Wajib. Teks yang ditampilkan dalam chip saran. Saat diketuk, teks ini akan diposting kembali ke percakapan kata demi kata seolah-olah pengguna telah mengetiknya. Setiap judul harus unik di antara kumpulan chip saran. Maksimal 25 karakter |
StaticCanvasPrompt
Merepresentasikan respons Canvas Interaktif yang akan dikirim ke pengguna. Ini dapat digunakan bersamaan dengan model "firstSimple" di dalam prompt yang berisi prompt untuk berbicara dengan pengguna selain menampilkan respons kanvas interaktif.
Representasi JSON | |
---|---|
{ "url": string, "data": [ value ], "suppressMic": boolean } |
Kolom | |
---|---|
url |
Wajib. URL tampilan web yang akan dimuat. |
data[] |
Opsional. Data JSON akan diteruskan ke halaman web pengalaman imersif sebagai peristiwa. Jika "ganti" pada prompt yang memuatnya adalah "false" nilai data yang ditentukan dalam perintah Canvas ini akan ditambahkan setelah nilai data ditentukan dalam perintah Canvas sebelumnya. |
suppressMic |
Opsional. Nilai sebenarnya berarti bahwa mikrofon tidak akan dibuka untuk menangkap input setelah respons imersif ini ditampilkan kepada pengguna. |