EventHandler

Menentukan pengendali yang akan dieksekusi setelah sebuah peristiwa. Contoh peristiwa adalah peristiwa berbasis intent dan kondisi dalam scene.

Representasi YAML
webhookHandler: string

# Union field prompt can be only one of the following:
staticPrompt: 
  object (StaticPrompt)
staticPromptName: string
# End of list of possible types for union field prompt.
Kolom
webhookHandler

string

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

object (StaticPrompt)

Perintah statis inline. Dapat berisi referensi ke resource string dalam paket.

staticPromptName

string

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 (StaticPromptCandidate)
Kolom
candidates[]

object (StaticPromptCandidate)

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 (Selector)
promptResponse: 
  object (StaticPromptResponse)
Kolom
selector

object (Selector)

Opsional. Kriteria apakah dialog ini cocok dengan permintaan. Jika pemilih kosong, dialog ini akan selalu dipicu.

promptResponse

object (StaticPromptResponse)

Respons perintah yang terkait dengan pemilih.

Pemilih

Menentukan kriteria apakah prompt cocok dengan permintaan.

Representasi YAML
surfaceCapabilities: 
  object (SurfaceCapabilities)
Kolom
surfaceCapabilities

object (SurfaceCapabilities)

Kumpulan kemampuan permukaan yang diperlukan.

SurfaceCapabilities

Menampilkan permukaan yang digunakan pengguna untuk membuat permintaan ke Action.

Representasi YAML
capabilities: 
  - enum (Capability)
Kolom
capabilities[]

enum (Capability)

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 (StaticSimplePrompt)
content: 
  object (StaticContentPrompt)
lastSimple: 
  object (StaticSimplePrompt)
suggestions: 
  - object (Suggestion)
link: 
  object (StaticLinkPrompt)
override: boolean
canvas: 
  object (StaticCanvasPrompt)
Kolom
firstSimple

object (StaticSimplePrompt)

Opsional. Respons suara dan teks saja pertama.

content

object (StaticContentPrompt)

Opsional. Konten seperti kartu, daftar, atau media yang akan ditampilkan kepada pengguna.

lastSimple

object (StaticSimplePrompt)

Opsional. Suara terakhir dan respons hanya teks.

suggestions[]

object (Suggestion)

Opsional. Saran untuk ditampilkan kepada pengguna, yang akan selalu muncul di akhir respons. Jika kolom append dalam perintah yang berisi adalah true, judul yang ditentukan di kolom ini akan ditambahkan ke judul yang ditentukan dalam perintah saran yang ditentukan sebelumnya dan nilai duplikat akan dihapus.

override

boolean

Opsional. Mode untuk menggabungkan pesan ini dengan pesan yang telah ditetapkan sebelumnya. true akan menghapus semua pesan yang ditetapkan sebelumnya (pertama dan terakhir, konten, link saran, dan kanvas) serta menambahkan pesan yang ditentukan dalam perintah ini. false akan menambahkan pesan yang ditentukan dalam dialog ini ke pesan yang ditentukan dalam respons sebelumnya. Menyetel kolom ini ke false juga akan memungkinkan 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

object (StaticCanvasPrompt)

Respons yang akan digunakan untuk pengalaman kanvas interaktif.

StaticSimplePrompt

Menampilkan prompt sederhana yang akan dikirim ke pengguna.

Representasi YAML
variants: 
  - object (Variant)
Kolom
variants[]

object (Variant)

Daftar kemungkinan varian.

Varian

Mewakili varian yang merupakan bagian dari perintah sederhana.

Representasi YAML
speech: string
text: string
Kolom
speech

string

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 override dalam perintah yang memuatnya adalah true, ucapan yang ditentukan dalam kolom ini akan menggantikan ucapan Perintah sederhana sebelumnya.

text

string

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 override dalam perintah yang memuatnya adalah true, teks yang ditentukan dalam kolom ini akan menggantikan teks Dialog sederhana sebelumnya.

StaticContentPrompt

Placeholder untuk bagian Konten pada StaticPrompt.

Representasi YAML
# Union field content can be only one of the following:
card: 
  object (StaticCardPrompt)
image: 
  object (StaticImagePrompt)
table: 
  object (StaticTablePrompt)
media: 
  object (StaticMediaPrompt)
list: 
  object (StaticListPrompt)
collection: 
  object (StaticCollectionPrompt)
