Créer une application Google Chat avec un agent d'IA ADK

Cette page explique comment créer un module complémentaire Google Workspace qui fonctionne dans Google Chat et qui interagit avec un agent IA Agent Development Kit (ADK) hébergé dans Vertex AI Agent Engine.

Remarque : Dans Google Chat, les modules complémentaires sont présentés aux utilisateurs en tant qu'applications Google Chat. Vous pouvez également créer votre application Chat à l'aide de événements d'interaction de l'API Google Chat. Pour en savoir plus, consultez la présentation de l'extension de Google Chat.

Les agents IA perçoivent leur environnement de manière autonome, raisonnent et exécutent des actions complexes en plusieurs étapes pour atteindre un objectif défini. Dans ce tutoriel, vous allez déployer l' exemple multi-agent ADK LLM Auditor qui critique et révise les faits à l'aide de Gemini et de l'ancrage de la recherche Google.

Le schéma suivant présente l'architecture et le modèle de messagerie :

Dans le schéma précédent, un utilisateur interagissant avec une application Chat implémentée avec un agent IA ADK suit le flux d'informations suivant :

1. Un utilisateur envoie un message à une application Chat, en passant par un message privé ou un espace Chat.
2. La logique de l'application Chat implémentée dans Apps Script ou en tant que serveur Web avec des points de terminaison HTTP reçoit et traite le message.
3. L'agent IA implémenté avec ADK et hébergé avec Vertex AI Agent Engine reçoit et traite l'interaction.
4. L'application Chat ou l'agent IA peuvent éventuellement s'intégrer aux services Google Workspace, tels que Agenda ou Sheets, ou à d'autres services Google, tels que Google Maps ou YouTube.
5. L'application Chat envoie des réponses de manière asynchrone à l'aide de l'API Google Chat pour communiquer la progression de l'agent IA.
6. Les réponses sont envoyées à l'utilisateur.

Objectifs

• configurer votre environnement ;
• déployer l'agent IA ADK ;
• déployer l'application Chat ;
• configurer l'application Chat ;
• tester l'application Chat.

Prérequis

• Un compte Google Workspace Business ou Enterprise ayant accès à Google Chat.
• Un projet Google Cloud avec facturation activée. Pour vérifier que 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.

Configurer votre environnement

Activer les API Google Cloud

Avant d'utiliser les API Google, vous devez les activer dans un projet Google Cloud. Vous pouvez activer une ou plusieurs API dans un même projet Google Cloud.

• Dans la console Google Cloud, activez les API Google Chat, Vertex AI et Cloud Resource Manager.

  Activer les API

Configurer l'écran de consentement OAuth

Toutes les applications utilisant OAuth 2.0 nécessitent une configuration d'écran d'autorisation. La configuration de l'écran de consentement OAuth de votre application définit ce qui est affiché aux utilisateurs et aux évaluateurs de l'application, et enregistre votre application pour que vous puissiez la publier ultérieurement.

1. Dans la console Google API, accédez à Menu > Google Auth platform > Branding.

   Accéder à la page "Branding"

2. Si vous avez déjà configuré Google Auth Platform, vous pouvez configurer les paramètres de l'écran de consentement OAuth suivants dans Branding, Audience et Accès aux données. Si le message Google Auth Platform pas encore configuré s'affiche, cliquez sur Premiers pas :
1. Sous Informations sur l'application, dans Nom de l'application, saisissez un nom pour l'application.
2. Dans Adresse e-mail d'assistance utilisateur, choisissez une adresse e-mail d'assistance à laquelle les utilisateurs peuvent vous contacter s'ils ont des questions sur leur consentement.
3. Cliquez sur Suivant.
4. Dans le champ Audience, sélectionnez Interne.
5. Cliquez sur Suivant.
6. Sous Coordonnées, saisissez une adresse e-mail à laquelle vous recevrez des notifications en cas de modification de votre projet.
7. Cliquez sur Suivant.
8. Sous Terminer, consultez le Règlement sur les données utilisateur dans les services d'API Google et, si vous l'acceptez, sélectionnez J'accepte le Règlement sur les données utilisateur dans les services d'API Google.
9. Cliquez sur Continuer.
10. Cliquez sur Créer.
3. Pour l'instant, vous pouvez ignorer l'ajout de niveaux d'accès. À l'avenir, lorsque vous créerez une application à utiliser en dehors de votre organisation Google Workspace, vous devrez définir le type d'utilisateur sur Externe. Ajoutez ensuite les niveaux d'autorisation dont votre application a besoin. Pour en savoir plus, consultez le guide complet Configurer l'écran de consentement OAuth guide.

Créer un compte de service dans la console Google Cloud

Créez un compte de service avec le rôle Vertex AI User en procédant comme suit :

Console Google Cloud

1. Dans la console Google Cloud, accédez à Menu > IAM et administration > Comptes de service.

   Accéder à la page "Comptes de service"

   Les étapes restantes s'affichent dans la console Google Cloud.

