EventHandler

candidates: 
  - object (StaticPromptCandidate)

object (StaticPromptCandidate)

L'elenco di prompt candidati da inviare al client. 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.

selector: 
  object (Selector)
promptResponse: 
  object (StaticPromptResponse)

object (Selector)

(Facoltativo) Il criterio per determinare se questo prompt corrisponde a una richiesta. Se il selettore è vuoto, questo prompt verrà attivato sempre.

object (StaticPromptResponse)

La risposta del prompt associata al selettore.

surfaceCapabilities: 
  object (SurfaceCapabilities)

object (SurfaceCapabilities)

L'insieme di capacità di superficie richieste.

capabilities: 
  - enum (Capability)

enum (Capability)

Obbligatorio. Le capacità della superficie che effettua una richiesta all'Azione.

firstSimple: 
  object (StaticSimplePrompt)
content: 
  object (StaticContentPrompt)
lastSimple: 
  object (StaticSimplePrompt)
suggestions: 
  - object (Suggestion)
link: 
  object (StaticLinkPrompt)
override: boolean
canvas: 
  object (StaticCanvasPrompt)

object (StaticSimplePrompt)

(Facoltativo) La prima risposta vocale e di solo testo.

object (StaticContentPrompt)

(Facoltativo) Contenuti come una scheda, un elenco o contenuti multimediali da mostrare all'utente.

object (StaticSimplePrompt)

(Facoltativo) L'ultima risposta vocale e di solo testo.

object (Suggestion)

(Facoltativo) Suggerimenti da mostrare all'utente, che saranno sempre visualizzati alla fine della risposta. Se il campo append nel prompt contenente è true, i titoli definiti in questo campo verranno aggiunti ai titoli definiti in qualsiasi prompt di suggerimenti definito in precedenza e i valori duplicati verranno rimossi.

object (StaticLinkPrompt)

(Facoltativo) Un chip di suggerimento aggiuntivo che può rimandare all'app o al sito associato. Il chip verrà visualizzato con il titolo "Apri ". Massimo 20 caratteri.

boolean

(Facoltativo) Modalità per unire questi messaggi a messaggi definiti in precedenza. true cancellerà tutti i messaggi definiti in precedenza (primo e ultimo semplice, contenuti, link dei suggerimenti e canvas) e aggiungerà i messaggi definiti in questa richiesta. false aggiungerà i messaggi definiti in questo prompt a quelli definiti nelle risposte precedenti. Se questo campo viene impostato su false, verrà attivata anche l'aggiunta ad alcuni campi all'interno dei prompt semplici, del prompt Suggerimenti e del prompt di Canvas (parte del prompt di contenuto). I messaggi Contenuti e Link vengono sempre sovrascritti, se definiti nel prompt. Il valore predefinito è false.

object (StaticCanvasPrompt)

Una risposta da utilizzare per l'esperienza interattiva sulla tela.

variants: 
  - object (Variant)

object (Variant)

Elenco delle possibili varianti.

speech: string
text: string

string

(Facoltativo) Rappresenta il discorso da pronunciare all'utente. Può essere SSML o sintesi vocale. Per impostazione predefinita, la voce verrà aggiunta alla voce del prompt semplice precedente. Se il campo override nel prompt contenente è true, la voce definita in questo campo sostituirà la voce del prompt semplice precedente.

string

(Facoltativo) Testo da visualizzare nel fumetto della chat. Se non viene specificato, verrà utilizzato il rendering del campo vocale riportato sopra. Limitato a 640 caratteri. Per impostazione predefinita, il testo verrà aggiunto al testo del prompt semplice precedente. Se il campo override nel prompt contenente è true, il testo definito in questo campo sostituirà il testo del prompt semplice precedente.

# 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.

object (StaticCardPrompt)

Una carta di base.

object (StaticImagePrompt)

Un'immagine.

object (StaticTablePrompt)

Scheda tabella.

object (StaticMediaPrompt)

Risposta che indica un insieme di contenuti multimediali da riprodurre.

object (StaticListPrompt)

Una scheda per presentare un elenco di opzioni tra cui scegliere.

object (StaticCollectionPrompt)

Una scheda che presenta un elenco di opzioni tra cui scegliere.

object (StaticCollectionBrowsePrompt)

Una scheda con una raccolta di pagine web da aprire.