collectionBrowse: 
  object (StaticCollectionBrowsePrompt)
# End of list of possible types for union field content.
Kolom
Kolom union content. Hanya satu jenis konten yang boleh ditampilkan di Prompt. content hanya dapat berupa salah satu dari berikut:
card

object (StaticCardPrompt)

Kartu dasar.

image

object (StaticImagePrompt)

Gambar.

table

object (StaticTablePrompt)

Kartu tabel.

media

object (StaticMediaPrompt)

Respons yang menunjukkan kumpulan media yang akan diputar.

list

object (StaticListPrompt)

Kartu untuk menyajikan daftar opsi yang dapat dipilih.

collection

object (StaticCollectionPrompt)

Kartu yang menampilkan daftar opsi yang dapat dipilih.

collectionBrowse

object (StaticCollectionBrowsePrompt)

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 (StaticImagePrompt)
imageFill: enum (ImageFill)
button: 
  object (StaticLinkPrompt)
Kolom
title

string

Opsional. Keseluruhan judul kartu.

subtitle

string

Opsional. Subtitel kartu.

text

string

Wajib diisi. Teks isi kartu yang diperlukan kecuali ada gambar. Mendukung serangkaian sintaksis markdown terbatas untuk pemformatan.

image

object (StaticImagePrompt)

Opsional. Banner besar untuk kartu. Tinggi ditetapkan ke 192 dp.

imageFill

enum (ImageFill)

Opsional. Cara latar belakang gambar akan diisi.

button

object (StaticLinkPrompt)

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

string

Wajib diisi. URL sumber gambar. Gambar dapat berupa JPG, PNG, dan GIF (animasi dan non-animasi). Misalnya,https://www.agentx.com/logo.png.

alt

string

Wajib diisi. Deskripsi teks dari gambar yang akan digunakan untuk aksesibilitas, misalnya {i>screen reader <i}(pembaca layar).

height

integer

Opsional. Tinggi gambar dalam piksel.

width

integer

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 (OpenUrl)
Kolom
name

string

Nama tautan

open

object (OpenUrl)

Menentukan perilaku saat pengguna membuka link.

OpenUrl

Menentukan perilaku saat pengguna membuka link.

Representasi YAML
url: string
hint: enum (UrlHint)
Kolom
url

string

Kolom URL yang dapat berupa: - URL http/https untuk membuka Aplikasi yang Tertaut Aplikasi atau halaman web

hint

enum (UrlHint)

Menunjukkan petunjuk untuk jenis URL.

StaticTablePrompt

Kartu tabel untuk menampilkan tabel teks.

Representasi YAML
title: string
subtitle: string
image: 
  object (StaticImagePrompt)
columns: 
  - object (TableColumn)
rows: 
  - object (TableRow)
button: 
  object (StaticLinkPrompt)
Kolom
title

string

Opsional. Judul tabel keseluruhan. Harus disetel jika subtitel disetel.

subtitle

string

Opsional. Subtitel untuk tabel.

image

object (StaticImagePrompt)

Opsional. Gambar yang terkait dengan tabel.

columns[]

object (TableColumn)

Opsional. Header dan perataan kolom.

rows[]

object (TableRow)

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

object (StaticLinkPrompt)

Opsional. Tombol.

TableColumn

Menjelaskan kolom dalam tabel.

Representasi YAML
header: string
align: enum (HorizontalAlignment)
Kolom
header

string

Teks header untuk kolom.

align

enum (HorizontalAlignment)

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 (TableCell)
divider: boolean
Kolom
cells[]

object (TableCell)

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

boolean

Menunjukkan apakah harus ada pemisah setelah setiap baris.

TableCell

Menggambarkan sel dalam baris.

Representasi YAML
text: string
Kolom
text

string

Konten teks dalam sel.

StaticMediaPrompt

Berisi informasi tentang media, seperti nama, deskripsi, URL, dll. ID berikutnya: 11

Representasi YAML
mediaType: enum (MediaType)
startOffset: string
optionalMediaControls: 
  - enum (OptionalMediaControls)
mediaObjects: 
  - object (MediaObject)
repeatMode: enum (RepeatMode)
Kolom
mediaType

enum (MediaType)

Jenis media respons ini.

startOffset

string (Duration format)

Offset awal objek media pertama.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

optionalMediaControls[]