2. Sélectionnez un projet Google Cloud.
3. Cliquez sur Créer un compte de service.
4. Saisissez le nom du compte de service à afficher dans la console Google Cloud.
   Remarque : Par défaut, Google crée un ID de compte de service unique basé sur le nom du compte de service. Vous pouvez modifier l'ID dans le champ "ID du compte de service". Vous ne pourrez pas le modifier par la suite.
5. Si vous ne souhaitez pas définir de contrôles des accès à ce stade, cliquez sur OK pour terminer la création du compte de service. Pour définir les contrôles des accès dès maintenant, cliquez sur Créer et continuer , puis passez à l'étape suivante.
   Remarque : L'octroi d'un contrôle des accès ici n'affecte que les ressources Google Cloud. Les ressources Google Workspace (telles que Google Sheets et Google Drive) sont partagées et configurées séparément.
6. Facultatif : Attribuez des rôles à votre compte de service pour accorder l'accès aux ressources de votre projet Google Cloud en plus des ressources Google Workspace. Pour en savoir plus, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
7. Cliquez sur Continuer.
8. Facultatif : Saisissez les utilisateurs ou les groupes qui peuvent gérer ce compte de service et effectuer des actions avec celui-ci. Pour en savoir plus, consultez Emprunt d'identité d'un compte de service.
9. Cliquez sur OK pour terminer la création du compte de service.

   Notez l'adresse e-mail du compte de service.

gcloud CLI

1. Créez le compte de service :

   gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
     --display-name="SERVICE_ACCOUNT_NAME"

2. Facultatif : Attribuez des rôles à votre compte de service pour accorder l'accès aux ressources de votre projet Google Cloud en plus des ressources Google Workspace. Pour en savoir plus, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Le compte de service s'affiche sur la page "Comptes de service".

Créer une clé privée

Avertissement : Cet exemple utilise une clé de compte de service exportée par souci de simplicité. L'exportation d'une clé privée n'est pas recommandée en production, car elle ne doit pas être stockée dans un emplacement non sécurisé, tel qu'un contrôle de code source.

Pour en savoir plus sur les implémentations sécurisées des comptes de service et les bonnes pratiques, consultez Choisir quand utiliser des comptes de service.

Pour créer et télécharger une clé privée pour le compte de service, procédez comme suit :

1. Dans la console Google Cloud, accédez à Menu > IAM et administration > Comptes de service.

   Accéder à la page "Comptes de service"

   Les étapes restantes s'affichent dans la console Google Cloud.

2. Sélectionnez un projet Google Cloud.
3. Cliquez sur l'adresse e-mail du compte de service pour lequel vous souhaitez créer une clé.
4. Cliquez sur l'onglet Clés.
5. Cliquez sur le menu déroulant Ajouter une clé, puis sélectionnez Créer une clé.
6. Sélectionnez le type de clé JSON et cliquez sur Créer.

   La nouvelle paire de clés publique/privée est générée et téléchargée sur votre machine en tant que fichier de clé de compte de service. Enregistrez le fichier JSON téléchargé sous le nom credentials.json dans votre répertoire de travail. Il s'agit de la seule copie de cette clé. Une fois téléchargé, vous ne pouvez plus le télécharger à nouveau. Pour savoir comment stocker votre clé de manière sécurisée, consultez Bonnes pratiques pour la gestion des clés de compte de service.

Pour en savoir plus sur les comptes de service, consultez la section Comptes de service dans la documentation Google Cloud IAM.

Déployer l'agent IA ADK

1. Ouvrez l'exemple LLM Auditor dans Vertex AI Agent Garden :

   Ouvrir l'exemple

2. Cliquez sur Déployer.

3. Si vous y êtes invité, sélectionnez votre projet Google Cloud.

4. Cliquez sur Déployer dans Cloud Shell.

5. Si vous y êtes invité, cliquez sur Autoriser et suivez le flux OAuth pour Cloud Shell.

6. Une fois Cloud Shell complètement chargé, appuyez sur Entrée pour exécuter la ligne de commande préchargée et commencer le déploiement.

7. Si vous êtes invité à saisir une région, appuyez sur Entrée pour utiliser la région par défaut.

8. Une fois l'opération terminée, accédez à Vertex AI Agent Engine :

   Ouvrir Vertex AI Agent Engine

9. Cliquez sur pour copier le nom de ressource de l'agent nouvellement déployé à partir du tableau.

Créer et configurer le projet d'application Chat

1. Cliquez sur le bouton suivant pour ouvrir le projet Apps Script Guide de démarrage rapide de l'agent IA ADK.

   Ouvrir le projet

2. Cliquez sur Présentation > Créer une copie.

3. Dans votre projet Apps Script, cliquez sur Paramètres du projet > Modifier les propriétés du script > Ajouter une propriété de script pour ajouter les propriétés de script suivantes :

   1. REASONING_ENGINE_RESOURCE_NAME avec le nom de ressource de l'agent Vertex AI copié lors des étapes précédentes.
   2. SERVICE_ACCOUNT_KEY avec la clé JSON du compte de service téléchargée lors des étapes précédentes, par exemple { ... }.

4. Cliquez sur Enregistrer les propriétés du script.

