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 d'y répondre à l'aide de Dialogflow. Ce guide utilise Dialogflow CX, qui s'intègre directement à Google Chat, disponible dans la version Preview développeur. 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 utilisateurs à louer une voiture. Un utilisateur peut écrire : "Je souhaite louer une voiture". L'application Chat peut répondre par une question du type "Où souhaitez-vous récupérer le véhicule ?", ce qui lance une conversation humaine avec l'utilisateur. L'application Chat comprend la voix humaine et y répond lors de la réservation de la voiture.

Ce n'est qu'un exemple. Les applications de chat Dialogflow sont utiles dans tous les types d'interactions. Si elle nécessite une voix humaine naturelle, elle fait appel à une application de chat Dialogflow. Les agents prédéfinis vous aident à démarrer rapidement et vous montrent ce que Dialogflow peut faire, par exemple:

• Réserver des vols
• Prendre rendez-vous chez le médecin
• Commander un repas à domicile
• Répondre à des questions sur un catalogue de produits Retail (par exemple, savoir si des articles sont disponibles dans d'autres coloris)

Objectifs

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

Prérequis

• Un compte Google Workspace ayant accès à Google Chat
• Un projet Google Cloud.
• Assurez-vous d'activer la facturation pour votre projet Cloud. Découvrez comment vérifier l'état de facturation de vos projets.

Architecture

Le schéma suivant illustre l'architecture d'une application Chat créée avec Dialogflow:

Dans le schéma précédent, un utilisateur qui interagit avec une application Chat Dialogflow présente le flux d'informations suivant:

1. Un utilisateur envoie un message dans Chat à une application Chat, dans un message privé ou 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. À l'aide d'un webhook Dialogflow, l'agent Dialogflow peut éventuellement interagir avec des services tiers externes, tels qu'un système de gestion de projet ou un outil de billetterie.
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 les API Google Chat et 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 bonnes API, 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 comprend les nuances du langage humain. Dialogflow traduit le texte de l'utilisateur final au cours d'une conversation en données structurées compréhensibles par vos applications et services. Vous concevez et créez un agent Dialogflow capable de gérer les types de conversations requis pour votre système.

Un agent Dialogflow s'apparente à un agent de centre d'appels humain. Vous les entraînez tous les deux à gérer les scénarios de conversation attendus. Votre entraînement n'a pas besoin d'être trop explicite.

Pour créer l'agent Dialogflow CX, procédez comme suit:

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 Tout, 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 plus en détail ultérieurement, choisissez l'un des agents prédéfinis, qui sont également utiles pour en savoir plus sur ce qu'ils peuvent faire.

   Pour choisir un agent prédéfini, procédez comme suit:

   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 voitures.

      Les agents sont notés "Débutant", "Intermédiaire" ou "Avancé" 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, y compris l'activation de fonctionnalités et d'API dans la console Google Cloud.

   3. Cliquez sur Import as agent (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éez le vôtre pour créer d'autres types d'agents.

   Pour une présentation détaillée du processus de création d'agent, consultez la page 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. Vous ne pouvez pas modifier la langue par défaut d'un agent après sa création.

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 éventuellement personnaliser l'agent. Pour découvrir en détail le processus de personnalisation de l'agent, consultez la page 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 d'accueil.
   6. Dans la barre de rédaction Talk to agent (Parler à l'agent), saisissez Hello, puis appuyez sur Entrée. L'agent répond en se présentant.
   7. Effectuez le test à l'aide de l'exemple de conversation 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 l'associer à 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" et 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 Recevoir des messages privés et Rejoindre des espaces et des conversations de groupe.
   5. Sous Paramètres de connexion, sélectionnez Dialogflow.
   6. Dans Dialogflow settings (Paramètres Dialogflow), sélectionnez Dialogflow CX.
   7. Dans Nom de la ressource de l'agent ou de l'environnement, collez le nom de l'agent Dialogflow CX que vous avez copié à la fin de la section Créer un agent Dialogflow CX.
   8. Rendez cette application Chat accessible à des personnes et des groupes spécifiques 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 dans Chat.

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 indiqué lorsque vous vous avez ajouté en tant que testeur de confiance.

   Accéder à Google Chat

2. Cliquez sur add Nouveau chat.
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'affiche.

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

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

6. Effectuez le test en utilisant l'exemple de conversation de test.

Exemple de conversation test

Pour tester l'application 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 appelé Voyage: location de voitures.

Envoyer des messages de carte à partir de Dialogflow

Dialogflow peut répondre à l'aide de messages texte ou sous forme de fiches. Pour répondre avec un message de carte, spécifiez-le en tant que charge utile personnalisée dans le fulfillment.

Le code JSON suivant montre comment envoyer un message de carte en tant que charge utile personnalisée dans le traitement:

{
  '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 considérations

• La prise en charge des événements d'interaction de chat est limitée et certains points sont à prendre en compte :
  • Les types d'événements d'interaction suivants sont acceptés :
    • MESSAGE
    • ADDED_TO_SPACE
  • L'entrée de requête envoyée à l'agent Dialogflow correspond à la valeur du champ argumentText dans le message Chat. Si le message inclut une commande à barre oblique, la valeur du champ text est utilisée à la place.
  • La charge utile JSON complète de chaque événement d'interaction Chat est envoyée à Dialogflow en tant que charge utile personnalisée dans le paramètre de requête. Elle est accessible via un webhook Dialogflow en interrogeant la valeur du champ WebhookRequest.payload.
• La compatibilité des commandes à barre oblique est limitée :
  • Les commandes à barre oblique qui ouvrent des boîtes de dialogue ne sont pas compatibles avec les applications Chat de Dialogflow.
  • Lorsque les applications de chat Dialogflow reçoivent un message contenant une commande à barre oblique, la requête ne contient que la valeur du champ text. Le champ text commence par le nom de la commande à barre oblique (par exemple, /command), que vous pouvez utiliser pour configurer l'intent d'un agent Dialogflow afin de détecter une commande à barre oblique.
  • Si l'agent Dialogflow doit traiter la charge utile JSON de l'événement d'interaction Chat de la commande à barre oblique, il peut le faire en utilisant un webhook Dialogflow pour inspecter la charge utile personnalisée dans le paramètre de requête.
• Les aperçus de liens ne sont pas acceptés.
• Si l'agent Dialogflow répond 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 de l'API Chat une fois pour chaque message.

Dépannage

Lorsqu'une application ou une fiche Google Chat renvoie une erreur, l'interface Chat affiche un message indiquant "Un problème est survenu" ou "Impossible de traiter votre demande". Il peut arriver que l'interface Chat n'affiche aucun message d'erreur, mais que l'application ou la fiche Chat génère un résultat inattendu. Par exemple, il est possible qu'un message de fiche ne s'affiche pas.

Bien qu'aucun message d'erreur ne s'affiche dans l'interface Chat, des messages d'erreur descriptifs et des données de journal sont disponibles pour vous aider à corriger les erreurs lorsque la journalisation des erreurs est activée pour les applications Chat. Si vous avez besoin d'aide pour afficher, déboguer et corriger les erreurs, consultez Résoudre les erreurs Google Chat.

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 à Resource Manager

2. Dans la liste des projets, sélectionnez le projet 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 type machine à états pour concevoir l'agent Dialogflow, ce qui vous offre un contrôle clair et explicite sur une conversation, une meilleure expérience utilisateur et un meilleur workflow de développement. 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 la page Agents Dialogflow CX.
  • Pour obtenir des instructions détaillées sur la création et la configuration des agents, consultez la page Créer un agent Dialogflow CX.
• Dialogflow ES est une autre façon d'utiliser Dialogflow avec une application Chat.