Créer des agents conversationnels avec Application Integration

L'intégration d'applications 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 de conversation ?

Un agent de conversation (Dialogflow CX) est un agent virtuel qui communique avec les utilisateurs dans des conversations en langage naturel. Il analyse les entrées utilisateur, interprète l'intent 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 de conversation (Dialogflow CX), un outil représente une fonctionnalité ou un service spécifique auquel l'agent de conversation peut accéder. Les outils sont définis dans les playbooks et permettent à l'agent d'effectuer des actions telles que la récupération de données, l'exécution d'API ou l'interaction avec des systèmes externes. L'intégration d'applications génère ces outils en fonction des déclencheurs d'API de votre intégration, ce qui vous permet de connecter facilement votre logique d'intégration à vos flux de conversation.

Avant de commencer

Assurez-vous que les conditions suivantes sont remplies avant de créer un outil d'agent conversationnel à l'aide de l'intégration d'applications:

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 plus d'informations sur l'attribution de rôles aux comptes principaux, consultez la page 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 de l'intégration d'applications, 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 dans le volet Récapitulatif 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 d'intégration.
Dans la barre d'outils du concepteur, cliquez sur (menu d'actions), puis sélectionnez Create Conversational Agent Tool (Créer un outil d'agent conversationnel).
L'intégration d'applications vérifie que les API requises sont activées. Si ce n'est pas le cas, vous êtes 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 éventuellement 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, puis 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 ce n'est pas le cas, vous serez invité à les accorder.
Cliquez sur Afficher la spécification pour examiner la spécification générée pour les déclencheurs sélectionnés. Vous pouvez 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 des agents de conversation (Dialogflow CX), accédez à Playbooks (Playbooks), cliquez sur le playbook de l'agent créé, puis ajoutez des instructions au playbook pour utiliser l'outil. Pour en savoir plus, consultez la section 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 dans le volet Récapitulatif 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 d'intégration.
Dans la barre d'outils du concepteur, cliquez sur (menu d'actions), puis sélectionnez Create Conversational Agent Tool (Créer un outil d'agent conversationnel).
L'intégration d'applications vérifie que les API requises sont activées. Si ce n'est pas le cas, vous êtes 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 éventuellement 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 de conversation: une 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 un nom pour l'outil.
    
    Si vous sélectionnez Choisir un outil existant, la 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 ce n'est pas le cas, vous serez invité à les accorder.
Cliquez sur Afficher la spécification pour examiner la spécification générée pour les déclencheurs sélectionnés. Vous pouvez 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 des agents de conversation (Dialogflow CX), accédez à Playbooks (Playbooks), cliquez sur le playbook de l'agent créé, puis ajoutez des instructions au playbook pour utiliser l'outil. Pour en savoir plus, consultez la section 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.
Après avoir créé votre agent, examinez-le et testez-le dans la console des agents de conversation (Dialogflow CX).