Gestisci progetti con Google Chat, Vertex AI e Firestore

Questo tutorial mostra come creare un'app di Chat per Google Chat che un team può utilizzare per gestire i progetti in tempo reale. L'app Chat utilizza Vertex AI per aiutare i team a scrivere storie utente (che rappresentano le funzionalità di un sistema software dal punto di vista di un utente da sviluppare per il team) e salva le storie in un database Firestore.

• 

  Figura 1. Charlie discute con il suo team dello sviluppo di funzionalità in uno spazio di Chat. Se menzioni l'app di chat per la gestione dei progetti, l'app di chat ti offrirà assistenza.

• 

  Figura 2. Utilizzando il comando slash /createUserStory, Charlie crea una storia.

• 

  Figura 3. L'app di chat per la gestione dei progetti utilizza Vertex AI per scrivere la descrizione della storia, quindi la condivide nello spazio.

• 

  Figura 4. Charlie fa clic su Modifica per finalizzare i dettagli della storia. La descrizione AI è accurata, ma Charlie vuole più dettagli, quindi fa clic su Espandi per chiedere a Vertex AI di aggiungere i requisiti alla descrizione della storia. Charlie si assegna la storia, imposta lo stato su Iniziato, seleziona una priorità e una dimensione appropriate, quindi fa clic su Salva.

• 

  Figura 5. In qualsiasi momento, Charlie può visualizzare e gestire tutte le storie dell'utente del team con il comando slash /manageUserStories.

Prerequisiti

• Un account Google Workspace Business o Enterprise con accesso a Google Chat.

• Accesso ai servizi Google Cloud per svolgere le seguenti operazioni:

  • Crea un progetto Google Cloud.
  • Collega un account di fatturazione Google Cloud al progetto Cloud. Per scoprire se hai accesso, consulta Autorizzazioni richieste per abilitare la fatturazione.

  • Utilizza chiamate non autenticate di Cloud Functions, che puoi verificare determinando se la tua organizzazione Google Cloud utilizza la limitazione del dominio.

  Se necessario, chiedi l'accesso o l'autorizzazione all'amministratore Google Cloud.

• Se utilizzi Google Cloud CLI, un ambiente di sviluppo Node.js configurato per funzionare con gcloud CLI. Consulta Configurazione di un ambiente di sviluppo Node.js.

Obiettivi

• Crea un'app di chat che gestisca progetti software agili.
• Aiuta gli utenti a scrivere storie dell'utente con strumenti di scrittura di storie assistiti dall'AI generativa basati su Vertex AI:
  • Generare e rigenerare le descrizioni delle storie.
  • Espandi le descrizioni delle storie dalle note ai requisiti completi.
  • Correggi la grammatica per correggere i refusi.
• Mantieni aggiornato il lavoro scrivendo e leggendo da un database Firestore.
• Facilita la collaborazione in uno spazio di Chat consentendo agli utenti di creare, modificare, assegnare e avviare storie direttamente dalla conversazione.

Prodotti utilizzati

L'app di gestione dei progetti utilizza i seguenti prodotti Google Workspace e Google Cloud:

• API Chat: Un'API per lo sviluppo di app Google Chat che ricevono e rispondono a eventi di interazione di Chat, come i messaggi. L'app Google Chat per la gestione dei progetti utilizza l'API Chat per ricevere e rispondere agli eventi di interazione inviati da Chat e per configurare gli attributi che determinano il suo aspetto in Chat, come il nome e l'immagine dell'avatar.
• API Vertex AI: Una piattaforma AI generativa. L'app Google Chat per la gestione dei progetti utilizza l'API Vertex AI per scrivere titoli e descrizioni delle user story.
• Firestore: Un database di documenti serverless. L'app Google Chat per la gestione dei progetti utilizza Firebase per archiviare i dati relativi alle user story.

