Créer une application Google Chat Dialogflow CX qui comprend le langage naturel et y répond

Cette page explique comment créer une application Google Chat capable de comprendre le langage naturel et de répondre avec à l'aide de Dialogflow. Ce guide utilise Dialogflow CX, qui est directement intégré à Google Chat. Vous pouvez également utiliser Dialogflow ES pour créer une application Google Chat Dialogflow ES en suivant le guide Google Chat Dialogflow ES.

Prenons l'exemple d'une application Chat qui aide les clients à louer une voiture. Si l'utilisateur écrit "Je voudrais louer une voiture", L'application Chat peut répondre "Où voulez-vous récupérer le véhicule ?", par exemple. Cette question lance une conversation semblable à un échange entre deux humains, dans laquelle l'application Chat comprend l'utilisateur et lui répond avec un phrasé naturel, tout en réservant la voiture.

Il ne s'agit que d'un exemple. Les applications de chat Dialogflow sont utiles dans tous les types d'interactions. Si elle nécessite un phrasé naturel, elle requiert une application de chat Dialogflow. Les agents prédéfinis vous aident à vous lancer rapidement et vous montrent ce que Dialogflow peut faire, par exemple :

• Réserver des vols
• Planifier des rendez-vous médicaux
• Commander des repas
• Répondre à des questions sur un catalogue de produits, par exemple pour savoir si des articles sont disponibles dans d'autres couleurs

Objectifs

• configurer votre environnement ;
• Créez et déployez un agent Dialogflow CX.
• Créez et déployez une application Chat optimisée par l'agent Dialogflow CX.
• Testez l'application Chat.

Prérequis

• Compte Google Workspace Business ou Enterprise ayant accès à Google Chat.
• Un projet Google Cloud avec facturation activée. Pour vérifier si la facturation est activée pour un projet existant, consultez Vérifier l'état de facturation de vos projets. Pour créer un projet et configurer la facturation, consultez Créer un projet Google Cloud.

Architecture

Le schéma suivant illustre l'architecture d'une application de chat conçue avec Dialogflow :

Dans le diagramme précédent, un utilisateur qui interagit avec une application de chat Dialogflow suit le flux d'informations suivant :

1. Un utilisateur envoie un message dans Chat à une application Chat, soit dans un message privé, soit dans un espace Chat.
2. Un agent virtuel Dialogflow, qui réside dans Google Cloud, reçoit et traite le message pour produire une réponse.
3. Si vous le souhaitez, vous pouvez utiliser un webhook Dialogflow pour permettre à l'agent Dialogflow d'interagir avec des services tiers externes, tels qu'un système de gestion de projet ou un outil de gestion des tickets.
4. L'agent Dialogflow renvoie une réponse au service de l'application Chat dans Chat.
5. La réponse est envoyée à l'espace Chat.

Configurer l'environnement

1. Dans la console Google Cloud, activez l'API Google Chat et l'API Dialogflow.

   Activer les API

2. Vérifiez que vous activez les API dans le bon projet Cloud, puis cliquez sur Suivant.

3. Vérifiez que vous activez les API appropriées, puis cliquez sur Activer.

Créer un agent Dialogflow CX

Un agent Dialogflow CX est un agent virtuel qui gère les conversations simultanées avec vos utilisateurs finaux. Il s'agit d'un module de compréhension du langage naturel qui saisit les nuances du langage humain. Dialogflow traduit le texte de l'utilisateur final au cours d'une conversation en données structurées assimilables par vos applications et vos services. Vous pouvez créer un agent Dialogflow conçu pour gérer les types de conversations requis pour votre système.

Un agent Dialogflow est comparable à un agent humain de centre d'appels. L'un comme l'autre doivent apprendre à gérer les scénarios de conversation attendus, sans qu'il soit nécessaire de leur dispenser un entraînement/une formation trop explicite.

Voici comment créer l'agent Dialogflow CX :

1. Dans la console Dialogflow CX, ouvrez la console Dialogflow CX. Cliquez sur Menu menu > Dialogflow CX.

   Accéder à la console Dialogflow CX

2. Choisissez un projet Google Cloud. Pour trouver votre projet, vous devrez peut-être cliquer sur Tous, puis le rechercher.

