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 ( |
Champs | |
---|---|
onEnter |
Gestionnaire à invoquer lors de la transition vers cette scène |
intentEvents[] |
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[] |
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[] |
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 |
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 ( |
Champs | |
---|---|
name |
Obligatoire. Nom de l'espace publicitaire. |
type |
Obligatoire. Déclare le type de données de cet emplacement. |
required |
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 |
Facultatif. Enregistre des invites pour différentes étapes de remplissage d'emplacements. |
commitBehavior |
Facultatif. Comportement de commit associé à l'emplacement |
config |
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 { "@type": "type.googleapis.com/ google.actions.transactions.v3.CompletePurchaseValueSpec", "skuId": { "skuType": "SKU_TYPE_IN_APP", "id": "$session.params.userSelectedSkuId", "packageName": "com.example.company" } } |
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 ( |
Champs | |
---|---|
initialPrompt |
Invite pour la valeur de l'espace publicitaire. Exemple: "Quelle taille souhaitez-vous utiliser ?" |
noMatchPrompt1 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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, |
constant |
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é |