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

Ce tutoriel explique comment créer une application Google Chat qu'une équipe peut utiliser pour 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 d'un utilisateur à développer par l'équipe) et conserve les histoires dans une base de données Firestore.

  • Si vous mentionnez l'application de gestion de projet, elle vous proposera de l'aide.
    Figure 1. Charlie discute du développement de fonctionnalités dans un espace Chat avec son équipe. Lorsque vous mentionnez l'application Chat de gestion de projets, celle-ci propose de l'aide.
  • Utilisation de la commande slash /createUserStory pour créer une histoire.
    Figure 2 Charlie crée une histoire à l'aide de la commande slash /createUserStory.
  • L'application Chat de gestion de projets utilise Vertex AI pour rédiger la description de la story.
    Figure 3. L'application Chat de gestion de projet utilise Vertex AI pour rédiger la description de l'histoire, puis la partage dans l'espace.
  • Charlie finalise les détails de l'histoire.
    Figure 4. Charlie clique sur Modifier pour finaliser les détails de l'histoire. La description de l'IA est exacte, mais Charlie veut plus de détails. Il clique donc sur Développer pour que Vertex AI ajoute des exigences à la description de l'histoire. Charlie attribue l'histoire à elle-même, définit son état sur "Débuté", sélectionne une priorité et une taille appropriées, puis clique sur Enregistrer.
  • Gérer toutes les histoires d’utilisateurs de l'équipe.
    Figure 5 Charlie peut à tout moment consulter et gérer toutes les histoires d'utilisateurs de l'équipe à l'aide de la /manageUserStoriescommande slash
    .

Prérequis

Objectifs

  • Créez une application Chat qui gère des projets logiciels agiles.
  • Aidez les utilisateurs à rédiger des histoires d'utilisateurs grâce à des outils d'écriture d'histoires assistés par l'IA générative, optimisés par Vertex AI :
    • Générer et régénérer des descriptions de stories
    • Développez les descriptions des histoires à partir des notes pour répondre aux exigences.
    • Corriger la grammaire pour corriger les fautes de frappe.
  • Tenez votre travail à jour en écrivant dans une base de données Firestore et en y lisant des données.
  • 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 projet 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 projet utilise l'API Chat pour recevoir et répondre aux événements d'interaction envoyés par Chat, et pour configurer les attributs qui déterminent son apparence dans Chat, comme le nom et l'image de l'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 rédiger les titres et les descriptions des 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 : un service de calcul sans serveur léger qui vous permet de créer des fonctions autonomes à usage unique qui répondent aux événements d'interaction Chat sans avoir à gérer de serveur ni d'environnement d'exécution. L'application Google Chat de gestion de projet utilise Cloud Functions pour héberger le point de terminaison HTTP auquel Chat envoie des événements d'interaction et comme plate-forme de calcul pour exécuter la logique qui traite et répond à ces événements.

    Cloud Functions utilise les produits Google Cloud suivants pour créer et traiter les é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 builds automatisés.
    • Pub/Sub : service de messagerie asynchrone et évolutif qui dissocie les services qui produisent des messages des services qui traitent ces messages.
    • API Cloud Run Admin : environnement entièrement géré permettant d'exécuter des applications conteneurisées.

Architecture

L'architecture de l'application Google Chat de gestion de projets reçoit et traite les événements d'interaction avec Chat au niveau d'un point de terminaison HTTP, utilise Vertex AI pour faciliter la rédaction 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.

Schéma de l'architecture de l'application Google Chat de gestion de projet

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

  1. Un utilisateur envoie un message dans Chat et appelle l'application Google Chat de gestion de projet en lui envoyant un message directement, en la mentionnant dans un espace ou en saisissant une commande slash.

  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 projet traite la requête HTTP:

    1. Vertex AI vous aide à rédiger ou à mettre à jour une histoire d'utilisateur.

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

  4. Cloud Functions renvoie une réponse HTTP à Chat, qui l'affiche 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 > IAM et administration > Créer un projet.

    Accéder à "Créer un projet"

  2. Dans le champ Project Name (Nom du projet), saisissez un nom descriptif pour votre projet.

    Facultatif : Pour modifier l'ID de projet, cliquez sur Modifier. Une fois le projet créé, vous ne pourrez plus modifier l'ID. Choisissez-en donc un qui répond à vos besoins pour toute la durée de vie du projet.

  3. Dans le champ Emplacement, cliquez sur Parcourir pour afficher les emplacements potentiels de 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.

