Pages

Une conversation (session) d'agents de conversation (Dialogflow CX) peut être décrite et visualisée en tant que machine à états. Les états d'une session 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 statiques fournies par fulfillment sont ajoutées à la file d'attente de réponse.

    Si la réponse partielle est activée, les agents de conversation (Dialogflow CX) vident la file d'attente de réponse et envoient tous les messages en file d'attente en tant que réponse partielle à l'appelant de l'API de streaming.

    Si le fulfillment possède un webhook, celui-ci est appelé, ce qui peut ajouter des réponses supplémentaires à la file d'attente. Ces réponses supplémentaires ne déclenchent pas de vidage immédiat de la file d'attente de réponses.

  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 statiques fournies par fulfillment sont ajoutées à la file d'attente de réponse. La réponse partielle et le webhook sont également exécutés s'ils sont activés.
    • 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 :

    • La page contient un formulaire.
    • Les paramètres du formulaire sont obligatoires.
    • Aucun gestionnaire de nouvelle invites n'a été suivi à l'étape 3.
    • La réponse partielle et le webhook sont exécutés s'ils sont activés.
  5. Les messages de la file d'attente de réponses restants 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.

Navigation dans le cycle de vie des pages

Le visualiseur d'étapes d'exécution du simulateur vous permet de basculer entre les étapes d'un tour de conversation spécifique et de mettre en surbrillance les éléments du générateur d'agents associés à chaque étape. Dans l'exemple suivant, l'entrée de l'utilisateur final "Je voudrais louer une voiture" déclenche cinq étapes d'exécution et de transition:

  1. Le visualiseur d'étapes d'exécution vous redirige vers la page de début de la conversation pour la première étape. Dans ce cas, il s'agit de la page d'accueil par défaut. Étape 1 d'exécution de la page.

  2. La route de transition pour l'intent car_rental.reservation_create est déclenchée. Le visualiseur des étapes d'exécution met en avant ce parcours, où vous pouvez voir que la cible de la transition est la page Pickup Location. Étape 2 d'exécution de la page.

  3. L'agent accède à la page Pickup Location. Étape 3 d'exécution de la page.

  4. L'agent évalue le traitement des entrées de la page Pickup Location. La fonctionnalité de traitement est vide, donc rien ne se passe. Étape 4 d'exécution de la page.

  5. L'agent tente de collecter le paramètre de formulaire requis pickup_location, et le message de fulfillment de l'invite initiale pour ce paramètre s'affiche auprès de l'utilisateur final. Étape 5 d'exécution de la page.

Vous pouvez également annuler la dernière phrase et essayer autre chose pour tester différentes transitions de page.

Annuler la commande.

Créer une page

Pour créer une page :

Console

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  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. Indiquez un nom à afficher pour votre agent.
  7. Cliquez sur le bouton des paramètres à côté du nom à afficher 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 V3 V3beta1
REST Ressource de la page Ressource de la 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

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 Google Cloud 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 à afficher 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 V3 V3beta1
REST Ressource de la page Ressource de la 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

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

  • Nom à afficher : nom lisible de votre page.
  • Fulfillment d'entrée (é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.

Paramètres de la page

Les paramètres suivants sont disponibles pour les pages :

Pour accéder aux paramètres de la page :

Console

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Passez la souris sur la page dans la section Pages.
  5. Cliquez sur le bouton des options .
  6. Sélectionnez Paramètres de la page.
  7. Parcourez ou modifiez les paramètres.
  8. 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 V3 V3beta1
REST Ressource de la page Ressource de la 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

Supprimer une page

Pour supprimer une page, procédez comme suit :

Console

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  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 à afficher 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 V3 V3beta1
REST Ressource de la page Ressource de la 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