Planifier des voyages avec un agent IA accessible dans Google Workspace

HTTP

Apps Script

HTTP

1. Dans la console Google Cloud, activez les API Vertex AI, Places, People, Google Chat, Gmail, Cloud Build, Cloud Functions, Cloud Pub/Sub, Cloud Logging, Artifact Registry, Cloud Run et des modules complémentaires Google Workspace.

   Activer les API

2. Confirmez que vous activez les API dans le bon projet Cloud, puis cliquez sur Suivant.

3. Vérifiez que vous activez les API appropriées, puis cliquez sur Activer.

Apps Script

1. Dans la console Google Cloud, activez les API Vertex AI, Places, People et Google Chat.

   Activer les API

2. Confirmez que vous activez les API dans le bon projet Cloud, puis cliquez sur Suivant.

3. Vérifiez que vous activez les API appropriées, puis cliquez sur Activer.

Python

Afficher sur GitHub

Apps Script

Afficher sur GitHub

Python

1. Téléchargez ce dépôt GitHub.

   Télécharger

2. Dans l'environnement de développement local de votre choix, extrayez le fichier d'archive téléchargé et ouvrez le répertoire add-ons-samples/python/travel-adk-ai-agent.

   unzip add-ons-samples-main.zip
   cd add-ons-samples-main/python/travel-adk-ai-agent

3. Déplacez le fichier de clé JSON credentials.json du compte de service téléchargé lors des étapes précédentes vers le répertoire du projet.

4. Dans la console Google Cloud, accédez à Cloud Run :

   Accédez à Cloud Run

5. Cliquez sur Écrire une fonction.

6. Sur la page Créer un service, configurez votre fonction :

   1. Dans le champ Service name (Nom du compte de service), saisissez travel-concierge-app.
   2. Dans la liste Région, sélectionnez l'emplacement du projet Cloud que vous avez créé, PROJECT_LOCATION.
   3. Sous URL du point de terminaison, cliquez sur .
   4. Dans la liste Environnement d'exécution, sélectionnez la version la plus récente de Python.
   5. Dans la section Authentification, sélectionnez Autoriser l'accès public.
   6. Dans la section Conteneurs, volumes, mise en réseau, sécurité, sous Ressources :
      1. Dans le champ Mémoire, sélectionnez 1 Gio.
      2. Dans le champ CPU, sélectionnez 2.
   7. Cliquez sur Créer et attendez que Cloud Run crée le service. La console vous redirige vers l'onglet Source.

7. Dans l'environnement de développement local de votre choix, déployez la source du projet :

   gcloud run deploy travel-concierge-app --quiet --source . \
       --region PROJECT_LOCATION  \
       --function adk_ai_agent  \
       --set-env-vars LOCATION=LOCATION,PROJECT_NUMBER=PROJECT_NUMBER,ENGINE_ID=ENGINE_ID,BASE_URL=BASE_URL

   Remplacez les éléments suivants :

   1. PROJECT_LOCATION par l'emplacement de la fonction Cloud Run que vous avez créée précédemment.
   2. LOCATION avec l'emplacement du projet Google Cloud créé lors des étapes précédentes, PROJECT_LOCATION.
   3. PROJECT_NUMBER par le numéro de projet de l'agent d'IA Travel Concierge ADK déployé lors des étapes précédentes.
   4. ENGINE_ID par l'ID du moteur de l'agent d'IA Travel Concierge ADK déployé lors des étapes précédentes.
   5. BASE_URL par l'URL du point de terminaison que vous avez copiée précédemment.

Apps Script

Pour créer un projet Apps Script et le configurer afin qu'il utilise votre agent d'IA ADK Travel Concierge déployé :

1. Cliquez sur le bouton suivant pour ouvrir le projet Apps Script Agent d'IA ADK Travel Concierge.
   Ouvrir le projet

2. Cliquez sur info_outline Vue d'ensemble, puis sur Créer une copie.

3. Nommez votre copie du projet Apps Script :

   1. Cliquez sur Copie de l'agent d'IA ADK Travel Concierge.
   2. Dans le champ Titre du projet, saisissez Travel Concierge ADK AI Agent.
   3. Cliquez sur Renommer.

4. Dans votre projet Apps Script, cliquez sur Éditeur, puis déplacez le fichier VertexAi.gs vers le haut jusqu'à ce qu'il se trouve au-dessus du fichier AgentHandler.gs à l'aide de l'action Déplacer le fichier vers le haut.

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

6. ENGINE_ID avec l'ID de moteur de l'agent d'IA Travel Concierge ADK déployé lors des étapes précédentes, ENGINE_ID.

