Pages

Une conversation (session) Dialogflow CX peut être décrite et visualisée en tant que machine à états. Les états d'une session CX sont représentés par des pages.

Pour chaque flux, vous définissez de nombreuses pages dans lesquelles vos pages combinées peuvent gérer une conversation complète sur les sujets pour lesquels le flux est conçu. À un moment donné, une seule page est la page actuelle. La page actuelle est considérée comme active et le flux associé à cette page est considéré comme actif. Chaque flux dispose d'une page d'accueil spéciale. Lorsqu'un flux devient initialement actif, la page d'accueil devient la page actuelle. À chaque tour de conversation, la page actuelle reste la même ou passe à une autre page.

Vous configurez chaque page pour collecter auprès de l'utilisateur final des informations pertinentes pour l'état conversationnel représenté par la page. Par exemple, vous pouvez créer les pages (en bleu) dans le diagramme ci-dessous pour un flux de commande de nourriture d'un agent de livraison de pizza. Le nœud Démarrer du diagramme représente la page d'accueil du flux de commande de nourriture. Une fois le flux terminé, il passe au flux Confirmation.

Exemple de diagramme multi-flux.

Cycle de vie d'une page

Lorsqu'une page devient active, l'agent suit plusieurs étapes pouvant impliquer le fulfillment des entrées, le pré-remplissage des formulaires, l'évaluation du gestionnaire d'état, l'invite des paramètres de formulaire, l'envoi de messages de réponse à l'utilisateur final et une modification de page ou une boucle répétée :

Diagramme du cycle de vie de la page.

Les détails de ce processus sont les suivants :

  1. Si l'entrée fulfillment existe pour la page, elle est appelée. Toutes les réponses fournies par fulfillment sont ajoutées à la file d'attente de réponse.
  2. Si la page comporte des paramètres de formulaire, ils peuvent être préremplis :

  3. Si des gestionnaires d'état sont dans la portée, ils sont évalués en fonction des règles de l'ordre d'évaluation du gestionnaire. Cela peut impliquer des routes, des gestionnaires d'événements ou des gestionnaires de nouvelles invites appelés à partir de l'itération précédente de la boucle. Si un gestionnaire d'état est suivi, l'une ou les deux situations suivantes peuvent se produire :

    • Si le fulfillment existe pour le gestionnaire, il est appelé. Toutes les réponses fournies par fulfillment sont ajoutées à la file d'attente de réponse.
    • S'il existe un flux ou une page cible pour le gestionnaire, la session passe à la cible et la page devient inactive.
  4. Si toutes les conditions suivantes sont remplies, une invite de paramètre de formulaire est ajoutée à la file d'attente de réponses :

  5. Les messages de la file d'attente de réponses sont envoyés à l'utilisateur final, et l'agent attend la saisie de l'utilisateur final.

  6. Si l'entrée de l'utilisateur final fournit un paramètre de formulaire demandé, renseignez le paramètre. Passez à l'étape 3.

Créer une page

Pour créer une page :

Console

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet GCP.
  3. Sélectionnez votre agent.
  4. Sélectionnez un flux pour la page dans la section Flux.
  5. Cliquez sur le bouton d'ajout dans la section Pages.
  6. Attribuez un nom à votre page.
  7. Cliquez sur le bouton des paramètres à côté du nom de la page.
  8. Sélectionnez Modifier.
  9. Saisissez les champs dans le panneau de configuration de la page qui s'affiche.
  10. Cliquez sur Save.

API

Consultez la méthode create pour le type Page.

Sélectionnez un protocole et une version pour la référence de la page :

Protocole V3beta1
REST Ressource de la page
RPC Interface de la page
Java PagesClient
Node.js PagesClient
Python PagesClient

Données d'une page

Pour accéder aux données d'une page :

Console

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez le projet GCP pour l'agent.
  3. Sélectionnez votre agent.
  4. Cliquez sur le flux dans la section Flux.
  5. Les pages du flux sont insérées dans la section Pages.
  6. Cliquez sur le bouton des paramètres à côté du nom de la page.
  7. Sélectionnez Modifier.
  8. Saisissez les champs dans le panneau de configuration de la page qui s'affiche.
  9. Cliquez sur Enregistrer pour enregistrer les modifications.

API

Consultez les méthodes get et patch/update pour le type Page.

Sélectionnez un protocole et une version pour la référence de la page :

Protocole V3beta1
REST Ressource de la page
RPC Interface de la page
Java PagesClient
Node.js PagesClient
Python PagesClient

Les données suivantes sont associées aux pages :

  • Nom : nom à afficher pour votre flux.
  • Fulfillment des entrées (également appelé dialogue d'entrée) : il s'agit du fulfillment à appeler lorsque la page devient active.
  • Paramètres : il s'agit des valeurs des paramètres d'un formulaire de page qui capturent les entrées structurées de l'utilisateur final.
  • Routes : ces gestionnaires d'état peuvent être appelés lorsque la page est active. Pour plus d'informations, consultez la section Routes de gestionnaire au niveau des pages.
  • Groupes de routes : les routes de ces groupes peuvent être appelées lorsque la page est active. Pour en savoir plus, consultez la section Groupes de routes.
  • Gestionnaires d'événements : ces gestionnaires d'événements peuvent être appelés lorsque la page est active. Pour en savoir plus, consultez la section Gestionnaires d'événements au niveau de la page.

Supprimer une page

Pour supprimer une page, procédez comme suit :

Console

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet GCP.
  3. Sélectionnez votre agent.
  4. Sélectionnez le flux pour la page dans la section Flux.
  5. Cliquez sur le bouton des paramètres à côté du nom de la page dans la section Pages.
  6. Sélectionnez Supprimer.

API

Consultez la méthode delete pour le type Page.

Sélectionnez un protocole et une version pour la référence de la page :

Protocole V3beta1
REST Ressource de la page
RPC Interface de la page
Java PagesClient
Node.js PagesClient
Python PagesClient