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

Cette page explique comment créer un module complémentaire Google Workspace qui fonctionne dans Google Chat et interagit avec un agent IA Gemini Enterprise.

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 utiliserez l'agent de génération d'idées fourni par défaut par Google, qui aide les utilisateurs de la version Enterprise à innover et à résoudre des problèmes.

Agent de génération d'idées en tant qu'application de chat.

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

Architecture d'une application de chat implémentée avec un agent d'IA Gemini Enterprise.

Dans le schéma précédent, un utilisateur interagissant avec une application Chat implémentée avec un agent IA Gemini Enterprise 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 Gemini Enterprise 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 transmises à l'utilisateur.

Objectifs

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

Prérequis

Configurer votre environnement

Activer l'API Chat

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 l'API Google Chat.

Activer l'API

Configurer l'écran d'autorisation OAuth

Toutes les applications utilisant OAuth 2.0 nécessitent une configuration d'écran d'autorisation. La configuration de l'écran d'autorisation 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 APIs, 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. Sous 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 Discovery Engine User en procédant comme suit :

Console Google APIs

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

    Accéder à la page "Comptes de service"

  2. Cliquez sur Créer un compte de service.
  3. Renseignez les informations du compte de service, puis cliquez sur Créer et continuer.
  4. Facultatif : Attribuez des rôles à votre compte de service pour accorder l'accès aux ressources de votre projet Google Cloud. Pour en savoir plus, consultez Accorder, modifier et révoquer les accès à des ressources.
  5. Cliquez sur Continuer.
  6. 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 Gérer l'emprunt d'identité d'un compte de service.
  7. Cliquez sur OK. Notez l'adresse e-mail du compte de service.

CLI gcloud

  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. Pour en savoir plus, consultez Accorder, modifier et révoquer les accès à des ressources.

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

Créer une clé privée

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"

  2. Sélectionnez votre compte de service.
  3. Cliquez sur Clés > Ajouter une clé > Créer une clé.
  4. Sélectionnez JSON, puis 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 sous forme de fichier. 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 dont vous disposez. Découvrez comment stocker cette clé en toute sécurité. Consultez Gérer les clés de compte de service.

  5. Cliquez sur Fermer.

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

Créer et configurer le projet d'application Chat

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

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

  2. Notez les champs Numéro de projet et ID de projet.

  3. Accédez à Gemini Enterprise :

    Ouvrir Gemini Enterprise

  4. Notez l'emplacement et l'ID de l'application.

  5. Cliquez sur le bouton suivant pour ouvrir le projet Apps Script Démarrage rapide de l'agent IA GE.

    Ouvrir le projet

  6. Cliquez sur Présentation > Icône permettant de créer une copie Créer une copie.

  7. Dans votre projet Apps Script, cliquez sur Icône des paramètres du projet 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 la ressource d'application Gemini Enterprise composée des informations notées lors des étapes précédentes.

      projects/PROJECT_ID/locations/APP_LOCATION/collections/default_collection/engines/APP_ID

    2. SERVICE_ACCOUNT_KEY avec la clé JSON du compte de service téléchargée lors des étapes précédentes, par exemple { ... }.

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

  9. Dans votre projet Apps Script, cliquez sur Icône des paramètres du projet Paramètres du projet.

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

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

  12. 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 Icône permettant de créer une copie 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 GE 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 GE 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.

  5. Dans le nouveau message privé contenant l'application, saisissez I need to find ideas! (J'ai besoin d'idées !) et appuyez sur enter.

    L'application Chat répond avec la réponse de l'agent Génération d'idées par défaut.

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 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'aucun message d'erreur ne s'affiche dans l'interface utilisateur 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 pour les applications Chat est activée. 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.

Effectuer un nettoyage

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

  1. Dans la console Google APIs, accédez à la page Gérer les ressources. Cliquez sur 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 .
  3. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.