title: string
subtitle: string
text: string
image: 
  object (StaticImagePrompt)
imageFill: enum (ImageFill)
button: 
  object (StaticLinkPrompt)

string

(Facoltativo) Titolo generale della scheda.

string

(Facoltativo) Sottotitolo della scheda.

string

Obbligatorio. Il 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.

object (StaticImagePrompt)

(Facoltativo) Un'immagine hero per la carta. L'altezza è fissa a 192 dp.

enum (ImageFill)

(Facoltativo) Il modo in cui lo sfondo dell'immagine verrà riempito.

object (StaticLinkPrompt)

(Facoltativo) Un pulsante cliccabile da mostrare nella scheda.

url: string
alt: string
height: integer
width: integer

string

Obbligatorio. L'URL di origine dell'immagine. Le immagini possono essere in formato JPG, PNG e GIF (animate e non animate). Ad esempio,https://www.agentx.com/logo.png.

string

Obbligatorio. Una descrizione testuale dell'immagine da utilizzare per l'accessibilità, ad es. screen reader.

integer

(Facoltativo) L'altezza dell'immagine in pixel.

integer

(Facoltativo) La larghezza dell'immagine in pixel.

name: string
open: 
  object (OpenUrl)

string

Nome del link

object (OpenUrl)

Definisce il comportamento quando l'utente apre il link.

url: string
hint: enum (UrlHint)

string

Il campo url che può essere uno dei seguenti: - URL http/https per l'apertura di un'app collegata all'app o di una pagina web

enum (UrlHint)

Indica un suggerimento per il tipo di URL.

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

string

(Facoltativo) Titolo generale della tabella. Deve essere impostato se sono stati impostati i sottotitoli.

string

(Facoltativo) Sottotitolo per la tabella.

object (StaticImagePrompt)

(Facoltativo) Immagine associata alla tabella.

object (TableColumn)

(Facoltativo) Intestazioni e allineamento delle colonne.

object (TableRow)

(Facoltativo) Dati delle righe della tabella. È garantita la visualizzazione delle prime tre righe, ma altre potrebbero essere tagliate su determinate superfici. Esegui un test con il simulatore per vedere quali righe verranno visualizzate per una determinata superficie. Sulle piattaforme che supportano la funzionalità WEB_BROWSER, puoi indirizzare l'utente a una pagina web con più dati.

object (StaticLinkPrompt)

(Facoltativo) Pulsante.

header: string
align: enum (HorizontalAlignment)

string

Testo dell'intestazione per la colonna.

enum (HorizontalAlignment)

Allineamento orizzontale dei contenuti rispetto alla colonna. Se non specificato, i contenuti verranno allineati al bordo iniziale.

cells: 
  - object (TableCell)
divider: boolean

object (TableCell)

Celle in questa riga. È garantita la visualizzazione delle prime 3 celle, ma le altre potrebbero essere tagliate su determinate superfici. Esegui un test con il simulatore per vedere quali celle verranno visualizzate per una determinata superficie.

boolean

Indica se deve esserci un divisore dopo ogni riga.

text: string

string

Contenuto testuale della cella.

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

enum (MediaType)

Tipo multimediale di questa risposta.

string (Duration format)

Offset iniziale del primo oggetto multimediale.

Durata in secondi con un massimo di nove cifre frazionarie, terminata da "s". Esempio: "3.5s".

enum (OptionalMediaControls)

Tipi facoltativi di controlli multimediali supportati da questa sessione di risposte multimediali. Se impostato, la richiesta verrà effettuata a terze parti quando si verifica un determinato evento multimediale. Se non viene configurato, 3p deve comunque gestire due tipi di controllo predefiniti, FINISHED e FAILED.

object (MediaObject)

Elenco di oggetti multimediali.

enum (RepeatMode)

Modalità di ripetizione per l'elenco di oggetti multimediali.

name: string
description: string
url: string
image: 
  object (MediaImage)

string

Nome dell'oggetto multimediale.

string

Descrizione di questo oggetto multimediale.

string

L'URL che rimanda ai contenuti multimediali.

object (MediaImage)

Immagine da mostrare con la scheda dei contenuti multimediali.

# 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.

object (StaticImagePrompt)

Un'immagine di grandi dimensioni, come la copertina dell'album e così via.

object (StaticImagePrompt)