3. Vous pouvez désormais choisir un agent prédéfini ou créer le vôtre. Si vous préférez explorer la personnalisation des agents en détail plus tard, choisissez l'un des agents prédéfinis, qui sont également utiles pour découvrir ce que les agents peuvent faire.

   Pour choisir un agent prédéfini :

   1. Cliquez sur Utiliser des agents prédéfinis.

   2. Sélectionnez un agent prédéfini. Pour ce guide, sélectionnez Voyage : location de voiture.

      Les agents sont classés comme débutants, intermédiaires ou avancés en fonction du nombre de fonctionnalités qu'ils utilisent et de la sophistication de leur logique de conversation. Le choix d'un agent intermédiaire ou avancé peut nécessiter des personnalisations et des paramètres spécifiques à l'agent, y compris l'activation de fonctionnalités et d'API dans la console Google Cloud.

   3. Cliquez sur Importer en tant qu'agent.

   Pour créer votre propre agent, procédez comme suit :

   1. Cliquez sur Create agent (Créer un agent).
   2. Sélectionnez Générer automatiquement pour créer un agent de data store ou Créer votre propre agent pour créer d'autres types d'agents.

   Pour obtenir un tutoriel détaillé sur la création d'un agent, consultez Créer un agent Dialogflow CX.

4. Configurez les paramètres de base de l'agent :

   1. Dans Nom à afficher, saisissez un nom à afficher.
   2. Sélectionnez votre lieu préféré. Si vous souhaitez modifier les paramètres de localisation avancés, cliquez sur Modifier.
   3. Sélectionnez le fuseau horaire de votre choix.
   4. Sélectionnez la langue par défaut de votre agent. Une fois l'agent créé, vous ne pouvez plus modifier sa langue par défaut.

5. Cliquez sur Créer. Dialogflow CX commence à créer l'agent, puis affiche son flux de démarrage par défaut.

6. Vous pouvez également personnaliser l'agent. Pour obtenir un tutoriel détaillé sur la personnalisation des agents, consultez Créer un agent Dialogflow CX.

7. Nous vous recommandons de tester l'agent :

   1. Cliquez sur Tester l'agent.
   2. Sélectionnez Tester l'agent dans l'environnement.
   3. Dans "Environnement", sélectionnez Brouillon.
   4. Dans "Flow" (Flux), sélectionnez Default Start Flow (Flux de démarrage par défaut).
   5. Dans "Page", sélectionnez Page de démarrage.
   6. Dans la barre de rédaction Parler à l'agent, saisissez Hello, puis appuyez sur Entrée. L'agent répond en se présentant.
   7. Effectuez le test en ayant la conversation de test.

8. L'agent Dialogflow CX est créé. Revenez à la console Dialogflow CX. Cliquez sur Menu menu > Dialogflow CX.

   Accéder à la console Dialogflow CX

9. Sous Agents, cliquez sur more_vert > Copier le nom. Enregistrez ce nom, car vous l'utiliserez lors de la configuration de l'application Chat.

Créer une application Chat et la connecter à l'agent Dialogflow

Après avoir créé un agent Dialogflow CX, procédez comme suit pour le transformer en application Chat :

1. Dans la console Google Cloud, accédez à l'API Google Chat. Recherchez "API Google Chat", puis cliquez sur API Google Chat, puis sur Gérer.

   Accéder à l'API Chat

2. Cliquez sur Configuration et configurez l'application Chat :

   1. Dans le champ Nom de l'application, saisissez Dialogflow App.
   2. Dans URL de l'avatar, saisissez https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.
   3. Dans Description, saisissez Responds to real human conversation.
   4. Sous Fonctionnalité, sélectionnez Rejoindre des espaces et des conversations de groupe.
   5. Sous Paramètres de connexion, sélectionnez Dialogflow.
   6. Sous Paramètres Dialogflow, sélectionnez Dialogflow CX.
   7. Dans Nom de l'agent ou de la ressource d'environnement, collez le nom de l'agent Dialogflow CX que vous avez copié à la fin de Créer un agent Dialogflow CX.
   8. Rendez cette application Chat accessible à certains utilisateurs et groupes de votre domaine, puis saisissez votre adresse e-mail.
   9. Sous Journaux, sélectionnez Consigner les erreurs dans Logging.

3. Cliquez sur Enregistrer.

L'application Chat est prête à recevoir des messages et à y répondre.

Tester l'application Chat

