Flux

Les boîtes de dialogue complexes impliquent souvent plusieurs sujets de conversation. Par exemple, un agent de livraison de pizza peut présenter les commandes de nourriture, les informations sur le client et la confirmation comme sujets distincts. Chaque sujet nécessite plusieurs tours de conversation pour qu'un agent puisse acquérir les informations pertinentes de l'utilisateur final.

Les flux permettent de définir ces thèmes et les chemins de conversation associés. Chaque agent dispose d'un flux appelé flux de démarrage par défaut. Ce flux unique peut être tout ce dont vous avez besoin pour un agent simple. Des agents plus complexes peuvent nécessiter des flux supplémentaires, et différents membres de l'équipe de développement peuvent être chargés de créer et de gérer ces flux. Par exemple, les flux d'un agent de livraison de pizza peuvent se présenter comme suit :

Exemple de diagramme multi-flux.

Les flux Dialogflow CX ont la même fonction que les sous-agents des méga-agents Dialogflow ES. Les flux permettent un meilleur contrôle de la conversation et n'entraînent pas de coût supplémentaire.

Flux de démarrage par défaut

Lorsque vous créez un agent, le flux de démarrage par défaut est créé automatiquement. Pour un agent simple, vous pouvez utiliser ce flux comme seul flux. Pour les agents plus complexes, vous pouvez ajouter d'autres flux, et le flux de démarrage par défaut peut être utilisé comme point d'entrée simple de la conversation.

Lorsque vous utilisez l'API, vous pouvez référencer le flux de démarrage par défaut avec l'ID de flux suivant :

00000000-0000-0000-0000-000000000000

Page d'accueil du flux

Chaque flux dispose d'une page spéciale nommée Démarrer dans la console. Lorsque vous sélectionnez un flux dans la console, la page d'accueil est représentée par un nœud sur le graphique. Lorsqu'un flux devient initialement actif, cette page devient la page active.

Une page d'accueil ne comporte pas de paramètres de réponse ou de paramètre, comme les pages normales. Toutefois, vous pouvez envoyer un message en utilisant l'une des approches suivantes :

Page d'accueil de référence dans les requêtes API

Pour référencer la page d'accueil d'un flux dans les requêtes API d'exécution, utilisez START_PAGE comme ID de page.

Pour apporter des modifications au moment de la conception d'une page d'accueil via l'API, utilisez les méthodes d'API get et patch/update pour le type Flow.

Sélectionnez un protocole et une version pour la référence du flux :

Protocole V3 V3beta1
REST Ressource de flux Ressource de flux
RPC Interface de flux Interface de flux
C++ FlowsClient Non disponible
C# FlowsClient Non disponible
Go FlowsClient Non disponible
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Non disponible Non disponible
Python FlowsClient FlowsClient
Ruby Non disponible Non disponible

Créer un flux

Pour créer un flux :

Console

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Cliquez sur le bouton d'ajout dans la section Flux.
  5. Sélectionnez Créer un flux.
  6. Indiquez un nom à afficher pour votre flux.
  7. Cliquez sur le flux que vous venez de créer.

API

Consultez la méthode create pour le type Flow.

Sélectionnez un protocole et une version pour la référence du flux :

Protocole V3 V3beta1
REST Ressource de flux Ressource de flux
RPC Interface de flux Interface de flux
C++ FlowsClient Non disponible
C# FlowsClient Non disponible
Go FlowsClient Non disponible
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Non disponible Non disponible
Python FlowsClient FlowsClient
Ruby Non disponible Non disponible

Flux de données

Pour accéder aux données d'un flux, procédez comme suit :

Console

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez le projet Google Cloud pour l'agent.
  3. Recherchez l'agent dans la liste.
  4. Cliquez sur le nom à afficher de l'agent.
  5. Cliquez sur le flux dans la section Flux.
  6. Les pages du flux sont insérées dans la section Pages. Pour en savoir plus sur la modification de pages, consultez le guide des pages.
  7. Cliquez sur le flux dans le graphique.
  8. Un panneau de modification de flux s'affiche. Utilisez ce panneau pour parcourir et modifier des données de flux supplémentaires.
  9. Cliquez sur Enregistrer pour enregistrer les modifications.

API

Pour les flux, consultez les éléments get et patch/update pour le type Flow.

Sélectionnez un protocole et une version pour la référence du flux :

Protocole V3 V3beta1
REST Ressource de flux Ressource de flux
RPC Interface de flux Interface de flux
C++ FlowsClient Non disponible
C# FlowsClient Non disponible
Go FlowsClient Non disponible
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Non disponible Non disponible
Python FlowsClient FlowsClient
Ruby Non disponible Non disponible
Pour les pages, 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 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

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

Pour en savoir plus sur l'application des données à différents niveaux, consultez la section Niveaux d'application des données.

Paramètres du flux

Les paramètres suivants sont disponibles pour les flux :

  • Nom à afficher : nom lisible du flux.
  • Description : description du flux.
  • Paramètres de ML : les paramètres de ML de flux sont également accessibles et décrits dans les paramètres de ML de l'agent.
  • Détection automatique de la langue La détection automatique de la langue vous permet de spécifier les langues de l'utilisateur final que Dialogflow doit reconnaître automatiquement et dans lesquelles Dialogflow doit répondre. Pour en savoir plus, consultez la documentation sur la détection automatique des langues.
  • Paramètres vocaux avancés : ces paramètres vocaux peuvent éventuellement remplacer les mêmes paramètres de synthèse vocale de l'agent.
  • Paramètres d'adaptation vocale : paramètres d'adaptation vocale au niveau du flux avec des instructions plus détaillées dans l'adaptation vocale manuelle.