5. Dans la console Google API, accédez à Menu > IAM et administration > Paramètres.

   Accéder à la page Paramètres de la section IAM et administration

6. Dans le champ Numéro du projet, copiez la valeur.

7. Dans votre projet Apps Script, cliquez sur Paramètres du projet.

8. Sous Projet Google Cloud Platform (GCP), cliquez sur Changer de projet.

9. Dans le champ Numéro de projet GCP, collez le numéro de projet Google Cloud copié lors des étapes précédentes.

10. Cliquez sur Définir un projet. Le projet Cloud et le projet Apps Script sont désormais connectés.

Créer un déploiement de test

Vous avez besoin d'un ID de déploiement pour ce projet Apps Script afin de pouvoir l'utiliser à l'étape suivante.

Pour obtenir l'ID de déploiement "Head", procédez comme suit :

1. Dans le projet Apps Script de l'application Chat, cliquez sur Déployer > Tester les déploiements.
2. Sous ID de déploiement "Head", cliquez sur Copier.
3. Cliquez sur OK.

Configurer l'application Chat

À l'aide de votre déploiement Apps Script, procédez comme suit pour déployer l'application Google Chat à des fins de test :

1. Dans la console API, recherchez Google Chat API, puis cliquez sur API Google Chat.
2. Cliquez sur Gérer.

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

   1. Dans le champ Nom de l'application, saisissez ADK Quickstart.
   2. Dans le champ URL de l'avatar, saisissez https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.png.
   3. Dans le champ Description, saisissez ADK Quickstart.
   4. Sous Fonctionnalité, sélectionnez Rejoindre des espaces et des conversations de groupe.
   5. Sous Paramètres de connexion, sélectionnez Projet Apps Script.
   6. Dans le champ ID de déploiement, collez l'ID de déploiement "Head" que vous avez copié précédemment.
   7. Sous Visibilité, sélectionnez Utilisateurs et groupes spécifiques de votre domaine, puis saisissez votre adresse e-mail.

4. Cliquez sur Enregistrer.

L'application Chat est prête à répondre aux messages.

Tester l'application Chat

Pour tester votre application Chat, ouvrez un espace de message privé avec l'application Chat et envoyez un message :

1. Ouvrez Google Chat à l'aide du 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 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'ouvre.

   Remarque : Si votre application Chat ne s'affiche pas dans la liste des résultats, assurez-vous d'avoir inclus votre compte Google Workspace dans les paramètres de visibilité de la page Configuration de l'API Chat de la console Google API.

5. Dans le nouveau message privé avec l'application, saisissez The Eiffel Tower was completed in 1900 et appuyez sur enter.

   L'application Chat répond avec les réponses des sous-agents Critic et Reviser.

Pour ajouter des testeurs de confiance et en savoir plus sur les tests des fonctionnalités interactives, consultez Tester les fonctionnalités interactives des applications Google Chat.

Résoudre les problèmes

Lorsqu'une application ou fiche Google Chat renvoie une erreur, l'interface Chat affiche un message indiquant "Un problème est survenu." ou "Impossible de traiter votre demande." Parfois, l'interface utilisateur de Chat n'affiche aucun message d'erreur, mais l'application ou la fiche Chat produit un résultat inattendu. Par exemple, un message de fiche peut ne pas s'afficher.

Bien qu'un message d'erreur ne s'affiche pas dans l'interface utilisateur de 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. Pour obtenir de l'aide sur l'affichage, le débogage et la correction des erreurs, consultez Résoudre et corriger les erreurs Google Chat.

Libérer de l'espace

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

Attention : La suppression d'un projet a les effets suivants :

• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour ce tutoriel et que vous le supprimez, vous supprimerez également tout autre travail effectué dans le projet.
• Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé dont vous souhaitez vous servir par la suite. Pour conserver les URL qui utilisent l'ID du projet, telles qu'une URL sur appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.

Si vous envisagez d'explorer plusieurs tutoriels et guides de démarrage rapide, réutiliser des projets peut vous aider à ne pas dépasser les limites de quotas des projets.

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

   Accéder à Resource Manager

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

Articles associés

• Créer une application Google Chat avec un agent IA ADK exposé par A2A
• Créer une application Google Chat avec un agent IA ADK exposé par A2UI
• Créer des agents Gemini Enterprise étroitement intégrés aux datastores, aux API et aux applications Chat de Workspace
• Créer des agents Vertex AI étroitement intégrés aux datastores, aux API et aux applications Chat de Workspace
• Vérifier des affirmations avec un agent IA ADK et un modèle Gemini
• Planifier des voyages avec un agent IA accessible dans Google Workspace
• Créer une application Google Chat avec un agent IA Gemini Enterprise
• Intégrer des concepts d'IA fondamentaux dans les applications Chat
• Répondre à des questions basées sur des conversations Chat à l'aide d'une application Chat avec l'IA Gemini
• Répondre aux incidents avec Google Chat, Vertex AI, Apps Script et l'authentification des utilisateurs
• Gérer des projets avec Google Chat, Vertex AI et Firestore