Scene

La scène est l'unité de base du flux de contrôle lors de la conception d'une conversation. Elles peuvent être enchaînées 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 dans 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 une fois que le gestionnaire on_load a été appelé. Important : Ces événements définissent l'ensemble des intents limités à cette scène et sont prioritaires sur tous les événements définis globalement qui ont les mêmes intents ou leurs expressions 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. Celles-ci sont évaluées après que le formulaire a été rempli ou immédiatement après on_load si cette scène n'a 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 d'emplacements. Chaque emplacement définit le type de données qu'il va résoudre, ainsi que la configuration permettant de personnaliser l'utilisation de cette résolution (par exemple, des invites).
onSlotUpdated

object (EventHandler)

Handler appelé en cas de changement d'état d'un emplacement non causé par des mises à jour dans un autre gestionnaire. Cela permet d'invalider les emplacements, la scène ou d'autres changements d'état de la scène.

Encoche

Configuration d'un emplacement. Les emplacements sont des unités uniques de données 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'emplacement.
type

object (ClassReference)

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

boolean

Facultatif. Indique si l'emplacement doit être rempli avant de pouvoir avancer. Les emplacements obligatoires non remplis déclencheront une invite personnalisable à l'utilisateur.
promptSettings

object (PromptSettings)

Facultatif. Enregistre des invites pour différentes étapes du remplissage de cases.
commitBehavior

object (CommitBehavior)

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

value (Value format)

Facultatif. Configuration supplémentaire associée à l'emplacement utilisé pour remplir l'emplacement. Le format de la configuration est spécifique au type de l'emplacement. Des références de ressources au paramètre 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 un bon de commande numérique en faisant 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

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'emplacement lui-même. Exemple : "Quelle taille voulez-vous ?"
noMatchPrompt1

object (EventHandler)

Invite à afficher 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 à afficher 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 à afficher lorsque l'entrée utilisateur ne correspond pas au type de valeur attendu pour l'emplacement lors de 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 ne fournit aucune entrée pour la dernière fois. Exemple : "Désolé, je n'ai pas compris."

CommitBehavior

Message décrivant le comportement du commit associé à l'emplacement une fois qu'il a été rempli.

Représentation YAML 
writeSessionParam: string
Champs
writeSessionParam

string

Paramètre de session permettant d'écrire la valeur de l'emplacement une fois qu'il a été rempli. Notez que les chemins d'accès imbriqués ne sont pas acceptés pour le moment. "€€" permet d'écrire la valeur de l'emplacement dans un paramètre de session portant le même nom que l'emplacement. 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 elle 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 pas acceptés pour le moment. Par exemple: sessionParam = "fruit" correspond à $session.params.fruit. sessionParam = "ticket" correspond à $session.params.ticket.
constant

value (Value format)

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