• Cloud Functions: Un servizio di calcolo serverless leggero che ti consente di creare funzioni autonome a uso specifico in grado di rispondere agli eventi di interazione di Chat senza la necessità di gestire un server o un ambiente di runtime. L'app Google Chat per la gestione dei progetti utilizza Cloud Functions per ospitare l'endpoint HTTP a cui Chat invia gli eventi di interazione e come piattaforma di calcolo per eseguire la logica che elabora e risponde a questi eventi.

  Cloud Functions utilizza i seguenti prodotti Google Cloud per creare, elaborare eventi di interazione e ospitare risorse di calcolo:

  • Cloud Build: Una piattaforma di integrazione continua, distribuzione e deployment completamente gestita che esegue build automatizzate.
  • Pub/Sub: Un servizio di messaggistica asincrono e scalabile che disaccoppia i servizi che producono messaggi dai servizi che li elaborano.
  • API Cloud Run Admin: Un ambiente completamente gestito per l'esecuzione di app containerizzate.

Architettura

L'architettura dell'app Google Chat per la gestione dei progetti riceve ed elabora gli eventi di interazione di Chat in un endpoint HTTP, utilizza Vertex AI per scrivere user story e memorizza i dettagli delle user story in un database Firestore. Il seguente diagramma mostra l'architettura delle risorse Google Workspace e Google Cloud utilizzate.

L'app Google Chat per la gestione dei progetti funziona nel seguente modo:

1. Un utente invia un messaggio in Chat e richiama l'app Google Chat di gestione dei progetti inviandole un messaggio direttamente, menzionandola in uno spazio o inserendo un comando slash.

2. Chat invia una richiesta HTTP sincrona all'endpoint HTTP di Cloud Functions.

3. L'app Google Chat per la gestione dei progetti elabora la richiesta HTTP:

   1. Vertex AI aiuta a scrivere o aggiornare una storia dell'utente.

   2. Un database Firestore archivia, recupera, aggiorna o elimina i dati delle storie dell'utente.

4. Cloud Functions restituisce una risposta HTTP a Chat, che la mostra all'utente come messaggio o finestra di dialogo.

Prepara l'ambiente

Questa sezione mostra come creare e configurare un progetto Google Cloud per l'app Chat.

Crea un progetto Google Cloud

Console API di Google

1. Nella console API di Google, vai a Menu > IAM e amministrazione > Crea un progetto.

   Vai a Crea un progetto