Pour en savoir plus sur l'application des données à différents niveaux, consultez la section Niveaux d'application des données.

Pour accéder aux paramètres du flux, procédez comme suit :

Console

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Passez la souris sur le flux dans la section Flows (Flux).
  5. Cliquez sur le bouton des options .
  6. Sélectionnez Paramètres du flux.
  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 Flow.

Sélectionnez un protocole et une version pour la référence du flux :

Protocole V3 V3beta1
REST Ressource de flux Ressource de flux
RPC Interface de flux Interface de flux
C++ FlowsClient Non disponible
C# FlowsClient Non disponible
Go FlowsClient Non disponible
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Non disponible Non disponible
Python FlowsClient FlowsClient
Ruby Non disponible Non disponible

Supprimer un flux

Pour supprimer un flux, procédez comme suit :

Console

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Passez la souris sur le flux dans la section Flows (Flux).
  5. Cliquez sur le bouton Paramètres.
  6. Sélectionnez Supprimer.

API

Consultez la méthode delete pour le type Flow.

Sélectionnez un protocole et une version pour la référence du flux :

Protocole V3 V3beta1
REST Ressource de flux Ressource de flux
RPC Interface de flux Interface de flux
C++ FlowsClient Non disponible
C# FlowsClient Non disponible
Go FlowsClient Non disponible
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Non disponible Non disponible
Python FlowsClient FlowsClient
Ruby Non disponible Non disponible

Entraîner un flux

Pour entraîner un flux, procédez comme suit :

Console

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Cliquez sur Agent Settings (Paramètres de l'agent).
  5. Ouvrez l'onglet ML.
  6. Pour entraîner un seul flux, cliquez sur Entraîner sur la ligne correspondante.
  7. Pour entraîner plusieurs flux, cochez la case correspondante, puis cliquez sur Train selected flow NLU model (Entraîner le modèle NLU de flux sélectionné).

API

Consultez la méthode train pour le type Flow.

Sélectionnez un protocole et une version pour la référence du flux :

Protocole V3 V3beta1
REST Ressource de flux Ressource de flux
RPC Interface de flux Interface de flux
C++ FlowsClient Non disponible
C# FlowsClient Non disponible
Go FlowsClient Non disponible
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Non disponible Non disponible
Python FlowsClient FlowsClient
Ruby Non disponible Non disponible

Exporter un flux

Vous pouvez exporter un flux de deux manières:

  • Exportation de données : cette opération exporte votre flux sous forme de données brutes afin de pouvoir l'importer dans n'importe quel agent. Lorsque vous exportez un flux, les ressources référencées par celui-ci (intents, entités, webhooks) sont également exportées. Lorsque vous suivez les étapes ci-dessous, choisissez le format de données de données brutes.

  • Exportation de diagramme (Aperçu) : permet d'exporter votre flux sous forme de diagramme visuel. Le format d'exportation est le format XML draw.io. Vous pouvez donc importer le schéma au format Lucidchart, diagrams.net ou tout autre outil de diagramme pouvant importer le format draw.io. Lors des étapes ci-dessous, choisissez le format de données XML.

Vous pouvez exporter un flux avec les options suivantes:

  • Inclure les flux référencés : exporte le flux cible et tous les niveaux de flux référencés. Les flux référencés incluent les flux auxquels le flux cible fait référence en plus des flux référencés par les flux référencés suivants, sans profondeur maximale. Lors de l'importation, tous les flux exportés seront importés et les transitions entre ces flux seront préservées.

Pour exporter un flux :

Console

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Passez la souris sur le flux dans la section Flows (Flux).
  5. Cliquez sur le bouton des options .
  6. Sélectionnez Exporter un flux.
  7. Suivez les instructions pour terminer.

API

Consultez la méthode export pour le type Flow.

Sélectionnez un protocole et une version pour la référence du flux :

Protocole V3 V3beta1
REST Ressource de flux Ressource de flux
RPC Interface de flux Interface de flux
C++ FlowsClient Non disponible
C# FlowsClient Non disponible
Go FlowsClient Non disponible
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Non disponible Non disponible
Python FlowsClient FlowsClient
Ruby Non disponible Non disponible

Importer un flux

Lorsque vous importez un flux depuis un agent source vers un agent cible, les ressources globales référencées par le flux (intents, entités, webhooks) sont importées avec les données spécifiques au flux. Si l'agent cible dispose de ressources globales portant les mêmes noms à afficher que dans l'agent source, Dialogflow fournit un résumé de ces ressources, ainsi que trois options pour résoudre les conflits associés:

  • Replace existing resources (Remplacer les ressources existantes) : les ressources d'agent source écrasent les ressources d'agent cible.
  • Importer en tant que nouvelles ressources : les ressources de l'agent source seront ajoutées avec un suffixe distinctif dans leur nom.
  • Conserver les ressources d'origine : les ressources de l'agent cible ne seront pas modifiées.

Pour importer un flux :

Console

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez votre projet Google Cloud.
  3. Sélectionnez votre agent.
  4. Cliquez sur le bouton d'ajout dans la section Flux.
  5. Sélectionnez Importer un flux.
  6. Suivez les instructions pour terminer.

API

Consultez la méthode import pour le type Flow.

Sélectionnez un protocole et une version pour la référence du flux :

Protocole V3 V3beta1
REST Ressource de flux Ressource de flux
RPC Interface de flux Interface de flux
C++ FlowsClient Non disponible
C# FlowsClient Non disponible
Go FlowsClient Non disponible
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP Non disponible Non disponible
Python FlowsClient FlowsClient
Ruby Non disponible Non disponible

Précédent
Collaboration entre agents
Suivant
Pages