Créer des agents conversationnels avec Application Integration

L'Application Integration simplifie désormais la création d'expériences conversationnelles en s'intégrant directement aux agents conversationnels (Dialogflow CX). Cette fonctionnalité vous permet de créer des chatbots et des outils intelligents qui améliorent les interactions utilisateur et automatisent les tâches, directement à partir de vos workflows d'intégration à l'aide de déclencheurs d'API.

Qu'est-ce qu'un agent conversationnel ?

Un agent de conversation (Dialogflow CX) est un agent virtuel qui communique avec les utilisateurs en langage naturel. Il analyse les saisies des utilisateurs, interprète leurs intentions et fournit des réponses appropriées, ce qui permet d'offrir des expériences conversationnelles interactives et personnalisées. Ces agents sont conçus pour gérer les conversations sur différents canaux, tels que les sites Web, les applications mobiles et les plates-formes de messagerie.

Qu'est-ce qu'un outil d'agent conversationnel ?

Dans les agents conversationnels (Dialogflow CX), un outil représente une fonctionnalité ou un service spécifique auxquels l'agent conversationnel peut accéder. Les outils sont définis dans les playbooks et permettent à l'agent d'effectuer des actions telles que récupérer des données, exécuter des API ou interagir avec des systèmes externes. L'Application Integration génère ces outils en fonction des déclencheurs d'API de votre intégration, ce qui facilite la connexion de la logique d'intégration à vos flux de conversation.

Avant de commencer

Avant de créer un outil d'agent conversationnel à l'aide d'Application Integration, assurez-vous des points suivants :

Attribuez les rôles IAM suivants à votre compte principal :
- Administrateur de compte de service (roles/iam.serviceAccountAdmin)
- Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin)
- Éditeur d'agent de la console Dialogflow (roles/dialogflow.consoleAgentEditor)
Pour savoir comment attribuer des rôles à des comptes principaux, consultez Attribuer ou révoquer un rôle unique.

Rôles IAM requis pour les comptes de service

Les rôles IAM suivants sont requis pour les comptes de service utilisés pour créer un outil d'agent conversationnel :

Compte de service	Description	Rôles requis
Compte de service	Compte de service utilisé pour créer l'outil d'agent conversationnel.	Demandeur Application Integration (`roles/integrations.integrationInvoker`)
Agent de service Dialogflow (`service-{$PROJECT_ID}@gcp-sa-dialogflow.iam.gserviceaccount.com`)	Compte de service utilisé par les agents de conversation (Dialogflow CX) pour accéder à l'intégration.	Créateur de jetons du compte de service (`roles/iam.serviceAccountTokenCreator`)

Créer un outil d'agent conversationnel

Pour créer un outil d'agent conversationnel à l'aide d'Application Integration, procédez comme suit :

Dans la console Google Cloud, accédez à la page Application Integration.
Accéder à Application Integration
Dans le menu de navigation, cliquez sur Intégrations.
La page Intégrations s'affiche et liste toutes les intégrations disponibles dans le projet Google Cloud.
Sélectionnez une intégration existante ou cliquez sur Créer une intégration pour en créer une.
Si vous créez une intégration :
1. Saisissez un nom et une description dans le volet Créer une intégration.
2. Sélectionnez une région pour l'intégration.
  Remarque : Le menu déroulant Régions ne répertorie que les régions provisionnées dans votre projet Google Cloud. Pour provisionner une nouvelle région, cliquez sur Activer la région. Pour en savoir plus, consultez la section Activer une nouvelle région.
3. Sélectionnez un compte de service pour l'intégration. Vous pouvez modifier ou mettre à jour les informations du compte de service d'une intégration à tout moment depuis le volet Résumé de l'intégration de la barre d'outils d'intégration.
  Remarque : L'option permettant de sélectionner un compte de service ne s'affiche que si vous avez activé la gouvernance de l'intégration pour la région sélectionnée.
4. Cliquez sur Créer.
  Cela entraîne son ouverture dans l'éditeur d'intégrations.
Sélectionnez une intégration existante. Cela entraîne son ouverture dans l'éditeur d'intégrations.
Assurez-vous que l'intégration sélectionnée est configurée avec un ou plusieurs déclencheurs d'API.
Publiez la version de l'intégration.
Dans la barre d'outils du concepteur, cliquez sur (menu d'actions), puis sélectionnez Créer un outil d'agent conversationnel.
Application Integration vérifie que les API requises sont activées. Si ce n'est pas le cas, vous serez invité à les activer.
Dans le volet Créer un outil d'agent conversationnel, fournissez les entrées suivantes :
1. Déclencheurs d'API : tous les déclencheurs d'API de votre intégration sont sélectionnés par défaut. Vous pouvez également désélectionner les déclencheurs d'API que vous ne souhaitez pas inclure dans l'outil.
2. Type : sélectionnez Créer un agent conversationnel et saisissez les informations suivantes :
  1. Région : sélectionnez la région de l'agent.
  2. Nom de l'agent : saisissez un nom pour l'agent.
  3. Nom de l'outil : saisissez un nom pour l'outil.
