StaticPrompt

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

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.

StaticPromptCandidate

Rappresenta un candidato di prompt statico.

Rappresentazione JSON 
{
  "selector": {
    object (Selector)
  },
  "promptResponse": {
    object (StaticPromptResponse)
  }
}
Campi
selector

object (Selector)

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

object (StaticPromptResponse)

La risposta del prompt associata al selettore.

Selettore

Definisce i criteri per stabilire se un prompt corrisponde a una richiesta.

Rappresentazione JSON 
{
  "surfaceCapabilities": {
    object (SurfaceCapabilities)
  }
}
Campi
surfaceCapabilities

object (SurfaceCapabilities)

L'insieme di capacità di superficie richieste.

SurfaceCapabilities

Rappresenta la piattaforma utilizzata dall'utente per inviare una richiesta all'azione.

Rappresentazione JSON 
{
  "capabilities": [
    enum (Capability)
  ]
}
Campi
capabilities[]

enum (Capability)

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

StaticPromptResponse

Rappresenta risposte strutturate da inviare all'utente, come testo, voce, schede, dati canvas, chip di suggerimenti e così via.

Rappresentazione JSON 
{
  "firstSimple": {
    object (StaticSimplePrompt)
  },
  "content": {
    object (StaticContentPrompt)
  },
  "lastSimple": {
    object (StaticSimplePrompt)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "link": {
    object (StaticLinkPrompt)
  },
  "override": boolean,
  "canvas": {
    object (StaticCanvasPrompt)
  }
}
Campi
firstSimple

object (StaticSimplePrompt)

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

object (StaticContentPrompt)

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

object (StaticSimplePrompt)

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

object (Suggestion)

(Facoltativo) Suggerimenti da mostrare all'utente, che saranno sempre visualizzati alla fine della risposta. Se l'opzione "Aggiungi" il campo nel prompt contenitore è "true" i titoli definiti in questo campo verranno aggiunti ai titoli definiti in qualsiasi richiesta di suggerimenti definita in precedenza e i valori duplicati verranno rimossi.
override

boolean

(Facoltativo) Modalità per unire questi messaggi a messaggi definiti in precedenza. "vero" cancellerà tutti i messaggi definiti in precedenza (primo e ultimo semplice, contenuti, link dei suggerimenti e canvas) e aggiungerà i messaggi definiti in questo prompt. "false" aggiungerà i messaggi definiti in questo prompt a quelli definiti nelle risposte precedenti. Se imposti questo campo su "false" attiverà anche l'aggiunta ad alcuni campi all'interno dei prompt semplici, del prompt Suggestions e del prompt Canvas (parte del prompt Content). I messaggi Contenuti e Link vengono sempre sovrascritti, se definiti nel prompt. Il valore predefinito è "false".
canvas

object (StaticCanvasPrompt)

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

StaticSimplePrompt

Rappresenta un semplice prompt da inviare a un utente.

Rappresentazione JSON 
{
  "variants": [
    {
      object (Variant)
    }
  ]
}
Campi
variants[]

object (Variant)

Elenco delle possibili varianti.

Variante

Rappresenta una variante che fa parte del prompt semplice.

Rappresentazione JSON 
{
  "speech": string,
  "text": string
}
Campi
speech

string

(Facoltativo) Rappresenta il discorso da pronunciare all'utente. Può essere SSML o sintesi vocale. Se l'opzione "Aggiungi" il campo nel prompt contenitore è "true" la voce definita in questo campo verrà aggiunta alla voce del prompt semplice precedente.
text

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. Se l'opzione "Aggiungi" il campo nel prompt contenitore è "true" il testo definito in questo campo verrà aggiunto al testo del prompt semplice precedente.

StaticContentPrompt

Un segnaposto per la parte relativa ai contenuti di un prompt statico.

Rappresentazione 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.
}
Campi
Campo unione content. In un prompt può essere presente un solo tipo di contenuto. content può essere solo uno dei seguenti:
card

object (StaticCardPrompt)

Una carta di base.
image

object (StaticImagePrompt)

Un'immagine.
table

object (StaticTablePrompt)

Scheda tabella.
media

object (StaticMediaPrompt)

Risposta che indica un insieme di contenuti multimediali da riprodurre.
list

object (StaticListPrompt)

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

object (StaticCollectionPrompt)

Una scheda che presenta 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 (StaticImagePrompt)
  },
  "imageFill": enum (ImageFill),
  "button": {
    object (StaticLinkPrompt)
  }
}
Campi
title

string

(Facoltativo) Titolo generale della scheda.
subtitle

string

(Facoltativo) Sottotitolo della scheda.
text

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

object (StaticImagePrompt)

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

enum (ImageFill)

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

object (StaticLinkPrompt)

(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

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

string

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

integer

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

integer

(Facoltativo) La larghezza dell'immagine in pixel.

StaticLinkPrompt

Definisce un link che verrà visualizzato come chip di suggerimento e può essere aperto dall'utente.

Rappresentazione JSON 
{
  "name": string,
  "open": {
    object (OpenUrl)
  }
}
Campi
name

string

Nome del link
open

object (OpenUrl)

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 (UrlHint)
}
Campi
url

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
hint

