Les paramètres CX ressemblent aux paramètres ES, mais l'utilitaire et le champ d'application ont été étendus, et la syntaxe des paramètres de référence a changé.
Définir, référencer, régler et obtenir des paramètres
Il existe quatre façons générales d'utiliser les paramètres :
- Définir au moment de la conception : lors de la conception, vous utilisez la console ou l'API pour définir les paramètres. Par exemple, vous pouvez définir un paramètre d'intent et l'utiliser dans une phrase d'entraînement pour indiquer une entrée d'utilisateur final à extraire.
- Références au moment de la conception : les références de paramètres sont des variables contenant des valeurs de paramètre à extraire lors de l'exécution. Au moment de la conception, vous utilisez la console ou l'API pour référencer des paramètres dans différents types de données. Par exemple, vous pouvez référencer un paramètre de session dans une réponse de fulfillment statique pour une route.
- Définition au moment de l'exécution : au moment de l'exécution, le service Dialogflow, votre service qui appelle l'API, et votre service de webhook peuvent tous définir des valeurs de paramètres. Par exemple, le service Dialogflow définit la valeur d'un paramètre d'intent lorsqu'une entrée d'utilisateur final correspond à l'intent et que cette entrée contient des données de paramètre.
- Obtention au moment de l'exécution : au moment de l'exécution, vos références de paramètres contiennent les valeurs de paramètres qui ont été définies. Vous pouvez utiliser l'API ou un webhook pour les obtenir. Par exemple, lorsqu'un intent est mis en correspondance et que votre webhook est appelé, votre service de webhook reçoit les valeurs des paramètres de l'intent.
Nommer les paramètres
Les règles suivantes s'appliquent à l'attribution de noms aux paramètres :
- Utilisez les caractères suivants :
[A-Z],[a-z],[0-9],.,-,_. - Les noms de paramètres n'étant pas sensibles à la casse, Dialogflow traite
Appleetapplecomme étant le même paramètre. Le webhook et le code client de l'API doivent également traiter les noms de paramètres comme n'étant pas sensibles à la casse, car il n'y a aucune garantie quant à la casse des noms de paramètres renvoyés par Dialogflow.
Types de valeurs de paramètres
Les valeurs de paramètre acceptent plusieurs types de valeurs. La section Sessions ci-dessous explique comment référencer chaque type de valeur de paramètre. Les types de valeurs suivants sont acceptés :
| Type | Description |
|---|---|
| Scalaire | Valeur numérique ou de chaîne unique. |
| Composite | Objet JSON renseigné en fonction d'une entité composite ou en renseignant un paramètre d'intent, qui contient les champs original et resolved. |
| Liste | Liste de valeurs scalaires ou composites renseignées pour un paramètre configuré en tant que liste. Reportez-vous aux options Est une liste ci-dessous. |
Paramètre de chaîne vide et valeurs nulles
Vous pouvez définir les valeurs de paramètre de chaîne sur "", ce qui définit le paramètre sur la chaîne vide.
Vous pouvez définir n'importe quelle valeur de paramètre sur null, ce qui indique que le paramètre n'a pas été défini.
Valeurs d'origine des paramètres
Lorsque le texte est mis en correspondance avec une entité particulière au moment de l'exécution, il est souvent résolu en une valeur plus pratique à traiter. Par exemple, le mot "pommes" dans les données saisies par l'utilisateur final peut être résolu en "pomme" pour une entité fruit.
Tous les types de valeur pour les références de paramètres d'intent peuvent faire référence à la valeur d'origine ou résolue.
Seuls les types de valeurs composites pour les références de paramètres de session peuvent référencer la valeur d'origine.
Paramètres d'intent
Les intents utilisent des paramètres pour extraire les données fournies par les utilisateurs finaux lorsque les intents sont mis en correspondance. Les données suivantes sont utilisées pour définir un paramètre d'intent :
- Nom (également appelé ID ou Nom à afficher) : nom qui identifie le paramètre.
- Type d'entité : type d'entité associé au paramètre.
- Est une liste : si le paramètre est défini sur "vrai", le paramètre est traité comme une liste de valeurs.
- Masquer dans le journal : si la valeur est définie sur "true", les données de paramètre fournies par l'utilisateur final sont masquées.
Définir des paramètres d'intent
Les paramètres d'intent sont définis au moment de la conception lors de la création des données d'intent ou lors de l'annotation de phrases d'entraînement.
Paramètres d'intent de référence
Les références des paramètres d'intent peuvent être utilisées dans les messages de réponse de fulfillment statique des routes d'intents.
Vous pouvez référencer la valeur d'origine ou la valeur résolue.
Pour référencer un paramètre pour l'intent actuellement associé, utilisez l'un des formats suivants :
$intent.params.parameter-id.original $intent.params.parameter-id.resolved
Par exemple, si l'ID de paramètre est date, vous pouvez référencer la valeur résolue au format suivant : $intent.params.date.resolved.
Définir des paramètres d'intent
Lorsqu'une entrée d'utilisateur final correspond à un intent au moment de l'exécution, tout paramètre utilisé par une annotation pour la phrase d'entraînement associée est défini par Dialogflow.
Le fulfillment d'une route d'intent peut utiliser un préréglage des paramètres de fulfillment pour définir une valeur de paramètre d'intent au moment de l'exécution.
Obtenir des paramètres d'intent
Lors du tour de conversation dans lequel un intent est mis en correspondance, votre code peut accéder aux valeurs des paramètres d'intent.
Les interactions avec l'API renverront les valeurs du paramètre d'intent.
Consultez le champ de réponse queryResult.parameters de la méthode detectIntent pour le type Session.
Sélectionnez un protocole et une version pour la référence de session :
| Protocole | V3 | V3beta1 |
|---|---|---|
| REST | Ressource de la session | Ressource de la session |
| RPC | Interface de la session | Interface de la session |
| C++ | SessionsClient | Non disponible |
| C# | SessionsClient | Non disponible |
| Go | SessionsClient | Non disponible |
| Java | SessionsClient | SessionsClient |
| Node.js | SessionsClient | SessionsClient |
| PHP | Non disponible | Non disponible |
| Python | SessionsClient | SessionsClient |
| Ruby | Non disponible | Non disponible |
Le webhook reçoit les valeurs de paramètre de l'intent.
Consultez le champ intentInfo.parameters dans la requête du webhook.
Paramètres de formulaire
Pour chaque page, vous pouvez définir un formulaire, qui est une liste de paramètres devant être collectés par l'utilisateur final pour la page. L'agent interagit avec l'utilisateur final pour plusieurs tours de conversation, jusqu'à ce qu'il ait collecté tous les paramètres du formulaire requis, également appelés paramètres de page L'agent collecte ces paramètres dans l'ordre défini sur la page. Pour chaque paramètre du formulaire requis, vous fournissez également des invites que l'agent utilise pour demander ces informations à l'utilisateur final. Ce processus est appelé le remplissage du formulaire.
Par exemple, vous pouvez créer un formulaire qui recueille le nom et le numéro de téléphone de l'utilisateur final pour une page Collect Customer Info.
Le remplissage de formulaire CX ressemble au remplissage de cases ES.
Les données suivantes sont utilisées pour définir un paramètre de formulaire :
| Nom de l'option de console | Chaîne de champ de l'API | Description |
|---|---|---|
| Nom à afficher | Page.form.parameters[].displayName |
Un nom qui identifie le paramètre. |
| Type d'entité | Page.form.parameters[].entityType |
Le type d'entité associé au paramètre. |
| Obligatoire | Page.form.parameters[].required |
Indique si le paramètre est requis. Les paramètres obligatoires doivent être renseignés avant la fin du remplissage du formulaire. L'agent demande alors des valeurs à l'utilisateur final. Pour en savoir plus, consultez la section Définir des paramètres de formulaire ci-dessous. |
| Valeur par défaut (visible uniquement lorsque la case Obligatoire est décochée) | Page.form.parameters[].defaultValue |
Valeur par défaut d'un paramètre facultatif. Pour en savoir plus, consultez la section Définir des paramètres de formulaire ci-dessous. |
| Est une liste | Page.form.parameters[].isList |
Si le paramètre est défini sur "true", le paramètre est traité comme une liste de valeurs. |
| Masquer dans le journal | Page.form.parameters[].redact |
Si la valeur est définie sur "true", les données de paramètre fournies par l'utilisateur final sont masquées. |
| Fulfillment d'invite initial | Page.form.parameters[].fillBehavior.initialPromptFulfillment |
Invite initiale sous la forme de fulfillment pour demander une valeur de paramètre requise à l'utilisateur final. Pour en savoir plus, consultez la section Définir des paramètres de formulaire ci-dessous. |
| Gestionnaires d'événements de nouvelle invite | Page.form.parameters[].fillBehavior.repromptEventHandlers |
Ils sont utilisés lorsque l'agent doit demander à nouveau à l'utilisateur final de remplir le paramètre en cas d'échec d'une tentative. Consultez la section Gestionnaires de nouvelles invites de remplissage de formulaires. Si aucun gestionnaire d'événements de nouvelle invite n'est défini, l'agent envoie une nouvelle invite avec les invites initiales après une tentative ayant échoué. |
| DTMF | Non disponible | Consultez la section DTMF ci-dessous. |
Définir et gérer les paramètres de formulaire
Les paramètres du formulaire sont définis au moment de la conception lors de la création d'une page.
Pour modifier l'ordre des paramètres du formulaire à l'aide de la console, cliquez sur le titre de la section Paramètres sur la page, puis faites glisser les lignes de paramètres dans le tableau des paramètres.
Pour supprimer un paramètre de formulaire, cliquez sur le titre de la section Parameters (Paramètres) de la page, passez la souris sur un paramètre, puis cliquez sur le bouton de suppression delete.
Paramètres du formulaire de référence
Les références des paramètres du formulaire ne sont pas utilisées directement. Vous ne pouvez vérifier l'état de remplissage que pour les paramètres de formulaire individuels ou pour l'ensemble du formulaire. Vous pouvez utiliser ces références d'état du formulaire dans une exigence de condition d'une route de condition.
Pour vérifier si le formulaire de la page actuelle est rempli, utilisez la condition suivante :
$page.params.status = "FINAL"
Pour vérifier si un paramètre de formulaire particulier a été rempli lors du dernier tour, utilisez la condition suivante :
$page.params.parameter-id.status = "UPDATED"
Définir des paramètres de formulaire
Les valeurs des paramètres de formulaire peuvent être définies de différentes manières. Les sous-sections suivantes décrivent chaque mécanisme permettant de définir les valeurs des paramètres de formulaire.
Valeurs des paramètres par défaut
Vous pouvez fournir des valeurs par défaut pour les paramètres de formulaire facultatifs. Au début du remplissage du formulaire, tous les paramètres facultatifs du formulaire non définis sont définis sur leurs valeurs par défaut. Ces valeurs peuvent être initialisées ou remplacées par certains des mécanismes ci-dessous.
Si un paramètre est obligatoire, sa valeur par défaut est ignorée.
Remplissage de formulaire
Dialogflow définit automatiquement les valeurs de paramètre fournies par l'utilisateur final lors du remplissage du formulaire. L'agent collecte les paramètres obligatoires dans l'ordre défini sur la page. L'agent invite l'utilisateur final à saisir les valeurs requises à l'aide du fulfillment initial des invites que vous fournissez pour chaque paramètre requis. Les paramètres facultatifs ne déclenchent pas d'invites.
Si la valeur du paramètre requis n'est pas fournie par l'utilisateur final après une invite d'agent, l'invite initiale est répétée, sauf si un comportement différent est défini dans les gestionnaires de nouvelles invites. Si plusieurs invites de texte initiales sont définies, le comportement de l'agent est identique à celui des réponses textuelles de fulfillment.
Propagation des paramètres de l'intent et de session
Lorsqu'un paramètre de n'importe quel type est défini au moment de l'exécution, il est écrit dans la session et devient un paramètre de session.
Lorsqu'une page devient initialement active, et au cours de sa période d'activité, tout paramètre de formulaire portant le même nom qu'un paramètre de session est automatiquement défini sur la valeur du paramètre de session.
Cela peut se produire avec un paramètre d'intent correspondant dans une route d'intent ou une propagation de paramètre.
La propagation des paramètres d'intent et de session est le seul moyen de définir des paramètres de formulaire facultatifs sur les valeurs saisies par l'utilisateur final. Cependant, ce mécanisme peut également définir ou remplacer les valeurs de paramètres de formulaire requises.
Préréglages des paramètres de fulfillment
Le fulfillment pour une route, un gestionnaire d'événements ou une nouvelle invite de formulaire peut utiliser un préréglage de paramètre de fulfillment pour définir une valeur de paramètre de formulaire au moment de l'exécution. Un préréglage des paramètres de fulfillment remplace une valeur de paramètre, y compris les valeurs par défaut des paramètres.
Configuration des paramètres de webhook
Votre webhook peut définir les valeurs des paramètres du formulaire au moment de l'exécution.
Consultez le champ pageInfo.formInfo.parameterInfo dans la réponse Webhook.
Obtenir des paramètres de formulaire
Les interactions avec l'API renvoient les valeurs des paramètres de formulaire.
Consultez le champ de réponse queryResult.parameters de la méthode detectIntent pour le type Session.
Sélectionnez un protocole et une version pour la référence de session :
| Protocole | V3 | V3beta1 |
|---|---|---|
| REST | Ressource de la session | Ressource de la session |
| RPC | Interface de la session | Interface de la session |
| C++ | SessionsClient | Non disponible |
| C# | SessionsClient | Non disponible |
| Go | SessionsClient | Non disponible |
| Java | SessionsClient | SessionsClient |
| Node.js | SessionsClient | SessionsClient |
| PHP | Non disponible | Non disponible |
| Python | SessionsClient | SessionsClient |
| Ruby | Non disponible | Non disponible |
Le webhook reçoit les valeurs de paramètre du formulaire.
Consultez le champ pageInfo.formInfo.parameterInfo dans la requête du webhook.
Gestionnaires de nouvelles invites de remplissage de formulaires
Les gestionnaires de nouvelles invites, également appelés gestionnaires d'événements au niveau des paramètres, permettent de définir le comportement complexe d'invite de paramètres pour les paramètres requis. Par exemple, les gestionnaires de nouvelles invites peuvent être utilisés pour modifier l'invite lorsque l'utilisateur final ne fournit pas de valeur après l'invite initiale et pour passer à une autre page après N tentatives infructueuses.
Si aucun gestionnaire de nouvelles invites n'est défini, l'invite initiale est à nouveau soumise à l'utilisateur final si nécessaire.
Si l'utilisateur final répond par une entrée inattendue, un événement sys.no-match-* ou sys.no-input-* est appelé, et tous les gestionnaires de nouvelles invites définis pour ces événements sont appelés.
Comme d'autres gestionnaires d'événements, un gestionnaire de nouvelles invites est un type de gestionnaire d'état pouvant être configuré avec l'un des éléments suivants, ou les deux :
- Un fulfillment pour fournir un message de nouvelle invite à l'utilisateur final et/ou un préréglage de paramètres.
- Une cible de transition permettant de modifier la page actuelle
Paramètres de session
Lorsqu'un paramètre de n'importe quel type est défini au moment de l'exécution, il est écrit dans la session et devient un paramètre de session. Ces paramètres ne sont pas explicitement définis au moment de la conception. Vous pouvez référencer ces paramètres de session à tout moment au cours d'une session.
Paramètres de session de référence
Les références de paramètres de session peuvent être utilisées dans les messages de réponse statique pour les types de fulfillment suivants :
- Fulfillment des entrées de page
- Fulfillment de la route
- Fulfillment du gestionnaire d'événements
- Fulfillment d'invite de formulaire
- Fulfillment de nouvelle invite de formulaire
Les références peuvent également être utilisées dans:
- Valeurs d'en-tête du webhook pour l'authentification.
- Requêtes de webhook flexibles, pour envoyer des valeurs de paramètre à un webhook.
Pour référencer un paramètre de session, utilisez les formats suivants :
Scalaire
Pour accéder à un paramètre avec un type d'entité scalaire, procédez comme suit :
$session.params.parameter-id
Par exemple, si l'ID de paramètre est date, vous pouvez référencer la valeur au format suivant : $session.params.date.
Composite
Pour accéder à un membre d'un paramètre avec un type d'entité composite, procédez comme suit :
$session.params.parameter-id.member-name
Par exemple, si l'ID de paramètre est
location, vous pouvez référencer la valeur de membrezip-codeau format suivant :$session.params.location.zip-code.Pour accéder à la valeur d'origine d'un paramètre avec un type d'entité composite:
$session.params.parameter-id.original
Pour accéder à l'objet complet d'un paramètre avec un type d'entité composite, utilisez la fonction système IDENTITY.
Liste
Pour accéder à la liste complète des éléments, procédez comme suit :
$session.params.parameter-id
Par exemple, si l'ID du paramètre de liste est
colorset que les valeurs extraites d'une requête utilisateur sont["red", "blue", "yellow"], vous pouvez référencer toutes les valeurs au format suivant :$session.params.colors.Pour accéder à l'énième élément d'un paramètre de liste :
$session.params.parameter-id[i]
Par exemple, si l'ID du paramètre de liste est
colors, vous pouvez référencer la première valeur au format suivant :$session.params.colors[0].
Définir des paramètres de session
Une fois le formulaire rempli, les paramètres renseignés sont écrits dans la session par Dialogflow.
Le fulfillment pour une route, un gestionnaire d'événements ou une nouvelle invite de formulaire peut utiliser un préréglage de paramètre de fulfillment pour définir une valeur de paramètre de session au moment de l'exécution.
Votre webhook peut définir les valeurs des paramètres de session lors de l'exécution.
Consultez le champ sessionInfo.parameters dans la réponse de webhook standard ou consultez la réponse de webhook flexible.
Les interactions avec l'API peuvent définir des valeurs de paramètres de session.
Consultez le champ de requête queryParams.parameters de la méthode detectIntent pour le type Session.
Sélectionnez un protocole et une version pour la référence de session :
| Protocole | V3 | V3beta1 |
|---|---|---|
| REST | Ressource de la session | Ressource de la session |
| RPC | Interface de la session | Interface de la session |
| C++ | SessionsClient | Non disponible |
| C# | SessionsClient | Non disponible |
| Go | SessionsClient | Non disponible |
| Java | SessionsClient | SessionsClient |
| Node.js | SessionsClient | SessionsClient |
| PHP | Non disponible | Non disponible |
| Python | SessionsClient | SessionsClient |
| Ruby | Non disponible | Non disponible |
Obtenir des paramètres de session
Les interactions avec l'API renverront les valeurs du paramètre de la session.
Consultez le champ de réponse queryResult.parameters de la méthode detectIntent pour le type Session.
Sélectionnez un protocole et une version pour la référence de session :
| Protocole | V3 | V3beta1 |
|---|---|---|
| REST | Ressource de la session | Ressource de la session |
| RPC | Interface de la session | Interface de la session |
| C++ | SessionsClient | Non disponible |
| C# | SessionsClient | Non disponible |
| Go | SessionsClient | Non disponible |
| Java | SessionsClient | SessionsClient |
| Node.js | SessionsClient | SessionsClient |
| PHP | Non disponible | Non disponible |
| Python | SessionsClient | SessionsClient |
| Ruby | Non disponible | Non disponible |
Le webhook reçoit les valeurs de paramètre de la session.
Consultez le champ sessionInfo.parameters dans la requête du webhook.
Propagation des paramètres
Lorsqu'une entrée d'utilisateur final fournit une valeur de paramètre, le paramètre peut être propagé vers d'autres niveaux :
- Lorsqu'un paramètre d'intent est défini par une correspondance d'intent, les paramètres de formulaire ayant un nom similaire de la page active sont définis sur la même valeur. Le type d'entité du paramètre est déterminé par la définition du paramètre d'intent.
- Lorsqu'un paramètre d'intent est défini par une correspondance d'intent ou qu'un paramètre de formulaire est défini lors du remplissage du formulaire, le paramètre devient un paramètre de session.
DTMF pour les intégrations de téléphonie
Vous pouvez activer et configurer DTMF (signaux à double fréquence) pour un paramètre. Une fois cette option activée, l'utilisateur final d'un agent utilisant une intégration téléphonique peut utiliser le clavier du téléphone pour fournir des valeurs de paramètres.
Pour réduire toute ambiguïté, les entrées DTMF peuvent être interprétées sous les formes normale et spécifique à DTMF (recommandées) :
- La forme normale est simplement les valeurs du clavier telles qu'elles ont été saisies par l'utilisateur final.
Par exemple,
123#. - Le formulaire spécifique à DTMF convertit l'entrée en
dtmf_digits_[digits], où[digits]correspond aux chiffres DTMF d'origine, avec*remplacé parstaret#remplacé. avecpound. Par exemple,123#est interprété commedtmf_digits_123pound.
Lors de la mise en correspondance des types d'entités pour un paramètre, Dialogflow essaie de faire correspondre les formulaires normaux et spécifiques à DTMF.
Lorsqu'un type d'entité est utilisé pour une entrée DTMF, il est recommandé de définir des synonymes tels que dtmf_digits_123 pour améliorer la mise en correspondance de la NLU.
Si l'entrée DTMF ne remplit pas la condition de fin (soit elle n'a pas atteint la longueur maximale de chiffres, soit elle n'a pas été arrêtée par le chiffre de fin). L'agent Dialogflow continue à attendre d'autres entrées. Au cours de cette période, si le délai avant expiration de la reconnaissance vocale est déclenché, l'agent appelle alors un événement sans entrée. Si seul un énoncé est détecté, l'agent fait la correspondance avec l'entrée vocale. Si les données vocales et les entrées DTMF sont détectées, l'entrée vocale est ignorée et seule l'entrée DTMF est prise en compte.
Pour activer et personnaliser le DTMF pour un paramètre, procédez comme suit :
Console
- Activez les Paramètres avancés dans les paramètres de synthèse vocale et de réponse vocale interactive si ce n'est pas déjà fait.
- Créez un paramètre de page.
- Dans le volet des paramètres, activez l'option Activer DTMF.
- Définissez Chiffres max sur le nombre maximal de chiffres que l'utilisateur final peut fournir pour ce paramètre.
- Définissez Finish digit (chiffre de fin) sur la valeur du clavier qui mettra fin à l'entrée DTMF pour le paramètre.
Il est courant d'utiliser
#pour ce paramètre. Le chiffre de fin n'est pas ajouté à la requête Dialogflow sur l'agent. Par conséquent, si le chiffre de fin est # et que l'entrée est 123#, l'entrée de requête réelle est "123".
Lorsque vous créez votre agent, vous pouvez tester les entrées DTMF dans le simulateur.
Points de terminaison intelligents
Si la gestion des points de terminaison intelligents est activée pour l'agent, vous pouvez personnaliser le comportement des points de terminaison intelligents pour un paramètre numérique.
- Définissez Nombre minimal de chiffres pour indiquer au point de terminaison intelligent d'attendre que tous les chiffres soient collectés.
- Définissez Corriger les transcriptions pour améliorer la reconnaissance vocale des chiffres en corrigeant les erreurs de transcription courantes des chiffres. Cette option n'est disponible que pour les requêtes qui spécifient un code de langue "en" ou "en-*".
- Définissez le délai d'attente pour spécifier le délai supplémentaire que Dialogflow attendra que l'utilisateur fournisse davantage d'entrées.
Paramètres à l'échelle du flux
Les paramètres à l'échelle du flux peuvent être définis en tant que préréglages de paramètres de traitement ou paramètres de formulaire. Ces paramètres ne peuvent être référencés que lorsque le flux dans lequel ils sont définis est actif. Ils ne sont pas conservés dans les paramètres de session.
Pour définir ou référencer un paramètre de portée flux, utilisez la syntaxe suivante:
$flow.parameter-name
Par exemple, si le nom du paramètre est date, vous pouvez le définir ou le référencer comme $flow.date.
Notez que l'utilisation du préfixe $ lors de la définition des paramètres est différente de celle des autres types de paramètres qui n'utilisent pas $ pour la définition des paramètres.
Exemple de définition de paramètre à l'échelle du flux : 
Durée de vie de la valeur du paramètre dont la portée est définie au niveau du flux
Cette situation est rare, mais dans certains cas avancés, vous devrez peut-être comprendre comment les valeurs des paramètres de portée du flux sont conservées (ou supprimées) lorsqu'un flux devient inactif, puis réactivé.
Si les valeurs des paramètres dont le champ d'application est défini sur le flux sont conservées lorsqu'un flux devient inactif, puis réactivé, dépend de la pile de flux et des instances de flux sur la pile.
- Lorsque le flux A passe au flux B à l'aide d'une cible de transition spécifique, le flux A (flux parent) reste dans la pile, le flux A conserve ses valeurs de paramètre limitées au flux et une nouvelle instance du flux B (flux enfant) est ajoutée à la pile.
- Lorsqu'un flux enfant revient à un flux parent à l'aide d'une cible de transition symbolique (par exemple, END_FLOW), le flux enfant est supprimé de la pile, toutes les valeurs de paramètres à l'échelle du flux enfant sont supprimées et toutes les valeurs de paramètres à l'échelle du flux parent sont conservées.
- En utilisant une série de transitions avec des cibles de transition spécifiques, la pile de flux peut contenir plusieurs instances d'un même type de flux. Chaque instance du type de flux possède des valeurs de paramètres uniques dont la portée est définie au niveau du flux. Par exemple: A1 -> B1 -> C1 -> B2, où A, B et C sont des types de flux, et les numéros désignent les instances de ces types de flux. Dans cet exemple, B1 et B2 sont des instances différentes du flux B et possèdent des paramètres uniques de portée flux.
Exemples :
| Transitions | Résultat |
|---|---|
| Le flux A (A1) devient actif. Le flux B (B1) devient actif à l'aide d'une cible de transition spécifique. Le flux B revient au flux A (A1) qui l'a initié à l'aide d'une cible de transition symbolique. |
Le flux A conserve les valeurs des paramètres. |
| Le flux A (A1) devient actif. Le flux B (B1) devient actif à l'aide d'une cible de transition spécifique. Le flux B passe à une nouvelle instance du flux A (A2) à l'aide d'une cible de transition spécifique. |
La nouvelle instance du flux A (A2) en haut de la pile n'a pas accès aux valeurs de paramètre du flux A (A1) en bas de la pile. |
| Le flux A (A1) devient actif. Le flux B (B1) devient actif à l'aide d'une cible de transition spécifique. Le flux A (A1) devient actif à l'aide d'une cible de transition symbolique. Le flux B (B2) devient actif à l'aide d'une cible de transition spécifique. |
Le flux B (B2) ne conserve pas les valeurs des paramètres définies alors qu'il était actif après la deuxième transition (B1). |
Paramètres de portée requête
Les paramètres dont la portée est définie au niveau de la requête sont des paramètres de courte durée créés par Dialogflow. Ils ne peuvent être référencés que pendant le cycle de vie de la requête actuelle et ne sont pas conservés dans les paramètres de session.
Les paramètres dont la portée est définie au niveau de la requête sont générés par Dialogflow pour les fonctionnalités suivantes.
Langue et entrées utilisateur
Vous pouvez accéder au code de langue et aux entrées utilisateur associés à la requête à l'aide de la commande suivante:
| Reference | Description |
|---|---|
| $request.language | Code de langue spécifié dans QueryInput.language_code. |
| $request.resolved-language | Code de langue utilisé par l'agent lors du traitement. La langue résolue peut être différente de celle spécifiée dans la requête. Par exemple, si l'agent n'accepte que "en", alors que la langue spécifiée dans la requête est "en-US", la langue résolue sera "en". |
| $request.user-utterance | Énoncé de l'utilisateur actuel spécifié dans la requête. |
Charge utile personnalisée
Lorsque QueryParameters.payload est défini, vous pouvez accéder au paramètre correspondant via $request.payload.param-id.
Analyse des sentiments
Les références de sentiment suivantes sont disponibles lorsque l'analyse des sentiments est activée:
| Reference | Type | Description |
|---|---|---|
| $request.sentiment.score | Nombre | Score de sentiment compris entre -1,0 (sentiment négatif) et 1,0 (sentiment positif). |
| $request.sentiment.magnitude | Nombre | Indique l'intensité générale des émotions (positives et négatives) entre 0,0 et +inf. Contrairement au score, la magnitude n'est pas normalisée ; chaque expression d'émotion dans l'entrée utilisateur final (positive ou négative) contribue à la magnitude de l'entrée. Les entrées plus longues peuvent avoir des grandeurs plus importantes. |
| $request.sentiment.succeeded | Booléen | "True" si l'analyse des sentiments aboutit, "false" dans le cas contraire. |
Masquage du paramètre
Pour tout paramètre d'intent ou de formulaire, vous pouvez activer le masquage des paramètres afin de masquer les données de paramètre d'exécution pour l'utilisateur final dans les journaux et le stockage interne Dialogflow.
Les paramètres masqués sont affichés sous la forme $parameter-name_redacted dans les journaux.
Par exemple, considérons une entrée d'utilisateur final "Mon adresse est 1600 Amphitheatre Parkway" qui génère l'envoi d'un paramètre adresse à "1600 Parkway Parkway". Le texte enregistré sera "Mon adresse est $address_redacted".
Pour activer le masquage des paramètres, procédez comme suit :
Console
Cochez la case Masquer dans le journal lors de la création ou de la mise à jour d'un paramètre.
API
Définissez le champ parameters[].redact sur "true" pour le type Intent.
Sélectionnez un protocole et une version pour la référence de l'intent :
| Protocole | V3 | V3beta1 |
|---|---|---|
| REST | Ressource d'intent | Ressource d'intent |
| RPC | Interface d'intent | Interface d'intent |
| C++ | IntentsClient | Non disponible |
| C# | IntentsClient | Non disponible |
| Go | IntentsClient | Non disponible |
| Java | IntentsClient | IntentsClient |
| Node.js | IntentsClient | IntentsClient |
| PHP | Non disponible | Non disponible |
| Python | IntentsClient | IntentsClient |
| Ruby | Non disponible | Non disponible |
Définissez le champ form.parameters[].redact sur "true" pour le type Page.
Sélectionnez un protocole et une version pour la référence de la page :
| Protocole | V3 | V3beta1 |
|---|---|---|
| REST | Ressource de page | Ressource de page |
| RPC | Interface de la page | Interface de la page |
| C++ | PagesClient | Non disponible |
| C# | PagesClient | Non disponible |
| Go | PagesClient | Non disponible |
| Java | PagesClient | PagesClient |
| Node.js | PagesClient | PagesClient |
| PHP | Non disponible | Non disponible |
| Python | PagesClient | PagesClient |
| Ruby | Non disponible | Non disponible |
Vous pouvez également masquer tous les paramètres d'un type d'entité spécifique.