Ce tutoriel explique comment créer une application Google Chat qui permet de gérer les incidents en temps réel. Pour répondre à un incident, l'application crée et remplit un espace Chat, facilite la gestion des incidents avec des messages, des commandes à barre oblique et des boîtes de dialogue, et utilise l'IA pour résumer la réponse à l'incident dans un document Google Docs.
Un incident est un événement qui nécessite l'attention immédiate d'une équipe de personnes à résoudre. Voici quelques exemples d'incidents:
- Création d'une demande urgente dans un système de gestion de la relation client (CRM) plate-forme, ce qui nécessite une équipe de service pour collaborer sur une résolution.
- Un système se déconnecte, ce qui alerte un groupe d'ingénieurs en fiabilité des sites (SRE). afin qu'ils puissent collaborer et le remettre en ligne.
- Un tremblement de terre de grande magnitude se produit et les services d'urgence ont besoin pour coordonner leur réponse.
Pour les besoins de ce tutoriel, l'alerte d'incident démarre lorsqu'un utilisateur signale l'incident en cliquant sur un bouton depuis une page Web. La page Web simule un incident en demandant aux utilisateurs de saisir des informations de base: titre, la description et les adresses e-mail des personnes interrogées.
Découvrez l'application Chat de gestion des incidents en action:
- <ph type="x-smartling-placeholder">
-
Figure 2 : Notification indiquant que l'espace Chat de l'incident a été créé -
Figure 3 : l'espace Chat de gestion des incidents -
Figure 4 : Résoudre l'incident à l'aide d'une commande à barre oblique. -
Figure 5 : Boîte de dialogue de résolution des incidents -
Figure 6 : Document Google Docs de résolution d'incident partagé dans l'espace -
Figure 7 : Document Google Docs sur la résolution des incidents liés à l'IA.
Prérequis
Si vous avez besoin d'activer l'un de ces prérequis pour votre organisation, contactez votre administrateur Google Workspace pour les activer:
- Une entreprise Un compte Google Workspace ayant accès à Google Chat :
- Pour avoir Annuaire (partage des contacts) activée pour Google Workspace. L'appli d'incident utilise l'annuaire pour consulter les informations sur les les coordonnées, comme son nom ; et votre adresse e-mail. Les personnes chargées de la réponse aux incidents doivent être des utilisateurs disposant d'une adresse e-mail Google Chat dans votre organisation Google Workspace.
Objectifs
- Créez une application Chat qui répond aux incidents.
- Voici comment aider les utilisateurs à faire face aux incidents:
<ph type="x-smartling-placeholder">
- </ph>
- Créer des espaces de réponse aux incidents
- Publier des messages résumant les incidents et les réponses.
- Favorisez la collaboration grâce aux Fonctionnalités de l'application Chat
- résumer des conversations et des solutions avec Vertex AI ;
Architecture
Le schéma suivant illustre l'architecture de Google Workspace Ressources Google Cloud utilisées par la réponse aux incidents Application Google Chat.
L'architecture montre comment la réponse aux incidents L'application Google Chat traite un incident et sa résolution.
Un utilisateur commence un incident à partir d’un site Web externe hébergé sur Apps Script.
Le site Web envoie une requête HTTP asynchrone au Application Google Chat, également hébergée sur Apps Script.
L'application Google Chat de gestion des incidents traite la requête:
Un membre d'équipe est ajouté au service SDK Admin d'Apps Script telles que l'ID utilisateur et l'adresse e-mail.
Avec un ensemble de requêtes HTTP envoyées à l'API Chat à l'aide de la méthode le service de chat avancé d'Apps Script, la gestion des incidents L'application Google Chat crée un incident Chat espace, le remplit avec des membres de l'équipe et envoie un message à l'espace.
Les membres de l'équipe discutent de l'incident dans l'espace Chat.
Un membre de l'équipe appelle une commande à barre oblique pour signaler une résolution au l'incident.
Appel HTTP vers l'API Chat à l'aide d'Apps Script Le service de chat avancé affiche la liste messages de l'espace.
Vertex AI reçoit les messages listés et génère un résumé.
Le service
DocumentApp
d'Apps Script crée un et ajoute le résumé de Vertex AI document.L'application Google Chat de gestion des incidents appelle API Chat pour envoyer un message partageant un lien vers le résumé Document Docs.
Préparer l'environnement
Cette section explique comment créer et configurer un projet Google Cloud pour le Application Chat
Créer un projet Google Cloud
console Google Cloud
- Dans la console Google Cloud, accédez au menu > IAM et Administrateur > Créer un projet. .
-
Dans le champ Nom du projet, saisissez un nom descriptif pour votre projet.
Facultatif: Pour modifier l'ID du projet, cliquez sur Modifier. Impossible de modifier l'ID du projet Une fois le projet créé, choisissez donc un ID qui répond à vos besoins pendant toute la durée de vie projet.
- Dans le champ Lieu, cliquez sur Parcourir pour afficher les emplacements potentiels de votre projet. Cliquez ensuite sur Sélectionner. <ph type="x-smartling-placeholder">
- 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 console CLI ("gcloud"):
-
Cloud Shell: pour utiliser un terminal en ligne avec la gcloud CLI
déjà configuré, activez Cloud Shell.
Activer Cloud Shell -
Shell local: pour utiliser un environnement de développement local,
installer et
initialiser
la gcloud CLI.
Pour créer un projet Cloud, utilisez la commande "gcloud projects create" :gcloud projects create PROJECT_ID
Activer la facturation pour le projet Cloud
<ph type="x-smartling-placeholder">console Google Cloud
- Dans la console Google Cloud, accédez à Facturation. Cliquez sur Menu > Facturation > Mes projets.
- Dans Sélectionner une organisation, choisissez l'organisation associée à votre projet Google Cloud.
- Sur la ligne du projet, ouvrez le menu Actions. ( ), cliquez sur Modifier la facturation, puis sélectionnez l'option Compte de facturation Cloud.
- Cliquez sur Définir le compte.
CLI gcloud
- Pour lister les comptes de facturation disponibles, exécutez la commande suivante:
gcloud billing accounts list
- 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
est l'ID de projet de la pour lequel vous souhaitez activer la facturation.BILLING_ACCOUNT_ID
est l'ID du compte de facturation à associer. le projet Google Cloud.
Activer les API
console Google Cloud
Dans la console Google Cloud, activez l'API Google Chat, l'API Google Docs l'API SDK Admin et l'API Vertex AI.
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 que vous avez créé à l'aide de la commande
gcloud config set project
:gcloud config set project PROJECT_ID
Remplacez PROJECT_ID par l'ID de projet de Google Cloud que vous avez créé.
Activer les API Google Chat, Google Docs, SDK Admin et Vertex AI à l'aide de la commande
gcloud services enable
:gcloud services enable chat.googleapis.com docs.googleapis.com admin.googleapis.com aiplatform.googleapis.com
Configurer l'authentification et l'autorisation
L'authentification et l'autorisation permettent au L'application Chat accède aux ressources dans Google Workspace et Google Cloud pour traiter les incidents.
Dans ce tutoriel, vous allez publier l'application en interne. Vous pouvez donc utiliser un espace réservé. des informations. Avant de publier l'application en externe, remplacez l'espace réservé avec des informations réelles pour l'écran de consentement.
Dans la console Google Cloud, accédez à Menu > API et Services > Écran de consentement OAuth.
Sous Type d'utilisateur, sélectionnez Interne, puis cliquez sur Créer.
Dans le champ Nom de l'application, saisissez
Incident Management
.Dans Adresse e-mail d'assistance utilisateur, sélectionnez votre adresse e-mail ou une adresse Google Groupes.
Sous Coordonnées du développeur, saisissez votre adresse e-mail.
Cliquez sur Enregistrer et continuer.
Cliquez sur Ajouter ou supprimer des habilitations. Un panneau contenant la liste des champs d'application s'affiche pour chaque API activée dans votre projet Cloud.
Sous Ajouter manuellement des champs d'application, collez les champs d'application suivants:
https://www.googleapis.com/auth/chat.spaces.create
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.app
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/admin.directory.user.readonly
https://www.googleapis.com/auth/script.external_request
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/cloud-platform
Cliquez sur Add to Table (Ajouter à la table).
Cliquez sur Mettre à jour.
Cliquez sur Enregistrer et continuer.
Consultez le récapitulatif d'enregistrement de l'application, puis cliquez sur Retour au tableau de bord.
Créer et déployer l'application Chat
Dans la section suivante, vous allez copier et mettre à jour Projet Apps Script contenant toutes les applications pour votre application Chat. Il n'est donc pas nécessaire de copier et coller chaque fichier.
Certaines fonctions incluent des traits de soulignement à la fin de leur nom, comme
processSlashCommand_()
de ChatApp.gs
. Le trait de soulignement
masque la fonction
depuis la page Web d'initialisation de l'incident
lorsqu'il est ouvert dans un navigateur. Pour plus
pour en savoir plus, consultez
Fonctions privées.
Apps Script prend en charge deux types de fichiers : les scripts .gs
et .html
.
. Pour respecter cette prise en charge, le code JavaScript côté client de l'application est inclus
dans les balises <script />
et son code CSS est inclus dans les balises <style />
à l'intérieur
un fichier HTML.
Vous pouvez éventuellement afficher l'intégralité du projet sur GitHub.
Voici un aperçu de chaque fichier:
Consts.gs
Définit les constantes référencées par d'autres fichiers de code, y compris l'ID de votre projet Cloud, l'ID d'emplacement Vertex AI et pour fermer un incident.
Afficher le code
Consts.gs
ChatApp.gs
Gère les événements d'interaction Chat, y compris les messages, les clics sur les fiches, les commandes à barre oblique et les boîtes de dialogue. Répond aux Commande à barre oblique
/closeIncident
en ouvrant une boîte de dialogue pour rassembler les incidents détails de la résolution. Lit les messages dans l'espace en appelant la méthodespaces.messages.list
de l'API Chat. Récupère les ID utilisateur à l'aide du service d'annuaire du SDK Admin dans Apps Script.Afficher le code
ChatApp.gs
ChatSpaceCreator.gs
Reçoit les données de formulaire saisies par les utilisateurs concernant l'incident d'initialisation, et l'utilise pour configurer un chat en créant et en renseignant un espace, puis en publiant un message l'incident.
Afficher le code
ChatSpaceCreator.gs
DocsApi.gs
Appelle l'API Google Docs pour créer un document Google Docs dans un dans le Google Drive de l'utilisateur et rédige un résumé des informations sur l'incident, (créée dans
VertexAiApi.gs
) au document.Afficher le code
DocsApi.gs
VertexAiApi.gs
Résume la conversation dans le chat à l'aide de Vertex AI. Ce résumé est publié dans un espace document dans
DocsAPI.gs
.Afficher le code
VertexAiApi.gs
WebController.gs
diffuse le site Web d'initialisation de l'incident.
Afficher le code
WebController.gs
Index.html
Code HTML constituant le site Web d'initialisation de l'incident.
Afficher le code
Index.html
JavaScript.html
Gère le comportement des formulaires, y compris les envois, les erreurs et les effacer pour le site Web d'initialisation de l'incident. Inclus dans
Index.html
par la fonctioninclude
personnalisée deWebController.gs
.Afficher le code
JavaScript.html
Stylesheet.html
CSS pour le site Web d'initialisation de l'incident Il est incluses dans
Index.html
par la fonctioninclude
personnalisée dansWebController.gs
Afficher le code
Stylesheet.html
Trouver votre numéro et votre ID de projet Cloud
Dans la console Google Cloud, accédez à votre projet Cloud.
Cliquez sur Paramètres et utilitaires . > Paramètres du projet.
Notez les valeurs des champs Numéro du projet et ID du projet. Toi utilisez-les dans les sections suivantes.
Créer le projet Apps Script
Pour créer un projet Apps Script et l'associer à votre Cloud:
- Cliquez sur le bouton suivant pour ouvrir le projet Apps Script Répondre aux incidents avec Google Chat.
Ouvrir le projet - Cliquez sur Vue d'ensemble.
- Sur la page "Vue d'ensemble", cliquez sur Créer une copie .
Nommez votre copie du projet Apps Script:
Cliquez sur Copie de Répondre aux incidents avec Google Chat.
Dans Titre du projet, saisissez
Incident Management Chat app
.Cliquez sur Renommer.
Dans votre copie du projet Apps Script, accédez à
Consts.gs
et remplacezYOUR_PROJECT_ID
par l'ID de votre Google Cloud.
Définir le projet Cloud du projet Apps Script
- Dans votre projet Apps Script, cliquez sur Paramètres du projet.
- Sous Projet Google Cloud Platform (GCP), cliquez sur Changer de projet.
- Dans Numéro de projet GCP, collez le numéro de votre projet Cloud.
- Cliquez sur Définir un projet. Le projet Cloud et Apps Script projet sont maintenant connectés.
Créer un déploiement Apps Script
Maintenant que tout le code est en place, déployez Apps Script projet. Vous utilisez l'ID de déploiement lorsque vous configurez Application de chat dans Google Cloud
Dans Apps Script, ouvrez le projet de l'application de gestion des incidents.
Cliquez sur Déployer > Nouveau déploiement.
Si Module complémentaire et Application Web ne sont pas déjà sélectionnés, à côté de Sélectionnez le type, cliquez sur les types de déploiement , puis sélectionnez Module complémentaire et Application Web.
Dans Description, saisissez une description pour cette version, par exemple
Complete version of incident management app
Dans Exécuter en tant que, sélectionnez Utilisateur accédant à l'application Web.
Sous Qui a accès, sélectionnez Tous les membres de votre organisation Workspace. où "votre organisation Workspace" est le nom de votre organisation Google Workspace.
Cliquez sur Déployer. Rapports Apps Script réussis déploiement, et fournit un ID de déploiement et une URL pour l'incident page Web d'initialisation.
Notez l'URL de l'application Web. Vous pourrez y accéder par la suite au début d'un incident. Copiez l'ID de déploiement. Vous utilisez cet identifiant lorsque vous configurez Application Chat dans la console Google Cloud
Cliquez sur OK.
Configurer l'application Chat dans la console Google Cloud
Cette section explique comment configurer l'API Google Chat dans la console Google Cloud contenant des informations sur votre application Chat, y compris ID du déploiement que vous venez de créer à partir de votre script Apps Script projet.
Dans la console Google Cloud, cliquez sur Menu. > Autres produits > Google Workspace > Bibliothèque de produits > API Google Chat > Gérer > Configuration.
Dans le champ Nom de l'application, saisissez
Incident Management
.Dans le champ URL de l'avatar, saisissez
https://developers.google.com/chat/images/quickstart-app-avatar.png
.Dans Description, saisissez
Responds to incidents.
.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 Projet Apps Script.
Dans Deployment ID (ID de déploiement), collez l'ID de déploiement Apps Script. que vous avez copiée précédemment depuis le projet Apps Script le déploiement.
Enregistrez une commande à barre oblique que la commande Utilisation complète d'une application Chat:
Sous Commandes à barre oblique, cliquez sur Ajouter une commande à barre oblique.
Dans le champ Nom, saisissez
/closeIncident
.Dans le champ ID de commande, saisissez
1
.Dans Description, saisissez
Closes the incident being discussed in the space.
Sélectionnez Ouvre une boîte de dialogue.
Cliquez sur OK. La commande à barre oblique est enregistrée et répertoriée.
Sous Visibilité, sélectionnez Rendre cette application Chat accessible à des personnes et des groupes spécifiques dans votre domaine Workspace, puis saisissez votre adresse e-mail.
Sous Journaux, sélectionnez Consigner les erreurs dans Logging.
Cliquez sur Enregistrer. Un message indiquant que la configuration est enregistrée s'affiche, prêts à être testés.
Tester l'application Chat
Pour tester l'application Chat de gestion des incidents, lancez une de la page Web et vérifiez que l'application Chat fonctionne comme prévu:
Accédez à l'URL de l'application Web de déploiement d'Apps Script.
Quand Apps Script demande l'autorisation d'accéder à vos données, cliquez sur Examiner les autorisations, puis connectez-vous avec un compte Google approprié. dans votre domaine Google Workspace, puis cliquez sur Allow (Autoriser).
La page Web d'initialisation de l'incident s'ouvre. Saisissez les informations relatives au test:
- Dans le champ Titre de l'incident, saisissez
The First Incident
. - Si vous le souhaitez, dans Répondants aux incidents, saisissez les adresses e-mail vos collègues de la réponse aux incidents. Il doit s'agir d'utilisateurs ayant un compte Google Chat de votre organisation Google Workspace ; ou la création d'un espace. Ne saisissez pas votre propre adresse e-mail, car elle est automatiquement inclus.
- Dans le champ Message initial, saisissez
Testing the incident management Chat app.
.
- Dans le champ Titre de l'incident, saisissez
Cliquez sur Créer un espace Chat. Un message
creating space
s'affiche.Une fois l'espace créé, un message
Space created!
s'affiche. Cliquez sur Ouvrir l'espace : cette option permet d'ouvrir l'espace dans Chat dans un nouvel onglet.Si vous le souhaitez, vous et les autres personnes impliquées dans la gestion des incidents pouvez envoyer des messages dans le espace. L'application résume ces messages à l'aide de Vertex AI et partage un document rétrospectif.
Pour mettre fin à la réponse à l’incident et commencer le processus de résolution, dans le Espace Chat, saisissez
/closeIncident
. Une gestion des incidents s'ouvre.Dans Fermer l'incident, saisissez une description pour la résolution de l'incident. comme
Test complete
.Cliquez sur Fermer l'incident.
L'application de gestion des incidents liste les messages de l'espace et les résume avec Vertex AI, colle le résumé dans un document Google Docs et partage dans l'espace.
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
Menu > IAM et Administrateur
> Gérer les ressources.
<ph type="x-smartling-placeholder"></ph> Accéder au gestionnaire de ressources
- Dans la liste des projets, sélectionnez celui que vous souhaitez supprimer, puis cliquez sur Supprimez .
- Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour le supprimer. le projet.
Articles associés
- Répondre à des questions basées sur des conversations Chat avec l'application Gemini AI Chat
- Gérer des projets avec Google Chat, Vertex AI et Firestore
- L'application de gestion des incidents s'authentifie avec les identifiants de l'utilisateur pour appeler des API
et à appeler des services Google Cloud, comme l'API Chat et l'API Vertex AI.
Cela signifie que l'utilisateur qui initialise un incident doit avoir accès à ces
services. Pour rendre l'application plus robuste, envisagez d'appeler l'API Vertex AI.
en tant que compte de service au lieu des identifiants de l'utilisateur appelant
la commande à barre oblique
/closeIncident
. Si vous avez besoin d'aide pour configurer un compte de service pour l'API Vertex AI, consultez Utilisez un compte de service personnalisé.