Diese Seite wurde von der Cloud Translation API übersetzt.

Projekte mit Google Chat, Vertex AI und Firestore verwalten

In dieser Anleitung erfahren Sie, wie Sie eine Google Chat-App erstellen, mit der ein Team Projekte in Echtzeit verwalten kann. In der Chat-App wird Vertex AI verwendet, um Teams beim Erstellen von User Storys zu unterstützen. Diese stellen Funktionen eines Softwaresystems aus der Sicht eines Nutzers dar, die das Team entwickeln soll. Die Storys werden in einer Firestore-Datenbank gespeichert.

Abbildung 1: Charlie bespricht die Funktionsentwicklung in einem Chatbereich mit seinem Team. Wenn Sie die Chat-App für die Projektverwaltung erwähnen, bietet die Chat-App Hilfe an.
Abbildung 2: Charlie erstellt mit dem Befehl /createUserStory eine Story.
Abbildung 3 Die Projektmanagement-Chat-App verwendet Vertex AI, um die Beschreibung der Geschichte zu schreiben, und teilt die Geschichte dann im Gruppenbereich.
Abbildung 4: Charlie klickt auf Bearbeiten, um die Storydetails fertigzustellen. Die KI-Beschreibung ist korrekt, aber Charlie möchte mehr Details. Also klickt Charlie auf Maximieren, damit Vertex AI der Beschreibung der Story Anforderungen hinzufügt. Charlie weist sich die Geschichte zu, legt den Status auf „Gestartet“ fest, wählt eine passende Priorität und Größe aus und klickt dann auf Speichern.
Abbildung 5: Charlie kann jederzeit alle User Storys des Teams mit dem /manageUserStories-Schrägstrichbefehl ansehen und verwalten.

Vorbereitung

Ein Google Workspace-Konto für Unternehmen oder Organisationen mit Zugriff auf Google Chat.
Zugriff auf Google Cloud-Dienste für Folgendes:
- Google Cloud-Projekt erstellen.
- Google Cloud-Rechnungskonto mit dem Cloud-Projekt verknüpfen Unter Erforderliche Berechtigungen zum Aktivieren der Abrechnung erfahren Sie, ob Sie Zugriff haben.
- Verwenden Sie nicht authentifizierte Aufrufe von Google Cloud-Funktionen. Sie können prüfen, ob Ihre Google Cloud-Organisation die eingeschränkte Domainfreigabe verwendet.
Wenden Sie sich bei Bedarf an Ihren Google Cloud-Administrator, um Zugriff oder Berechtigung zu erhalten.
Wenn Sie die Google Cloud CLI verwenden, eine Node.js-Entwicklungsumgebung, die für die Verwendung mit der gcloud CLI konfiguriert ist. Weitere Informationen finden Sie unter Node.js-Entwicklungsumgebung einrichten.

Zielsetzungen

Erstellen Sie eine Chat-App, mit der agile Softwareprojekte verwaltet werden.
Mithilfe von generativen KI-gestützten Tools zum Erstellen von Storys, die auf Vertex AI basieren, können Sie Nutzern beim Erstellen von User Storys helfen:
- Story-Beschreibungen generieren und neu generieren
- Erweitern Sie die Storybeschreibungen aus den Notizen, um die Anforderungen zu erfüllen.
- Korrigieren Sie die Grammatik, um Tippfehler zu korrigieren.
Halten Sie die Arbeit auf dem neuesten Stand, indem Sie in eine Firestore-Datenbank schreiben und aus dieser lesen.
Erleichtern Sie die Zusammenarbeit in einem Chatbereich, indem Sie Nutzern die Möglichkeit geben, Geschichten direkt aus der Unterhaltung heraus zu erstellen, zu bearbeiten, zuzuweisen und zu starten.

Verwendete Produkte

Für die Projektmanagement-App werden die folgenden Google Workspace- und Google Cloud-Produkte verwendet:

