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 :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 :
- Propagation de l'intent
- Utilisez une condition simple
true
dans une route ayant une réponse de fulfillment ou une cible de transition. à une page normale avec le fulfillment d'entrée. - Événements personnalisés
Page de référence de début dans les requêtes API
Pour référencer la page de démarrage d'un flux dans les requêtes de l'API d'exécution, utilisez START_PAGE
comme ID de page.
Pour modifier une page de démarrage au moment de la conception à l'aide de 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
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Cliquez sur le bouton d'ajout add dans la section Flux.
- Sélectionnez Créer un flux.
- Indiquez un nom à afficher pour votre flux.
- 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
- Ouvrez la console Dialogflow CX.
- Choisissez le projet Google Cloud pour l'agent.
- Recherchez l'agent dans la liste.
- Cliquez sur le nom à afficher de l'agent.
- Cliquez sur le flux dans la section Flux.
- 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.
- Cliquez sur le flux dans le graphique.
- Un panneau de modification de flux s'affiche. Utilisez ce panneau pour parcourir et modifier des données de flux supplémentaires.
- 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 |
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 flux :
- Pages : liste des pages qui composent le flux.
- Routes : toutes ces routes peuvent être appelées lorsque la page d'accueil du flux est active. Les routes avec une exigence d'intent peuvent être suivies lorsque d'autres pages du flux sont actives. Pour en savoir plus, consultez les sections Portée du gestionnaire d'état et Routes au niveau du flux.
- Gestionnaires d'événements : ces gestionnaires peuvent être appelés lorsque le flux est actif. Pour en savoir plus, consultez la section Gestionnaires d'événements au niveau du flux.
Pour en savoir plus sur la façon dont les données sont appliquées à différents niveaux, consultez les 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 des utilisateurs finaux que les agents conversationnels (Dialogflow CX) doivent reconnaître et dans lesquelles ils doivent répondre automatiquement. Pour en savoir plus, consultez la documentation sur la détection automatique de la langue.
Verrouillage du flux : un flux verrouillé ne peut pas être modifié, y compris les modifications suivantes apportées à ses ressources enfants :
- Vous ne pouvez pas créer, modifier ni supprimer de pages.
- Vous ne pouvez pas créer, modifier ni supprimer de versions.
- Il est impossible de créer, de modifier ni de supprimer des groupes de routes au niveau du flux.
- Les groupes de routes au niveau de l'agent référencés par un flux verrouillé ou par une page d'un flux verrouillé ne peuvent pas être supprimés, mais ils peuvent toujours être modifiés.
Paramètres vocaux avancés : ces paramètres vocaux avancés peuvent éventuellement remplacer les mêmes paramètres vocaux 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 Adaptation vocale manuelle.
Paramètres d'entrée : paramètres du playbook de tâches mis à disposition du flux.
Paramètres de retour : paramètres que le flux renvoie à un playbook de tâches.
Pour en savoir plus sur la façon dont les données sont appliquées à différents niveaux, consultez les niveaux d'application des données.
Pour accéder aux paramètres du flux, procédez comme suit :
Console
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Passez la souris sur le flux dans la section Flows (Flux).
- Cliquez sur le bouton des options more_vert.
- Sélectionnez Paramètres du flux.
- Parcourez ou modifiez les paramètres.
- 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
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Passez la souris sur le flux dans la section Flows (Flux).
- Cliquez sur le bouton more_vertParamètres.
- 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
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Cliquez sur Agent Settings (Paramètres de l'agent).
- Ouvrez l'onglet ML.
- Pour entraîner un seul flux, cliquez sur Entraîner sur la ligne correspondante.
- 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 :
Exporter les données : cette option permet d'exporter votre flux sous forme de données brutes, afin qu'il puisse être importé 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 Données brutes.
Exporter le diagramme (aperçu) : cette option permet d'exporter votre flux sous forme de diagramme visuel. Le format d'exportation est draw.io XML. Vous pouvez donc importer le diagramme dans Lucidchart, diagrams.net ou tout autre outil de diagramme compatible avec le format draw.io. Lorsque vous suivez les é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 ultérieurs, sans profondeur maximale. Lors de l'importation, tous les flux exportés seront importés et les transitions entre ces flux seront conservées.
Pour exporter un flux :
Console
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Passez la souris sur le flux dans la section Flows (Flux).
- Cliquez sur le bouton des options more_vert.
- Sélectionnez Exporter un flux.
- 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 d'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 comporte des ressources globales dont les noms à afficher sont identiques à ceux de l'agent source, les agents de conversation (Dialogflow CX) fournissent un récapitulatif de ces ressources, ainsi que trois options pour résoudre les conflits :
- Remplacer les ressources existantes : les ressources de l'agent source écraseront celles de l'agent cible.
- Importer en tant que nouvelles ressources : les ressources de l'agent source seront ajoutées avec un suffixe distinctif dans le nom.
- Conserver les ressources d'origine : les ressources de l'agent cible ne seront pas modifiées.
Pour importer un flux :
Console
- Ouvrez la console Dialogflow CX.
- Choisissez votre projet Google Cloud.
- Sélectionnez votre agent.
- Cliquez sur le bouton d'ajout add dans la section Flux.
- Sélectionnez Importer un flux.
- 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 |