Testez l'application Chat Dialogflow CX en lui envoyant un message dans Google Chat.

1. Ouvrez Google Chat avec le compte Google Workspace que vous avez fourni lorsque vous vous êtes ajouté en tant que testeur de confiance.

   Accéder à Google Chat

2. Cliquez sur add Nouvelle discussion.
3. Dans le champ Ajouter une ou plusieurs personnes, saisissez le nom de votre application Chat.

4. Sélectionnez votre application Chat dans les résultats. Un message privé s'ouvre.

5. Dans le nouveau message privé contenant l'application, saisissez Hello et appuyez sur enter.

   L'application Chat Dialogflow répond en se présentant.

6. Effectuez le test en ayant la conversation de test.

Exemple de conversation de test

Pour tester l'application de chat Dialogflow CX dans la console Dialogflow CX ou dans Google Chat, engagez la conversation suivante. L'explication vous aide à comprendre comment l'agent Dialogflow CX interprète le langage naturel de l'utilisateur et produit sa propre réponse en langage naturel à chaque étape de la conversation. Cet exemple de conversation est basé sur l'agent prédéfini Voyage : location de voiture.

Envoyer des messages de carte depuis Dialogflow

Dialogflow peut répondre avec des messages textuels ou des cartes. Pour répondre avec un message sous forme de fiche, spécifiez-le comme charge utile personnalisée dans fulfillment.

Le code JSON suivant montre comment envoyer un message de carte en tant que charge utile personnalisée dans l'exécution :

{ "hostAppDataAction": { "chatDataAction": { "createMessageAction": {
  "message": { "cardsV2": [{
    "cardId": "createCardMessage",
    "card": {
      "header": {
        "title": "A card message!",
        "subtitle": "Sent from Dialogflow",
        "imageUrl": "https://developers.google.com/chat/images/chat-product-icon.png",
        "imageType": "CIRCLE"
      },
      "sections": [{ "widgets": [{ "buttonList": { "buttons": [{
        "text": "Read the docs!",
        "onClick": { "openLink": {
          "url": "https://developers.google.com/workspace/chat"
        }}
      }]}}]}]
    }
  }]}
}}}}

Limites et points à prendre en compte

• Lorsque vous utilisez des applications Google Chat avec Dialogflow, les objets d'événement Chat présentent les limites et les points à prendre en compte suivants :
  • Événements de l'application Home : la prise en charge des événements APP_HOME n'est pas encore disponible.
  • Entrée de requête Dialogflow : le texte envoyé en tant qu'entrée de requête à l'agent Dialogflow dépend du type d'événement :
    • MESSAGE : valeur du champ argumentText du message de chat.
    • APP_COMMAND : chaîne "APP_COMMAND_PAYLOAD".
    • ADDED_TO_SPACE : chaîne "ADDED_TO_SPACE_PAYLOAD".
    • REMOVED_FROM_SPACE : chaîne "REMOVED_FROM_SPACE_PAYLOAD".
    • CARD_CLICKED : chaîne "BUTTON_CLICKED_PAYLOAD".
    • WIDGET_UPDATED : chaîne "WIDGET_UPDATED_PAYLOAD" (utilisée pour la saisie semi-automatique).
  • Charge utile complète de l'événement : la charge utile JSON complète de l'événement d'interaction de chat est envoyée à Dialogflow dans le champ WebhookRequest.payload. Vous pouvez y accéder dans votre webhook Dialogflow. Pour en savoir plus, consultez la documentation sur les requêtes de webhook Dialogflow CX.
• Points à prendre en compte pour répondre aux commandes et recevoir des données à partir de fiches ou de boîtes de dialogue :
  • Si l'agent Dialogflow doit traiter la charge utile JSON de l'événement d'interaction de chat, il peut le faire à l'aide d'un webhook Dialogflow pour inspecter la charge utile personnalisée dans le paramètre de requête.
  • Pour afficher une boîte de dialogue à partir de l'agent Dialogflow, répondez avec une seule charge utile JSON personnalisée contenant un objet RenderActions avec la navigation pushCard.
  • Pour traiter les données saisies à partir de cartes, vous pouvez utiliser un webhook Dialogflow et répondre avec une seule charge utile JSON personnalisée contenant l'action appropriée.
