Gérer des projets avec Google Chat, Vertex AI et Firestore

Ce tutoriel explique comment créer une application Google Chat permettant à une équipe de gérer des projets en temps réel. L'application Chat utilise Vertex AI pour aider les équipes à rédiger des histoires d'utilisateurs (qui représentent les fonctionnalités d'un système logiciel du point de vue de l'utilisateur, que l'équipe doit développer) et conserve les histoires dans une base de données Firestore.

Prérequis

• Un compte Google Workspace ayant accès à Google Chat

• L'accès aux services Google Cloud permet d'effectuer les opérations suivantes:

  • Créez un projet Google Cloud.
  • associer un compte de facturation Google Cloud au projet Cloud ; Pour savoir si vous y avez accès, consultez la section Autorisations requises pour activer la facturation.

  • utiliser des appels de fonction Google Cloud non authentifiés, que vous pouvez vérifier en déterminant si votre organisation Google Cloud utilise le partage restreint de domaine ;

  Si nécessaire, demandez à votre administrateur Google Cloud de vous accorder un accès ou une autorisation.

• Si vous utilisez Google Cloud CLI, un environnement de développement Node.js configuré pour fonctionner avec gcloud CLI. Consultez la page Configurer un environnement de développement Node.js.

Objectifs

• créer une application Chat qui gère des projets logiciels agiles ;
• Aidez les utilisateurs à écrire des histoires d'utilisateurs avec les outils de rédaction d'histoires assistés par l'IA générative et optimisés par Vertex AI :
  • Générez et regénérez des descriptions de stories.
  • Développez les descriptions de l'histoire à partir des notes pour répondre aux exigences.
  • Corriger la grammaire pour corriger les fautes de frappe.
• Maintenez vos travaux à jour en écrivant et en lisant dans une base de données Firestore.
• Facilitez la collaboration dans un espace Chat en permettant aux utilisateurs de créer, de modifier, d'attribuer et de démarrer des histoires directement depuis la conversation.

Produits utilisés

L'application de gestion de projets utilise les produits Google Workspace et Google Cloud suivants:

• API Chat : API permettant de développer des applications Google Chat qui reçoivent des événements d'interaction avec Chat, tels que des messages, et y répondent. L'application Google Chat de gestion de projets utilise l'API Chat pour recevoir les événements d'interaction envoyés par Chat et y répondre, et pour configurer les attributs qui déterminent la façon dont il s'affiche dans Chat, comme le nom et l'image d'avatar.
• API Vertex AI : plate-forme d'IA générative. L'application Google Chat de gestion de projet utilise l'API Vertex AI pour écrire des titres et des descriptions d'histoires d'utilisateurs.
• Firestore : base de données de documents sans serveur. L'application Google Chat de gestion de projet utilise Firebase pour stocker des données sur les histoires d'utilisateurs.

• Cloud Functions : service de calcul sans serveur léger qui vous permet de créer des fonctions autonomes à application unique pouvant répondre à des événements d'interaction Chat sans avoir à gérer de serveur ni d'environnement d'exécution. L'application Google Chat de gestion de projets utilise Cloud Functions pour héberger le point de terminaison HTTP auquel Chat envoie les événements d'interaction et en tant que plate-forme de calcul pour exécuter une logique qui traite ces événements et y répond.

  Cloud Functions utilise les produits Google Cloud suivants pour créer, traiter des événements d'interaction et héberger des ressources de calcul:

  • Cloud Build : plate-forme entièrement gérée d'intégration, de livraison et de déploiement continus qui exécute des compilations automatisées.
  • Pub/Sub : service de messagerie asynchrone et évolutif qui dissocie les services générant des messages des services qui les traitent.
  • API Cloud Run Admin : environnement entièrement géré pour l'exécution d'applications conteneurisées.

Architecture

L'architecture de l'application de gestion de projets Google Chat reçoit et traite les événements d'interaction Chat sur un point de terminaison HTTP, utilise Vertex AI pour vous aider à rédiger des histoires d'utilisateurs et stocke les détails des histoires d'utilisateurs dans une base de données Firestore. Le schéma suivant illustre l'architecture des ressources Google Workspace et Google Cloud utilisées.

L'application Google Chat de gestion de projets fonctionne comme suit:

1. Un utilisateur envoie un message dans Chat et appelle l'application de gestion de projets Google Chat en lui envoyant un message direct, en la mentionnant dans un espace ou en saisissant une commande à barre oblique.

2. Chat envoie une requête HTTP synchrone au point de terminaison HTTP de la fonction Cloud.

3. L'application Google Chat de gestion de projets traite la requête HTTP:

   1. Vertex AI permet d'écrire ou de mettre à jour une histoire d'utilisateur.

   2. Une base de données Firestore stocke, récupère, met à jour ou supprime les données des histoires d'utilisateur.

4. Cloud Functions renvoie à Chat une réponse HTTP qui la présente à l'utilisateur sous la forme d'un message ou d'une boîte de dialogue.

Préparer l'environnement

Cette section explique comment créer et configurer un projet Google Cloud pour l'application Chat.

Créer un projet Google Cloud

Console Google Cloud

1. Dans la console Google Cloud, accédez à Menu menu > IAM et administration > Créer un projet.

   Accéder à la page Créer un projet

2. Dans le champ Nom du projet, saisissez un nom descriptif pour votre projet.

   Facultatif: Pour modifier l'ID du projet, cliquez sur Modifier. Une fois le projet créé, l'ID ne pourra plus être modifié. Par conséquent, choisissez un ID qui répond à vos besoins tout au long de la durée de vie du projet.

3. Dans le champ Emplacement, cliquez sur Parcourir pour afficher les emplacements potentiels pour votre projet. Cliquez ensuite sur Sélectionner.
4. Cliquez sur Créer. La console Google Cloud accède à la page "Tableau de bord", et votre projet est créé en quelques minutes.

gcloud CLI

Dans l'un des environnements de développement suivants, accédez à la Google Cloud CLI ("gcloud"):

• Cloud Shell: pour utiliser un terminal en ligne avec la gcloud CLI configurée, activez Cloud Shell.
  Activer Cloud Shell
• Shell locale: pour utiliser un environnement de développement local, installez et initialize la gcloud CLI.
  Pour créer un projet Cloud, utilisez la commande "gcloud projects create" :

  gcloud projects create PROJECT_ID

  Remplacez PROJECT_ID en définissant l'ID du projet que vous souhaitez créer.

Activer la facturation pour le projet Cloud

Console Google Cloud

1. Dans la console Google Cloud, accédez à Facturation. Cliquez sur Menu menu > Facturation > Mes projets.

   Accéder à la facturation de mes projets

2. Dans Sélectionner une organisation, choisissez l'organisation associée à votre projet Google Cloud.
3. Sur la ligne du projet, ouvrez le menu Actions (more_vert), cliquez sur Modifier la facturation, puis sélectionnez le compte de facturation Cloud.
4. Cliquez sur Définir le compte.

gcloud CLI

1. Pour afficher la liste des comptes de facturation disponibles, exécutez la commande suivante :

   gcloud billing accounts list

2. Associez un compte de facturation à un projet Google Cloud :

   gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID

   Remplacez les éléments suivants :

   • PROJECT_ID correspond à l'ID du projet Cloud pour lequel vous souhaitez activer la facturation.
   • BILLING_ACCOUNT_ID est l'ID du compte de facturation à associer au projet Google Cloud.

Activer les API

Authentification et autorisation

Aucune configuration d'authentification et d'autorisation n'est nécessaire pour suivre ce tutoriel.

Pour appeler les API Firestore et Vertex AI, ce tutoriel utilise les identifiants par défaut de l'application avec le compte de service par défaut associé à la fonction Cloud, que vous n'avez pas besoin de configurer. Dans le contexte d'un environnement de production, il est généralement recommandé de créer et d'associer un compte de service à la fonction Cloud.

Créer et déployer l'application Google Chat

Maintenant que votre projet Google Cloud est créé et configuré, vous êtes prêt à créer et à déployer l'application Google Chat. Dans cette section, vous allez procéder comme suit:

1. Créez une base de données Firestore dans laquelle conserver et récupérer des histoires d'utilisateurs.
2. Examinez éventuellement l'exemple de code.
3. Créez une fonction Cloud pour héberger et exécuter le code de l'application Chat en réponse aux événements reçus de Chat sous forme de requêtes HTTP.
4. Créez et déployez une application Google Chat sur la page de configuration de l'API Google Chat.

Créer la base de données Firestore

Dans cette section, vous allez créer une base de données Firestore pour conserver et récupérer des histoires d'utilisateur, mais vous ne définissez pas le modèle de données. Le modèle de données est défini implicitement dans l'exemple de code par les fichiers model/user-story.js et model/user.js.

La base de données de l'application Chat de gestion de projets utilise un modèle de données NoSQL basé sur des documents class organisés en collections collections_bookmark. Pour en savoir plus, consultez la section Modèle de données Firestore.

Le schéma suivant présente le modèle de données de l'application Google Chat de gestion de projet:

La collection racine est spaces, où chaque document représente un espace dans lequel l'application Chat a créé des stories. Chaque histoire d'utilisateur est représentée par un document de la sous-collection userStories, et chaque utilisateur est représenté par un document de la sous-collection users.

Voici comment créer la base de données Firestore:

Examiner l'exemple de code

Si vous le souhaitez, avant de créer la fonction Cloud, prenez le temps d'examiner et de vous familiariser avec l'exemple de code hébergé sur GitHub.

Afficher sur GitHub

Voici un aperçu de chaque fichier:

env.js

Variables de configuration d'environnement permettant de déployer l'application Chat dans un projet et une région Google Cloud spécifiés. Vous devez mettre à jour les variables de configuration dans ce fichier.

package.json et package-lock.json

Paramètres et dépendances du projet Node.js

index.js

Point d'entrée de la fonction Cloud de l'application Chat. Il lit l'événement Chat de la requête HTTP, appelle le gestionnaire d'applications et publie la réponse HTTP en tant qu'objet JSON.

controllers/app.js

La logique d'application principale. Il traite les événements d'interaction en gérant les mentions et les commandes à barre oblique de l'application Chat. Pour répondre aux clics sur les fiches, il appelle app-action-handler.js.

controllers/app-action-handler.js

La logique d'application pour gérer les clics sur les fiches Événements d'interaction Chat

services/space-service.js, services/user-service.js et services/user-story-service.js

Ces fichiers contiennent les parties de la logique d'application spécifique à l'utilisation des espaces Chat, des utilisateurs et des histoires d'utilisateurs. Les fonctions de ces fichiers sont appelées par app.js ou app-action-handler.js. Pour effectuer des opérations de base de données, les fonctions de ces fichiers appellent des fonctions dans firestore-service.js.

services/firestore-service.js

Gère les opérations de base de données. Les fonctions de ce fichier sont appelées par services/space-service.js, services/user-service.js et services/user-story-service.js.

services/aip-service.js

Appelle l'API Vertex AI pour la prédiction de texte avec l'IA générative.

model/*.js

Ces fichiers contiennent la définition des classes et des énumérations que les services d'application utilisent pour stocker et transmettre des données entre les fonctions. Il définit le modèle de données de la base de données Firestore.

views/*.js

Chaque fichier de ce répertoire instancie un objet carte que l'application Chat renvoie à Chat sous forme de message fiche ou de réponse d'action de boîte de dialogue.

views/widgets/*.js

Chaque fichier instancie un type d'objet widget que l'application utilise pour créer les cartes dans le répertoire views/.

test/**/*.test.js

Chaque fichier de ce répertoire et de ses sous-répertoires contient les tests unitaires pour la fonction, le contrôleur, le service, la vue ou le widget correspondants. Vous pouvez exécuter tous les tests unitaires en exécutant npm run test dans le répertoire racine du projet.

Créer et déployer la fonction Cloud

Dans cette section, vous allez créer et déployer une fonction Cloud qui comprend la logique d'application de l'application Chat de gestion de projet.

La fonction Cloud s'exécute en réponse à une requête HTTP de Chat contenant un événement d'interaction. Lors de son exécution, le code de la fonction Cloud traite l'événement et renvoie à Chat une réponse que Chat affiche sous forme de message, de boîte de dialogue ou d'autre type d'interaction utilisateur. Le cas échéant, la fonction Cloud lit également ou écrit dans la base de données Firestore.

Voici comment créer la fonction Cloud:

1. Une fois le déploiement de la fonction terminé, copiez la propriété url de la réponse. Il s'agit de l'URL du déclencheur que vous utiliserez dans la section suivante pour configurer l'application Google Chat.

Configurer l'application Google Chat dans la console Google Cloud

Cette section explique comment configurer l'API Chat dans la console Google Cloud avec des informations sur votre application Chat, y compris son nom, les commandes à barre oblique compatibles et l'URL du déclencheur de la fonction Cloud de l'application Chat à laquelle elle envoie des événements d'interaction Chat.

1. Dans la console Google Cloud, cliquez sur Menu menu > Plus de produits > Google Workspace > Bibliothèque de produits > API Google Chat > Gérer > Configuration.

   Accéder à la configuration de l'API Chat

2. Dans le champ Nom de l'application, saisissez Project Manager.

3. Dans URL de l'avatar, saisissez https://developers.google.com/chat/images/quickstart-app-avatar.png.

4. Dans le champ Description, saisissez Manages projects with user stories..

5. Activez l'option Activer les fonctionnalités interactives.

6. Sous Fonctionnalité, sélectionnez Recevoir des messages privés, puis Rejoindre des espaces et des conversations de groupe.

7. Sous Paramètres de connexion, sélectionnez URL de l'application.

8. Dans le champ URL de l'application, collez l'URL du déclencheur que vous avez copiée à partir du déploiement Cloud Functions, au format https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial. Si vous avez déployé la fonction Cloud à l'aide de la gcloud CLI, il s'agit de la propriété url.

9. Enregistrez les commandes à barre oblique de l'application Chat. Pour enregistrer une commande à barre oblique:

   1. Sous Commandes à barre oblique, cliquez sur Ajouter une commande à barre oblique.

   2. Pour chaque commande à barre oblique détaillée dans le tableau suivant, saisissez le nom, l'ID de commande et la description, indiquez si la commande à barre oblique Ouvre une boîte de dialogue, puis cliquez sur OK:

      Nom	ID de commande	Description	Ouvre une boîte de dialogue
      /createUserStory	1	Crée une histoire avec le titre spécifié.	Non sélectionné
      /myUserStories	2	Répertorie toutes les histoires attribuées à l'utilisateur.	Non sélectionné
      /userStory	3	Affiche l'état actuel de l'histoire spécifiée.	Non sélectionné
      /manageUserStories	4	Ouvre une boîte de dialogue permettant de modifier les articles.	Sélectionné
      /cleanupUserStories	5	Supprime toutes les histoires de l'espace.	Non sélectionné

10. Sous Visibilité, sélectionnez Rendre cette application Chat accessible à des personnes et des groupes spécifiques de votre domaine Workspace, puis saisissez votre adresse e-mail.

11. Sous Journaux, vous pouvez éventuellement sélectionner Consigner les erreurs dans Logging.

12. Cliquez sur Enregistrer. Un message de configuration enregistrée s'affiche, indiquant que l'application Chat est prête à être testée.

Tester l'application Chat

Testez l'application Chat de gestion de projets en lui envoyant des messages et en utilisant ses commandes à barre oblique pour créer, modifier et supprimer des histoires d'utilisateurs.

1. Ouvrez Google Chat avec le compte Google Workspace que vous avez indiqué lorsque vous vous avez ajouté en tant que testeur de confiance.

   Accéder à Google Chat

2. Cliquez sur add 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'affiche.

5. Dans le nouveau message privé contenant l'application, saisissez Hello, puis appuyez sur enter. L'application Chat de gestion de projet répond avec un menu d'aide détaillant ses fonctionnalités.
6. Pour créer une story, saisissez /createUserStory Test story dans la barre de message et envoyez-la. L'application Chat de gestion de projet répond par un message sous forme de fiche détaillant l'histoire d'utilisateur qu'elle crée pour vous à l'aide de l'IA générative de Vertex AI.

7. Dans la console, consultez la base de données Firestore pour examiner les enregistrements créés concernant l'espace dans lequel vous avez ajouté l'application Chat, les utilisateurs qui ont interagi avec elle et l'histoire d'utilisateur que vous avez créée.

   Accéder à Firestore

8. Revenez à Google Chat.

   Accéder à Google Chat

9. Si vous souhaitez modifier l'histoire, cliquez sur Modifier. Lorsque vous êtes satisfait de l'histoire, cliquez sur Enregistrer.
10. Testez chaque commande à barre oblique compatible avec l'application. Pour les afficher, saisissez / ou mentionnez l'application Chat.
11. Supprimez l'histoire d'utilisateur test en exécutant la commande à barre oblique /cleanupUserStories. Vous pouvez également supprimer ou désinstaller l'application. Lorsqu'elle est supprimée, l'application supprime toutes les histoires d'utilisateurs créées dans cet espace.

Résoudre les problèmes

Lorsqu'une application ou une fiche Google Chat renvoie une erreur, l'interface Chat affiche un message indiquant "Un problème est survenu" ou "Impossible de traiter votre demande". Il peut arriver que l'interface Chat n'affiche aucun message d'erreur, mais que l'application ou la fiche Chat génère un résultat inattendu. Par exemple, il est possible qu'un message de fiche ne s'affiche pas.

Bien qu'aucun message d'erreur ne s'affiche dans l'interface 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. Si vous avez besoin d'aide pour afficher, déboguer et corriger les erreurs, consultez Résoudre les erreurs Google Chat.

Effectuer un nettoyage

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

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

   Accéder à Resource Manager

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

Articles associés

• Répondre à des questions basées sur des conversations Chat avec l'application Gemini AI Chat
• Gérer les incidents à l'aide de Google Chat, Vertex AI et Apps Script