Gestisci progetti con Google Chat, Vertex AI e Firestore

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

• 

  Figura 1. Carlo parla dello sviluppo di funzionalità in uno spazio di Chat con il suo team. Menzionando l'app Chat per la gestione dei progetti viene chiesto all'app Chat di offrire assistenza.

• 
  Figura 2. Usando 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 e poi condivide la storia nello spazio.
• 
  Figura 4. Carlo fa clic su Modifica per finalizzare i dettagli della storia. La descrizione dell'IA è accurata, ma Carlo vuole maggiori dettagli, quindi fa clic su Espandi per chiedere a Vertex AI di aggiungere requisiti alla descrizione della storia. Carlo si assegna la storia, imposta lo stato su Iniziata, seleziona una priorità e una dimensione appropriate, quindi fa clic su Salva.
• 
  Figura 5. In qualsiasi momento, Carlo può visualizzare e gestire tutte le storie degli utenti del team con il comando slash /manageUserStories.

Prerequisiti

• Un account Google Workspace con accesso a Google Chat.

• Accedi ai servizi Google Cloud per:

  • Creare un progetto Google Cloud.
  • Collegare un account di fatturazione Google Cloud al progetto Cloud. Per sapere se hai accesso, consulta Autorizzazioni necessarie per abilitare la fatturazione.

  • Utilizza le chiamate di funzioni Google Cloud Functions non autenticate, che puoi verificare determinando se la tua organizzazione Google Cloud utilizza la condivisione limitata per i domini.

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

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

Obiettivi

• Creare un'app di Chat che gestisca progetti software agili.
• Aiuta gli utenti a scrivere storie degli utenti con strumenti di scrittura di storie basati sull'IA generativa e basati su Vertex AI:
  • Genera e rigenera descrizioni delle storie.
  • Espandi le descrizioni delle storie dalle note per completare i requisiti.
  • Correggi la grammatica per correggere gli errori di battitura.
• Mantieni aggiornato il lavoro scrivendo e leggendo in un database Firestore.
• Agevola la collaborazione in uno spazio di Chat consentendo agli utenti di creare, modificare, assegnare e avviare storie direttamente dalla conversazione.

Prodotti utilizzati

L'app per la 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 agli eventi di interazione con 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, nonché per configurare gli attributi che determinano il modo in cui viene visualizzata in Chat, ad esempio nome e immagine dell'avatar.
• API Vertex AI: una piattaforma di IA generativa. L'app Google Chat per la gestione dei progetti utilizza l'API Vertex AI per scrivere titoli e descrizioni delle storie utente.
• Firestore: un database di documenti serverless. L'app Google Chat per la gestione dei progetti utilizza Firebase per archiviare i dati delle storie utente.

• Cloud Functions: un servizio di serverless computing leggero che consente di creare funzioni autonome a uso specifico in grado di rispondere agli eventi di interazione di Chat senza la necessità di gestire un ambiente server o di runtime. L'app Google Chat per la gestione dei progetti utilizza Cloud Functions per ospitare l'endpoint HTTP a cui Chat invia eventi di interazione e come piattaforma di elaborazione per eseguire una 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 automatiche.
  • 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 eventi di interazione con Chat in un endpoint HTTP, utilizza Vertex AI per scrivere le storie degli utenti e archivia i dettagli delle storie utente 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 per la gestione dei progetti inviando un messaggio diretto, menzionandola in uno spazio o inserendo un comando slash.

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

3. L'app Google Chat per il project management elabora la richiesta HTTP:

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

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

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

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

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

   Vai a Crea un progetto

2. 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.

3. Nel campo Località, fai clic su Sfoglia per visualizzare le potenziali località per il tuo progetto. Poi, fai clic su Seleziona.
   Attenzione: non riesci a trovare la tua organizzazione Google Workspace?
   Questo significa che non hai eseguito l'accesso a un account Google Workspace. Alcune delle funzionalità descritte nella documentazione per gli sviluppatori di Google Workspace sono disponibili solo per i progetti associati a un'organizzazione.
4. 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":

  gcloud projects create PROJECT_ID

  Sostituisci PROJECT_ID impostando l'ID per il progetto che vuoi creare.

Abilita la fatturazione per il progetto cloud

Se non riesci a collegare un account di fatturazione, non hai le autorizzazioni necessarie per apportare questa modifica. Per maggiori informazioni, consulta Autorizzazioni richieste per abilitare la fatturazione.

Console Google Cloud

1. Nella console Google Cloud, 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.

