Scene

La scène est l'unité de base du flux de contrôle lors de la conception d'une conversation. Ils peuvent être enchaînés avec d'autres scènes, générer des invites pour l'utilisateur final et définir des emplacements. Le nom de la scène est spécifié dans le nom du fichier.

Représentation YAML 
onEnter: 
  object (EventHandler)
intentEvents: 
  - object (IntentEvent)
conditionalEvents: 
  - object (ConditionalEvent)
slots: 
  - object (Slot)
onSlotUpdated: 
  object (EventHandler)
Champs
onEnter

object (EventHandler)

Gestionnaire à invoquer lors de la transition vers cette scène
intentEvents[]

object (IntentEvent)

Liste des événements qui se déclenchent en fonction des intents. Ces événements peuvent être déclenchés à tout moment après l'appel du gestionnaire on_load. Important : Ces événements définissent l'ensemble d'intents limités à cette scène et prévalent sur tous les événements définis globalement qui ont les mêmes intents ou leurs phrases de déclenchement. Les noms d'intent doivent être uniques au sein d'une scène.
conditionalEvents[]

object (ConditionalEvent)

Liste des événements à déclencher en fonction d'instructions conditionnelles. Elles sont évaluées une fois le formulaire rempli ou immédiatement après on_load si cette scène ne contient pas de formulaire (l'évaluation n'est effectuée qu'une seule fois). Seul le premier événement correspondant sera déclenché.
slots[]

object (Slot)

Liste numérotée des emplacements. Chaque emplacement définit le type de données qu'il résoudrea et la configuration permettant de personnaliser l'expérience associée à cette résolution (par exemple, les invites).
onSlotUpdated

object (EventHandler)

Gestionnaire appelé lorsque l'état d'un emplacement change non causé par des mises à jour dans un autre gestionnaire. Cela permet d'invalider des emplacements, de invalider la scène et d'apporter d'autres changements à l'état de la scène.

Encoche

Configuration d'un emplacement. Les emplacements sont des unités de données uniques qui peuvent être remplies via le langage naturel (paramètres d'intent), les paramètres de session et d'autres sources.

Représentation YAML 
name: string
type: 
  object (ClassReference)
required: boolean
promptSettings: 
  object (PromptSettings)
commitBehavior: 
  object (CommitBehavior)
config: value
defaultValue: 
  object (DefaultValue)
Champs
name

string

Obligatoire. Nom de l'espace publicitaire.
type

object (ClassReference)

Obligatoire. Déclare le type de données de cet emplacement.
required

boolean

Facultatif. Indique si l'espace publicitaire doit être rempli avant l'avancement. Les emplacements obligatoires qui n'ont pas été remplis déclencheront une invite personnalisable destinée à l'utilisateur.
promptSettings

object (PromptSettings)

Facultatif. Enregistre des invites pour différentes étapes de remplissage d'emplacements.
commitBehavior

object (CommitBehavior)

Facultatif. Comportement de commit associé à l'emplacement
config

value (Value format)

Facultatif. Configuration supplémentaire associée à l'emplacement utilisé pour le remplir. Le format de la configuration est spécifique au type d'emplacement. Des références de ressources aux paramètres d'utilisateur ou de session peuvent être ajoutées à cette configuration. Cette configuration est nécessaire pour remplir les emplacements liés aux transactions et à l'engagement utilisateur.

Exemple: pour un emplacement de type actions.type.CompletePurchaseValue, la configuration suivante propose une commande de produit numérique avec une référence à un paramètre de session défini par le client userSelectedSkuId:

{ "@type": "type.googleapis.com/ google.actions.transactions.v3.CompletePurchaseValueSpec", "skuId": { "skuType": "SKU_TYPE_IN_APP", "id": "$session.params.userSelectedSkuId", "packageName": "com.example.company" } }
defaultValue

object (DefaultValue)

Facultatif. Configuration permettant de renseigner une valeur par défaut pour cet emplacement.

PromptSettings

Un emplacement unique où les invites d'emplacements sont définies.

Représentation YAML 
initialPrompt: 
  object (EventHandler)
noMatchPrompt1: 
  object (EventHandler)
noMatchPrompt2: 
  object (EventHandler)
noMatchFinalPrompt: 
  object (EventHandler)
noInputPrompt1: 
  object (EventHandler)
noInputPrompt2: 
  object (EventHandler)
noInputFinalPrompt: 
  object (EventHandler)
Champs
initialPrompt

object (EventHandler)

Invite pour la valeur de l'espace publicitaire. Exemple: "Quelle taille souhaitez-vous utiliser ?"
noMatchPrompt1

object (EventHandler)

Invite à être donnée lorsque l'entrée utilisateur ne correspond pas au type de valeur attendu pour l'emplacement pour la première fois. Exemple: "Désolé, je n'ai pas compris."
noMatchPrompt2

object (EventHandler)

Invite à être donnée lorsque l'entrée utilisateur ne correspond pas au type de valeur attendu pour l'emplacement pour la deuxième fois. Exemple: "Désolé, je n'ai pas compris."
noMatchFinalPrompt

object (EventHandler)

Invite à être donnée lorsque l'entrée utilisateur ne correspond pas au type de valeur attendu pour l'emplacement pour la dernière fois. Exemple: "Désolé, je n'ai pas compris."
noInputPrompt1

object (EventHandler)

Invite à donner lorsque l'utilisateur ne fournit pas d'entrée pour la première fois. Exemple: "Désolé, je n'ai pas compris."
noInputPrompt2

object (EventHandler)

Invite à donner lorsque l'utilisateur ne fournit pas d'entrée pour la deuxième fois. Exemple: "Désolé, je n'ai pas compris."
noInputFinalPrompt

object (EventHandler)

Invite à donner lorsque l'utilisateur n'a pas fourni d'entrée pour la dernière fois. Exemple: "Désolé, je n'ai pas compris."

CommitBehavior

Message décrivant le comportement de commit associé à l'emplacement une fois celui-ci rempli.

Représentation YAML 
writeSessionParam: string
Champs
writeSessionParam

string

Paramètre de session permettant d'écrire la valeur de l'espace publicitaire une fois celui-ci rempli. Notez que les chemins d'accès imbriqués ne sont actuellement pas acceptés. "$$" permet d'écrire la valeur de l'emplacement dans un paramètre de session portant le même nom que l'emplacement. Par exemple: writeSessionParam = "fruit" correspond à "$session.params.fruit". writeSessionParam = "ticket" correspond à "$session.params.ticket".

DefaultValue

Configuration permettant de renseigner une valeur par défaut pour cet emplacement.

Représentation YAML 
sessionParam: string
constant: value
Champs
sessionParam

string

Facultatif. Paramètre de session à utiliser pour initialiser la valeur de l'emplacement, si la valeur n'est pas vide. Le type de la valeur doit correspondre au type de l'espace publicitaire. Notez que les chemins d'accès imbriqués ne sont actuellement pas acceptés. Par exemple, sessionParam = "fruit" correspond à $session.params.fruit. sessionParam = "ticket" correspond à $session.params.ticket.
constant

value (Value format)

Facultatif. Valeur par défaut constante de l'espace publicitaire. Il ne sera utilisé que si une valeur n'a pas été renseignée pour cet emplacement via la propriété sessionParam. Le type de cette valeur doit correspondre au type de l'espace publicitaire.