enum (UrlHint)

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 (StaticImagePrompt)
  },
  "columns": [
    {
      object (TableColumn)
    }
  ],
  "rows": [
    {
      object (TableRow)
    }
  ],
  "button": {
    object (StaticLinkPrompt)
  }
}
Campi
title

string

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

string

(Facoltativo) Sottotitolo per la tabella.
image

object (StaticImagePrompt)

(Facoltativo) Immagine associata alla tabella.
columns[]

object (TableColumn)

(Facoltativo) Intestazioni e allineamento delle colonne.
rows[]

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

object (StaticLinkPrompt)

(Facoltativo) Pulsante.

TableColumn

Descrive una colonna della tabella.

Rappresentazione JSON 
{
  "header": string,
  "align": enum (HorizontalAlignment)
}
Campi
header

string

Testo dell'intestazione per la colonna.
align

enum (HorizontalAlignment)

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

TableRow

Descrive una riga della tabella.

Rappresentazione JSON 
{
  "cells": [
    {
      object (TableCell)
    }
  ],
  "divider": boolean
}
Campi
cells[]

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

boolean

Indica se deve esserci un divisore dopo ogni riga.

TableCell

Descrive una cella in una riga.

Rappresentazione JSON 
{
  "text": string
}
Campi
text

string

Contenuto testuale della cella.

StaticMediaPrompt

Contiene informazioni sul contenuto multimediale, come nome, descrizione, URL e così via. ID successivo: 9

Rappresentazione JSON 
{
  "mediaType": enum (MediaType),
  "startOffset": string,
  "optionalMediaControls": [
    enum (OptionalMediaControls)
  ],
  "mediaObjects": [
    {
      object (MediaObject)
    }
  ]
}
Campi
mediaType

enum (MediaType)

Tipo multimediale di questa risposta.
startOffset

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".
optionalMediaControls[]

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.
mediaObjects[]

object (MediaObject)

Elenco di oggetti multimediali.

MediaObject

Rappresenta un singolo oggetto multimediale.

Rappresentazione JSON 
{
  "name": string,
  "description": string,
  "url": string,
  "image": {
    object (MediaImage)
  }
}
Campi
name

string

Nome dell'oggetto multimediale.
description

string

Descrizione di questo oggetto multimediale.
url

string

L'URL che rimanda ai contenuti multimediali.
image

object (MediaImage)

Immagine da mostrare con la scheda dei contenuti multimediali.

MediaImage

Immagine da mostrare all'interno di un MediaPrompt.

Rappresentazione 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.
}
Campi
Campo unione image. È consentito un solo tipo di MediaImage. image può essere solo uno dei seguenti:
large

object (StaticImagePrompt)

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

object (StaticImagePrompt)

Una piccola icona immagine visualizzata a destra rispetto al 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 (ListItem)
    }
  ]
}
Campi
title

string

(Facoltativo) Titolo dell'elenco.
subtitle

string

(Facoltativo) Sottotitolo dell'elenco.
items[]

object (ListItem)

Obbligatorio. Voci dell'elenco.

ListItem

Un elemento dell'elenco.

Rappresentazione JSON 
{
  "key": string,
  "title": string,
  "description": string,
  "image": {
    object (StaticImagePrompt)
  }
}
Campi
key

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

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

string

(Facoltativo) Corpo del testo dell'elemento.
image

object (StaticImagePrompt)

(Facoltativo) Immagine elemento.

StaticCollectionPrompt

Una scheda per presentare una raccolta di opzioni tra cui scegliere.

Rappresentazione JSON 
{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (CollectionItem)
    }
  ],
  "imageFill": enum (ImageFill)
}
Campi
title

string

(Facoltativo) Titolo della raccolta.
subtitle

string

(Facoltativo) Sottotitolo della raccolta.
items[]

object (CollectionItem)

Obbligatorio. Elementi della raccolta.
imageFill

enum (ImageFill)

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

CollectionItem

Un elemento nella raccolta.

Rappresentazione JSON 
{
  "key": string,
  "title": string,
  "description": string,
  "image": {
    object (StaticImagePrompt)
  }
}
Campi
key

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

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

string

(Facoltativo) Corpo del testo dell'elemento.
image

object (StaticImagePrompt)

(Facoltativo) Immagine elemento.

Suggerimento

Rappresenta un chip di suggerimento, un elemento UI mostrato all'utente per comodità.

Rappresentazione JSON 
{
  "title": string
}
Campi
title

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

StaticCanvasPrompt

Rappresenta una risposta di Canvas interattiva da inviare all'utente. Può essere utilizzato in combinazione con il campo "firstSimple" nel prompt contenente per parlare con l'utente oltre a visualizzare una risposta canvas interattiva.

Rappresentazione JSON 
{
  "url": string,
  "data": [
    value
  ],
  "suppressMic": boolean
}
Campi
url

string

Obbligatorio. URL della vista web da caricare.
data[]

value (Value format)

(Facoltativo) Dati JSON da trasmettere alla pagina web dell'esperienza immersiva sotto forma di evento. Se l'opzione "override" il campo 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.
suppressMic

boolean

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