CLI gcloud

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 gcloud CLI déjà configuré, activez Cloud Shell.
    Activer Cloud Shell
  • Shell local : pour utiliser un environnement de développement local, installez et initialisez 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  > Facturation > Mes projets.

    Accéder à la page "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 (), cliquez sur Modifier la facturation, puis sélectionnez le compte de facturation Cloud.
  4. Cliquez sur Définir le compte.

CLI gcloud

  1. Pour lister les 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 de projet 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

console Google Cloud

  1. Dans la console Google Cloud, activez l'API Google Chat, l'API Vertex AI, l'API Cloud Functions, l'API Firestore, l'API Cloud Build, l'API Pub/Sub et l'API Cloud Run Admin.

    Activer les API

  2. Vérifiez 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.

CLI gcloud

  1. Si nécessaire, définissez le projet Cloud actuel sur celui que vous avez créé avec la commande gcloud config set project:

    gcloud config set project PROJECT_ID

    Remplacez PROJECT_ID par l'ID de projet du projet Cloud que vous avez créé.

  2. Activez l'API Google Chat, l'API Vertex AI, l'API Cloud Functions, l'API Firestore, l'API Cloud Build, l'API Pub/Sub et l'API Cloud Run Admin avec la commande gcloud services enable :

    gcloud services enable chat.googleapis.com \
aiplatform.googleapis.com \
cloudfunctions.googleapis.com \
firestore.googleapis.com \
cloudbuild.googleapis.com \
pubsub.googleapis.com \
run.googleapis.com

    Les API Cloud Build, Pub/Sub et Cloud Run Admin sont des prérequis pour Cloud Functions.

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 un environnement de production, il est généralement recommandé de create 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 effectuer les opérations suivantes:

  1. Créez une base de données Firestore dans laquelle conserver et récupérer les histoires d'utilisateurs.
  2. Vous pouvez également examiner 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'utilisateurs, mais vous ne définirez 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 projet utilise un modèle de données NoSQL basé sur des documents organisés en collections . Pour en savoir plus, consultez la section Modèle de données Firestore.

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

Modèle de données de la base de données Firestore.

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 dans la sous-collection userStories, et chaque utilisateur est représenté par un document dans la sous-collection users.

Afficher les définitions de collection, de document et de champ

spaces

Espaces dans lesquels l'application Chat a créé des stories.

Champs
Document IDString
Identifiant unique d'un espace spécifique dans lequel des stories sont créées. Correspond au nom de la ressource de l'espace dans l'API Chat.
userStoriesSubcollection of Documents (userStories)
Histoires créées par l'application Chat et ses utilisateurs. Correspond à l'Document ID d'un userStories dans Firebase.
usersSubcollection of Documents (user)
Utilisateurs qui ont créé des histoires ou à qui elles leur sont attribuées.
displayNameString
Nom à afficher de l'espace dans l'API Chat. Non défini pour les messages privés échangés avec les utilisateurs.

userStories

Stories créées par l'application Chat et ses utilisateurs

Champs
Document IDString
Identifiant unique d'une histoire d'utilisateur spécifique créée par l'application Chat et ses utilisateurs.
assigneeDocument (user)
Nom de la ressource de l'utilisateur affecté à la création de l'histoire. Correspond au Document ID du document users et au nom de la ressource d'un utilisateur dans l'API Chat.
descriptionString
Une description de la fonctionnalité logicielle du point de vue de l'utilisateur.
priorityEnum
L'urgence avec laquelle accomplir la tâche. Les valeurs possibles sont Low, Medium ou High.
sizeEnum
Quantité de travail. Les valeurs possibles sont Small, Medium ou Large.
statusEnum
Phase de travail. Les valeurs possibles sont OPEN, STARTED ou COMPLETED.
titleString
Titre de l'histoire : bref résumé.

users

Utilisateurs qui ont créé des histoires ou à qui des histoires ont été attribuées.

Champs
Document IDString
Identifiant unique d'un utilisateur spécifique. Correspond à l'assignee d'un userStories dans Firebase et au nom de ressource d'un utilisateur dans l'API Chat.
avatarUrlString
URL hébergeant l'image de l'avatar Chat de l'utilisateur.
displayNameString
Nom à afficher de l'utilisateur dans Chat.

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

console Google Cloud

  1. Dans Google Cloud Console, accédez à Cloud Firestore. Cliquez sur Menu > Firestore.

    Accéder à Firestore

  2. Cliquez sur Créer une base de données.

  3. Dans Sélectionner le mode Firestore, cliquez sur Mode natif.

  4. Cliquez sur Continuer.

  5. Configurez la base de données:

    1. Dans Nommer votre base de données, laissez l'ID de base de données sur (default).

    2. Dans Type d'emplacement, spécifiez une région pour votre base de données, par exemple us-central1. Pour de meilleures performances, sélectionnez le même emplacement que la fonction Cloud de l'application Chat ou un emplacement à proximité.

  6. Cliquez sur Créer une base de données.

