- StaticPromptCandidate
- Selettore
- SurfaceCapabilities
- StaticPromptResponse
- StaticSimplePrompt
- Variante
- StaticContentPrompt
- StaticCardPrompt
- StaticImagePrompt
- StaticLinkPrompt
- OpenUrl
- StaticTablePrompt
- TableColumn
- TableRow
- TableCell
- StaticMediaPrompt
- MediaObject
- MediaImage
- StaticListPrompt
- ListItem
- StaticCollectionPrompt
- CollectionItem
- Suggerimento
- StaticCanvasPrompt
Rappresenta un elenco di candidati, uno dei quali verrà selezionato come prompt da mostrare nella risposta all'utente. Questo messaggio è localizzabile.
Rappresentazione JSON | |
---|---|
{
"candidates": [
{
object ( |
Campi | |
---|---|
candidates[] |
L'elenco dei prompt dei candidati da inviare al cliente. Ogni prompt ha un selettore per determinare quando può essere utilizzato. Verrà inviato il primo selettore che corrisponde a una richiesta, mentre il resto verrà ignorato. |
StaticPromptCandidate
Rappresenta un candidato del prompt statico.
Rappresentazione JSON | |
---|---|
{ "selector": { object ( |
Campi | |
---|---|
selector |
Campo facoltativo. I criteri per stabilire se questo prompt corrisponde a una richiesta. Se il selettore è vuoto, verrà sempre attivato questo messaggio. |
promptResponse |
La risposta del prompt associata al selettore. |
Selettore
Definisce i criteri per stabilire se un prompt corrisponde a una richiesta.
Rappresentazione JSON | |
---|---|
{
"surfaceCapabilities": {
object ( |
Campi | |
---|---|
surfaceCapabilities |
L'insieme di funzionalità delle piattaforme richieste. |
SurfaceCapabilities
Rappresenta la piattaforma utilizzata dall'utente per effettuare una richiesta all'Azione.
Rappresentazione JSON | |
---|---|
{
"capabilities": [
enum ( |
Campi | |
---|---|
capabilities[] |
Obbligatorio. Le funzionalità della piattaforma che effettua una richiesta all'Azione. |
StaticPromptResponse
Rappresenta le risposte strutturate da inviare all'utente, ad esempio testo, discorsi, schede, dati canvas, chip di suggerimenti e così via.
Rappresentazione JSON | |
---|---|
{ "firstSimple": { object ( |
Campi | |
---|---|
firstSimple |
Campo facoltativo. La prima risposta vocale e di solo testo. |
content |
Campo facoltativo. Contenuti come una scheda, un elenco o un contenuto multimediale da mostrare all'utente. |
lastSimple |
Campo facoltativo. L'ultima risposta vocale e di solo testo. |
suggestions[] |
Campo facoltativo. Suggerimenti da mostrare all'utente, che saranno sempre visualizzati alla fine della risposta. Se il campo "aggiungi" nel prompt contenente è "true", i titoli definiti in questo campo verranno aggiunti ai titoli definiti nei prompt di suggerimenti definiti in precedenza e i valori duplicati verranno rimossi. |
link |
Campo facoltativo. Un chip di suggerimenti aggiuntivo che può rimandare all'app o al sito associati. Il chip verrà visualizzato con il titolo "Apri |
override |
Campo facoltativo. Modalità per l'unione di questi messaggi a quelli definiti in precedenza. "true" cancellerà tutti i messaggi definiti in precedenza (primo e ultimo semplice, contenuti, link ai suggerimenti e canvas) e aggiungerà i messaggi definiti in questo prompt. "false" aggiungerà i messaggi definiti in questa richiesta ai messaggi definiti nelle risposte precedenti. Se imposti questo campo su "false", consenti anche l'aggiunta ad alcuni campi all'interno dei prompt semplici, del prompt dei suggerimenti e di Canvas (parte del prompt dei contenuti). I messaggi relativi ai contenuti e ai link verranno sempre sovrascritti, se definiti nel prompt. Il valore predefinito è "false". |
canvas |
Una risposta da utilizzare per l'esperienza interattiva della stampa su tela. |
StaticSimplePrompt
Rappresenta un semplice prompt da inviare a un utente.
Rappresentazione JSON | |
---|---|
{
"variants": [
{
object ( |
Campi | |
---|---|
variants[] |
Elenco delle possibili varianti. |
Variante
Rappresenta una variante che fa parte del prompt semplice.
Rappresentazione JSON | |
---|---|
{ "speech": string, "text": string } |
Campi | |
---|---|
speech |
Campo facoltativo. Rappresenta il parlato che verrà detto all'utente. Può essere SSML o sintesi vocale. Se il campo "aggiungi" nel prompt contenente è "true", il parlato definito in questo campo verrà aggiunto al discorso del prompt semplice precedente. |
text |
Campo facoltativo. Testo da visualizzare nel fumetto della chat. Se non viene specificato, verrà utilizzato il rendering visualizzato del campo vocale qui sopra. Limite: 640 caratteri. Se il campo "aggiungi" nel prompt contenente è "true", il testo definito in questo campo verrà aggiunto al testo del prompt semplice precedente. |
StaticContentPrompt
Un segnaposto per la parte Contenuto di un prompt statico.
Rappresentazione JSON | |
---|---|
{ // Union field |
Campi | ||
---|---|---|
Campo di unione content . In un prompt può essere presente un solo tipo di contenuto. content può essere solo uno dei seguenti: |
||
card |
Una scheda di base. |
|
image |
Un'immagine. |
|
table |
Scheda tabella. |
|
media |
Risposta che indica un insieme di contenuti multimediali da riprodurre. |
|
list |
Una scheda per presentare un elenco di opzioni tra cui scegliere. |
|
collection |
Una scheda con un elenco di opzioni tra cui scegliere. |
StaticCardPrompt
Una scheda di base per visualizzare alcune informazioni, ad esempio un'immagine e/o del testo.
Rappresentazione JSON | |
---|---|
{ "title": string, "subtitle": string, "text": string, "image": { object ( |
Campi | |
---|---|
title |
Campo facoltativo. Titolo generale della scheda. |
subtitle |
Campo facoltativo. Sottotitolo della scheda. |
text |
Obbligatorio. Corpo del testo della scheda necessario, a meno che non sia presente un'immagine. Supporta un insieme limitato di sintassi di markdown per la formattazione. |
image |
Campo facoltativo. Un'immagine promozionale per la scheda. L'altezza è fissa a 192 dp. |
imageFill |
Campo facoltativo. Il modo in cui verrà riempito lo sfondo dell'immagine. |
button |
Campo facoltativo. Un pulsante cliccabile da mostrare nella scheda. |
StaticImagePrompt
Un'immagine visualizzata nella scheda.
Rappresentazione JSON | |
---|---|
{ "url": string, "alt": string, "height": integer, "width": integer } |
Campi | |
---|---|
url |
Obbligatorio. L'URL di origine dell'immagine. Le immagini possono essere JPG, PNG e GIF (animate e non animate). Ad esempio, |
alt |
Obbligatorio. Una descrizione testuale dell'immagine da utilizzare per l'accessibilità, ad esempio screen reader. |
height |
Campo facoltativo. L'altezza dell'immagine in pixel. |
width |
Campo facoltativo. La larghezza dell'immagine in pixel. |
StaticLinkPrompt
Definisce un link che verrà visualizzato come chip di suggerimenti e può essere aperto dall'utente.
Rappresentazione JSON | |
---|---|
{
"name": string,
"open": {
object ( |
Campi | |
---|---|
name |
Nome del collegamento |
open |
Definisce il comportamento quando l'utente apre il link. |
OpenUrl
Definisce il comportamento quando l'utente apre il link.
Rappresentazione JSON | |
---|---|
{
"url": string,
"hint": enum ( |
Campi | |
---|---|
url |
Il campo dell'URL, che può essere uno dei seguenti: - URL http/https per aprire un'app o una pagina web collegate all'app |
hint |
Indica un suggerimento per il tipo di URL. |
StaticTablePrompt
Una scheda per visualizzare una tabella di testo.
Rappresentazione JSON | |
---|---|
{ "title": string, "subtitle": string, "image": { object ( |
Campi | |
---|---|
title |
Campo facoltativo. Titolo generale della tabella. Deve essere impostato se è impostato un sottotitolo. |
subtitle |
Campo facoltativo. Sottotitolo della tabella. |
image |
Campo facoltativo. Immagine associata alla tabella. |
columns[] |
Campo facoltativo. Intestazioni e allineamento delle colonne. |
rows[] |
Campo facoltativo. Dati delle righe della tabella. È garantito che vengano mostrate le prime 3 righe, ma altre potrebbero essere tagliate su alcune superfici. Fai una prova con il simulatore per vedere quali righe verranno mostrate per una determinata superficie. Sulle piattaforme che supportano la funzionalità WEB_BROWSER, puoi indirizzare l'utente a una pagina web con più dati. |
button |
Campo facoltativo. Pulsante. |
TableColumn
Descrive una colonna nella tabella.
Rappresentazione JSON | |
---|---|
{
"header": string,
"align": enum ( |
Campi | |
---|---|
header |
Testo dell'intestazione per la colonna. |
align |
Allineamento orizzontale della colonna dei contenuti in alto. Se non specificati, i contenuti verranno allineati al bordo iniziale. |
TableRow
Descrive una riga della tabella.
Rappresentazione JSON | |
---|---|
{
"cells": [
{
object ( |
Campi | |
---|---|
cells[] |
Celle in questa riga. È garantito che le prime 3 celle vengano visualizzate, ma altre potrebbero essere tagliate su determinate superfici. Fai una prova con il simulatore per vedere quali celle verranno mostrate per una determinata superficie. |
divider |
Indica se dopo ogni riga deve essere presente un divisore. |
TableCell
Descrive una cella in una riga.
Rappresentazione JSON | |
---|---|
{ "text": string } |
Campi | |
---|---|
text |
Contenuti testuali della cella. |
StaticMediaPrompt
Contiene informazioni sui contenuti multimediali, come nome, descrizione, URL e così via. ID successivo: 9
Rappresentazione JSON | |
---|---|
{ "mediaType": enum ( |
Campi | |
---|---|
mediaType |
Tipo multimediale di questa risposta. |
startOffset |
Offset iniziale del primo oggetto multimediale. Una durata in secondi con un massimo di nove cifre frazionarie, terminata da " |
optionalMediaControls[] |
Tipi di controlli multimediali facoltativi supportati da questa sessione di risposte multimediali. Se impostato, la richiesta verrà effettuata a 3p quando si verifica un determinato evento multimediale. Se non viene configurato, 3p deve comunque gestire due tipi di controllo predefiniti, FINISHED e FAILED. |
mediaObjects[] |
Elenco di oggetti multimediali. |
MediaObject
Rappresenta un singolo oggetto multimediale.
Rappresentazione JSON | |
---|---|
{
"name": string,
"description": string,
"url": string,
"image": {
object ( |
Campi | |
---|---|
name |
Il nome dell'oggetto multimediale. |
description |
Descrizione di questo oggetto multimediale. |
url |
L'URL che rimanda ai contenuti multimediali. |
image |
Immagine da mostrare con la scheda Contenuti multimediali. |
MediaImage
Immagine da visualizzare all'interno di un MediaPrompt.
Rappresentazione JSON | |
---|---|
{ // Union field |
Campi | ||
---|---|---|
Campo di unione image . È consentito un solo tipo di MediaImage. image può essere solo uno dei seguenti: |
||
large |
Un'immagine di grandi dimensioni, ad esempio la copertina dell'album e così via. |
|
icon |
Una piccola icona con un'immagine visualizzata sulla destra del titolo. Viene ridimensionato a 36 x 36 dp. |
StaticListPrompt
Una scheda per presentare un elenco di opzioni tra cui scegliere.
Rappresentazione JSON | |
---|---|
{
"title": string,
"subtitle": string,
"items": [
{
object ( |
Campi | |
---|---|
title |
Campo facoltativo. Titolo dell'elenco. |
subtitle |
Campo facoltativo. Sottotitolo dell'elenco. |
items[] |
Obbligatorio. Voci dell'elenco. |
ListItem
Un elemento dell'elenco.
Rappresentazione JSON | |
---|---|
{
"key": string,
"title": string,
"description": string,
"image": {
object ( |
Campi | |
---|---|
key |
Obbligatorio. La chiave NLU che corrisponde al nome della chiave di accesso nel tipo associato. Quando l'elemento viene toccato, questa chiave viene riportata come parametro di opzione di selezione. |
title |
Obbligatorio. Titolo dell'elemento. Una volta toccato, il testo viene pubblicato nuovamente nella conversazione, come se l'utente lo avesse digitato. Ogni titolo deve essere univoco nell'insieme di elementi. |
description |
Campo facoltativo. Corpo del testo dell'elemento. |
image |
Campo facoltativo. Immagine dell'elemento. |
StaticCollectionPrompt
Una scheda per presentare una raccolta di opzioni tra cui scegliere.
Rappresentazione JSON | |
---|---|
{ "title": string, "subtitle": string, "items": [ { object ( |
Campi | |
---|---|
title |
Campo facoltativo. Titolo della raccolta. |
subtitle |
Campo facoltativo. Sottotitolo della raccolta. |
items[] |
Obbligatorio. Elementi della raccolta. |
imageFill |
Campo facoltativo. Tipo di opzione di visualizzazione dell'immagine. |
CollectionItem
Un elemento della raccolta.
Rappresentazione JSON | |
---|---|
{
"key": string,
"title": string,
"description": string,
"image": {
object ( |
Campi | |
---|---|
key |
Obbligatorio. La chiave NLU che corrisponde al nome della chiave di accesso nel tipo associato. Quando l'elemento viene toccato, questa chiave viene riportata come parametro di opzione di selezione. |
title |
Obbligatorio. Titolo dell'elemento. Una volta toccato, il testo viene pubblicato nuovamente nella conversazione, come se l'utente lo avesse digitato. Ogni titolo deve essere univoco nell'insieme di elementi. |
description |
Campo facoltativo. Corpo del testo dell'elemento. |
image |
Campo facoltativo. Immagine dell'elemento. |
Suggerimento
Rappresenta un chip di suggerimenti, un elemento UI mostrato all'utente per praticità.
Rappresentazione JSON | |
---|---|
{ "title": string } |
Campi | |
---|---|
title |
Obbligatorio. Il testo mostrato nel chip di suggerimento. Una volta toccato, il testo viene pubblicato nuovamente nella conversazione, come se l'utente lo avesse digitato. Ogni titolo deve essere univoco nell'insieme di chip di suggerimenti. Massimo 25 caratteri |
StaticCanvasPrompt
Rappresenta una risposta Interactive Canvas da inviare all'utente. Questa opzione può essere utilizzata in combinazione con il campo "firstSimple" nel prompt contenitore per parlare con l'utente, oltre a visualizzare una risposta canvas interattiva.
Rappresentazione JSON | |
---|---|
{ "url": string, "data": [ value ], "suppressMic": boolean } |
Campi | |
---|---|
url |
Obbligatorio. URL della visualizzazione web da caricare. |
data[] |
Campo facoltativo. Dati JSON da trasmettere alla pagina web dell'esperienza immersiva sotto forma di evento. Se il campo "Sostituisci" nel prompt contenente è "false", i valori dei dati definiti nel prompt di Canvas verranno aggiunti dopo i valori dei dati definiti nei prompt di Canvas precedenti. |
suppressMic |
Campo facoltativo. Un valore true indica che il microfono non verrà aperto per acquisire l'input dopo che questa risposta immersiva viene presentata all'utente. |