7. LOCATION par l'emplacement du projet Google Cloud créé lors des étapes précédentes, PROJECT_LOCATION.

8. PROJECT_NUMBER par le numéro de projet de l'agent d'IA Travel Concierge ADK déployé lors des étapes précédentes, PROJECT_NUMBER.

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

10. Cliquez sur Enregistrer les propriétés de script.

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

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

13. Dans Numéro de projet GCP, collez le numéro de projet de l'agent d'IA Travel Concierge ADK déployé lors des étapes précédentes, PROJECT_NUMBER.

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

Python

Utilisez un déploiement de module complémentaire Google Workspace pour installer l'exemple de projet dans toutes les applications Google Workspace (sauf Google Chat) afin de permettre les tests.

1. Dans l'environnement de développement local de votre choix, ouvrez le fichier deployment.json à partir du code source du projet et remplacez toutes les occurrences de $BASE_URL par la valeur de BASE_URL, l'URL du point de terminaison que vous avez copiée lors des étapes précédentes.

2. Créez un déploiement de module complémentaire Google Workspace nommé travel-concierge-addon :

   gcloud workspace-add-ons deployments create travel-concierge-addon \
       --deployment-file=deployment.json

3. Installez le déploiement du module complémentaire Google Workspace :

   gcloud workspace-add-ons deployments install travel-concierge-addon

Apps Script

Installez le projet Apps Script sur toutes les applications Google Workspace (sauf Google Chat) pour activer les tests.

1. Dans votre projet Apps Script, cliquez sur Déployer > Tester les déploiements, puis sur Installer.

Python

Installez l'exemple de projet dans Chat à l'aide de l'URL du point de terminaison pour activer les tests.

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

   Accéder à la page de configuration de l'API Google Chat

2. Configurer l'application Chat :

   1. Dans le champ Nom de l'application, saisissez Travel ADK AI Agent.
   2. Dans le champ URL de l'avatar, saisissez https://goo.gle/3SfMkjb.
   3. Dans le champ Description, saisissez Travel ADK AI Agent.
   4. Sous Paramètres de connexion, sélectionnez URL du point de terminaison HTTP.
   5. Sous Déclencheurs, sélectionnez Utiliser une URL de point de terminaison HTTP commune pour tous les déclencheurs.
   6. Dans le champ URL du point de terminaison HTTP, collez l'URL du point de terminaison que vous avez copiée précédemment, BASE_URL.
   7. Enregistrez une commande rapide que l'application Chat entièrement implémentée utilise :
      1. Sous Commandes, cliquez sur Ajouter une commande.
      2. Dans ID de commande, saisissez 1.
      3. Dans Description, saisissez Reset session.
      4. Sous Type de commande, sélectionnez Commande rapide.
      5. Dans le champ Nom, saisissez Reset session.
      6. Cliquez sur OK. La commande rapide est enregistrée et listée.
   8. Sous Visibilité, sélectionnez Rendre cette application de chat accessible à certains utilisateurs et groupes du domaine Votre espace de travail, puis saisissez votre adresse e-mail.
   9. Sous Journaux, sélectionnez Enregistrer les erreurs dans Logging.
   10. Cliquez sur Enregistrer.

Apps Script

Installez le projet Apps Script dans Chat à l'aide de l'ID de déploiement Head pour activer les tests.

1. Dans votre projet Apps Script, cliquez sur Déployer > Tester les déploiements, puis sur Copier sous ID de déploiement Head.

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

   Accéder à la page de configuration de l'API Google Chat

3. Configurer l'application Chat :

   1. Dans le champ Nom de l'application, saisissez Travel ADK AI Agent.
   2. Dans le champ URL de l'avatar, saisissez https://goo.gle/3SfMkjb.
   3. Dans le champ Description, saisissez Travel ADK AI Agent.
   4. Sous Paramètres de connexion, sélectionnez Apps Script.
   5. Dans le champ ID de déploiement, collez l'ID de déploiement Head que vous avez copié précédemment.
   6. Enregistrez une commande rapide que l'application Chat entièrement implémentée utilise :
      1. Sous Commandes, cliquez sur Ajouter une commande.
      2. Dans ID de commande, saisissez 1.
      3. Dans Description, saisissez Reset session.
      4. Sous Type de commande, sélectionnez Commande rapide.
      5. Dans le champ Nom, saisissez Reset session.
      6. Cliquez sur OK. La commande rapide est enregistrée et listée.
   7. Sous Visibilité, sélectionnez Rendre cette application de chat accessible à certains utilisateurs et groupes du domaine Votre espace de travail, puis saisissez votre adresse e-mail.
   8. Sous Journaux, sélectionnez Enregistrer les erreurs dans Logging.
   9. Cliquez sur Enregistrer.