Interfaccia a riga di comando gcloud

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 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

1. Nella console Google Cloud, 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, quindi fai clic su Avanti.

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

Interfaccia a riga di comando gcloud

1. 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.

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.

autentica e autorizza

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 l'account di servizio predefinito associato alla funzione Cloud Functions, che non è necessario configurare. Nel contesto di un ambiente di produzione, in genere è necessario creare e collegare un account di servizio alla funzione Cloud Functions.

Creare ed eseguire il deployment dell'app Google Chat

Ora che il tuo progetto Google Cloud è stato creato e configurato, puoi creare l'app Google Chat ed eseguirne il deployment. In questa sezione imparerai come segue:

1. Crea un database Firestore in cui persistere e recuperare le storie degli utenti.
2. Se vuoi, rivedi il codice campione.
3. Creare 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 ed esegui il deployment di un'app Google Chat nella pagina di configurazione dell'API Google Chat.

Crea il database Firestore

In questa sezione creerai un database Firestore per mantenere e recuperare le storie degli utenti, ma non definisci il modello dei dati. Il modello dei dati è impostato implicitamente nel codice di esempio 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 ulteriori informazioni, consulta Modello dei dati di Firestore.

Il seguente diagramma è 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 le storie. Ogni storia utente è rappresentata da un documento nella sottoraccolta userStories e ogni utente è rappresentato da un documento nella sottoraccolta users.

Visualizza le definizioni di raccolte, documenti e campi

spaces

Spazi in cui l'app Chat ha creato le 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 al Document ID di userStories in Firebase.
users	Subcollection of Documents (user) Utenti che hanno creato o a cui sono state 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 utente specifica creata dall'app Chat e dai suoi utenti.
assignee	Document (user) Il nome della risorsa dell'utente assegnato per completare la storia. Corrisponde all'Document ID del documento users e al nome della risorsa di un utente nell'API Chat.
description	String Una descrizione della funzionalità 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 richiesto. I valori possibili sono Small, Medium o Large.
status	Enum La fase del lavoro. I valori possibili sono OPEN, STARTED o COMPLETED.
title	String Il titolo della storia; un breve riepilogo.

users

Utenti che hanno creato o a cui sono state assegnate storie.

Campi
Document ID	String ID univoco di un utente specifico. Corrisponde all'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 di Chat dell'utente.

Ecco come creare il database Firestore:

Console Google Cloud

1. Nella console Google Cloud, 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à Native.

4. Fai clic su Continua.

5. Configura il database:

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

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

6. Fai clic su Crea database.

Interfaccia a riga di comando gcloud

• 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

Facoltativamente, prima di creare la funzione Cloud Functions, dedica un momento a rivedere e acquisire familiarità con il codice campione ospitato su GitHub.

Visualizza su GitHub

Ecco una panoramica di ciascun file:

env.js

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

package.json e package-lock.json

Impostazioni e dipendenze del progetto Node.js.

index.js

Punto di ingresso per la funzione Cloud Functions dell'app Chat. Legge l'evento 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 le menzioni e i comandi slash dell'app Chat. Per rispondere ai clic sulle schede, chiama app-action-handler.js.

controllers/app-action-handler.js

La logica dell'applicazione per gestire i clic delle schede su Eventi di interazione con la 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 il lavoro con gli spazi di Chat, gli utenti e le storie utente. Le funzioni in questi file sono chiamate da app.js o app-action-handler.js. Per eseguire operazioni di database, le funzioni in questi file chiamano le funzioni in firestore-service.js.

services/firestore-service.js

Gestisce le operazioni del database. Le funzioni in questo file sono richiamate 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 con l'IA generativa.