Chat API: API zum Entwickeln von Google Chat-Apps, die Chat-Interaktionsereignisse wie Nachrichten empfangen und darauf reagieren. Die Google Chat App für das Projektmanagement verwendet die Chat API, um von Google Chat gesendete Interaktionsereignisse zu empfangen und darauf zu reagieren und um Attribute wie Name und Avatar zu konfigurieren, mit denen festgelegt wird, wie sie in Google Chat angezeigt werden.
Vertex AI API: Eine Plattform für generative KI. Die Google Chat-App für die Projektverwaltung verwendet die Vertex AI API, um Titel und Beschreibungen für User Storys zu erstellen.
Firestore: Eine serverlose Dokumentendatenbank. Die Google Chat-App für die Projektverwaltung verwendet Firebase, um Daten zu User Storys zu speichern.
Cloud Functions: Ein einfacher, serverloser Computing-Dienst, mit dem Sie zweckgebundene, eigenständige Funktionen erstellen können, die auf Chat-Interaktionsereignisse reagieren, ohne dass Sie eine Server- oder Laufzeitumgebung verwalten müssen. Die Google Chat App für das Projektmanagement verwendet Cloud Functions, um den HTTP-Endpunkt zu hosten, an den Chat Interaktionsereignisse sendet, und als Computing-Plattform, um Logik auszuführen, die diese Ereignisse verarbeitet und darauf reagiert.

Cloud Functions verwendet die folgenden Google Cloud-Produkte zum Erstellen, Verarbeiten von Interaktionsereignissen und Hosten von Rechenressourcen:
- Cloud Build: Eine vollständig verwaltete Plattform für Continuous Integration, Continuous Delivery und Continuous Deployment, die automatisierte Builds ausführt.
- Pub/Sub: Ein asynchroner, skalierbarer Messaging-Dienst, der Dienste entkoppelt, die Nachrichten von Diensten erzeugen, die diese Nachrichten verarbeiten.
- Cloud Run Admin API: Eine vollständig verwaltete Umgebung zum Ausführen von Containeranwendungen.

Architektur

Die Architektur der Google Chat-App für die Projektverwaltung empfängt und verarbeitet Chat-Interaktionsereignisse an einem HTTP-Endpunkt, verwendet Vertex AI, um User Storys zu erstellen, und speichert die Details der User Storys in einer Firestore-Datenbank. Das folgende Diagramm zeigt die Architektur der verwendeten Google Workspace- und Google Cloud-Ressourcen.

Architekturdiagramm für die Google Chat-App zur Projektverwaltung

So funktioniert die Google Chat-App für das Projektmanagement:

Ein Nutzer sendet eine Nachricht in Google Chat und ruft die Google Chat-App für die Projektverwaltung auf, indem er ihr entweder direkt eine Nachricht sendet, sie in einem Gruppenbereich erwähnt oder einen Befehl eingibt.
Chat sendet eine synchrone HTTP-Anfrage an den HTTP-Endpunkt der Cloud-Funktion.
Die Google Chat-App für das Projektmanagement verarbeitet die HTTP-Anfrage:
1. Vertex AI unterstützt Sie beim Erstellen oder Aktualisieren einer User Story.
2. In einer Firestore-Datenbank werden User-Story-Daten gespeichert, abgerufen, aktualisiert oder gelöscht.
Cloud Functions gibt eine HTTP-Antwort an Google Chat zurück, die dem Nutzer als Nachricht oder Dialogfeld angezeigt wird.

Umgebung vorbereiten

In diesem Abschnitt wird beschrieben, wie Sie ein Google Cloud-Projekt für die Chat-App erstellen und konfigurieren.

Google Cloud-Projekt erstellen

Google Cloud Console

Öffnen Sie in der Google Cloud Console das Dreistrich-Menü > IAM und Verwaltung > Projekt erstellen.
Zur Seite „Projekt erstellen“
Geben Sie im Feld Projektname einen aussagekräftigen Namen für Ihr Projekt ein.
Optional: Klicken Sie auf Bearbeiten, um die Projekt-ID zu bearbeiten. Die Projekt-ID kann nach dem Erstellen des Projekts nicht mehr geändert werden. Wählen Sie also eine ID aus, die während der gesamten Dauer des Projekts den Anforderungen entspricht.
Klicken Sie im Feld Standort auf Durchsuchen, um mögliche Standorte für Ihr Projekt zu sehen. Klicken Sie danach auf Auswählen.
Achtung: Ihre Google Workspace-Organisation wird nicht angezeigt?
Das bedeutet, dass Sie nicht in einem Google Workspace-Konto angemeldet sind. Einige der in der Google Workspace-Entwicklerdokumentation beschriebenen Funktionen sind nur für Projekte verfügbar, die mit einer Organisation verknüpft sind.
Klicken Sie auf Erstellen. In der Google Cloud Console wird die Seite „Dashboard“ geöffnet und Ihr Projekt wird innerhalb weniger Minuten erstellt.

