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
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 (représentant les caractéristiques d'un
système logiciel du point de vue d’un utilisateur pour que l’équipe puisse le développer) et
mais conserve les histoires
dans une base de données Firestore.
<ph type="x-smartling-placeholder"></ph>
Figure 1. Charlie discute avec son équipe du développement de fonctionnalités dans un espace Chat. Lorsque vous mentionnez l'application Chat de gestion de projets, celle-ci propose de l'aide.
Figure 2 : Charlie crée une histoire à l'aide de la commande à barre oblique /createUserStory.
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.
Figure 4 : Charlie clique sur Modifier pour finaliser les détails de l'histoire. La description fournie par l'IA est exacte, mais Charlie souhaite obtenir plus d'informations. Charlie clique donc sur Développer pour que Vertex AI ajoute des exigences à la description de l'histoire. Charlie se voit attribuer l'histoire, définit l'état sur "Commencer", sélectionne une priorité et une taille appropriées, puis clique sur Enregistrer.
Figure 5 : Charlie peut consulter et gérer à tout moment toutes les histoires d'utilisateurs de l'équipe à l'aide de la commande à barre oblique /manageUserStories.
Créer une application Chat qui gère des logiciels agiles
projets.
Aider les utilisateurs à rédiger des histoires d'utilisateurs grâce à l'IA
Outils de rédaction de récits assistés par l'IA et fournis par Vertex AI:
<ph type="x-smartling-placeholder">
</ph>
Générer et regénérer des descriptions de récit
Étendez les descriptions de l'histoire à partir des notes pour compléter les exigences.
Corriger la grammaire pour corriger les fautes de frappe.
Maintenez votre travail à jour en écrivant et en lisant des données dans une base de données Firestore.
Facilitez la collaboration dans un espace Chat en permettant aux utilisateurs
Créez, modifiez, attribuez et commencez des stories directement depuis la conversation.
Produits utilisés
L'application de gestion de projets utilise les applications Google Workspace et
Produits Google Cloud:
API Chat:
API permettant de développer des applications Google Chat qui reçoivent des messages et y répondent
Événements d'interaction avec le chat, comme les messages La gestion de projet
L'application Google Chat utilise l'API Chat pour recevoir des messages et y répondre
aux événements d'interaction envoyés par Chat et à configurer des attributs
déterminent la façon dont il apparaît dans Chat, comme le nom et l'image de l'avatar.
API Vertex AI:
Plate-forme d'IA générative. La gestion de projet
L'application Google Chat utilise l'API Vertex AI pour rédiger un récit utilisateur
titres et descriptions.
Firestore:
Base de données de documents sans serveur La gestion de projet
L'application Google Chat utilise Firebase pour stocker des données sur des 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 peuvent répondre à Chat
d'interaction sans avoir à gérer de serveur ni d'environnement d'exécution. La
L'application Google Chat de gestion de projets utilise Cloud Functions pour
hébergent le point de terminaison HTTP auquel Chat envoie les événements d'interaction
Compute Engine 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 les événements d'interaction et héberger les 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 génèrent des messages provenant
de services qui les traitent.
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 projet reçoit et
traite les événements d'interaction avec Chat sur un point de terminaison HTTP, utilise Vertex AI pour aider
écrire des histoires d'utilisateurs et en stockera les détails dans une base de données Firestore. La
le schéma suivant illustre l'architecture
ressources Google Cloud utilisées.
L'application de gestion de projet Google Chat fonctionne comme suit:
Un utilisateur envoie un message dans Chat et appelle la
dans l'application Google Chat de gestion de projets, par message
directement, en le mentionnant dans un espace ou
en saisissant une commande à barre oblique.
Chat envoie une requête HTTP synchrone au service
point de terminaison HTTP.
L'application de gestion de projet Google Chat traite le protocole HTTP
requête:
Vertex AI vous aide à rédiger ou à mettre à jour une histoire d'utilisateur.
Une base de données Firestore stocke, récupère, met à jour ou supprime une histoire d'utilisateur
données.
Cloud Functions renvoie à Chat une réponse HTTP,
l'affiche sous forme de message ou de boîte de dialogue.
Préparer l'environnement
Cette section explique comment créer et configurer un projet Google Cloud pour le
Application Chat
Dans la console Google Cloud, activez l'API Google Chat, l'API Vertex AI,
les API Cloud Functions, Firestore, Cloud Build
l'API Pub/Sub et l'API Cloud Run Admin.
Vérifiez que vous activez les API au bon endroit
Google Cloud, puis cliquez sur Suivant.
Vérifiez que vous activez les API appropriées, puis cliquez sur Activer.
CLI gcloud
Si nécessaire, définissez le projet Cloud actuel sur celui
créé avec la commande gcloud config set project:
gcloudconfigsetprojectPROJECT_ID
Remplacez PROJECT_ID par l'ID de projet de
Google Cloud que vous avez créé.
activer 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 à l'aide de la commande gcloud services enable:
Les API Cloud Build, Pub/Sub et Cloud Run Admin sont indispensables
Cloud Functions.
Authentification et autorisation
Aucune configuration d'authentification et d'autorisation n'est nécessaire pour suivre cette
tutoriel.
Pour appeler les API Firestore et Vertex AI, ce tutoriel utilise
Identifiants par défaut de l'application
avec le compte de service par défaut associé à la fonction Cloud que vous
vous n'avez pas besoin de configurer. Dans un environnement de production,
généralement
créer
et
joindre
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
suivantes:
Créer une base de données Firestore dans laquelle conserver et récupérer des histoires d'utilisateurs
Si vous le souhaitez, examinez l'exemple de code.
Créer une fonction Cloud pour héberger et exécuter le
Code de l'application Chat en réponse à des événements
reçues de Chat en tant que requêtes HTTP.
Créer et déployer une application Google Chat sur l'API Google Chat
page de configuration.
Créer la base de données Firestore
Dans cette section, vous allez créer une base de données Firestore pour la persistance et la récupération
des histoires d’utilisateurs, 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 model/user-story.js et model/user.js
.
La base de données de l'application Chat de gestion de projet utilise une base de données NoSQL
de données basé sur
classdocuments
organisées en
collections_bookmarkcollections. Pour en savoir plus, consultez
Modèle de données Firestore.
Le schéma suivant présente la gestion de projet
Modèle de données de l'application Google Chat:
La collection racine est spaces, où chaque document représente un espace que le
L'application Chat a créé des stories. Chaque histoire
d’utilisateur est
représenté par un document de la sous-collection userStories, et chaque utilisateur est
représentée par un document de 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 ID
String ID unique d'un espace spécifique où sont créées des histoires. Correspond au nom de ressource de l'espace dans l'API Chat.
userStories
Subcollection of Documents (userStories) Les stories créées par l'application Chat et ses utilisateurs Correspond au Document ID d'un userStories dans Firebase.
users
Subcollection of Documents (user) Utilisateurs qui ont créé des histoires ou à qui elles leur sont attribuées.
displayName
String 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 ID
String ID unique d'une histoire d'utilisateur spécifique créée par l'application Chat et ses utilisateurs.
assignee
Document (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.
description
String Description de la fonctionnalité logicielle du point de vue de l'utilisateur.
priority
Enum L'urgence à accomplir le travail. Les valeurs possibles sont Low, Medium ou High.
size
Enum La quantité de travail. Les valeurs possibles sont Small, Medium ou Large.
status
Enum Phase de travail. Les valeurs possibles sont OPEN, STARTED ou COMPLETED.
title
String Titre de la story un bref résumé.
users
Utilisateurs qui ont créé ou auquel des histoires sont attribuées.
Champs
Document ID
String Identifiant unique d'un utilisateur spécifique. Correspond au assignee d'un userStories dans Firebase et au nom de la ressource d'un utilisateur dans l'API Chat.
avatarUrl
String URL hébergeant l'avatar de l'utilisateur dans Chat.
displayName
String Nom à afficher Chat de l'utilisateur.
Voici comment créer la base de données Firestore:
console Google Cloud
Dans Google Cloud Console, accédez à Cloud Firestore. Cliquez sur
Menumenu>Firestore.
Dans Sélectionner le mode Firestore, cliquez sur Mode natif.
Cliquez sur Continuer.
Configurez la base de données:
Dans le champ Attribuer un nom à la base de données, laissez le champ ID de base de données défini sur (default).
Dans Type d'emplacement, spécifiez une région pour votre base de données, telle que
us-central1 Pour de meilleures performances, sélectionnez "Identique" ou "À proximité"
en tant que fonction Cloud de l'application Chat.
Cliquez sur Créer une base de données.
CLI gcloud
Créez une base de données Firestore en mode natif avec la
Commande gcloud firestore databases create:
Les variables de configuration d'environnement permettant de déployer le
Application de chat avec un projet Google Cloud spécifié et
dans la même région. 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 la
Événement de chat de
la requête HTTP, appelle le gestionnaire de l'application et publie la réponse HTTP sous forme de
JSON.
controllers/app.js
La logique d'application principale. Traite le
événements d'interaction en gérant
Mentions et commandes à barre oblique de l'application Chat
Pour répondre aux clics sur la fiche, elle appelle app-action-handler.js.
services/space-service.js, services/user-service.js et services/user-story-service.js
Ce fichier contient les différentes parties
la logique d'application spécifique aux espaces Chat,
les utilisateurs et
les 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 dans
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
Elle appelle l'API Vertex AI pour le texte d'IA générative
de la prédiction.
model/*.js
Ces fichiers contiennent la définition des classes et des énumérations que l'application
les services utilisent pour stocker et transmettre
des données entre les fonctions. Ils définissent le
pour la base de données Firestore.
Chaque fichier est instancié
un type de 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 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 les
la logique d'application de l'application Chat de gestion de projets.
La fonction Cloud s'exécute en réponse
à une requête HTTP de Chat contenant un objet Chat
d'interaction. Lorsqu'il est exécuté, le code de la fonction Cloud traite l'événement et
renvoie à Chat une réponse qui s'affiche sous la forme
message, boîte de dialogue ou autre type d'interaction utilisateur. Le cas échéant, le service
La fonction lit également la base de données Firestore ou y écrit des données.
Voici comment créer la fonction Cloud:
console Google Cloud
Téléchargez le code depuis GitHub sous forme de fichier ZIP.
Le dossier extrait contient l'intégralité des exemples Google Workspace.
un dépôt de clés.
Dans le dossier extrait, accédez à
google-chat-samples-main/node/project-management-app/, puis compresser
le dossier project-management-app dans un fichier ZIP.
Le répertoire racine du fichier ZIP doit contenir les éléments suivants :
fichiers et dossiers:
env.js
README.md
gcloudignore.text
package-lock.json
package.json
index.js
model/
controllers/
views/
services/
Dans la console Google Cloud, accédez à la page Cloud Functions.
Assurez-vous que le projet Google Cloud de votre
L'application Chat est sélectionnée.
Cliquez sur add_boxCréer une fonction.
Sur la page Créer une fonction, configurez votre fonction:
Dans Environnement, sélectionnez 2e génération.
Dans Nom de la fonction, saisissez project-management-tutorial.
Dans Région, sélectionnez une région.
Sous Authentification, sélectionnez
Autorisez les appels non authentifiés.
Cliquez sur Suivant.
Dans Environnement d'exécution, sélectionnez Node.js 20.
Dans Point d'entrée, supprimez le texte par défaut et saisissez
projectManagementChatApp
Dans Code source, sélectionnez Importation de fichier ZIP.
Dans Bucket de destination :
create
ou sélectionnez un bucket:
Cliquez sur Parcourir.
Choisissez un bucket.
Cliquez sur Sélectionner.
Google Cloud importe le fichier ZIP dans les fichiers des composants et les extrait
dans ce bucket. Cloud Functions copie ensuite les fichiers des composants
la fonction Cloud.
Dans Fichier ZIP, importez le fichier ZIP que vous avez téléchargé depuis GitHub.
extraites et recompressées:
Cliquez sur Parcourir.
Accédez au fichier ZIP et sélectionnez-le.
Cliquez sur Open (Ouvrir).
Cliquez sur Déployer.
La page Détails de Cloud Functions s'ouvre, et votre fonction s'affiche.
avec deux indicateurs de progression: un pour la compilation et l'autre 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.
Modifiez l'exemple de code pour définir des constantes:
Sur la page Détails de la fonction Cloud, cliquez sur Modifier.
Cliquez sur Suivant.
Dans Code source, sélectionnez Éditeur intégré.
Dans l'éditeur intégré, ouvrez le fichier env.js.
Remplacez project-id par l'ID de votre projet Cloud.
Facultatif: Mettez à jour us-central1 avec un
localisation disponible
pour votre fonction Cloud.
Cliquez sur Déployer.
Une fois le déploiement de la fonction terminé, copiez l'URL du déclencheur:
Sur la page Informations sur la fonction, cliquez sur Déclencheur.
Copiez l'URL. Vous en avez besoin pour configurer
l'application Chat dans la section suivante.
Une fois le déploiement de la fonction terminé, copiez la propriété url à partir de
de réponse. Il s'agit de l'URL de déclenchement 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 le
la console Google Cloud avec des informations sur votre application Chat,
y compris le nom de l'application Chat, la barre oblique acceptée
et l'URL de déclencheur du cloud de l'application Chat
Fonction à laquelle envoie des événements d'interaction Chat.
Dans la console Google Cloud, cliquez sur Menu.
menu>Autres produits>Google Workspace>Bibliothèque de produits>API Google Chat>Gérer>Configuration.
Dans le champ Nom de l'application, saisissez Project Manager.
Dans le champ URL de l'avatar, saisissez https://developers.google.com/chat/images/quickstart-app-avatar.png.
Dans Description, saisissez Manages projects with user stories..
Activez l'option Activer les fonctionnalités interactives.
Sous Fonctionnalité, sélectionnez Recevoir des messages privés, Rejoindre des espaces et des conversations de groupe.
Sous Paramètres de connexion, sélectionnez URL de l'application.
Dans URL de l'application, collez l'URL de déclencheur que vous avez copiée depuis le cloud
de Cloud Functions, au format suivant :
https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial
Si vous avez déployé la fonction Cloud avec la gcloud CLI, il s'agit du url
.
Enregistrer l'activité de l'application Chat
commandes à barre oblique. Pour enregistrer une commande à barre oblique:
Sous Commandes à barre oblique, cliquez sur Ajouter une commande à barre oblique.
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 Opens a dialog (Ouvre une boîte de dialogue), puis cliquez sur Done (OK) :
Nom
ID de commande
Description
Ouvre une boîte de dialogue
/createUserStory
1
Crée une histoire avec le titre spécifié.
Désélectionné
/myUserStories
2
Liste toutes les histoires attribuées à l'utilisateur.
Désélectionné
/userStory
3
Affiche l'état actuel de l'histoire spécifiée.
Désélectionné
/manageUserStories
4
Ouvre une boîte de dialogue permettant de modifier les articles.
Sélectionné
/cleanupUserStories
5
Supprime tous les articles de l'espace.
Désélectionné
Sous Visibilité, sélectionnez
Rendre cette application Chat accessible à des personnes et groupes spécifiques de votre
domaine Workspace, puis saisissez votre adresse e-mail.
Si vous le souhaitez, sous Journaux, sélectionnez Consigner les erreurs dans Logging.
Cliquez sur Enregistrer. Un message de configuration enregistrée s'affiche.
L'application Chat est
prêts à être testés.
Tester l'application Chat
Tester l'application Chat de gestion de projet en lui envoyant un message
et en utilisant ses commandes à barre oblique pour créer,
modifier et supprimer des histoires d’utilisateur.
Ouvrez Google Chat à l'aide du compte Google Workspace que vous
fourni lorsque vous vous êtes ajouté en tant que testeur de confiance.
Dans le champ Ajouter une ou plusieurs personnes, saisissez le nom de votre
Application Chat
Sélectionnez votre application Chat dans les résultats. Un direct
message s'ouvre.
Dans le nouveau message privé avec l'application, saisissez Hello et
appuyez sur enter. La gestion de projet
L'application Chat répond par un menu d'aide détaillé
peut faire.
Pour créer une story, saisissez /createUserStory Test story dans le
dans la barre de message et envoyez-le. La gestion de projet
L'application de chat répond par un message de fiche détaillant les
qu'il crée pour vous à l'aide de l'IA générative de Vertex AI.
Dans la console, consultez la base de données Firestore pour examiner
qu'il a créés à propos de l'espace auquel vous avez ajouté
l'application de chat, les utilisateurs
qui ont interagi avec elle,
et l’histoire d’utilisateur
que vous avez créée.
Si vous souhaitez modifier l'histoire, cliquez sur Modifier. Lorsque vous êtes satisfait de
cliquez sur Enregistrer.
Testez chaque commande à barre oblique compatible avec l'application. Pour les afficher, saisissez
/ ou mentionnez l'application Chat.
Supprimez l'histoire d'utilisateur test en émettant le /cleanupUserStories.
commande à barre oblique. Par ailleurs,
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
card renvoie une erreur, la
L'interface Chat affiche le message "Une erreur s'est produite".
ou "Impossible de traiter votre demande." Parfois, l'interface utilisateur de Chat
n'affiche aucun message d'erreur, mais que l'application ou
la carte produit un résultat inattendu. Par exemple, un message de fiche peut ne pas
s'affichent.
Même s'il est possible qu'aucun message d'erreur ne s'affiche dans l'interface utilisateur de Chat,
Des messages d'erreur descriptifs et des données de journaux 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,
le débogage et la correction des erreurs, consultez
Résoudre les problèmes liés à Google Chat
Effectuer un nettoyage
Afin d'éviter que des frais ne soient facturés sur votre compte Google Cloud pour
utilisées dans ce tutoriel, nous vous recommandons de supprimer
Google Cloud.
Dans la console Google Cloud, accédez à la page Gérer les ressources. Cliquez sur
Menumenu>IAM et Administrateur>Gérer les ressources.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/08/22 (UTC).
[]
[]
{
"last_modified": "Dernière mise à jour le 2024/08/22 (UTC).",
"state": ""
}