CLI gcloud

  • Créez une base de données Firestore en mode natif à l'aide de la commande gcloud firestore databases create:

    gcloud firestore databases create \
--location=LOCATION \
--type=firestore-native

    Remplacez LOCATION par le nom d'une région Firestore, telle que us-central1.

Examiner l'exemple de code

Avant de créer la fonction Cloud, vous pouvez prendre 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 chacun d'eux :

env.js
Variables de configuration de l'environnement pour 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 de 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 à partir de la requête HTTP, appelle le gestionnaire d'application et publie la réponse HTTP en tant qu'objet JSON.
controllers/app.js
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 la fiche, elle appelle app-action-handler.js.
controllers/app-action-handler.js
La logique d'application pour gérer les événements d'interaction avec le chat de clic sur une fiche.
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écifiques à 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. Ils définissent le modèle de données pour la base de données Firestore.
views/*.js
Chaque fichier de ce répertoire instancie un objet de fiche que l'application Chat renvoie ensuite à Chat en tant que message de fiche ou réponse à une 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 fiches dans le répertoire views/.
test/**/*.test.js
Chaque fichier de ce répertoire et de ses sous-répertoires contient les tests unitaires de la fonction, du contrôleur, du service, de la vue ou du widget correspondant. 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 Chat. Lors de l'exécution, le code de la fonction Cloud traite l'événement et renvoie une réponse à Chat, que Chat affiche sous la forme d'un message, d'une boîte de dialogue ou d'un autre type d'interaction utilisateur. Le cas échéant, la fonction Cloud lit ou écrit également dans la base de données Firestore.

Pour créer la fonction Cloud :

console Google Cloud

  1. Téléchargez le code depuis GitHub sous forme de fichier ZIP.

    Télécharger le fichier ZIP

  2. Décompressez le fichier ZIP téléchargé.

    Le dossier extrait contient l'intégralité du dépôt d'exemples Google Workspace.

  3. Dans le dossier extrait, accédez à google-chat-samples-main/node/project-management-app/, puis compressez le dossier project-management-app dans un fichier ZIP.

    Le répertoire racine du fichier ZIP doit contenir les fichiers et dossiers suivants :

    • env.js
    • README.md
    • gcloudignore.text
    • package-lock.json
    • package.json
    • index.js
    • model/
    • controllers/
    • views/
    • services/

  4. Dans la console Google Cloud, accédez à la page Cloud Functions.

    Accéder à Cloud Functions

    Assurez-vous que le projet Google Cloud de votre application Chat est sélectionné.

  5. Cliquez sur Créer une fonction.

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

    1. Dans Environnement, sélectionnez Fonction Cloud Run.
    2. Dans le champ Nom de la fonction, saisissez project-management-tutorial.
    3. Dans Région, sélectionnez une région.
    4. Sous Authentification, cochez Autoriser les appels non authentifiés.
    5. Cliquez sur Suivant.

  7. Dans Environnement d'exécution, sélectionnez Node.js 20.

  8. Dans le champ Point d'entrée, supprimez le texte par défaut et saisissez projectManagementChatApp.

  9. Dans Code source, sélectionnez Importation de fichier ZIP.

  10. Dans Bucket de destination, create ou sélectionnez un bucket:

    1. Cliquez sur Parcourir.
    2. Choisissez un bucket.
    3. Cliquez sur Sélectionner.

    Google Cloud importe le fichier ZIP dans ce bucket et les extrait. Cloud Functions copie ensuite les fichiers des composants dans la fonction Cloud.

  11. Dans Fichier ZIP, importez le fichier ZIP que vous avez téléchargé à partir de GitHub, extrait et recompressé:

    1. Cliquez sur Parcourir.
    2. Accédez au fichier ZIP et sélectionnez-le.
    3. Cliquez sur Open (Ouvrir).

  12. Cliquez sur Déployer.

    La page Informations sur Cloud Functions s'ouvre, et votre fonction s'affiche avec deux indicateurs de progression : un pour la compilation et un pour le service. Lorsque les deux indicateurs de progression disparaissent et sont remplacés par une coche, votre fonction est déployée et prête.

  13. Modifiez l'exemple de code pour définir des constantes:

    1. Sur la page Détails de la fonction Cloud, cliquez sur Modifier.
    2. Cliquez sur Suivant.
    3. Dans Code source, sélectionnez Éditeur intégré.
    4. Dans l'éditeur intégré, ouvrez le fichier env.js.
    5. Remplacez project-id par l'ID de votre projet Cloud.
    6. Facultatif: Remplacez us-central1 par un emplacement compatible pour votre fonction Cloud.

  14. Cliquez sur Déployer.

  15. Une fois le déploiement de la fonction terminé, copiez l'URL du déclencheur:

    1. Sur la page Détails de la fonction, cliquez sur Déclencheur.
    2. Copiez l'URL. Vous en aurez besoin pour configurer l'application Chat dans la section suivante.