gcloud-CLI

Rufen Sie in einer der folgenden Entwicklungsumgebungen die Google Cloud CLI (gcloud) auf:

Cloud Shell: Aktivieren Sie Cloud Shell, um ein Onlineterminal zu verwenden, auf dem die gcloud CLI bereits eingerichtet ist.
Cloud Shell aktivieren
Lokale Shell: Um eine lokale Entwicklungsumgebung zu verwenden, installieren und initialisieren Sie die gcloud CLI.
Verwenden Sie den Befehl gcloud projects create, um ein Cloud-Projekt zu erstellen:
```
gcloud projects create PROJECT_ID
```
Ersetzen Sie PROJECT_ID durch die ID des Projekts, das Sie erstellen möchten.

Abrechnung für das Cloud-Projekt aktivieren

Google Cloud Console

Klicken Sie in der Google Cloud Console auf Abrechnung. Klicken Sie auf Menü > Abrechnung > Meine Projekte.
Zur Abrechnung für „Meine Projekte“
Wählen Sie unter Organisation auswählen die Organisation aus, die mit Ihrem Google Cloud-Projekt verknüpft ist.
Öffnen Sie in der Projektzeile das Menü Aktionen (), klicken Sie auf Abrechnung ändern und wählen Sie das Cloud Billing-Konto aus.
Klicken Sie auf Konto festlegen.

gcloud-CLI

Führen Sie folgenden Befehl aus, um eine Liste der verfügbaren Rechnungskonten aufzurufen:
```
gcloud billing accounts list
```
So verknüpfen Sie ein Abrechnungskonto mit einem Google Cloud-Projekt:
```
gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID
```
Ersetzen Sie Folgendes:
- PROJECT_ID ist die Projekt-ID des Cloud-Projekts, für das Sie die Abrechnung aktivieren möchten.
- BILLING_ACCOUNT_ID ist die Rechnungskonto-ID, die mit dem Google Cloud-Projekt verknüpft werden soll.

APIs aktivieren

Google Cloud Console

Aktivieren Sie in der Google Cloud Console die Google Chat API, die Vertex AI API, die Cloud Functions API, die Firestore API, die Cloud Build API, die Pub/Sub API und die Cloud Run Admin API.

APIs aktivieren
Prüfen Sie, ob Sie die APIs im richtigen Cloud-Projekt aktivieren, und klicken Sie dann auf Weiter.
Prüfen Sie, ob Sie die richtigen APIs aktivieren, und klicken Sie dann auf Aktivieren.

gcloud-CLI