3. Compte de service : choisissez un compte de service disposant des rôles et autorisations nécessaires pour l'accès aux ressources de l'agent. Si l'un d'eux est manquant, vous serez invité à l'attribuer.
Cliquez sur Afficher la spécification pour examiner la spécification générée pour les déclencheurs sélectionnés. Vous pouvez éventuellement modifier la spécification avant de l'enregistrer.
Cliquez sur Enregistrer.
Un message s'affiche pour indiquer que l'outil a bien été créé. Cliquez sur Afficher pour ouvrir l'agent dans la console Agents de conversation (Dialogflow CX).
Dans la console Agents de conversation (Dialogflow CX), accédez à Playbooks, cliquez sur le playbook de l'agent créé, puis ajoutez des instructions au playbook pour utiliser l'outil. Pour en savoir plus, consultez Outils de playbook.

Créer un outil d'agent conversationnel à l'aide d'un agent existant

Pour créer un outil d'agent conversationnel à l'aide d'un agent existant, procédez comme suit :

Dans la console Google Cloud, accédez à la page Application Integration.
Accéder à Application Integration
Dans le menu de navigation, cliquez sur Intégrations.
La page Intégrations s'affiche et liste toutes les intégrations disponibles dans le projet Google Cloud.
Sélectionnez une intégration existante ou cliquez sur Créer une intégration pour en créer une.
Si vous créez une intégration :
1. Saisissez un nom et une description dans le volet Créer une intégration.
2. Sélectionnez une région pour l'intégration.
  Remarque : Le menu déroulant Régions ne répertorie que les régions provisionnées dans votre projet Google Cloud. Pour provisionner une nouvelle région, cliquez sur Activer la région. Pour en savoir plus, consultez la section Activer une nouvelle région.
3. Sélectionnez un compte de service pour l'intégration. Vous pouvez modifier ou mettre à jour les informations du compte de service d'une intégration à tout moment depuis le volet Résumé de l'intégration de la barre d'outils d'intégration.
  Remarque : L'option permettant de sélectionner un compte de service ne s'affiche que si vous avez activé la gouvernance de l'intégration pour la région sélectionnée.
4. Cliquez sur Créer.
  Cela entraîne son ouverture dans l'éditeur d'intégrations.
Sélectionnez une intégration existante. Cela entraîne son ouverture dans l'éditeur d'intégrations.
Assurez-vous que l'intégration sélectionnée est configurée avec un ou plusieurs déclencheurs d'API.
Publiez la version de l'intégration.
Dans la barre d'outils du concepteur, cliquez sur (menu d'actions), puis sélectionnez Créer un outil d'agent conversationnel.
Application Integration vérifie que les API requises sont activées. Si ce n'est pas le cas, vous serez invité à les activer.
Dans le volet Créer un outil d'agent conversationnel, fournissez les entrées suivantes :
1. Déclencheurs d'API : tous les déclencheurs d'API de votre intégration sont sélectionnés par défaut. Vous pouvez également désélectionner les déclencheurs d'API que vous ne souhaitez pas inclure dans l'outil.
2. Type : sélectionnez Choisir un agent conversationnel existant, puis procédez comme suit :
  1. Agent conversationnel : la liste des agents disponibles dans votre projet s'affiche. Sélectionnez l'agent que vous souhaitez utiliser.
  2. Outil : sélectionnez Créer un outil ou Choisir un outil existant.
    Si vous sélectionnez Créer un outil, saisissez le nom de l'outil.
    
    Si vous sélectionnez Choisir un outil existant, une liste des outils disponibles dans l'agent sélectionné s'affiche. Sélectionnez l'outil que vous souhaitez utiliser.
3. Compte de service : choisissez un compte de service disposant des rôles et autorisations nécessaires pour l'accès aux ressources de l'agent. Si l'un d'eux est manquant, vous serez invité à l'attribuer.
Cliquez sur Afficher la spécification pour examiner la spécification générée pour les déclencheurs sélectionnés. Vous pouvez éventuellement modifier la spécification avant de l'enregistrer.
Cliquez sur Enregistrer.
Un message s'affiche pour indiquer que l'outil a bien été créé. Cliquez sur Afficher pour ouvrir l'agent dans la console Agents de conversation (Dialogflow CX).
Dans la console Agents de conversation (Dialogflow CX), accédez à Playbooks, cliquez sur le playbook de l'agent créé, puis ajoutez des instructions au playbook pour utiliser l'outil. Pour en savoir plus, consultez Outils de playbook.

Remarques

Les considérations suivantes s'appliquent lorsque vous utilisez des outils d'agent conversationnel :

Les outils d'agent conversationnel ne peuvent être créés que pour les intégrations publiées avec des déclencheurs d'API.
Une fois votre agent créé, vérifiez-le et testez-le dans la console Agents de conversation (Dialogflow CX).