2. Nel campo Project Name (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 l'intera durata del progetto.

3. Nel campo Posizione, fai clic su Sfoglia per visualizzare le potenziali posizioni per il tuo progetto. Poi, fai clic su Seleziona.
   Attenzione: non riesci a trovare la tua organizzazione Google Workspace?
   Ciò significa che non hai eseguito l'accesso a un account Google Workspace. Alcune delle funzionalità descritte nella documentazione per lo sviluppo di Google Workspace sono disponibili solo per i progetti associati a un'organizzazione.
4. Fai clic su Crea. La console API di Google passa alla pagina Dashboard e il tuo progetto viene creato in pochi minuti.

gcloud CLI

In uno dei seguenti ambienti di sviluppo, accedi a Google Cloud CLI (gcloud):

• Cloud Shell: per utilizzare un terminale online con gcloud CLI già configurata, attiva Cloud Shell.
  Attiva Cloud Shell
• Shell locale: per utilizzare un ambiente di sviluppo locale, installa e inizializza gcloud CLI.
  Per creare un progetto Cloud, utilizza il comando gcloud projects create:

  gcloud projects create PROJECT_ID

  Sostituisci PROJECT_ID impostando l'ID del progetto che vuoi creare.

Abilita la fatturazione per il progetto Cloud

Se non riesci a collegare un account di fatturazione, non disponi delle autorizzazioni necessarie per apportare questa modifica. Per ulteriori informazioni, vedi Autorizzazioni richieste per abilitare la fatturazione.

Console API di Google

1. Nella console API di Google, vai a Fatturazione. Fai clic su Menu > Fatturazione > I miei progetti.

   Vai a Fatturazione per i miei progetti

2. In Seleziona un'organizzazione, scegli l'organizzazione associata al tuo progetto Google Cloud.
3. Nella riga del progetto, apri il menu Azioni (), fai clic su Modifica fatturazione e scegli l'account di fatturazione Cloud.
4. Fai clic su Imposta account.

gcloud CLI

1. Per elencare gli account di fatturazione disponibili, esegui:

   gcloud billing accounts list

2. 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 per il progetto Cloud per il quale vuoi abilitare la fatturazione.
   • BILLING_ACCOUNT_ID è l'ID account di fatturazione da collegare al progetto Google Cloud.

Abilita le API

Console API di Google

1. Nella console API di Google, abilita l'API Google Chat, l'API Vertex AI, l'API Cloud Functions, l'API Firestore, l'API Cloud Build, l'API Pub/Sub e l'API Cloud Run Admin.

   Abilita le API

2. Verifica di abilitare le API nel progetto Cloud corretto, poi fai clic su Avanti.

3. Verifica di abilitare le API corrette, quindi fai clic su Abilita.

gcloud CLI

1. Se necessario, imposta il progetto Cloud corrente su quello che hai 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.

2. Abilita l'API Google Chat, l'API Vertex AI, l'API Cloud Functions, l'API Firestore, l'API Cloud Build, l'API Pub/Sub e l'API Cloud Run Admin con il comando 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

   Le API Cloud Build, Pub/Sub e Cloud Run Admin sono prerequisiti di Cloud Functions.

Autenticazione e autorizzazione

Per seguire questo tutorial non è necessaria alcuna configurazione di autenticazione e autorizzazione.

Per chiamare le API Firestore e Vertex AI, questo tutorial utilizza le credenziali predefinite dell'applicazione con il service account predefinito collegato alla funzione Cloud Functions, che non devi configurare. Nel contesto di un ambiente di produzione, in genere crei e colleghi un service account alla Cloud Function.

Creare e distribuire l'app Google Chat

Ora che il tuo progetto Google Cloud è stato creato e configurato, puoi creare e distribuire l'app Google Chat. In questa sezione, devi:

1. Crea un database Firestore in cui rendere persistenti e recuperare le storie dell'utente.
2. (Facoltativo) Rivedi il codice campione.
3. Crea una funzione Cloud Functions per ospitare ed eseguire il codice dell'app Chat in risposta agli eventi ricevuti da Chat come richieste HTTP.
4. Crea e implementa un'app Google Chat nella pagina di configurazione dell'API Google Chat.

Crea il database Firestore

In questa sezione, crei un database Firestore per rendere persistenti e recuperare le storie dell'utente, ma non definisci il modello dei dati. Il modello dei dati viene impostato implicitamente nel codice campione dai file model/user-story.js e model/user.js.

Il database dell'app Chat per la gestione dei progetti utilizza un modello di dati NoSQL basato su documenti organizzati in raccolte. Per scoprire di più, consulta la sezione Modello di dati di Firestore.

Il seguente diagramma mostra una panoramica del modello di dati dell'app Google Chat per la gestione dei progetti:

La raccolta principale è spaces, dove ogni documento rappresenta uno spazio in cui l'app Chat ha creato storie. Ogni storia dell'utente è rappresentata da un documento nella sottoraccolta userStories e ogni utente è rappresentato da un documento nella sottoraccolta users.

Visualizzare le definizioni di raccolta, documento e campo

spaces

Spazi in cui l'app Chat ha creato storie.

Campi
Document ID	String ID univoco di uno spazio specifico in cui vengono create le storie. Corrisponde al nome della risorsa dello spazio nell'API Chat.
userStories	Subcollection of Documents (userStories) Storie create dall'app Chat e dai suoi utenti. Corrisponde a Document ID di un userStories in Firebase.
users	Subcollection of Documents (user) Utenti che hanno creato o a cui sono assegnate storie.
displayName	String Il nome visualizzato dello spazio nell'API Chat. Non impostato per i messaggi diretti con gli utenti.

userStories

Storie create dall'app Chat e dai suoi utenti.

Campi
Document ID	String ID univoco di una storia dell'utente specifica creata dall'app di chat e dai suoi utenti.
assignee	Document (user) Il nome risorsa dell'utente assegnato per completare la storia. Corrisponde a Document ID del documento users e al nome della risorsa di un utente nell'API Chat.
description	String Una descrizione della funzionalità del software dal punto di vista dell'utente.
priority	Enum L'urgenza con cui completare il lavoro. I valori possibili sono Low, Medium o High.
size	Enum La quantità di lavoro. I valori possibili sono Small, Medium o Large.
status	Enum La fase di lavoro. I valori possibili sono OPEN, STARTED o COMPLETED.
title	String Il titolo della storia; un breve riassunto.

users

Gli utenti che hanno creato o a cui sono assegnate le storie.

Campi
Document ID	String ID univoco di un utente specifico. Corrisponde a assignee di un userStories in Firebase e al nome della risorsa di un utente nell'API Chat.
avatarUrl	String URL che ospita l'immagine dell'avatar di Chat dell'utente.
displayName	String Il nome visualizzato dell'utente di Chat.

Ecco come creare il database Firestore:

Console API di Google

1. Nella console API di Google, vai a Firestore. Fai clic su Menu > Firestore.

   Vai a Firestore

2. Fai clic su Crea database.

3. In Seleziona la modalità Firestore, fai clic su Modalità nativa.

4. Fai clic su Continua.

5. Configura il database:

   1. In Assegna un nome al database, lascia ID database impostato su (default).

   2. In Tipo di località, specifica una regione per il tuo database, ad esempio us-central1. Per ottenere prestazioni ottimali, seleziona la stessa località o una località vicina a quella della funzione Cloud Functions dell'app di Chat.

6. Fai clic su Crea database.

gcloud CLI

• Crea un database Firestore in modalità Native con il comando gcloud firestore databases create:

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

  Sostituisci LOCATION con il nome di una regione Firestore, ad esempio us-central1.

Esamina il codice campione

Se vuoi, prima di creare la Cloud Function, prenditi un momento per esaminare e familiarizzare con il codice campione ospitato su GitHub.

Visualizza su GitHub

Ecco una panoramica di ogni file:

env.js

Variabili di configurazione dell'ambiente per il deployment dell'app di chat in un progetto cloud e una regione Google Cloud specifici. Devi aggiornare le variabili di configurazione in questo file.

package.json e package-lock.json

Impostazioni progetto e dipendenze di Node.js.

index.js

Entry point per la funzione Cloud Functions dell'app Chat. Legge l'evento di chat dalla richiesta HTTP, chiama il gestore dell'app e pubblica la risposta HTTP come oggetto JSON.

controllers/app.js

La logica principale dell'applicazione. Elabora gli eventi di interazione gestendo i comandi slash e le menzioni dell'app Chat. Per rispondere ai clic sulle schede, chiama app-action-handler.js.

controllers/app-action-handler.js

Logica dell'applicazione per gestire il clic sulla scheda Eventi di interazione di Chat.

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

Questi file contengono le parti della logica dell'applicazione specifiche per l'utilizzo degli spazi di Chat, degli utenti e delle storie dell'utente. Le funzioni in questi file vengono chiamate da app.js o app-action-handler.js. Per eseguire operazioni sul database, le funzioni in questi file chiamano funzioni in firestore-service.js.

services/firestore-service.js

Gestisce le operazioni del database. Le funzioni in questo file vengono chiamate da services/space-service.js, services/user-service.js e services/user-story-service.js.

services/aip-service.js

Chiama l'API Vertex AI per la previsione del testo dell'AI generativa.

model/*.js

Questi file contengono la definizione di classi ed enumerazioni che i servizi dell'applicazione utilizzano per archiviare e trasferire dati tra le funzioni. Definiscono il modello di dati per il database Firestore.

views/*.js

Ogni file in questa directory crea un oggetto scheda che l'app di Chat invia di nuovo a Chat come messaggio con scheda o risposta all'azione di dialogo.

views/widgets/*.js

Ogni file crea un'istanza di un tipo di oggetto widget che l'app utilizza per creare le schede nella directory views/.

test/**/*.test.js

Ogni file in questa directory e nelle relative sottodirectory contiene i test unitari per la funzione, il controller, il servizio, la visualizzazione o il widget corrispondente. Puoi eseguire tutti i test delle unità eseguendo npm run test nella directory principale del progetto.

Crea ed esegui il deployment della funzione Cloud Functions

In questa sezione, crei ed esegui il deployment di una funzione Cloud Functions che comprende la logica dell'applicazione dell'app Chat di gestione dei progetti.

La funzione Cloud Functions viene eseguita in risposta a una richiesta HTTP da Chat contenente un evento di interazione di Chat. Quando viene eseguito, il codice della funzione Cloud Functions elabora l'evento e restituisce una risposta a Chat, che Chat esegue il rendering come messaggio, finestra di dialogo o altro tipo di interazione utente. Se applicabile, la funzione Cloud Functions legge anche dal database Firestore o scrive al suo interno.

Ecco come creare la funzione Cloud Functions:

Console API di Google

1. Scarica il codice da GitHub come file ZIP.

   Scarica il file ZIP

2. Estrai il file ZIP scaricato.

   La cartella estratta contiene l'intero repository di esempi di Google Workspace.

3. Nella cartella estratta, vai a add-ons-samples-main/node/chat/project-management-app/, quindi comprimi la cartella project-management-app in un file ZIP.

   La directory principale del file ZIP deve contenere i seguenti file e cartelle:

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

4. Nella console API di Google, vai alla pagina Cloud Functions:

   Vai a Cloud Functions

   Assicurati che sia selezionato il progetto Google Cloud per la tua app di Chat.

5. Fai clic su Crea funzione.

6. Nella pagina Crea funzione, configura la funzione:

   1. In Ambiente, seleziona Funzione Cloud Run.
   2. In Nome funzione, inserisci project-management-tutorial.
   3. In Regione, seleziona una regione.
   4. In Autenticazione, seleziona Consenti chiamate non autenticate.
   5. Fai clic su Avanti.

7. In Runtime, seleziona Node.js 20.

8. In Punto di ingresso, elimina il testo predefinito e inserisci projectManagementChatApp.

9. In Codice sorgente, seleziona Caricamento zip.

10. In Bucket di destinazione, crea o seleziona un bucket:

    1. Fai clic su Sfoglia.
    2. Scegli un bucket.
    3. Fai clic su Seleziona.

    Google Cloud carica il file ZIP ed estrae i file dei componenti in questo bucket. Cloud Functions copia quindi i file dei componenti nella funzione Cloud.

11. In File zip, carica il file zip che hai scaricato da GitHub, estratto e ricompresso:

    1. Fai clic su Sfoglia.
    2. Vai al file ZIP e selezionalo.
    3. Fai clic su Apri.

12. Fai clic su Esegui il deployment.

    Si apre la pagina Dettagli di Cloud Functions e la funzione viene visualizzata con due indicatori di avanzamento: uno per la build e uno per il servizio. Quando entrambi gli indicatori di avanzamento scompaiono e vengono sostituiti da un segno di spunta, la funzione è stata implementata ed è pronta.

13. Modifica il codice campione per impostare le costanti:

    1. Nella pagina Dettagli funzione Cloud Functions, fai clic su Modifica.
    2. Fai clic su Avanti.
    3. In Codice sorgente, seleziona Modifica in linea.
    4. Nell'editor incorporato, apri il file env.js.
    5. Sostituisci project-id con l'ID progetto Cloud.
    6. (Facoltativo) Aggiorna us-central1 con una località supportata per la tua funzione Cloud.

14. Fai clic su Esegui il deployment.

15. Al termine del deployment della funzione, copia l'URL del trigger:

    1. Nella pagina Dettagli funzione, fai clic su Trigger.
    2. Copia l'URL. Ti servirà per configurare l'app Chat nella sezione seguente.

gcloud CLI

1. Clona il codice da GitHub:

   git clone https://github.com/googleworkspace/add-ons-samples.git

2. Passa alla directory che contiene il codice per questa app di chat di gestione dei progetti:

   cd add-ons-samples/node/chat/project-management-app

3. Modifica il file env.js per impostare le variabili di ambiente:

   1. Sostituisci project-id con l'ID progetto Google Cloud.
   2. Sostituisci us-central1 con la posizione del tuo progetto Google Cloud.

4. Esegui il deployment della funzione Cloud Functions su Google Cloud:

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

   Sostituisci REGION con una località di Cloud Functions in cui è ospitata la sua infrastruttura IT, ad esempio us-central1.

1. Al termine del deployment della funzione, copia la proprietà url dalla risposta. Questo è l'URL del trigger che utilizzerai nella sezione seguente per configurare l'app Google Chat.

Configura l'app Google Chat nella console API di Google

Questa sezione mostra come configurare l'API Chat nella console API di Google con informazioni sulla tua app di chat, inclusi il nome dell'app di chat, i comandi slash supportati e l'URL trigger della funzione Cloud dell'app di chat a cui invia gli eventi di interazione di Chat.

1. Nella console API di Google, fai clic su Menu > API e servizi > API e servizi abilitati > API Google Chat > Configurazione.

   Vai alla configurazione dell'API Chat

2. In Nome app, digita Project Manager.

3. In URL avatar, digita https://developers.google.com/chat/images/quickstart-app-avatar.png.

4. In Descrizione, digita Manages projects with user stories.

5. Fai clic sul pulsante di attivazione/disattivazione Abilita funzionalità interattive in modo che sia impostato su On.

6. Nella sezione Funzionalità, seleziona Partecipa a spazi e conversazioni di gruppo.

7. Nella sezione Impostazioni di connessione, seleziona URL endpoint HTTP.

8. Copia l'indirizzo email del service account. Ti serve questa email quando autorizzi la tua app Google Chat a richiamare la tua funzione.

9. In Trigger, seleziona Utilizza un URL dell'endpoint HTTP comune per tutti i trigger.

10. In URL endpoint HTTP, incolla l'URL trigger della funzione Cloud Functions formattato come https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial. Se hai eseguito il deployment della funzione Cloud Functions con gcloud CLI, questa è la proprietà url.

11. Registra i comandi slash dell'app Chat. Per registrare un comando slash:

    1. Nella sezione Comandi, fai clic su Aggiungi un comando.

    2. Per ogni comando descritto nella tabella seguente, inserisci l'ID comando, la Descrizione, seleziona Comando slash in Tipo di comando, inserisci il Nome comando slash, seleziona Finestra di dialogo e poi fai clic su Fine:

       ID comando	Descrizione	Nome comando slash	Dialog
       1	Crea una storia con il titolo specificato.	/createUserStory	Deselezionato
       2	Elenca tutte le storie assegnate all'utente.	/myUserStories	Deselezionato
       3	Mostra lo stato attuale della storia specificata.	/userStory	Deselezionato
       4	Si apre una finestra di dialogo in cui è possibile modificare le storie.	/manageUserStories	Selezionato
       5	Elimina tutte le storie nello spazio.	/cleanupUserStories	Deselezionato

12. In Visibilità, seleziona Rendi disponibile questa app Google Chat a utenti e gruppi specifici nel tuo dominio Workspace e inserisci il tuo indirizzo email.

13. (Facoltativo) In Log, seleziona Registra errori in Logging.

14. Fai clic su Salva. Viene visualizzato un messaggio di conferma del salvataggio della configurazione.

L'app Chat è pronta a ricevere e rispondere ai messaggi su Chat.

Testare l'app Chat

Prova l'app Chat di gestione dei progetti inviandole un messaggio e utilizzando i suoi comandi slash per creare, modificare ed eliminare le storie dell'utente.

1. Apri Google Chat utilizzando l'account Google Workspace che hai fornito quando ti sei aggiunto come tester attendibile.

   Vai a Google Chat

2. Fai clic su Nuova chat.
3. Nel campo Aggiungi una o più persone, digita il nome della tua app di Chat.

4. Seleziona l'app di chat dai risultati. Si apre un messaggio diretto.

   Nota:se non vedi la tua app di Chat nell'elenco dei risultati, assicurati di aver incluso il tuo account Google Workspace nelle impostazioni di visibilità della pagina di configurazione dell'API di Chat nella console API di Google.
5. Nel nuovo messaggio diretto con l'app, digita Hello e premi enter. L'app di chat per la gestione dei progetti risponde con un menu di assistenza che descrive le sue funzionalità.
6. Per creare una storia, digita /createUserStory Test story nella barra dei messaggi e inviala. L'app di chat di gestione dei progetti risponde con un messaggio della scheda che descrive in dettaglio la user story che crea per te utilizzando l'AI generativa di Vertex AI.

7. Nella console API, controlla il database Firestore per esaminare i record creati sullo spazio a cui hai aggiunto l'app Chat, gli utenti che hanno interagito con lo spazio e la storia dell'utente che hai creato.

   Vai a Firestore

8. Torna a Google Chat.

   Vai a Google Chat

9. (Facoltativo) Per modificare la storia, fai clic su Modifica. Quando la storia ti soddisfa, fai clic su Salva.
10. Prova ogni comando slash supportato dall'app. Per visualizzarli, digita / o menziona l'app Chat.
11. Elimina la storia dell'utente di test eseguendo il comando slash /cleanupUserStories. In alternativa, rimuovi o disinstalla l'app. Una volta rimossa, l'app elimina tutte le storie dell'utente create in quello spazio.

Risoluzione dei problemi

Quando un'app Google Chat o una scheda restituisce un errore, l'interfaccia di Chat mostra il messaggio "Si è verificato un problema". o "Impossibile elaborare la richiesta". A volte l'interfaccia utente di Chat non mostra alcun messaggio di errore, ma l'app o la scheda Chat produce un risultato imprevisto; ad esempio, un messaggio della scheda potrebbe non essere visualizzato.

Anche se nell'interfaccia utente di Chat potrebbe non essere visualizzato un messaggio di errore, sono disponibili messaggi di errore descrittivi e dati di log per aiutarti a correggere gli errori quando la registrazione degli errori per le app di chat è attivata. Per assistenza nella visualizzazione, nel debug e nella correzione degli errori, consulta Risolvere e correggere gli errori di Google Chat.

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.

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per questo tutorial, quando lo eliminerai, eliminerai anche tutto il lavoro che hai svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL su appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più tutorial e guide rapide, puoi riutilizzare i progetti ed evitare così di superare i limiti di quota.

1. Nella console API di Google, vai alla pagina Gestisci risorse. Fai clic su Menu > IAM e amministrazione > Gestisci risorse.

   Vai a Resource Manager

2. Nell'elenco dei progetti, seleziona quello che vuoi eliminare e poi fai clic su Elimina .
3. Nella finestra di dialogo, digita l'ID progetto, quindi fai clic su Chiudi per eliminare il progetto.

Argomenti correlati

• Pianificare i viaggi con un agente AI accessibile in Google Workspace
• Rispondere a domande basate sulle conversazioni di Chat con un'app Gemini AI Chat
• Rispondere agli incidenti con Google Chat, Vertex AI, Apps Script e l'autenticazione utente
• Verificare l'accuratezza delle affermazioni con un agente AI ADK e il modello Gemini
• Integrare concetti di base dell'AI nelle app di chat
• Creare un'app di Chat come componente aggiuntivo di Google Workspace con Apps Script