Legen Sie gegebenenfalls das aktuelle Cloud-Projekt auf das Projekt fest, das Sie mit dem Befehl gcloud config set project erstellt haben:
```
gcloud config set project PROJECT_ID
```
Ersetzen Sie PROJECT_ID durch die Projekt-ID des von Ihnen erstellten Cloud-Projekts.
Aktivieren Sie die Google Chat API, die Vertex AI API, die Cloud Functions API, die Firestore API, die Cloud Build API, die Pub/Sub API und die Cloud Run Admin API mit dem Befehl 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
```
Die Cloud Build API, die Pub/Sub API und die Cloud Run Admin API sind Voraussetzungen für Cloud Functions.

Authentifizierung und Autorisierung

Für diese Anleitung ist keine Konfiguration der Authentifizierung und Autorisierung erforderlich.

Für den Aufruf der Firestore- und Vertex AI-APIs werden in dieser Anleitung Standardanmeldedaten der Anwendung mit dem Standarddienstkonto verwendet, das mit der Cloud-Funktion verknüpft ist. Sie müssen diese nicht einrichten. In einer Produktionsumgebung create und hängen Sie stattdessen ein Dienstkonto an die Cloud-Funktion an.

Google Chat App erstellen und bereitstellen

Nachdem Sie Ihr Google Cloud-Projekt erstellt und konfiguriert haben, können Sie die Google Chat-App erstellen und bereitstellen. In diesem Abschnitt gehen Sie so vor:

Erstellen Sie eine Firestore-Datenbank, in der Sie User Storys speichern und abrufen können.
Optional können Sie sich den Beispielcode ansehen.
Erstellen Sie eine Cloud Function, um den Code der Chat-App zu hosten und auszuführen, als Reaktion auf Ereignisse, die von Google Chat als HTTP-Anfragen empfangen werden.
Erstellen und bereitstellen Sie eine Google Chat-App auf der Konfigurationsseite der Google Chat API.

Firestore-Datenbank erstellen

In diesem Abschnitt erstellen Sie eine Firestore-Datenbank, um User Storys zu speichern und abzurufen. Das Datenmodell wird jedoch nicht definiert. Das Datenmodell wird im Beispielcode implizit durch die Dateien model/user-story.js und model/user.js festgelegt.

Die Datenbank der Chat-App für die Projektverwaltung verwendet ein NoSQL-Datenmodell, das auf Dokumenten basiert, die in Sammlungen organisiert sind. Weitere Informationen finden Sie unter Firestore-Datenmodell.

Das folgende Diagramm zeigt einen Überblick über das Datenmodell der Google Chat-App für die Projektverwaltung:

Datenmodell der Firestore-Datenbank.

Die Stammsammlung ist spaces. Jedes Dokument steht für einen Gruppenbereich, in dem die Chat-App Geschichten erstellt hat. Jede User Story wird durch ein Dokument in der Untersammlung userStories und jeder Nutzer durch ein Dokument in der Untersammlung users dargestellt.

Sammlungs-, Dokument- und Felddefinitionen aufrufen

`spaces`

Gruppenbereiche, in denen die Chat App Geschichten erstellt hat.

Felder
`Document ID`	`String` Eindeutige ID eines bestimmten Gruppenbereichs, in dem Stories erstellt werden. Entspricht dem Ressourcennamen des Gruppenbereichs in der Chat API.
`userStories`	`Subcollection of Documents (userStories)` In der Chat App und von Nutzern erstellte Stories. Entspricht dem `Document ID` eines `userStories` in Firebase.
`users`	`Subcollection of Documents (user)` Nutzer, die Storys erstellt haben oder denen Storys zugewiesen sind.
`displayName`	`String` Der Anzeigename des Gruppenbereichs in der Chat API. Nicht festgelegt für Direktnachrichten an Nutzer.

`userStories`

Von der Google Chat App und ihren Nutzern erstellte Stories.

Felder
`Document ID`	`String` Eindeutige ID einer bestimmten User Story, die von der Chat-App und ihren Nutzern erstellt wurde.
`assignee`	`Document (user)` Der Ressourcenname des Nutzers, dem die Aufgabe zugewiesen ist, die Story zu erledigen. Entspricht der `Document ID` des `users`-Dokuments und dem Ressourcennamen eines Nutzers in der Chat API.
`description`	`String` Eine Beschreibung der Softwarefunktion aus der Sicht des Nutzers.
`priority`	`Enum` Die Dringlichkeit, mit der die Arbeit erledigt werden muss. Mögliche Werte sind `Low`, `Medium` und `High`.
`size`	`Enum` Wie viel Arbeit? Mögliche Werte sind `Small`, `Medium` und `Large`.
`status`	`Enum` Die Arbeitsphase. Mögliche Werte sind `OPEN`, `STARTED` und `COMPLETED`.
`title`	`String` Der Titel der Geschichte; eine kurze Zusammenfassung.

`users`

Nutzer, die Storys erstellt haben oder denen Storys zugewiesen sind.

Felder
`Document ID`	`String` Die eindeutige ID eines bestimmten Nutzers. Entspricht der `assignee` einer `userStories` in Firebase und dem Ressourcennamen eines Nutzers in der Chat API.
`avatarUrl`	`String` URL, unter der das Chat-Avatarbild des Nutzers gehostet wird.
`displayName`	`String` Der Anzeigename des Nutzers in Google Chat.

So erstellen Sie die Firestore-Datenbank:

Google Cloud Console

Wechseln Sie in der Google Cloud Console zu Firestore. Klicken Sie auf das Dreistrich-Menü > Firestore.

Firestore aufrufen
Klicken Sie auf Datenbank erstellen.
Klicken Sie unter Firestore-Modus auswählen auf Nativer Modus.
Klicken Sie auf Weiter.
Konfigurieren Sie die Datenbank:
1. Behalten Sie unter Datenbank benennen als Datenbank-ID den Wert (default) bei.
2. Geben Sie unter Standorttyp eine Region für die Datenbank an, z. B. us-central1. Für eine optimale Leistung sollten Sie denselben Speicherort oder einen Speicherort in der Nähe der Cloud Function der Chat-App auswählen.
Klicken Sie auf Datenbank erstellen.

gcloud-CLI

Mit dem Befehl gcloud firestore databases create eine Firestore-Datenbank im nativen Modus erstellen:
```
gcloud firestore databases create \
--location=LOCATION \
--type=firestore-native
```
Ersetzen Sie LOCATION durch den Namen einer Firestore-Region, z. B. us-central1.

Beispielcode ansehen

Sie können sich vor dem Erstellen der Cloud-Funktion optional mit dem auf GitHub gehosteten Beispielcode vertraut machen.

Auf GitHub ansehen

Hier eine Übersicht über die einzelnen Dateien:

env.js: Umgebungskonfigurationsvariablen für die Bereitstellung der Chat-App in einem bestimmten Google Cloud-Projekt und einer bestimmten Region. Sie müssen die Konfigurationsvariablen in dieser Datei aktualisieren.
package.json und package-lock.json: Node.js-Projekteinstellungen und ‑Abhängigkeiten
index.js: Einstiegspunkt für die Cloud-Funktion der Chat-App. Er liest das Chat-Ereignis aus der HTTP-Anfrage, ruft den App-Handler auf und postet die HTTP-Antwort als JSON-Objekt.
controllers/app.js: Die Hauptlogik der Anwendung. Verarbeitet die Interaktionsereignisse, indem Erwähnungen in der Chat-App und Slash-Befehle verarbeitet werden. Um auf Kartenklicks zu reagieren, wird app-action-handler.js aufgerufen.
controllers/app-action-handler.js: Anwendungslogik zum Verarbeiten von Chat-Interaktionsereignissen beim Klicken auf eine Karte.
services/space-service.js, services/user-service.js und services/user-story-service.js: Diese Dateien enthalten die Teile der Anwendungslogik, die speziell für die Arbeit mit Chatbereichen, Nutzern und User Storys relevant sind. Die Funktionen in diesen Dateien werden von app.js oder app-action-handler.js aufgerufen. Um Datenbankvorgänge auszuführen, rufen die Funktionen in diesen Dateien Funktionen in firestore-service.js auf.
services/firestore-service.js: Verarbeitet Datenbankvorgänge. Die Funktionen in dieser Datei werden von services/space-service.js, services/user-service.js und services/user-story-service.js aufgerufen.
services/aip-service.js: Die Vertex AI API für die Textvorhersage mit generativer KI wird aufgerufen.
model/*.js: Diese Dateien enthalten die Definition von Klassen und Enumerationen, die die Anwendungsdienste zum Speichern und Übergeben von Daten zwischen Funktionen verwenden. Er legt das Datenmodell für die Firestore-Datenbank fest.
views/*.js: Jede Datei in diesem Verzeichnis instanziiert ein Kartenobjekt, das die Chat-App dann entweder als Kartennachricht oder als Antwort auf eine Dialogaktion an Google Chat zurücksendet.
views/widgets/*.js: Jede Datei instanziiert einen Widget-Objekttyp, mit dem die App die Karten im Verzeichnis views/ erstellt.
test/**/*.test.js: Jede Datei in diesem Verzeichnis und seinen Unterverzeichnissen enthält die Unittests für die entsprechende Funktion, den Controller, den Dienst, die Ansicht oder das Widget. Sie können alle Unit-Tests ausführen, indem Sie npm run test im Stammverzeichnis des Projekts ausführen.

Cloud Functions-Funktion erstellen und bereitstellen

In diesem Abschnitt erstellen und stellen Sie eine Cloud Functions-Funktion bereit, die die Anwendungslogik der Chat-App für die Projektverwaltung enthält.

Die Cloud-Funktion wird als Reaktion auf eine HTTP-Anfrage von Google Chat ausgeführt, die ein Chatinteraktionsereignis enthält. Beim Ausführen verarbeitet der Cloud Function-Code das Ereignis und gibt eine Antwort an Google Chat zurück, die in Google Chat als Nachricht, Dialogfeld oder andere Art von Nutzerinteraktion gerendert wird. Gegebenenfalls liest die Cloud Functions-Funktion auch aus der Firestore-Datenbank oder schreibt in diese.

So erstellen Sie die Cloud Functions-Funktion:

Google Cloud Console

Laden Sie den Code als ZIP-Datei von GitHub herunter.

ZIP-Datei herunterladen
Extrahieren Sie die heruntergeladene ZIP-Datei.

Der extrahierte Ordner enthält das gesamte Google Workspace-Repository mit Beispielen.
Rufen Sie im extrahierten Ordner google-chat-samples-main/node/project-management-app/ auf und komprimieren Sie den Ordner project-management-app in eine ZIP-Datei.

Das Stammverzeichnis der ZIP-Datei muss die folgenden Dateien und Ordner enthalten:
- env.js
- README.md
- gcloudignore.text
- package-lock.json
- package.json
- index.js
- model/
- controllers/
- views/
- services/
Wechseln Sie in der Google Cloud Console zur Seite Cloud Functions:

Zu Cloud Functions

Prüfen Sie, ob das Google Cloud-Projekt für Ihre Chat-App ausgewählt ist.
Klicken Sie auf Funktion erstellen.
Richten Sie die Funktion auf der Seite Funktion erstellen ein:
1. Wählen Sie unter Umgebung die Option Cloud Run-Funktion aus.
2. Geben Sie unter Funktionsname project-management-tutorial ein.
3. Wählen Sie unter Region eine Region aus.
4. Wählen Sie unter Authentifizierung die Option Nicht authentifizierte Aufrufe zulassen aus.
5. Klicken Sie auf Weiter.
Wählen Sie unter Laufzeit die Option Node.js 20 aus.
Löschen Sie unter Einstiegspunkt den Standardtext und geben Sie projectManagementChatApp ein.
Wählen Sie unter Quellcode die Option ZIP-Datei hochladen aus.
Wählen Sie unter Ziel-Bucket einen Bucket aus oder create Sie einen:
1. Klicken Sie auf Durchsuchen.
2. Wählen Sie einen Bucket aus.
3. Klicken Sie auf Auswählen.
Google Cloud lädt die ZIP-Datei in diesen Bucket hoch und extrahiert diese. Cloud Functions kopiert dann die Komponentendateien in die Cloud Function.
Laden Sie in der ZIP-Datei die ZIP-Datei hoch, die Sie von GitHub heruntergeladen, extrahiert und wieder komprimiert haben:
1. Klicken Sie auf Durchsuchen.
2. Wählen Sie die ZIP-Datei aus.
3. Klicken Sie auf Öffnen.
Klicken Sie auf Bereitstellen.

Die Seite Cloud Functions-Details wird geöffnet und Ihre Funktion wird mit zwei Fortschrittsanzeigen angezeigt: einer für den Build und einer für den Dienst. Wenn beide Fortschrittsanzeigen verschwinden und durch ein Häkchen ersetzt werden, ist die Funktion bereitgestellt und einsatzbereit.
Bearbeiten Sie den Beispielcode, um Konstanten festzulegen:
1. Klicken Sie auf der Seite Cloud Function-Details auf Bearbeiten.
2. Klicken Sie auf Weiter.
3. Wählen Sie unter Quellcode die Option Inline-Editor aus.
4. Öffnen Sie die Datei env.js im Inline-Editor.
5. Ersetzen Sie project-id durch Ihre Cloudprojekt-ID.
6. Optional: Aktualisieren Sie us-central1 mit einem unterstützten Standort für Ihre Cloud-Funktion.
Klicken Sie auf Bereitstellen.
Wenn die Bereitstellung der Funktion abgeschlossen ist, kopieren Sie die Trigger-URL:
1. Klicken Sie auf der Seite Funktionsdetails auf Trigger.
2. Kopieren Sie die URL. Sie benötigen sie, um die Chat-App im folgenden Abschnitt zu konfigurieren.

gcloud-CLI

Klonen Sie den Code aus GitHub:

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

Wechseln Sie zu dem Verzeichnis, das den Code für diese Chat-App zur Projektverwaltung enthält:
```
cd google-chat-samples/node/project-management-app
```
Bearbeiten Sie die Datei env.js, um Umgebungsvariablen festzulegen:
1. Ersetzen Sie project-id durch Ihre Google Cloud-Projekt-ID.
2. Ersetzen Sie us-central1 durch den Speicherort Ihres Google Cloud-Projekts.

Stellen Sie die Cloud Function in Google Cloud bereit:

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

Ersetzen Sie REGION durch den Speicherort der Cloud-Funktion, an dem die Infrastruktur gehostet wird, z. B. us-central1.

Kopieren Sie nach Abschluss der Bereitstellung der Funktion das Attribut url aus der Antwort. Dies ist die Trigger-URL, die Sie im nächsten Abschnitt zum Konfigurieren der Google Chat App verwenden.

Google Chat-App in der Google Cloud Console konfigurieren

In diesem Abschnitt erfahren Sie, wie Sie die Chat API in der Google Cloud Console mit Informationen zu Ihrer Chat-App konfigurieren, einschließlich des Namens der Chat-App, unterstützter Slash-Befehle und der Trigger-URL der Cloud-Funktion der Chat-App, an die Chat-Interaktionsereignisse gesendet werden.

Klicken Sie in der Google Cloud Console auf das Dreistrich-Menü und dann auf > Weitere Produkte > Google Workspace > Produktbibliothek > Google Chat API > Verwalten > Konfiguration.

Chat API-Konfiguration aufrufen
Geben Sie unter App-Name Project Manager ein.
Geben Sie unter Avatar-URL https://developers.google.com/chat/images/quickstart-app-avatar.png ein.
Geben Sie unter Beschreibung den Wert Manages projects with user stories. ein.
Klicken Sie auf die Ein/Aus-Schaltfläche Interaktive Funktionen aktivieren, um die Position „Ein“ festzulegen.
Wählen Sie unter Funktionsweise die Optionen 1:1-Nachrichten empfangen und Gruppenbereichen und Gruppenunterhaltungen beitreten aus.
Wählen Sie unter Verbindungseinstellungen die Option HTTP-Endpunkt-URL aus.
Fügen Sie unter HTTP-Endpunkt-URL die Trigger-URL ein, die Sie aus der Cloud Functions-Bereitstellung kopiert haben. Die URL muss folgendermaßen formatiert sein: https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial. Wenn Sie die Cloud Functions-Funktion mit der gcloud CLI bereitgestellt haben, ist dies das Attribut url.

Registrieren Sie die Slash-Befehle der Chat-App. So registrierst du einen Slash-Befehl:

Klicken Sie unter Slash-Befehle auf Slash-Befehl hinzufügen.

Geben Sie für jeden in der folgenden Tabelle beschriebenen Slash-Befehl den Namen, die Befehls-ID und die Beschreibung ein. Wählen Sie dann aus, ob der Slash-Befehl ein Dialogfeld öffnet, und klicken Sie auf Fertig:

Name	Befehls-ID	Beschreibung	Öffnet ein Dialogfeld
`/createUserStory`	1	Erstelle eine Story mit dem angegebenen Titel.	Auswahl aufgehoben
`/myUserStories`	2	Listet alle Stories auf, die dem Nutzer zugewiesen sind.	Auswahl aufgehoben
`/userStory`	3	Der aktuelle Status der angegebenen Story.	Auswahl aufgehoben
`/manageUserStories`	4	Es wird ein Dialogfeld geöffnet, in dem Stories bearbeitet werden können.	Ausgewählt
`/cleanupUserStories`	5	Alle Meldungen im Gruppenbereich werden gelöscht.	Auswahl aufgehoben

Wählen Sie unter Sichtbarkeit die Option Diese Chat-App bestimmten Personen und Gruppen in Ihrer Workspace-Domain zur Verfügung stellen aus und geben Sie Ihre E-Mail-Adresse ein.
Optional können Sie unter Protokolle die Option Fehler in Logging protokollieren auswählen.
Klicken Sie auf Speichern. Es wird eine Meldung angezeigt, dass die Konfiguration gespeichert wurde. Die Chat-App kann jetzt getestet werden.

Chat App testen

Testen Sie die Chat-App für die Projektverwaltung, indem Sie ihr Nachrichten senden und mithilfe der Slash-Befehle User Storys erstellen, bearbeiten und löschen.

Öffnen Sie Google Chat mit dem Google Workspace-Konto, das Sie angegeben haben, als Sie sich als vertrauenswürdiger Tester hinzugefügt haben.

Zu Google Chat
Klicken Sie auf Neuer Chat.
Geben Sie im Feld Eine oder mehrere Personen hinzufügen den Namen Ihrer Chat-App ein.
Wählen Sie aus den Ergebnissen Ihre Chat-App aus. Eine Direktnachricht wird geöffnet.

Hinweis: Wenn Ihre Chat-App nicht in der Ergebnisliste angezeigt wird, prüfen Sie, ob Sie Ihr Google Workspace-Konto in den Sichtbarkeitseinstellungen auf der Seite Chat API-Konfiguration in der Google Cloud Console hinzugefügt haben.
Geben Sie in der neuen Direktnachricht an die Anwendung Hello ein und drücken Sie enter. Die Chat-App für das Projektmanagement antwortet mit einem Hilfemenü, in dem die Funktionen beschrieben werden.
Um eine Geschichte zu erstellen, geben Sie /createUserStory Test story in die Nachrichtenleiste ein und senden die Nachricht. Die Chat-App für die Projektverwaltung antwortet mit einer Kartennachricht, in der die User Story beschrieben wird, die sie mithilfe von generativer KI von Vertex AI für Sie erstellt hat.
Prüfen Sie in der Console die Firestore-Datenbank, um die Datensätze zu überprüfen, die erstellt wurde, zu dem Bereich, dem Sie die Chat-App hinzugefügt haben, zu den Nutzern, die damit interagiert haben, und zu der von Ihnen erstellten User Story.

Firestore aufrufen
Kehren Sie zu Google Chat zurück.

Zu Google Chat
Optional: Wenn Sie die Geschichte bearbeiten möchten, klicken Sie auf Bearbeiten. Wenn Sie mit der Story zufrieden sind, klicken Sie auf Speichern.
Testen Sie alle von der App unterstützten Slash-Befehle. Geben Sie dazu / ein oder erwähnen Sie die Chat-App.
Löschen Sie die Test-User Story mit dem Befehl /cleanupUserStories. Alternativ können Sie die App entfernen oder deinstallieren. Wenn sie entfernt wird, werden alle in diesem Bereich erstellten User Stories gelöscht.

Fehlerbehebung

Wenn eine Google Chat-App oder Karte einen Fehler zurückgibt, wird in der Chat-Benutzeroberfläche die Meldung „Ein Fehler ist aufgetreten“ angezeigt. oder „Ihre Anfrage konnte nicht verarbeitet werden“ Manchmal wird in der Chat-Benutzeroberfläche keine Fehlermeldung angezeigt, aber die Chat-App oder -Karte führt zu einem unerwarteten Ergebnis. Beispielsweise wird eine Kartennachricht möglicherweise nicht angezeigt.

Auch wenn in der Chat-Benutzeroberfläche keine Fehlermeldung angezeigt wird, sind beschreibende Fehlermeldungen und Protokolldaten verfügbar, die Ihnen bei der Fehlerbehebung helfen, wenn die Fehlerprotokollierung für Chat-Apps aktiviert ist. Informationen zum Ansehen, Debuggen und Beheben von Fehlern finden Sie unter Google Chat-Fehler beheben.

Bereinigen

Damit Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen nicht in Rechnung gestellt werden, sollten Sie das Cloud-Projekt löschen.

Achtung: Das Löschen von Projekten hat folgende Auswirkungen:

Alle Inhalte des Projekts werden gelöscht. Wenn Sie für diese Anleitung ein bereits bestehendes Projekt verwendet haben, werden auch alle anderen im Rahmen des Projekts erstellten Daten gelöscht.
Benutzerdefinierte Projekt-IDs gehen verloren. Beim Erstellen dieses Projekts haben Sie möglicherweise eine benutzerdefinierte Projekt-ID erstellt, die Sie weiterhin verwenden möchten. Damit die URLs, die die Projekt-ID verwenden, z. B. eine URL auf appspot.com, erhalten bleiben, sollten Sie die ausgewählten Ressourcen innerhalb des Projekts löschen, anstatt das gesamte Projekt zu löschen.

Wenn Sie mehrere Anleitungen und Kurzanleitungen durcharbeiten möchten, können Sie die Überschreitung von Projektkontingenten vermeiden, indem Sie Projekte wiederverwenden.

Wechseln Sie in der Google Cloud Console zur Seite Ressourcen verwalten. Klicken Sie auf das Menü > IAM und Verwaltung > Ressourcen verwalten.
Ressourcenmanager aufrufen
Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen .
Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Beenden, um das Projekt zu löschen.