CLI gcloud

  1. Clonez le code depuis GitHub :

    git clone https://github.com/googleworkspace/google-chat-samples.git

  2. Accédez au répertoire contenant le code de cette application Chat de gestion de projets:

    cd google-chat-samples/node/project-management-app

  3. Modifiez le fichier env.js pour définir les variables d'environnement:

    1. Remplacez project-id par l'ID de votre projet Google Cloud.
    2. Remplacez us-central1 par l'emplacement de votre projet Google Cloud.

  4. Déployez la fonction Cloud dans Google Cloud :

    gcloud functions deploy project-management-tutorial \
--gen2 \
--region=REGION \
--runtime=nodejs20 \
--source=. \
--entry-point=projectManagementChatApp \
--trigger-http \
--allow-unauthenticated

    Remplacez REGION par un emplacement Cloud Functions où son infrastructure est hébergée, par exemple us-central1.

  1. Une fois le déploiement de la fonction terminé, copiez la propriété url à partir 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 le nom de l'application Chat, les commandes slash compatibles et l'URL de déclenchement 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 > Autres 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 le champ URL de l'avatar, saisissez https://developers.google.com/chat/images/quickstart-app-avatar.png.

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

  5. Cliquez sur le bouton Activer les fonctionnalités interactives pour l'activer.

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

  7. Sous Paramètres de connexion, sélectionnez URL du point de terminaison HTTP.

  8. Dans URL du point de terminaison HTTP, collez l'URL du déclencheur que vous avez copiée dans le déploiement de Cloud Functions, au format https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial. Si vous avez déployé la fonction Cloud avec la CLI gcloud, 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, puis 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éez une histoire avec le titre spécifié. Désélectionné
      /myUserStories 2 Répertorie toutes les stories attribuées à l'utilisateur. Désélectionné
      /userStory 3 Indique l'état actuel de la story spécifiée. Désélectionné
      /manageUserStories 4 Ouvre une boîte de dialogue permettant de modifier les stories. Sélectionné
      /cleanupUserStories 5 Supprime tous les articles de l'espace. Désélectionné

  10. Sous Visibilité, sélectionnez Rendre cette application de chat accessible à certains utilisateurs et groupes de votre domaine Workspace, puis saisissez votre adresse e-mail.

  11. Facultatif : Sous Journaux, sélectionnez Journaliser les erreurs dans Logging.

  12. Cliquez sur Enregistrer. Un message indiquant que la configuration a été enregistrée s'affiche, ce qui signifie que l'application Chat est prête à être testée.

Tester l'application Chat

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

  1. Ouvrez Google Chat avec le 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é avec l'application, saisissez Hello, puis appuyez sur enter. L'application Chat de gestion de projet répond par un menu d'aide détaillant ce qu'elle peut faire.
  6. Pour créer une histoire, saisissez /createUserStory Test story dans la barre de message et envoyez-la. L'application Chat de gestion de projet répond par un message 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 qu'elle a créés concernant l'espace auquel 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. Vous pouvez également cliquer sur Modifier pour modifier l'histoire. Lorsque vous êtes satisfait de l'histoire, cliquez sur Enregistrer.
  10. Testez chaque commande slash 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 /cleanupUserStories slash. Vous pouvez également supprimer ou désinstaller l'application. Une fois 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 le message "Un problème est survenu". ou "Impossible de traiter votre demande". Parfois, l'UI Chat n'affiche aucun message d'erreur, mais que l'application ou la fiche Chat produit un résultat inattendu (par exemple, un message de fiche ne s'affiche pas).

Bien qu'un message d'erreur ne s'affiche pas dans l'UI Chat, des messages d'erreur descriptifs et des données de journal sont disponibles pour vous aider à résoudre les erreurs lorsque la journalisation des erreurs pour les applications Chat est activée. Pour obtenir de l'aide concernant l'affichage, le débogage et la correction des erreurs, consultez Dépanner et corriger les erreurs dans Google Chat.

Effectuer un nettoyage

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.

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

    Accédez 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.