Gestisci progetti con Google Chat, Vertex AI e Firestore

Questo tutorial mostra come creare un'app di Google Chat che un team possa per gestire progetti in tempo reale. L'app Chat utilizza Vertex AI per aiutare i team a scrivere storie utente (che rappresentano le caratteristiche di un software dal punto di vista dell'utente che il team sviluppa) e rende persistenti le storie in un database Firestore.

Prerequisiti

• Un'azienda o un'impresa Google Workspace con accesso a Google Chat.

• Accedi ai servizi Google Cloud per:

  • Creare un progetto Google Cloud.
  • Collega un account di fatturazione Google Cloud al progetto Cloud. A per scoprire se hai accesso, Autorizzazioni necessarie per attivare la fatturazione.

  • Utilizzare chiamate di funzione Google Cloud Functions non autenticate, che puoi verificare determinando se le tue risorse Google Cloud l'organizzazione utilizza la condivisione limitata al dominio.

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

• Se utilizzi Google Cloud CLI, viene eseguito il deployment di un file Node.js di sviluppo configurato per funzionare con gcloud CLI. Consulta Impostazione di uno sviluppo Node.js encoder-decoder.

Obiettivi

• Crea un'app di Chat che gestisca un software agile in modo programmatico a gestire i progetti.
• Aiuta gli utenti a scrivere storie utente con la tecnologia Strumenti per la scrittura di storie assistiti dall'IA 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 il lavoro aggiornato scrivendo e leggendo un database Firestore.
• Agevola la collaborazione in uno spazio di Chat consentendo agli utenti creare, modificare, assegnare e avviare storie direttamente dalla conversazione.

Prodotti utilizzati

L'app di gestione dei progetti utilizza le seguenti funzionalità di Google Workspace e Prodotti Google Cloud:

• API Chat: Un'API per lo sviluppo di app Google Chat che ricevono e rispondono a Eventi di interazione via chat, come i messaggi. La gestione dei progetti L'app Google Chat utilizza l'API Chat per ricevere e rispondere agli eventi di interazione inviati da Chat e configurare attributi che determinano come appare in Chat, ad esempio il nome e l'immagine dell'avatar.
• API Vertex AI: una piattaforma di IA generativa. La gestione dei progetti L'app Google Chat utilizza l'API Vertex AI per scrivere una storia utente titoli e descrizioni.
• Firestore: Un database di documenti serverless. La gestione dei progetti L'app Google Chat utilizza Firebase per archiviare i dati delle storie utente.

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

  Cloud Functions utilizza i seguenti prodotti Google Cloud per creare: eventi di interazione con i processi e risorse di computing dell'host:

  • 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 elabora gli eventi di interazione con Chat su un endpoint HTTP, utilizza Vertex AI per scrive storie utente e archivia i relativi dettagli in un database Firestore. La il seguente diagramma mostra l'architettura di Google Workspace delle risorse Google Cloud utilizzate.

L'app Google Chat per la gestione dei progetti funziona così:

1. Un utente invia un messaggio in Chat e richiama la app Google Chat per la gestione dei progetti tramite messaggio direttamente, menzionandolo in uno spazio o inserendo un comando slash.

2. Chat invia una richiesta HTTP sincrona alla funzione Cloud Functions endpoint HTTP.

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

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

   2. Un database Firestore archivia, recupera, aggiorna o elimina una storia utente e i dati di Google Cloud.

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

prepara l'ambiente

Questa sezione mostra come creare e configurare un progetto Google Cloud App Chat.

Creare un progetto Google Cloud

Console Google Cloud

1. Nella console Google Cloud, vai al Menu menu > IAM e Amministratore > 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 creato dopo la creazione del progetto, quindi scegli un ID che soddisfi le tue esigenze per tutta la durata progetto.

3. Nel campo Località, fai clic su Sfoglia per visualizzare le località potenziali per il tuo progetto. Poi, fai clic su Seleziona.
4. Fai clic su Crea. La console Google Cloud accede alla pagina Dashboard e il progetto viene creato entro pochi minuti.

Interfaccia a riga di comando gcloud

In uno dei seguenti ambienti di sviluppo, accedi a Google Cloud Interfaccia a riga di comando ("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, install e inizializzare con 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

Console Google Cloud

1. Nella console Google Cloud, vai a Fatturazione. Clic Menu menu > Fatturazione > I miei progetti.

   Vai a Fatturazione per i miei progetti

2. In Seleziona un'organizzazione, scegli l'organizzazione associata del tuo progetto Google Cloud.
3. Nella riga del progetto, apri il menu Azioni (more_vert), fai clic su Modifica fatturazione e scegli di 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 per Progetto cloud per il quale vuoi abilitare la fatturazione.
   • BILLING_ACCOUNT_ID è l'ID account di fatturazione da collegare a a livello di progetto Google Cloud.

Abilita le API

Autenticazione e autorizzazione

Per farlo, non è necessaria alcuna configurazione di autenticazione e autorizzazione tutorial di Google Cloud.

Per chiamare le API Firestore e Vertex AI, questo tutorial utilizza Credenziali predefinite dell'applicazione con l'account di servizio predefinito collegato alla funzione Cloud Functions, non è necessario configurare. Nel contesto di un ambiente di produzione, in genere creazione e allega un account di servizio alla funzione Cloud Functions.

Creare e implementare l'app Google Chat

Ora che il progetto Google Cloud è stato creato e configurato, puoi iniziare a creare ed eseguire il deployment dell'app Google Chat. In questa sezione, seguenti:

1. Crea un database Firestore in cui mantenere e recuperare le storie degli utenti.
2. Se vuoi, esamina il codice campione.
3. Crea una funzione Cloud Functions per ospitare ed eseguire Codice dell'app di chat in risposta agli eventi ricevute da Chat come richieste HTTP.
4. Creare e implementare un'app Google Chat sull'API Google Chat di configurazione del deployment.

Crea il database Firestore

In questa sezione, creerai un database Firestore da mantenere e recuperare storie utente, ma non definisci il modello dei dati. Il modello dei dati è impostato implicitamente nel codice campione da model/user-story.js e model/user.js .

Il database dell'app Chat per la gestione dei progetti utilizza un database NoSQL modello dei dati basato su class documenti organizzati in collections_bookmark collections. Per saperne di più, vedi Modello dei dati Firestore.

Il seguente diagramma è una panoramica della gestione dei progetti Modello dei dati dell'app Google Chat:

La raccolta radice è spaces, dove ogni documento rappresenta uno spazio che il L'app Chat ha creato storie in. Ogni storia utente è rappresentato da un documento nella sottoraccolta userStories e ogni utente viene rappresentato da un documento nella sottoraccolta users.

Ecco come creare il database Firestore:

Esamina il codice campione

Facoltativamente, prima di creare la funzione Cloud Functions, dedica un momento alla revisione e acquisire familiarità 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 di Chat a un progetto Google Cloud specificato regione. 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. it legge Evento di chat da la richiesta HTTP, chiama il gestore dell'app e pubblica la risposta HTTP come JSON.

controllers/app.js

La logica principale dell'applicazione. Elabora eventi di interazione gestendo L'app di chat menziona e utilizza i comandi slash. Per rispondere ai clic sulla scheda, chiama il numero app-action-handler.js.

controllers/app-action-handler.js

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

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

Questi file contengono le parti della logica dell'applicazione specifica per lavorare con gli spazi di Chat, utenti e 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 funzioni in firestore-service.js.

services/firestore-service.js

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

services/aip-service.js

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

model/*.js

Questi file contengono la definizione delle classi e delle enumerazioni che l'applicazione per archiviare e trasferire dati tra le funzioni. Hanno impostato per il database Firestore.

views/*.js

Ogni file in questa directory crea un'istanza un oggetto card che l'app Chat rimanda a Chat sotto forma di un messaggio nella scheda o risposta all'azione della finestra di dialogo.

views/widgets/*.js

Ogni file crea un'istanza un tipo di widget utilizzato dall'app per creare le schede nella directory views/.

test/**/*.test.js

Ogni file in questa directory e nelle sue sottodirectory contiene i test delle unità per la funzione, il controller, il servizio, la vista o il widget corrispondenti. Puoi eseguire tutti i test delle unità eseguendo npm run test mentre nella directory radice 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 di Chat contenente un indirizzo evento di interazione. Quando viene eseguito, il codice della funzione Cloud Functions elabora l'evento e restituisce una risposta a Chat, che quest'ultima viene visualizzata come un messaggio, una finestra di dialogo o un altro tipo di interazione dell'utente. Se applicabile, le API Cloud La funzione legge o scrive anche sul database Firestore.

Ecco come creare la funzione Cloud Functions:

1. Al termine del deployment della funzione, copia la proprietà url dal risposta. Questo è l'URL attivatore da utilizzare 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 in console Google Cloud con informazioni sull'app Chat, inclusi il nome dell'app di Chat, la barra supportata e l'URL trigger del cloud dell'app Chat Funzione a cui invia eventi di interazione con Chat.

1. Nella console Google Cloud, fai clic su Menu. 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 sul pulsante di attivazione/disattivazione Abilita le funzionalità interattive per attivare le funzionalità.

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

7. In Impostazioni di connessione, seleziona URL app.

8. In App URL (URL app), incolla l'URL trigger che hai copiato dalla sezione Cloud Deployment delle funzioni, formattato come https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial. Se hai eseguito il deployment della funzione Cloud Functions con gcloud CLI, questo è il url proprietà.

9. Registrare l'interfaccia utente di Chat comandi slash. Per registrare un comando slash:

   1. In Comandi Slash, fai clic su Aggiungi un comando con barra.

   2. Per ciascun comando slash dettagliato nella tabella seguente, inserisci Nome, ID comando, Descrizione e scegli se Fai clic sul comando slash apre una finestra di dialogo, quindi fai clic su Fine:

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

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

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

12. Fai clic su Salva. Viene visualizzato un messaggio di configurazione salvata, il che significa L'app Chat è pronto per il test.

Testare l'app Chat

Testa l'app di Chat per la gestione dei progetti inviando un messaggio e usando i suoi comandi slash per creare, modificare ed eliminare le storie utente.

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

   Vai a Google Chat

2. Fai clic su add Nuova chat.
3. Nel campo Aggiungi una o più persone, digita il nome del tuo App Chat.

4. Seleziona la tua app Chat dai risultati. Un annuncio diretto si apre il messaggio.

5. Nel nuovo messaggio diretto con l'app, digita Hello e premi enter. La gestione dei progetti L'app Chat risponde con un menu della guida che descrive in dettaglio di cosa si tratta che è possibile fare.
6. Per creare una storia, digita /createUserStory Test story nel nella barra dei messaggi e invialo. La gestione dei progetti L'app Chat risponde con un messaggio nella scheda con i dettagli una storia utente che crea per te utilizzando l'IA generativa di Vertex AI.

7. Nella console, controlla il database Firestore per esaminare record che ha creato per lo spazio in cui hai aggiunto all'app di chat, agli utenti che hanno interagito con quest'ultima e la storia utente che hai creato.

   Vai a Firestore

8. Torna a Google Chat.

   Vai a Google Chat

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

Risoluzione dei problemi

Quando un'app Google Chat o card restituisce un errore, L'interfaccia di Chat mostra il messaggio "Si è verificato un problema". o "Impossibile elaborare la richiesta". A volte, l'UI di Chat non mostra alcun messaggio di errore, ma l'app Chat o la scheda restituisce un risultato inaspettato; Ad esempio, il messaggio di una scheda potrebbe non vengono visualizzate.

Anche se un messaggio di errore potrebbe non essere visualizzato nella UI di Chat, messaggi di errore descrittivi e dati di log che ti aiuteranno a correggere gli errori quando il logging degli errori per le app di chat è attivo. Per assistenza con la visualizzazione, il debug e la correzione degli errori, consulta Risolvere i problemi e correggere gli errori di Google Chat.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alla utilizzate in questo tutorial, ti consigliamo di eliminare progetto cloud.

1. Nella console Google Cloud, vai alla pagina Gestisci risorse. Clic Menu menu > IAM e Amministratore > Gestisci risorse.

   Vai a Resource Manager .

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

Argomenti correlati

• Rispondere a domande basate su conversazioni di Chat con un'app Gemini AI Chat
• Rispondere agli incidenti con Google Chat, Vertex AI e Apps Script