model/*.js

Questi file contengono la definizione di classi ed enumerazioni utilizzate dai servizi dell'applicazione per archiviare e passare dati da una funzione all'altra. Hanno impostato il modello dei dati per il database Firestore.

views/*.js

Ogni file in questa directory crea un'istanza di un oggetto card che l'app Chat restituisce quindi a Chat come messaggio scheda o risposta di 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 delle unità per la funzione, il controller, il servizio, la vista o il widget corrispondente. Puoi eseguire tutti i test delle unità eseguendo npm run test nella directory root del progetto.

Crea ed esegui il deployment della funzione Cloud Functions

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

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

Ecco come creare la funzione Cloud Functions:

Console Google Cloud

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 google-chat-samples-main/node/project-management-app/, quindi comprimi la cartella project-management-app in un file ZIP.

   La directory radice 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 Google Cloud, vai alla pagina Cloud Functions:

   Vai a Cloud Functions

   Assicurati che sia selezionato il progetto Google Cloud per l'app Chat.

5. Fai clic su Crea funzione.

6. Nella pagina Crea funzione, imposta la funzione:

   1. In Ambiente, seleziona 2a generazione.
   2. In Nome funzione, inserisci project-management-tutorial.
   3. In Regione, seleziona una regione.
   4. In Autenticazione, seleziona Consenti chiamate non autenticate.
   5. Tocca Next (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 postale.

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. e Cloud Functions copia i file dei componenti nella funzione Cloud Functions.

11. In File ZIP, carica il file ZIP scaricato da GitHub, estratto e ricompresso:

    1. Fai clic su Sfoglia.
    2. Individua e seleziona il file ZIP.
    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, il deployment della funzione è stato eseguito ed è pronta.

13. Modifica il codice campione per impostare le costanti:

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

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 Attivatore.
    2. Copia l'URL. Ti serve per configurare l'app Chat nella sezione seguente.

Interfaccia a riga di comando gcloud

1. Clona il codice da GitHub:

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

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

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

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

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

4. Esegui il deployment della funzione Cloud Functions in 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à della funzione Cloud Functions in cui è ospitata la relativa infrastruttura, ad esempio us-central1.

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

Configurare l'app Google Chat nella console Google Cloud

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

1. Nella console Google Cloud, fai clic su Menu > Altri prodotti > Google Workspace > Libreria prodotti > API Google Chat > Gestisci > 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 sull'opzione Attiva funzionalità interattive per attivare l'opzione.

6. In Funzionalità, seleziona Ricevi messaggi 1:1 e Partecipare a spazi e conversazioni di gruppo.

7. In Impostazioni di connessione, seleziona URL app.

8. In URL app, incolla l'URL di trigger che hai copiato dal deployment di Cloud Functions, nel formato 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.

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

   1. In Comandi slash, fai clic su Aggiungi comando slash.

   2. Per ogni comando slash descritto nella tabella seguente, inserisci Nome, ID comando, Descrizione e scegli se il comando slash apre una finestra di dialogo, poi fai clic su Fine:

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

10. In Visibilità, seleziona Rendi questa app di chat disponibile a persone e gruppi specifici nel tuo dominio Workspace e inserisci il tuo indirizzo email.

11. Facoltativamente, in Log, seleziona Registra errori in Logging.

12. Fai clic su Salva. Viene visualizzato un messaggio di configurazione salvata, a indicare che l'app Chat è pronta per essere testata.

Testare l'app Chat

Testa l'app di Chat per la gestione del progetto inviandole messaggi e utilizzando i comandi slash per creare, modificare ed eliminare le storie utente.

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

   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 Chat nell'elenco dei risultati, assicurati di aver incluso il tuo account Google Workspace nelle impostazioni di Visibilità della pagina Configurazione dell'API Chat nella console Google Cloud.
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 Guida che spiega in dettaglio cosa può fare.
6. Per creare una storia, digita /createUserStory Test story nella barra dei messaggi e inviala. L'app Chat di Project Management risponde con un messaggio scheda che descrive in dettaglio la storia utente che crea per te utilizzando l'IA generativa di Vertex AI.

7. Nella console, controlla il database Firestore per esaminare i record che ha creato in relazione allo spazio a cui hai aggiunto l'app Chat, gli utenti che l'hanno interagito e la storia utente che hai creato.

   Vai a Firestore

8. Torna a Google Chat.

   Vai a Google Chat

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

Risolvi il problema

Quando un'app o una scheda Google Chat restituisce un errore, nell'interfaccia di Chat viene visualizzato il messaggio "Si è verificato un problema" o "Impossibile elaborare la richiesta". A volte nell'interfaccia utente di Chat non vengono visualizzati messaggi di errore, ma l'app o la scheda Chat produce un risultato imprevisto; ad esempio, è possibile che non venga visualizzato un messaggio di scheda.

Anche se un messaggio di errore potrebbe non essere visualizzato nell'interfaccia utente di Chat, 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 informazioni su visualizzazione, debug e correzione degli errori, consulta l'articolo Risolvere 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 elimini, elimini anche qualsiasi altro lavoro 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 prevedi di esplorare più tutorial e guide rapide, puoi riutilizzare i progetti per evitare di superare i limiti di quota.

1. Nella console Google Cloud, 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 da eliminare e fai clic su Elimina .
3. 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
• Rispondere agli incidenti con Google Chat, Vertex AI e Apps Script