HTTP

Dans les applications Google Workspace autres que Chat, l'agent d'IA présente les limites suivantes :

• Elle est synchrone : les barres latérales ne peuvent être mises à jour qu'en réponse aux interactions des utilisateurs. Les réponses de l'agent d'IA ne s'affichent donc qu'une fois qu'elles sont entièrement générées (pas de streaming).

• Délai d'expiration possible : le délai d'expiration des mises à jour de la barre latérale est dépassé lorsqu'elles prennent plus de quelques minutes.

Ces limites n'existent pas dans Chat.

Apps Script

Dans toutes les applications Google Workspace, l'agent d'IA appelle les API REST Vertex AI à l'aide de UrlFetchApp, ce qui entraîne les limitations suivantes :

• Elle est synchrone : les réponses de l'agent d'IA ne sont renvoyées qu'une fois qu'elles sont entièrement générées (pas de streaming).

• Délai d'expiration : les requêtes des agents IA expirent lorsqu'elles prennent plus d'une minute environ.

Python

• main.py: : définit les principales interfaces utilisateur et la logique des interactions utilisateur (gestionnaires d'événements Google Workspace). Une extension typique consisterait à activer les documents Drive en tant que fonctionnalité de contexte pour l'application Drive, comme c'est le cas pour les messages Gmail dans l'application Gmail.

• vertex_ai.py: : gère les sessions, les réponses et les erreurs de l'agent d'IA, et définit les interfaces spécifiques à Vertex AI à implémenter pour prendre en charge les interactions avec l'agent et le rendu des réponses. Les extensions typiques consistent à ajouter la prise en charge de plusieurs sessions pour les conversations utilisateur distinctes et d'autres plates-formes de gestion des agents d'IA.

• agent_handler.py : implémente les interfaces spécifiques à Vertex AI définies dans vertex_ai.py dans les cas spécifiques des applications Chat et non Chat. Une extension typique consisterait à ajouter des boutons permettant aux utilisateurs d'envoyer des commentaires sur les réponses des agents d'IA.

• google_workspace.py: : implémente les interactions de la plate-forme de gestion des agents non IA à l'aide d'appels d'API. Seules les API Google Workspace sont utilisées dans cet exemple pour collecter des informations contextuelles et effectuer des actions. Une extension typique consiste à ajouter des fonctions pour récupérer des données d'entreprise à partir de Google Agenda ou d'un système de gestion de la relation client (CRM).

• travel_agent_ui_render.gs: : implémente les rendus de réponse spécifiques au Travel Concierge pour les sous-agents et les applications Workspace. Les extensions classiques consistent à ajouter la prise en charge de nouveaux rendus de réponse pour afficher graphiquement les options de vol et d'autres agents d'IA.

Apps Script

• Code.gs: : définit les principales interfaces utilisateur et la logique d'interaction utilisateur (gestionnaires d'événements Google Workspace). Une extension typique consisterait à activer les documents Drive en tant que fonctionnalité de contexte pour l'application Drive, comme c'est le cas pour les messages Gmail dans l'application Gmail.

• VertexAi.gs: : gère les sessions, les réponses et les erreurs de l'agent d'IA, et définit les interfaces spécifiques à Vertex AI à implémenter pour prendre en charge les interactions avec l'agent et le rendu des réponses. Les extensions typiques consistent à ajouter la prise en charge de plusieurs sessions pour les conversations utilisateur distinctes et d'autres plates-formes de gestion des agents d'IA.

• AgentHandler.gs : implémente les interfaces spécifiques à Vertex AI définies dans VertexAi.gs dans les cas spécifiques des applications Chat et non Chat. Une extension typique consisterait à ajouter des boutons permettant aux utilisateurs d'envoyer des commentaires sur les réponses des agents d'IA.

• GoogleWorkspace.gs: : implémente les interactions de la plate-forme de gestion des agents non IA à l'aide d'appels d'API. Seules les API Google Workspace sont utilisées dans cet exemple pour collecter des informations contextuelles et effectuer des actions. Une extension typique consiste à ajouter des fonctions pour récupérer des données d'entreprise à partir de Google Agenda ou d'un système de gestion de la relation client (CRM).

• TravelAgentUiRender.gs: : implémente les rendus de réponse spécifiques au service de conciergerie de voyage pour les sous-agents et les applications Workspace. Les extensions classiques consistent à ajouter la prise en charge de nouveaux rendus de réponse pour afficher graphiquement les options de vol et d'autres agents d'IA.