Questo tutorial mostra come creare un'app Google Chat che risponda agli incidenti in tempo reale. Quando risponde a un incidente, l'app crea e compila uno spazio di Chat, facilita la risoluzione degli incidenti con messaggi, comandi slash e finestre di dialogo e utilizza l'IA per riepilogare la risposta agli incidenti in un documento di Documenti Google.
Un incidente è un evento che richiede l'attenzione immediata di un team di persone per risolvere il problema. Esempi di incidenti includono:
- In una piattaforma di gestione dei rapporti con i clienti (CRM) viene creata una richiesta sensibile al tempo, che richiede la collaborazione di un team di servizio per la risoluzione.
- Un sistema si disconnette, avvisando un gruppo di Site Reliability Engineer (SRE) in modo che possano collaborare per riportarlo online.
- Si verifica un terremoto di magnitudo elevata e gli addetti alle emergenze devono coordinare la loro risposta.
Ai fini di questo tutorial, l'avviso di incidente si avvia quando qualcuno segnala l'incidente facendo clic su un pulsante da una pagina web. La pagina web simula un incidente chiedendo agli utenti di inserire informazioni di base sull'incidente: titolo, descrizione e indirizzi email di chi risponde.
Guarda l'app Chat per la gestione degli incidenti in azione:
-
Figura 2. Notifica che lo spazio di Chat dell'incidente è stato creato. -
Figura 3. Lo spazio di Chat per la risposta agli incidenti. -
Figura 4. Risolvere l'incidente con un comando slash. -
Figura 5. Finestra di dialogo per la risoluzione degli incidenti. -
Figura 6. Documento di Documenti Google di risoluzione degli incidenti condiviso nello spazio. -
Figura 7. Il documento di Documenti Google relativo alla risoluzione degli incidenti relativi all'IA.
Prerequisiti
Se hai bisogno di attivare uno di questi prerequisiti per la tua organizzazione, chiedi all'amministratore di Google Workspace di farlo:
- Un account Google Workspace con accesso a Google Chat.
- Attivare Directory (condivisione dei contatti) per Google Workspace. L'app per gli incidenti utilizza la directory per cercare i dati di contatto degli addetti alla risposta, come nome e indirizzo email. Gli utenti che rispondono agli incidenti devono essere utenti con un account Google Chat nella tua organizzazione Google Workspace.
Obiettivi
- Creare un'app di chat in grado di rispondere agli incidenti.
- Aiuta gli utenti a rispondere agli incidenti:
- Creazione di spazi di risposta agli incidenti.
- Pubblicazione di messaggi che riepilogano gli incidenti e le risposte.
- Supportare la collaborazione con funzionalità interattive dell'app Chat.
- Riassumi conversazioni e risoluzioni con Vertex AI.
Architettura
Il seguente diagramma mostra l'architettura delle risorse Google Workspace e Google Cloud utilizzate dall'app Google Chat per la risposta agli incidenti.
L'architettura mostra come l'app Google Chat di risposta agli incidenti elabora un incidente e la sua risoluzione.
Un utente avvia un incidente da un sito web esterno ospitato su Apps Script.
Il sito web invia una richiesta HTTP asincrona all'app Google Chat, anch'essa ospitata su Apps Script.
L'app Google Chat per la risposta agli incidenti elabora la richiesta:
Il servizio SDK Admin di Apps Script ottiene informazioni sui membri del team, come l'ID utente e l'indirizzo email.
Con un insieme di richieste HTTP all'API Chat che utilizza il servizio Apps Script Advanced Chat, l'app Google Chat per la risposta agli incidenti crea uno spazio di Chat agli incidenti, lo compila con i membri del team e invia un messaggio allo spazio.
I membri del team discutono dell'incidente nello spazio di Chat.
Un membro del team chiama un comando slash per segnalare una risoluzione dell'incidente.
Una chiamata HTTP all'API Chat utilizzando il servizio Advanced Chat di Apps Script elenca tutti i messaggi dello spazio di Chat.
Vertex AI riceve i messaggi elencati e genera un riepilogo.
Il servizio
DocumentApp
di Apps Script crea un documento di Documenti e aggiunge il riepilogo di Vertex AI al documento.L'app Google Chat per la risposta agli incidenti chiama l'API Chat per inviare un messaggio che condivide un link al documento di riepilogo di Documenti.
prepara l'ambiente
Questa sezione mostra come creare e configurare un progetto Google Cloud per l'app Chat.
Creare un progetto Google Cloud
Console Google Cloud
- Nella console Google Cloud, vai a Menu > IAM e amministrazione > Crea un progetto.
-
Nel campo Nome progetto, inserisci un nome descrittivo per il progetto.
(Facoltativo) Per modificare l'ID progetto, fai clic su Modifica. L'ID progetto non può essere modificato dopo la creazione del progetto, quindi scegli un ID che soddisfi le tue esigenze per tutta la durata del progetto.
- Nel campo Località, fai clic su Sfoglia per visualizzare le potenziali località per il tuo progetto. Poi, fai clic su Seleziona.
- Fai clic su Crea. La console Google Cloud accede alla pagina Dashboard e il tuo progetto viene creato in pochi minuti.
Interfaccia a riga di comando gcloud
In uno dei seguenti ambienti di sviluppo, accedi a Google Cloud CLI ("gcloud"):
-
Cloud Shell: per utilizzare un terminale online con gcloud CLI già configurato, attiva Cloud Shell.
Attivare Cloud Shell -
shell locale: per utilizzare un ambiente di sviluppo locale, installa e initialize gcloud CLI.
Per creare un progetto Cloud, utilizza il comando "gcloud projects create":
Sostituisci PROJECT_ID impostando l'ID per il progetto che vuoi creare.gcloud projects create PROJECT_ID
Abilita la fatturazione per il progetto cloud
Console Google Cloud
- Nella console Google Cloud, vai a Fatturazione. Fai clic su Menu > Fatturazione > I miei progetti.
- In Seleziona un'organizzazione, scegli l'organizzazione associata al tuo progetto Google Cloud.
- Nella riga del progetto, apri il menu Azioni ( ), fai clic su Modifica fatturazione e scegli l'account di fatturazione Cloud.
- Fai clic su Imposta account.
Interfaccia a riga di comando gcloud
- Per elencare gli account di fatturazione disponibili, esegui:
gcloud billing accounts list
- Collega un account di fatturazione a un progetto Google Cloud:
gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID
Sostituisci quanto segue:
PROJECT_ID
è l'ID progetto del progetto Cloud per cui vuoi abilitare la fatturazione.BILLING_ACCOUNT_ID
è l'ID account di fatturazione da collegare al progetto Google Cloud.
Abilita le API
Console Google Cloud
Nella console Google Cloud, abilita l'API Google Chat, l'API Documenti Google, l'API SDK Admin e l'API Vertex AI.
Verifica di abilitare le API nel progetto Cloud corretto, quindi fai clic su Avanti.
Verifica di abilitare le API corrette e fai clic su Abilita.
Interfaccia a riga di comando gcloud
Se necessario, imposta l'attuale progetto Cloud su quello creato con il comando
gcloud config set project
:gcloud config set project PROJECT_ID
Sostituisci PROJECT_ID con l'ID progetto del progetto Cloud che hai creato.
Abilita l'API Google Chat, l'API Google Docs, l'API SDK Admin e l'API Vertex AI con il comando
gcloud services enable
:gcloud services enable chat.googleapis.com docs.googleapis.com admin.googleapis.com aiplatform.googleapis.com
Configura autenticazione e autorizzazione
L'autenticazione e l'autorizzazione consentono all'app Chat di accedere alle risorse in Google Workspace e Google Cloud di elaborare una risposta agli incidenti.
In questo tutorial pubblicherai l'app internamente, quindi puoi utilizzare le informazioni relative ai segnaposto. Prima di pubblicare l'app esternamente, sostituisci le informazioni segnaposto con informazioni reali per la schermata di consenso.
Nella console Google Cloud, vai a Menu > API e servizi > Schermata consenso OAuth.
In Tipo di utente, seleziona Interno e poi fai clic su Crea.
In Nome app, digita
Incident Management
.In Email dell'assistenza utenti, seleziona il tuo indirizzo email o un gruppo Google appropriato.
In Dati di contatto dello sviluppatore, inserisci il tuo indirizzo email.
Fai clic su Salva e continua.
Fai clic su Aggiungi o rimuovi ambiti. Viene visualizzato un riquadro con un elenco di ambiti per ogni API abilitata nel progetto Cloud.
In Aggiungi manualmente gli ambiti, incolla i seguenti ambiti:
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
Fai clic su Aggiungi alla tabella.
Fai clic su Update (Aggiorna).
Fai clic su Salva e continua.
Esamina il riepilogo della registrazione dell'app e fai clic su Torna alla dashboard.
Creare ed eseguire il deployment dell'app Chat
Nella sezione seguente copi e aggiorni un intero progetto Apps Script che contiene tutto il codice dell'applicazione necessario per l'app Chat, quindi non è necessario copiare e incollare ogni file.
Alcune funzioni includono trattini bassi alla fine del nome, ad esempio
processSlashCommand_()
di ChatApp.gs
. Il trattino basso nasconde la funzione nella pagina web di inizializzazione degli incidenti quando è aperta in un browser. Per scoprire di più, consulta Funzioni private.
Apps Script supporta due tipi di file: .gs
script e .html
file. Per rispettare questo supporto, il codice JavaScript lato client dell'app è incluso
nei tag <script />
e il relativo CSS è incluso all'interno dei tag <style />
all'interno
di un file HTML.
Facoltativamente, puoi visualizzare l'intero progetto su GitHub.
Ecco una panoramica di ciascun file:
Consts.gs
Definisce le costanti a cui fanno riferimento altri file di codice, tra cui l'ID progetto Cloud, l'ID località Vertex AI e l'ID comando slash per chiudere un incidente.
Visualizza il codice di
Consts.gs
ChatApp.gs
Gestisce gli eventi di interazione con Chat, tra cui messaggi, clic sulle schede, comandi slash e finestre di dialogo. Risponde al comando slash
/closeIncident
aprendo una finestra di dialogo per raccogliere i dettagli sulla risoluzione dell'incidente. Legge i messaggi nello spazio chiamando il metodospaces.messages.list
nell'API Chat. Recupera gli ID utente utilizzando il servizio directory SDK Admin in Apps Script.Visualizza il codice di
ChatApp.gs
ChatSpaceCreator.gs
Riceve i dati del modulo inseriti dagli utenti nella pagina web di inizializzazione dell'incidente e li utilizza per configurare uno spazio di Chat creandolo e compilandolo, quindi pubblica un messaggio sull'incidente.
Visualizza il codice di
ChatSpaceCreator.gs
DocsApi.gs
Chiama l'API Google Docs per creare un documento di Documenti Google nel Google Drive di un utente e scrive nel documento un riepilogo delle informazioni relative all'incidente create in
VertexAiApi.gs
.Visualizza il codice di
DocsApi.gs
VertexAiApi.gs
Riassume la conversazione nello spazio di Chat usando Vertex AI. Questo riepilogo viene pubblicato in un documento appositamente creato in
DocsAPI.gs
.Visualizza il codice di
VertexAiApi.gs
WebController.gs
Pubblica il sito web di inizializzazione degli incidenti.
Visualizza il codice di
WebController.gs
Index.html
Il codice HTML che comprende il sito web di inizializzazione degli incidenti.
Visualizza il codice di
Index.html
JavaScript.html
Gestisce il comportamento dei moduli, inclusi invii, errori e cancellazioni, per il sito web di inizializzazione degli incidenti. È incluso in
Index.html
dalla funzioneinclude
personalizzata inWebController.gs
.Visualizza il codice di
JavaScript.html
Stylesheet.html
Il CSS per il sito web di inizializzazione degli incidenti. È inclusa in
Index.html
dalla funzioneinclude
personalizzata inWebController.gs
.Visualizza il codice di
Stylesheet.html
Trovare il numero e l'ID del progetto Cloud
Nella console Google Cloud, vai al tuo progetto Cloud.
Fai clic su Impostazioni e utilità > Impostazioni progetto.
Prendi nota dei valori nei campi Numero di progetto e ID progetto. Puoi usarli nelle sezioni seguenti.
Crea il progetto Apps Script
Per creare un progetto Apps Script e collegarlo al tuo progetto Cloud:
- Fai clic sul pulsante seguente per aprire il progetto Apps Script di Rispondi agli incidenti con Google Chat.
Apri il progetto - Fai clic su Panoramica.
- Nella pagina Panoramica, fai clic su Crea una copia.
Assegna un nome alla copia del progetto Apps Script:
Fai clic su Copia di Rispondere agli incidenti con Google Chat.
In Titolo del progetto, digita
Incident Management Chat app
.Fai clic su Rinomina.
Nella tua copia del progetto Apps Script, vai al file
Consts.gs
e sostituisciYOUR_PROJECT_ID
con l'ID del tuo progetto Cloud.
Imposta il progetto Cloud del progetto Apps Script
- Nel progetto Apps Script, fai clic su Impostazioni progetto.
- In Progetto Google Cloud Platform (GCP), fai clic su Cambia progetto.
- In Numero di progetto Google Cloud, incolla il numero del progetto Cloud.
- Fai clic su Imposta progetto. Il progetto Cloud e il progetto Apps Script ora sono collegati.
Crea un deployment di Apps Script
Ora che tutto il codice è a posto, esegui il deployment del progetto Apps Script. Utilizzi l'ID deployment quando configuri l'app Chat in Google Cloud.
In Apps Script, apri il progetto dell'app di risposta agli incidenti.
Fai clic su Esegui il deployment > Nuovo deployment.
Se Componente aggiuntivo e App web non sono già selezionati, accanto a Seleziona tipo, fai clic sui tipi di deployment e seleziona Componente aggiuntivo e App web.
In Descrizione, inserisci una descrizione per questa versione, ad esempio
Complete version of incident management app
.In Execute as (Esegui come), seleziona L'utente accede all'app web.
In Chi ha accesso, seleziona Chiunque all'interno della tua organizzazione Workspace, dove "la tua organizzazione Workspace" è il nome della tua organizzazione Google Workspace.
Fai clic su Esegui il deployment. Apps Script segnala l'implementazione riuscita e fornisce un ID deployment e un URL per la pagina web di inizializzazione dell'incidente.
Prendi nota dell'URL dell'app web da visitare in seguito quando si verifica un incidente. Copia l'ID deployment. Utilizza questo ID durante la configurazione dell'app Chat nella console Google Cloud.
Fai clic su Fine.
Configurare l'app Chat nella console Google Cloud
Questa sezione mostra come configurare l'API Google Chat nella console Google Cloud con informazioni sulla tua app Chat, incluso l'ID del deployment appena creato dal progetto Apps Script.
Nella console Google Cloud, fai clic su Menu > Altri prodotti > Google Workspace > Libreria prodotti > API Google Chat > Gestisci > Configurazione.
In Nome app, digita
Incident Management
.In URL avatar, digita
https://developers.google.com/chat/images/quickstart-app-avatar.png
.In Descrizione, digita
Responds to incidents.
.Fai clic sull'opzione Attiva funzionalità interattive per attivare l'opzione.
In Funzionalità, seleziona Ricevi messaggi 1:1 e Partecipare a spazi e conversazioni di gruppo.
In Impostazioni di connessione, seleziona Progetto Apps Script.
In ID deployment, incolla l'ID deployment di Apps Script che hai copiato in precedenza dal deployment del progetto Apps Script.
Registra un comando slash utilizzato dall'app di Chat completamente implementata:
In Comandi slash, fai clic su Aggiungi comando slash.
In Nome, digita
/closeIncident
.In ID comando, digita
1
.In Descrizione, digita
Closes the incident being discussed in the space.
Seleziona Apre una finestra di dialogo.
Fai clic su Fine. Il comando slash è registrato ed elencato.
In Visibilità, seleziona Rendi questa app di chat disponibile a persone e gruppi specifici nel tuo dominio Workspace e inserisci il tuo indirizzo email.
In Log, seleziona Registra errori in Logging.
Fai clic su Salva. Viene visualizzato un messaggio di configurazione salvata, che indica che l'app è pronta per il test.
Testare l'app Chat
Per testare l'app Chat per la gestione degli incidenti, avvia un incidente dalla pagina web e verifica che l'app Chat funzioni come previsto:
Vai all'URL dell'app web per il deployment di Apps Script.
Quando Apps Script chiede l'autorizzazione ad accedere ai tuoi dati, fai clic su Rivedi autorizzazioni, accedi con un Account Google appropriato nel tuo dominio Google Workspace e fai clic su Consenti.
Si apre la pagina web di inizializzazione degli incidenti. Inserisci le informazioni del test:
- In Titolo incidente, digita
The First Incident
. - Facoltativamente, in Responsabili agli incidenti, inserisci gli indirizzi email degli altri utenti che rispondono alle minacce. Devono essere utenti con un account Google Chat nella tua organizzazione Google Workspace, altrimenti la creazione dello spazio non va a buon fine. Non inserire il tuo indirizzo email perché viene incluso automaticamente.
- In Messaggio iniziale, digita
Testing the incident management Chat app.
.
- In Titolo incidente, digita
Fai clic su Crea spazio di Chat. Viene visualizzato un messaggio
creating space
.Una volta creato lo spazio, viene visualizzato un messaggio
Space created!
. Fai clic su Apri spazio per aprire lo spazio di Chat in una nuova scheda.Facoltativamente, tu e gli altri addetti alla risposta alle minacce potete inviare messaggi nello spazio. L'app riassume questi messaggi utilizzando Vertex AI e condivide un documento retrospettivo.
Per terminare la risposta all'incidente e iniziare il processo di risoluzione, digita
/closeIncident
nello spazio di Chat. Si apre una finestra di dialogo per la gestione degli incidenti.In Chiudi incidente, inserisci una descrizione per la risoluzione dell'incidente, ad esempio
Test complete
.Fai clic su Chiudi incidente.
L'app di gestione degli incidenti elenca i messaggi nello spazio, li riassume con Vertex AI, incolla il riepilogo in un documento di Documenti Google e condivide il documento nello spazio.
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, ti consigliamo di eliminare il progetto Cloud.
- Nella console Google Cloud, vai alla pagina Gestisci risorse. Fai clic su Menu > IAM e amministrazione > Gestisci risorse.
- Nell'elenco dei progetti, seleziona quello da eliminare e fai clic su Elimina .
- Nella finestra di dialogo, digita l'ID progetto e fai clic su Arresta per eliminare il progetto.
Argomenti correlati
- Rispondere a domande basate sulle conversazioni in Chat con un'app Gemini AI Chat
- Gestire progetti con Google Chat, Vertex AI e Firestore
- L'app di risposta agli incidenti si autentica con le credenziali utente per chiamare le API
e richiamare i servizi Google Cloud, come l'API Chat e l'API Vertex AI.
Ciò significa che l'utente che inizializza un incidente deve avere accesso a questi servizi. Per rendere l'app più solida, valuta la possibilità di chiamare l'API Vertex AI con come account di servizio anziché le credenziali utente dell'utente che richiede il comando slash
/closeIncident
. Per assistenza sulla configurazione di un account di servizio per l'API Vertex AI, consulta Usare un account di servizio personalizzato.