- 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
Mendefinisikan pengendali yang akan dijalankan setelah suatu 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 disisipkan atau direferensikan dengan nama. prompt hanya ada berupa salah satu diantara berikut: |
||
staticPrompt |
Dialog statis inline. Dapat berisi referensi ke resource string dalam paket. |
|
staticPromptName |
Nama perintah statis yang akan dipanggil. |
StaticPrompt
Mewakili daftar kandidat perintah, salah satunya akan dipilih sebagai perintah yang akan ditampilkan dalam respons kepada pengguna. Pesan ini dapat dilokalkan.
Representasi YAML | |
---|---|
candidates:
- object ( |
Kolom | |
---|---|
candidates[] |
Daftar perintah kandidat yang akan dikirim ke klien. Setiap dialog memiliki pemilih untuk menentukan kapan dapat digunakan. Pemilih pertama yang cocok dengan permintaan akan dikirim dan pemilih lainnya akan diabaikan. |
StaticPromptCandidate
Mewakili kandidat perintah statis.
Representasi YAML | |
---|---|
selector: object ( |
Kolom | |
---|---|
selector |
Opsional. Kriteria apakah dialog ini cocok dengan permintaan. Jika pemilih kosong, permintaan ini akan selalu dipicu. |
promptResponse |
Respons cepat yang terkait dengan pemilih. |
Pemilih
Menentukan kriteria apakah dialog cocok dengan permintaan.
Representasi YAML | |
---|---|
surfaceCapabilities:
object ( |
Kolom | |
---|---|
surfaceCapabilities |
Kumpulan kemampuan platform yang diperlukan. |
SurfaceCapabilities
Menampilkan platform yang digunakan pengguna untuk membuat permintaan ke Action.
Representasi YAML | |
---|---|
capabilities:
- enum ( |
Kolom | |
---|---|
capabilities[] |
Wajib. Kemampuan platform yang membuat permintaan ke Action. |
StaticPromptResponse
Menampilkan respons terstruktur untuk dikirim kepada pengguna, seperti teks, ucapan, kartu, data kanvas, chip saran, dll.
Representasi YAML | |
---|---|
firstSimple: object ( |
Kolom | |
---|---|
firstSimple |
Opsional. Respons pertama yang hanya berisi teks dan suara. |
content |
Opsional. Konten seperti kartu, daftar, atau media yang akan ditampilkan kepada pengguna. |
lastSimple |
Opsional. Respons terakhir yang hanya berupa teks dan suara. |
suggestions[] |
Opsional. Saran yang akan ditampilkan kepada pengguna yang akan selalu muncul di akhir respons. Jika kolom |
link |
Opsional. Chip saran tambahan yang dapat menautkan ke aplikasi atau situs terkait. Chip akan dirender dengan judul "Buka |
override |
Opsional. Mode penggabungan pesan ini dengan pesan yang telah ditentukan sebelumnya. |
canvas |
Respons yang akan digunakan untuk pengalaman kanvas interaktif. |
StaticSimplePrompt
Menampilkan perintah sederhana yang akan dikirim ke pengguna.
Representasi YAML | |
---|---|
variants:
- object ( |
Kolom | |
---|---|
variants[] |
Daftar kemungkinan varian. |
Varian
Menampilkan varian yang merupakan bagian dari prompt sederhana.
Representasi YAML | |
---|---|
speech: string text: string |
Kolom | |
---|---|
speech |
Opsional. Merepresentasikan 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 Simple prompt sebelumnya. Jika kolom |
StaticContentPrompt
Placeholder untuk bagian Content pada StaticPrompt.
Representasi YAML | |
---|---|
# Union field |
Kolom | ||
---|---|---|
Kolom union content . Hanya satu jenis konten yang boleh ada di Perintah. content hanya ada berupa salah satu diantara berikut: |
||
card |
Kartu dasar. |
|
image |
Gambar. |
|
table |
Kartu tabel. |
|
media |
Respons yang menunjukkan sekumpulan media yang akan diputar. |
|
list |
Kartu untuk menampilkan daftar opsi yang dapat dipilih. |
|
collection |
Kartu yang menampilkan daftar opsi untuk 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. Judul kartu secara keseluruhan. |
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. Tingginya ditetapkan ke 192 dp. |
imageFill |
Opsional. Cara mengisi latar belakang gambar. |
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. 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 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 link |
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 salah satu dari: - URL http/https untuk membuka Aplikasi atau halaman web yang ditautkan ke Aplikasi |
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 secara keseluruhan. Harus disetel jika subtitel sudah disetel. |
subtitle |
Opsional. Subtitel untuk tabel. |
image |
Opsional. Gambar yang terkait dengan tabel. |
columns[] |
Opsional. Header dan perataan kolom. |
rows[] |
Opsional. Data baris dalam tabel. 3 baris pertama dijamin akan ditampilkan, tetapi baris lainnya mungkin terpotong pada permukaan tertentu. Uji dengan simulator untuk melihat baris mana 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 konten. Jika tidak ditentukan, konten akan disejajarkan dengan tepi depan. |
TableRow
Menjelaskan baris dalam tabel.
Representasi YAML | |
---|---|
cells:
- object ( |
Kolom | |
---|---|
cells[] |
Sel dalam baris ini. 3 sel pertama dijamin akan ditampilkan, tetapi sel lainnya mungkin terpotong pada permukaan tertentu. Uji dengan simulator untuk melihat sel mana yang akan ditampilkan untuk permukaan tertentu. |
divider |
Menunjukkan apakah harus ada pemisah setelah setiap baris. |
TableCell
Menjelaskan sel secara berurutan.
Representasi YAML | |
---|---|
text: string |
Kolom | |
---|---|
text |
Konten teks di 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 ditetapkan, permintaan akan dibuat ke pihak ketiga saat peristiwa media tertentu terjadi. Jika tidak disetel, 3p masih harus menangani dua jenis kontrol default, FINISHED dan FAILED. |
mediaObjects[] |
Daftar objek media. |
repeatMode |
Mode berulang 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 ada berupa salah satu diantara berikut: |
||
large |
Gambar besar, seperti sampul album, dll. |
|
icon |
Ikon gambar kecil ditampilkan di sebelah kanan dari judul. Ukurannya diubah menjadi 36x36 dp. |
StaticListPrompt
Kartu untuk menampilkan daftar opsi yang dapat dipilih.
Representasi YAML | |
---|---|
title: string
subtitle: string
items:
- object ( |
Kolom | |
---|---|
title |
Opsional. Judul daftar. |
subtitle |
Opsional. Subtitel daftar. |
items[] |
Wajib. Daftar item. |
ListItem
Item dalam daftar.
Representasi YAML | |
---|---|
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 menampilkan kumpulan opsi yang dapat dipilih.
Representasi YAML | |
---|---|
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 YAML | |
---|---|
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. |
StaticCollectionBrowsePrompt
Menampilkan kumpulan dokumen web sebagai koleksi item kartu berukuran besar. Item dapat dipilih untuk meluncurkan dokumen web yang terkait di penampil web.
Representasi YAML | |
---|---|
items: - object ( |
Kolom | |
---|---|
items[] |
Item dalam koleksi jelajahi. 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. Judul item koleksi. |
description |
Deskripsi item koleksi. |
footer |
Teks footer untuk item koleksi, yang ditampilkan di bawah deskripsi. Satu baris teks, terpotong dengan elipsis. |
image |
Gambar untuk item koleksi. |
openUriAction |
Wajib. URI yang akan dibuka jika item dipilih. |
Saran
Mewakili chip saran, elemen UI yang ditampilkan kepada pengguna untuk kenyamanan.
Representasi YAML | |
---|---|
title: string |
Kolom | |
---|---|
title |
Wajib. Teks yang ditampilkan di 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. Maks 25 karakter |
StaticCanvasPrompt
Mewakili respons Canvas Interaktif untuk 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. URL tampilan web yang akan dimuat. |
data[] |
Opsional. Data JSON yang akan diteruskan ke halaman web pengalaman imersif sebagai peristiwa. Jika kolom |
suppressMic |
Opsional. Nilai sebenarnya berarti mikrofon tidak akan dibuka untuk menangkap input setelah respons imersif ini ditampilkan kepada pengguna. |
sendStateDataToCanvasApp |
Opsional. Jika |
enableFullScreen |
Opsional. Jika |
continueTtsDuringTouch |
Opsional. Jika benar, ketukan layar tidak akan menghentikan TTS untuk seluruh sesi kanvas. Nilai default: false. |