enum (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[]

object (MediaObject)

Daftar objek media.

repeatMode

enum (RepeatMode)

Mode pengulangan untuk daftar Objek Media.

MediaObject

Mewakili satu objek media.

Representasi YAML
name: string
description: string
url: string
image: 
  object (MediaImage)
Kolom
name

string

Nama objek media ini.

description

string

Deskripsi objek media ini.

url

string

URL yang mengarah ke konten media.

image

object (MediaImage)

Gambar yang akan ditampilkan dengan kartu media.

MediaImage

Gambar yang akan ditampilkan di dalam MediaPrompt.

Representasi YAML
# Union field image can be only one of the following:
large: 
  object (StaticImagePrompt)
icon: 
  object (StaticImagePrompt)
# End of list of possible types for union field image.
Kolom
Kolom union image. Hanya satu jenis MediaImage yang diizinkan. image hanya dapat berupa salah satu dari berikut:
large

object (StaticImagePrompt)

Gambar berukuran besar, seperti sampul album, dll.

icon

object (StaticImagePrompt)

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 (ListItem)
Kolom
title

string

Opsional. Judul daftar.

subtitle

string

Opsional. Subtitel daftar.

items[]

object (ListItem)

Wajib diisi. Item daftar.

ListItem

Item dalam daftar.

Representasi YAML
key: string
title: string
description: string
image: 
  object (StaticImagePrompt)
Kolom
key

string

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

string

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

string

Opsional. Teks isi item.

image

object (StaticImagePrompt)

Opsional. Gambar item.

StaticCollectionPrompt

Kartu untuk menyajikan kumpulan opsi yang dapat dipilih.

Representasi YAML
title: string
subtitle: string
items: 
  - object (CollectionItem)
imageFill: enum (ImageFill)
Kolom
title

string

Opsional. Judul koleksi.

subtitle

string

Opsional. Subtitel koleksi.

items[]

object (CollectionItem)

Wajib diisi. Item koleksi.

imageFill

enum (ImageFill)

Opsional. Jenis opsi tampilan gambar.

CollectionItem

Item dalam koleksi.

Representasi YAML
key: string
title: string
description: string
image: 
  object (StaticImagePrompt)
Kolom
key

string

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

string

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

string

Opsional. Teks isi item.

image

object (StaticImagePrompt)

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 (CollectionBrowseItem)
imageFill: enum (ImageFill)
Kolom
items[]

object (CollectionBrowseItem)

Item dalam koleksi penjelajahan. Ukuran daftar harus dalam rentang [2, 10].

imageFill

enum (ImageFill)

Opsi tampilan gambar untuk gambar dalam koleksi.

CollectionBrowseItem

Item dalam koleksi.

Representasi YAML
title: string
description: string
footer: string
image: 
  object (StaticImagePrompt)
openUriAction: 
  object (OpenUrl)
Kolom
title

string

Wajib diisi. Judul item koleksi.

description

string

Deskripsi item koleksi.

footer

string

Teks footer untuk item koleksi, ditampilkan di bawah deskripsi. Satu baris teks, terpotong dengan elipsis.

image

object (StaticImagePrompt)

Gambar untuk item koleksi.

openUriAction

object (OpenUrl)

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

string

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

string

Wajib diisi. URL tampilan web yang akan dimuat.

data[]

value (Value format)

Opsional. Data JSON akan diteruskan ke halaman web pengalaman imersif sebagai peristiwa. Jika kolom override dalam perintah yang berisi adalah false, nilai data yang ditentukan dalam perintah Canvas ini akan ditambahkan setelah nilai data ditentukan dalam perintah Canvas sebelumnya.

suppressMic

boolean

Opsional. Nilai sebenarnya berarti bahwa mikrofon tidak akan dibuka untuk menangkap input setelah respons imersif ini ditampilkan kepada pengguna.

sendStateDataToCanvasApp

boolean

Opsional. Jika true, metadata terkait percakapan akan disertakan dan dikirim kembali ke aplikasi kanvas.

enableFullScreen

boolean

Opsional. Jika true aplikasi kanvas akan memenuhi layar penuh dan tidak akan memiliki header di bagian atas. Pesan toast juga akan ditampilkan di layar pemuatan yang menyertakan nama tampilan Action, nama developer, dan petunjuk untuk keluar dari Action. Nilai default: false.

continueTtsDuringTouch

boolean

Opsional. Jika true (benar), ketukan layar tidak akan menghentikan TTS untuk seluruh sesi kanvas. Nilai default: false.