• Les aperçus de liens ne sont pas acceptés.
• Si l'agent Dialogflow ne répond qu'avec un seul message, celui-ci est envoyé à Google Chat de manière synchrone. Si l'agent Dialogflow répond avec plusieurs messages, tous les messages sont envoyés à Chat de manière asynchrone en appelant la méthode create sur la ressource spaces.messages dans l'API Chat une fois pour chaque message.
• Lorsque vous utilisez l'intégration Dialogflow CX avec Chat, l'agent Dialogflow et l'application Chat doivent être configurés dans le même projet Google Cloud. Si vous devez configurer Dialogflow et Chat dans différents projets Cloud, vous pouvez configurer un serveur intermédiaire pour faciliter la connexion. Pour en savoir plus, consultez l'exemple d'intégration de Chat pour Dialogflow CX sur GitHub.

Résoudre les problèmes

Pour déboguer votre application Chat, commencez par examiner les journaux d'erreurs. Comme cette application utilise Dialogflow, vous disposez de plusieurs ressources de journalisation et de dépannage :

• Journaux des modules complémentaires Google Workspace : interrogez les journaux pour obtenir des informations détaillées sur le comportement de l'application Chat, y compris ses interactions avec Chat. Consultez Interroger les journaux des modules complémentaires Google Workspace.

• Erreurs de l'application Google Chat : pour obtenir des informations générales sur les messages d'erreur et les solutions de l'application Chat, consultez Résoudre les erreurs de l'application Chat.

• Cloud Logging Dialogflow CX : assurez-vous que Cloud Logging est activé dans les paramètres de votre agent Dialogflow pour capturer des journaux d'exécution détaillés, y compris les erreurs de l'agent et les interactions avec le webhook. Découvrez comment activer et configurer cette fonctionnalité dans la documentation sur les paramètres de l'agent Dialogflow CX. Vous pouvez consulter ces journaux dans l'explorateur de journaux de la console Google Cloud.

• Historique des conversations Dialogflow CX : consultez les interactions précédentes pour comprendre le déroulement des conversations et identifier les points où des problèmes se produisent. Consultez Historique des conversations.

• Dépannage général de Dialogflow : pour les problèmes plus généraux liés à Dialogflow, consultez le guide de dépannage de Dialogflow CX.

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans ce tutoriel soient facturées sur votre compte Google Cloud, nous vous recommandons de supprimer le projet Cloud.

1. Dans la console Google Cloud, accédez à la page Gérer les ressources. Cliquez sur Menu menu > IAM et administration > Gérer les ressources.

   Accéder au gestionnaire de ressources

2. Dans la liste des projets, sélectionnez celui que vous souhaitez supprimer, puis cliquez sur Supprimer delete.
3. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.

Articles associés

• Dialogflow CX adopte une approche de machine à états pour la conception des agents Dialogflow. Vous bénéficiez ainsi d'un contrôle clair et explicite sur une conversation, d'une meilleure expérience utilisateur final et d'un workflow de développement amélioré. Lorsque vous créez une application Chat Dialogflow, nous vous recommandons d'utiliser Dialogflow CX.
  • Pour en savoir plus sur la création et la configuration d'agents, consultez Agents Dialogflow CX.
  • Pour obtenir un tutoriel détaillé sur la création et la configuration d'agents, consultez Créer un agent Dialogflow CX.
  • code Atelier de programmation : pour obtenir un exemple de création d'un agent de data store Dialogflow CX, consultez l'application de chat de connaissances de l'atelier de programmation Créer des applications pour Google Chat avec Gemini.
  • code Atelier de programmation : pour obtenir un exemple de création d'un agent conversationnel Dialogflow CX, consultez l'application de chat de commentaires de l'atelier de programmation Créer des applications pour Google Chat avec Gemini.
• Dialogflow ES est une autre façon d'utiliser Dialogflow avec une application Chat.

{
  "cardsV2": [{
    "cardId": "createCardMessage",
    "card": {
      "header": {
        "title": "A card message!",
        "subtitle": "Sent from Dialogflow",
        "imageUrl": "https://developers.google.com/chat/images/chat-product-icon.png",
        "imageType": "CIRCLE"
      },
      "sections": [
        {
          "widgets": [
            {
              "buttonList": {
                "buttons": [
                  {
                    "text": "Read the docs!",
                    "onClick": {
                      "openLink": {
                        "url": "https://developers.google.com/workspace/chat"
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}