Una piccola icona immagine visualizzata a destra rispetto al titolo. Viene ridimensionato a 36 x 36 dp.

title: string
subtitle: string
items: 
  - object (ListItem)

string

(Facoltativo) Titolo dell'elenco.

string

(Facoltativo) Sottotitolo dell'elenco.

object (ListItem)

Obbligatorio. Voci dell'elenco.

key: string
title: string
description: string
image: 
  object (StaticImagePrompt)

string

Obbligatorio. La chiave NLU corrispondente al nome della chiave di accesso nel tipo associato. Quando l'elemento viene toccato, questa chiave viene pubblicata come parametro di opzione di selezione.

string

Obbligatorio. Titolo dell'articolo. Se toccato, il testo viene pubblicato nella conversazione parola per parola, come se l'utente lo avesse digitato. Ogni titolo deve essere unico nell'insieme di elementi.

string

(Facoltativo) Corpo del testo dell'elemento.

object (StaticImagePrompt)

(Facoltativo) Immagine elemento.

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

string

(Facoltativo) Titolo della raccolta.

string

(Facoltativo) Sottotitolo della raccolta.

object (CollectionItem)

Obbligatorio. Elementi della raccolta.

enum (ImageFill)

(Facoltativo) Tipo di opzione di visualizzazione dell'immagine.

key: string
title: string
description: string
image: 
  object (StaticImagePrompt)

string

Obbligatorio. La chiave NLU corrispondente al nome della chiave di accesso nel tipo associato. Quando l'elemento viene toccato, questa chiave viene pubblicata come parametro di opzione di selezione.

string

Obbligatorio. Titolo dell'articolo. Se toccato, il testo viene pubblicato nella conversazione parola per parola, come se l'utente lo avesse digitato. Ogni titolo deve essere unico nell'insieme di elementi.

string

(Facoltativo) Corpo del testo dell'elemento.

object (StaticImagePrompt)

(Facoltativo) Immagine elemento.

items: 
  - object (CollectionBrowseItem)
imageFill: enum (ImageFill)

object (CollectionBrowseItem)

Elementi nella raccolta Sfoglia. La dimensione dell'elenco deve essere compresa nell'intervallo [2, 10].

enum (ImageFill)

Opzione di visualizzazione delle immagini per le immagini nella raccolta.

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

string

Obbligatorio. Titolo dell'elemento della raccolta.

string

Descrizione dell'elemento della raccolta.

string

Testo a piè di pagina per l'elemento della raccolta, visualizzato sotto la descrizione. Una singola riga di testo, troncata con i puntini di sospensione.

object (StaticImagePrompt)

Immagine per l'elemento della raccolta.

object (OpenUrl)

Obbligatorio. URI da aprire se l'elemento selezionato.

title: string

string

Obbligatorio. Il testo mostrato nel chip di suggerimento. Se toccato, il testo viene pubblicato nella conversazione parola per parola, come se l'utente lo avesse digitato. Ogni titolo deve essere univoco tra l'insieme di chip di suggerimento. Massimo 25 caratteri

url: string
data: 
  - value
suppressMic: boolean
sendStateDataToCanvasApp: boolean
enableFullScreen: boolean
continueTtsDuringTouch: boolean

string

Obbligatorio. URL della vista web da caricare.

value (Value format)

(Facoltativo) Dati JSON da trasmettere alla pagina web dell'esperienza immersiva sotto forma di evento. Se il campo override nel prompt contenente è false, i valori dei dati definiti in questo prompt di Canvas verranno aggiunti dopo i valori dei dati definiti nei prompt di Canvas precedenti.

boolean

(Facoltativo) Un valore reale indica che il microfono non si aprirà per acquisire l'input dopo aver presentato questa risposta immersiva all'utente.

boolean

(Facoltativo) Se true, i metadati relativi alla conversazione vengono inclusi e inviati all'applicazione canvas.

boolean

(Facoltativo) Se true l'applicazione canvas occupa l'intero schermo e non avrà un'intestazione nella parte superiore. Sulla schermata di caricamento verrà visualizzato anche un messaggio toast che include il nome visualizzato dell'azione, il nome dello sviluppatore e le istruzioni per uscire dall'azione. Valore predefinito: false.

boolean

(Facoltativo) Se il valore è true, i tocchi sullo schermo non interromperanno la sintesi vocale per l'intera sessione su tela. Valore predefinito: false.