StaticPrompt

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 (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 JSON
{
  "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 JSON
{
  "surfaceCapabilities": {
    object (SurfaceCapabilities)
  }
}
Kolom
surfaceCapabilities

object (SurfaceCapabilities)

Kumpulan kemampuan permukaan yang diperlukan.

SurfaceCapabilities

Menampilkan permukaan yang digunakan pengguna untuk membuat permintaan ke Action.

Representasi JSON
{
  "capabilities": [
    enum (Capability)
  ]
}
Kolom
capabilities[]

enum (Capability)

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 (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 "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.

override

boolean

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

object (StaticCanvasPrompt)

Respons yang akan digunakan untuk pengalaman kanvas interaktif.

StaticSimplePrompt

Menampilkan prompt sederhana yang akan dikirim ke pengguna.

Representasi JSON
{
  "variants": [
    {
      object (Variant)
    }
  ]
}
Kolom
variants[]

object (Variant)

Daftar kemungkinan varian.

Varian

Mewakili varian yang merupakan bagian dari perintah sederhana.

Representasi JSON
{
  "speech": string,
  "text": string
}
Kolom
speech

string

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

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. 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 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)
  }
  // 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.

StaticCardPrompt

Kartu dasar untuk menampilkan beberapa informasi, misalnya gambar dan/atau teks.

Representasi JSON
{
  "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. 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 JSON
{
  "url": string,
  "alt": string,
  "height": integer,
  "width": integer
}
Kolom
url

string

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

alt

string

Wajib. 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 JSON
{
  "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 JSON
{
  "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 JSON
{
  "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 JSON
{
  "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 JSON
{
  "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 JSON
{
  "text": string
}
Kolom
text

string

Konten teks dalam sel.

StaticMediaPrompt

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

Representasi JSON
{
  "mediaType": enum (MediaType),
  "startOffset": string,
  "optionalMediaControls": [
    enum (OptionalMediaControls)
  ],
  "mediaObjects": [
    {
      object (MediaObject)
    }
  ]
}
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.

MediaObject

Mewakili satu objek media.

Representasi JSON
{
  "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 JSON
{

  // 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 JSON
{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (ListItem)
    }
  ]
}
Kolom
title

string

Opsional. Judul daftar.

subtitle

string

Opsional. Subtitel daftar.

items[]

object (ListItem)

Wajib. Item daftar.

ListItem

Item dalam daftar.

Representasi JSON
{
  "key": string,
  "title": string,
  "description": string,
  "image": {
    object (StaticImagePrompt)
  }
}
Kolom
key

string

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

string

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

string

Opsional. Teks isi item.

image

object (StaticImagePrompt)

Opsional. Gambar item.

StaticCollectionPrompt

Kartu untuk menyajikan kumpulan opsi yang dapat dipilih.

Representasi JSON
{
  "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. Item koleksi.

imageFill

enum (ImageFill)

Opsional. Jenis opsi tampilan gambar.

CollectionItem

Item dalam koleksi.

Representasi JSON
{
  "key": string,
  "title": string,
  "description": string,
  "image": {
    object (StaticImagePrompt)
  }
}
Kolom
key

string

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

string

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

string

Opsional. Teks isi item.

image

object (StaticImagePrompt)

Opsional. Gambar item.

Saran

Mewakili chip saran, yaitu elemen UI yang ditampilkan kepada pengguna untuk memudahkan.

Representasi JSON
{
  "title": string
}
Kolom
title

string

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

string

Wajib. URL tampilan web yang akan dimuat.

data[]

value (Value format)

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

boolean

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