- Representasi YAML
- StaticPrompt
- StaticPromptCandidate
- Pemilih
- SurfaceCapabilities
- StaticPromptResponse
- StaticSimplePrompt
- Varian
- StaticContentPrompt
- StaticCardPrompt
- StaticImagePrompt
- StaticLinkPrompt
- OpenUrl
- StaticTablePrompt
- TableColumn
- TableRow
- TableCell
- StaticMediaPrompt
- MediaObject
- MediaImage
- StaticListPrompt
- ListItem
- StaticCollectionPrompt
- CollectionItem
- StaticCollectionBrowsePrompt
- CollectionBrowseItem
- Saran
- StaticCanvasPrompt
Menentukan pengendali yang akan dieksekusi setelah sebuah peristiwa. Contoh peristiwa adalah peristiwa berbasis intent dan kondisi dalam scene.
Representasi YAML | |
---|---|
webhookHandler: string # Union field |
Kolom | ||
---|---|---|
webhookHandler |
Nama pengendali webhook yang akan dipanggil. |
|
Kolom union prompt . Perintah dapat dibuat sebagai inline atau direferensikan oleh nama. prompt hanya dapat berupa salah satu dari berikut: |
||
staticPrompt |
Perintah statis inline. Dapat berisi referensi ke resource string dalam paket. |
|
staticPromptName |
Nama prompt statis yang akan dipanggil. |
StaticPrompt
Mewakili daftar kandidat prompt, salah satunya akan dipilih sebagai prompt yang akan ditampilkan sebagai respons terhadap pengguna. Pesan ini dapat dilokalkan.
Representasi YAML | |
---|---|
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 YAML | |
---|---|
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 YAML | |
---|---|
surfaceCapabilities:
object ( |
Kolom | |
---|---|
surfaceCapabilities |
Kumpulan kemampuan permukaan yang diperlukan. |
SurfaceCapabilities
Menampilkan permukaan yang digunakan pengguna untuk membuat permintaan ke Action.
Representasi YAML | |
---|---|
capabilities:
- enum ( |
Kolom | |
---|---|
capabilities[] |
Wajib diisi. 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 YAML | |
---|---|
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 kolom |
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. |
canvas |
Respons yang akan digunakan untuk pengalaman kanvas interaktif. |
StaticSimplePrompt
Menampilkan prompt sederhana yang akan dikirim ke pengguna.
Representasi YAML | |
---|---|
variants:
- object ( |
Kolom | |
---|---|
variants[] |
Daftar kemungkinan varian. |
Varian
Mewakili varian yang merupakan bagian dari perintah sederhana.
Representasi YAML | |
---|---|
speech: string text: string |
Kolom | |
---|---|
speech |
Opsional. Menunjukkan ucapan yang akan diucapkan kepada pengguna. Dapat berupa SSML atau text to speech. Secara default, ucapan akan ditambahkan ke ucapan perintah Sederhana sebelumnya. Jika kolom |
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. Secara default, teks akan ditambahkan ke teks Dialog sederhana sebelumnya. Jika kolom |
StaticContentPrompt
Placeholder untuk bagian Konten pada StaticPrompt.
Representasi YAML | |
---|---|
# 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. |
|
collectionBrowse |
Kartu yang menampilkan kumpulan halaman web yang akan dibuka. |
StaticCardPrompt
Kartu dasar untuk menampilkan beberapa informasi, misalnya gambar dan/atau teks.
Representasi YAML | |
---|---|
title: string subtitle: string text: string image: object ( |
Kolom | |
---|---|
title |
Opsional. Keseluruhan judul kartu. |
subtitle |
Opsional. Subtitel kartu. |
text |
Wajib diisi. 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 YAML | |
---|---|
url: string alt: string height: integer width: integer |
Kolom | |
---|---|
url |
Wajib diisi. URL sumber gambar. Gambar dapat berupa JPG, PNG, dan GIF (animasi dan non-animasi). Misalnya, |
alt |
Wajib diisi. 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 YAML | |
---|---|
name: string
open:
object ( |
Kolom | |
---|---|
name |
Nama tautan |
open |
Menentukan perilaku saat pengguna membuka link. |
OpenUrl
Menentukan perilaku saat pengguna membuka link.
Representasi YAML | |
---|---|
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 YAML | |
---|---|
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 |
button |
Opsional. Tombol. |
TableColumn
Menjelaskan kolom dalam tabel.
Representasi YAML | |
---|---|
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 YAML | |
---|---|
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 YAML | |
---|---|
text: string |
Kolom | |
---|---|
text |
Konten teks dalam sel. |
StaticMediaPrompt
Berisi informasi tentang media, seperti nama, deskripsi, URL, dll. ID berikutnya: 11
Representasi YAML | |
---|---|
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. |
repeatMode |
Mode pengulangan untuk daftar Objek Media. |
MediaObject
Mewakili satu objek media.
Representasi YAML | |
---|---|
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 YAML | |
---|---|
# 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 YAML | |
---|---|
title: string
subtitle: string
items:
- object ( |
Kolom | |
---|---|
title |
Opsional. Judul daftar. |
subtitle |
Opsional. Subtitel daftar. |
items[] |
Wajib diisi. Item daftar. |
ListItem
Item dalam daftar.
Representasi YAML | |
---|---|
key: string
title: string
description: string
image:
object ( |
Kolom | |
---|---|
key |
Wajib diisi. 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 diisi. 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 YAML | |
---|---|
title: string subtitle: string items: - object ( |
Kolom | |
---|---|
title |
Opsional. Judul koleksi. |
subtitle |
Opsional. Subtitel koleksi. |
items[] |
Wajib diisi. Item koleksi. |
imageFill |
Opsional. Jenis opsi tampilan gambar. |
CollectionItem
Item dalam koleksi.
Representasi YAML | |
---|---|
key: string
title: string
description: string
image:
object ( |
Kolom | |
---|---|
key |
Wajib diisi. 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 diisi. 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. |
StaticCollectionBrowsePrompt
Menyajikan serangkaian dokumen web sebagai kumpulan item ubin besar. Item dapat dipilih untuk meluncurkan dokumen web terkait di penampil web.
Representasi YAML | |
---|---|
items: - object ( |
Kolom | |
---|---|
items[] |
Item dalam koleksi penjelajahan. Ukuran daftar harus dalam rentang [2, 10]. |
imageFill |
Opsi tampilan gambar untuk gambar dalam koleksi. |
CollectionBrowseItem
Item dalam koleksi.
Representasi YAML | |
---|---|
title: string description: string footer: string image: object ( |
Kolom | |
---|---|
title |
Wajib diisi. Judul item koleksi. |
description |
Deskripsi item koleksi. |
footer |
Teks footer untuk item koleksi, ditampilkan di bawah deskripsi. Satu baris teks, terpotong dengan elipsis. |
image |
Gambar untuk item koleksi. |
openUriAction |
Wajib diisi. URI yang akan dibuka jika item dipilih. |
Saran
Mewakili chip saran, yaitu elemen UI yang ditampilkan kepada pengguna untuk memudahkan.
Representasi YAML | |
---|---|
title: string |
Kolom | |
---|---|
title |
Wajib diisi. 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 bersama dengan kolom firstSimple
dalam perintah yang berisi untuk berbicara dengan pengguna selain menampilkan respons kanvas interaktif.
Representasi YAML | |
---|---|
url: string data: - value suppressMic: boolean sendStateDataToCanvasApp: boolean enableFullScreen: boolean continueTtsDuringTouch: boolean |
Kolom | |
---|---|
url |
Wajib diisi. URL tampilan web yang akan dimuat. |
data[] |
Opsional. Data JSON akan diteruskan ke halaman web pengalaman imersif sebagai peristiwa. Jika kolom |
suppressMic |
Opsional. Nilai sebenarnya berarti bahwa mikrofon tidak akan dibuka untuk menangkap input setelah respons imersif ini ditampilkan kepada pengguna. |
sendStateDataToCanvasApp |
Opsional. Jika |
enableFullScreen |
Opsional. Jika |
continueTtsDuringTouch |
Opsional. Jika true (benar), ketukan layar tidak akan menghentikan TTS untuk seluruh sesi kanvas. Nilai default: false. |