Diese Seite wurde von der Cloud Translation API übersetzt.

Projekte mit Google Chat, Vertex AI und Firestore verwalten

In dieser Anleitung wird gezeigt, wie Sie eine Google Chat-App erstellen, mit der ein Team Projekte in Echtzeit verwalten kann. Die Chat-App verwendet Vertex AI, um Teams beim Schreiben von User Storys zu unterstützen (die Funktionen eines Softwaresystems aus der Sicht eines Nutzers darstellen, die das Team entwickeln soll) und speichert die Stories in einer Firestore-Datenbank.

Abbildung 1: Charlie spricht mit seinem Team über die Entwicklung von Funktionen in einem Chatbereich. Wenn Sie die Chat-App für das Projektmanagement erwähnen, wird sie aufgefordert, Hilfe anzubieten.
Abbildung 2: Mit dem Slash-Befehl /createUserStory erstellt Charlie eine Story.
Abbildung 3: Die Chat-App für das Projektmanagement verwendet Vertex AI, um die Geschichte zu beschreiben, und teilt sie dann im Gruppenbereich.
Abbildung 4: Charlie klickt auf Bearbeiten, um die Details der Geschichte zu bestätigen. 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 Story selbst zu, legt den Status auf „Gestartet“ fest, wählt eine geeignete Priorität und Größe aus und klickt auf Speichern.
Abbildung 5: Charlie kann jederzeit alle User Stories des Teams mit dem Slash-Befehl /manageUserStories ansehen und verwalten.

Voraussetzungen

Ein Google Workspace-Konto mit Zugriff auf Google Chat.
Zugriff auf Google Cloud-Dienste für folgende Aufgaben:
- Google Cloud-Projekt erstellen.
- Verknüpfen Sie ein Google Cloud-Rechnungskonto mit dem Cloud-Projekt. Unter Erforderliche Berechtigungen zum Aktivieren der Abrechnung können Sie nachlesen, ob Sie Zugriff haben.
- Verwenden Sie nicht authentifizierte Aufrufe von Google Cloud Functions-Funktionen, die Sie überprüfen können, indem Sie ermitteln, ob Ihre Google Cloud-Organisation die Freigabe mit Domaineinschränkung verwendet.
Bitten Sie gegebenenfalls Ihren Google Cloud-Administrator um Zugriff oder Berechtigungen.
Bei Verwendung der Google Cloud CLI: eine Node.js-Entwicklungsumgebung, die für die 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.
Helfen Sie Nutzern mit generativen KI-gestützten Tools zum Schreiben von Geschichten, die auf Vertex AI basieren:
- Erstellen Sie Beschreibungen für Ihre Storys und erstellen Sie sie neu.
- Erweitern Sie die Beschreibungen der Geschichte von den Notizen, um die Anforderungen zu erfüllen.
- Korrigieren Sie die Grammatik, um Tippfehler zu korrigieren.
Halten Sie Ihre Arbeit auf dem neuesten Stand, indem Sie in eine Firestore-Datenbank schreiben und aus ihr lesen.
Die Zusammenarbeit in einem Chatbereich wird erleichtert, indem Nutzer direkt in der Unterhaltung Geschichten erstellen, bearbeiten, zuweisen und starten können.

Verwendete Produkte

Die Projektmanagement-App verwendet die folgenden Google Workspace- und Google Cloud-Produkte:

Chat API: Eine 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 Chat gesendete Interaktionsereignisse zu empfangen und darauf zu reagieren sowie Attribute zu konfigurieren, die bestimmen, wie die App in Chat angezeigt wird, z. B. Name und Avatarbild.
Vertex AI API: Eine Generative AI-Plattform. Die Google Chat-Anwendung für das Projektmanagement verwendet die Vertex AI API, um Titel und Beschreibungen von User Storys zu schreiben.
Firestore: Eine serverlose Dokumentendatenbank Die Google Chat App für das Projektmanagement verwendet Firebase, um Daten zu User Storys zu speichern.
Cloud Functions: Ein einfacher serverloser Compute-Dienst, mit dem Sie eigenständige Funktionen erstellen können, die auf einen einzigen Zweck ausgerichtet sind und auf Chat-Interaktionsereignisse reagieren können, ohne einen Server oder eine Laufzeitumgebung verwalten zu müssen. Die Google Chat-Anwendung für das Projektmanagement verwendet Cloud Functions zum Hosten des HTTP-Endpunkts, 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, um Interaktionsereignisse zu erstellen, zu verarbeiten und Rechenressourcen zu hosten:
- 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 und skalierbarer Messaging-Dienst, der Dienste entkoppelt, die Nachrichten erstellen, von Diensten, die diese Nachrichten verarbeiten.
- Cloud Run Admin API: Eine vollständig verwaltete Umgebung zum Ausführen von Containeranwendungen.

Architektur

Die Architektur der Google Chat-Anwendung für das Projektmanagement empfängt und verarbeitet Chat-Interaktionsereignisse an einem HTTP-Endpunkt, verwendet Vertex AI zum Schreiben von User Storys und speichert User-Story-Details 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 für das Projektmanagement

Die Google Chat App für das Projektmanagement funktioniert so:

Ein Nutzer sendet eine Nachricht in Chat und ruft die Google Chat-App für das Projektmanagement auf, indem er sie entweder direkt schreibt, sie in einem Leerzeichen erwähnt oder einen Slash-Befehl eingibt.
Chat sendet eine synchrone HTTP-Anfrage an den HTTP-Endpunkt der Cloud Functions-Funktion.
Die Google Chat App für das Projektmanagement verarbeitet die HTTP-Anfrage:
1. Vertex AI hilft beim Schreiben 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 Chat zurück, die dem Nutzer entweder als Nachricht oder als 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 das 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 daher eine ID aus, die Ihren Anforderungen für die gesamte Lebensdauer des Projekts entspricht.
Klicken Sie im Feld Standort auf Durchsuchen, um potenzielle Standorte für Ihr Projekt aufzurufen. Klicken Sie danach auf Auswählen.
Achtung: Sie können Ihre Google Workspace-Organisation nicht finden?
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 einer Organisation zugeordnet sind.
Klicken Sie auf Erstellen. Die Google Cloud Console ruft die Dashboard-Seite auf und Ihr Projekt wird innerhalb weniger Minuten erstellt.

gcloud-CLI

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

Cloud Shell: Aktivieren Sie Cloud Shell, um ein Online-Terminal zu verwenden, bei dem die gcloud CLI bereits eingerichtet ist.
Cloud Shell aktivieren
Lokale Shell: Um eine lokale Entwicklungsumgebung zu verwenden, müssen Sie die gcloud CLI installieren und initialize.
Verwenden Sie den Befehl „gcloud projects create“, um ein Cloud-Projekt zu erstellen:
```
gcloud projects create PROJECT_ID
```
Ersetzen Sie PROJECT_ID, indem Sie die ID des Projekts festlegen, das Sie erstellen möchten.

Abrechnung für das Cloud-Projekt aktivieren

Google Cloud Console

Rufen Sie in der Google Cloud Console Abrechnung auf. Klicken Sie auf das Dreipunkt-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-Rechnungskonto aus.
Klicken Sie auf Konto festlegen.

gcloud-CLI

Führen Sie folgenden Befehl aus, um verfügbare Rechnungskonten aufzulisten:
```
gcloud billing accounts list
```
Rechnungskonto mit einem Google Cloud-Projekt verknüpfen:
```
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 die APIs im richtigen Cloud-Projekt aktiviert sind. Klicken Sie dann auf Weiter.
Prüfen Sie, ob die richtigen APIs aktiviert sind, und klicken Sie dann auf Aktivieren.

gcloud-CLI

Legen Sie gegebenenfalls für das aktuelle Cloud-Projekt 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 mit dem Befehl gcloud services enable 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:
```
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, Pub/Sub und Cloud Run Admin API sind Voraussetzung für Cloud Functions.

Authentifizierung und Autorisierung

Für diese Anleitung ist keine Authentifizierungs- und Autorisierungskonfiguration erforderlich.

In dieser Anleitung werden zum Aufrufen der Firestore und Vertex AI APIs Standardanmeldedaten für Anwendungen verwendet. Dabei wird das Standarddienstkonto an die Cloud Functions-Funktion angehängt, die Sie nicht einrichten müssen. In einer Produktionsumgebung würden Sie stattdessen stattdessen ein Dienstkonto erstellen und an die Cloud Functions-Funktion anhängen.

Google Chat App erstellen und bereitstellen

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

Firestore-Datenbank erstellen, in der User Storys beibehalten und abgerufen werden sollen
Sehen Sie sich optional den Beispielcode an.
Erstellen Sie eine Cloud Functions-Funktion, um den Code der Chat-Anwendung als Reaktion auf Ereignisse zu hosten und auszuführen, die von Chat als HTTP-Anfragen empfangen werden.
Auf der Konfigurationsseite der Google Chat API eine Google Chat-Anwendung erstellen und bereitstellen

Firestore-Datenbank erstellen

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

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

Das folgende Diagramm bietet einen Überblick über das Datenmodell der Google Chat App für das Projektmanagement:

Datenmodell der Firestore-Datenbank.

Die Stammsammlung ist spaces, wobei jedes Dokument einen Gruppenbereich darstellt, in dem die Chat-App Stories erstellt hat. Jede User Story wird durch ein Dokument in der Untersammlung userStories und jeder Nutzer durch ein Dokument in der Untersammlung users repräsentiert.

Definitionen für Sammlungen, Dokumente und Felder ansehen

`spaces`

Gruppenbereiche, in denen die Chat App Meldungen erstellt hat.

Felder
`Document ID`	`String` Eindeutige ID eines bestimmten Bereichs, in dem Stories erstellt werden. Entspricht dem Ressourcennamen des Gruppenbereichs in der Chat API.
`userStories`	`Subcollection of Documents (userStories)` Von der Chat App und ihren Nutzern erstellte Stories Entspricht dem `Document ID` einer `userStories` in Firebase.
`users`	`Subcollection of Documents (user)` Nutzer, die Stories erstellt oder ihnen zugewiesen wurden.
`displayName`	`String` Der Anzeigename des Gruppenbereichs in der Chat API. Nicht für Direktnachrichten mit Nutzern festgelegt.

`userStories`

Von der 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, der dem Abschluss der Story zugewiesen wurde. Entspricht dem `Document ID` des `users`-Dokuments und dem Ressourcennamen eines Nutzers in der Chat API.
`description`	`String` Eine Beschreibung der Softwarefunktion aus Sicht des Nutzers.
`priority`	`Enum` Die Dringlichkeit, mit der die Arbeiten abgeschlossen werden sollen. Mögliche Werte sind `Low`, `Medium` oder `High`.
`size`	`Enum` Die Menge an Arbeit. Mögliche Werte sind `Small`, `Medium` oder `Large`.
`status`	`Enum` Die Phase der Arbeit. Mögliche Werte sind `OPEN`, `STARTED` oder `COMPLETED`.
`title`	`String` Der Titel der Story; eine kurze Zusammenfassung.

`users`

Nutzer, die Stories erstellt oder ihnen zugewiesen wurden.

Felder
`Document ID`	`String` Eindeutige ID eines bestimmten Nutzers. Entspricht dem `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` 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 Menü > Firestore.

Firestore aufrufen
Klicken Sie auf Create database (Datenbank erstellen).
Klicken Sie unter Firestore-Modus auswählen auf Nativer Modus.
Klicken Sie auf Weiter.
Konfigurieren Sie die Datenbank:
1. Behalten Sie im Feld Datenbank benennen als Datenbank-ID (default) bei.
2. Geben Sie unter Standorttyp eine Region für die Datenbank an, z. B. us-central1. Wählen Sie für die beste Leistung den gleichen oder einen nahe gelegenen Standort wie die Cloud Functions-Funktion der Chat-Anwendung aus.
Klicken Sie auf Create database (Datenbank erstellen).

gcloud-CLI

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

Beispielcode ansehen

Optional können Sie sich vor dem Erstellen der Cloud Functions-Funktion einen Moment Zeit nehmen, um den auf GitHub gehosteten Beispielcode zu lesen und sich mit ihm vertraut zu machen.

Auf GitHub ansehen

Im Folgenden finden Sie eine Übersicht über die einzelnen Dateien:

env.js: Umgebungskonfigurationsvariablen zum Bereitstellen der Chat-Anwendung in einem angegebenen Google Cloud-Projekt und in einer bestimmten Region Sie müssen die Konfigurationsvariablen in dieser Datei aktualisieren.
package.json und package-lock.json: Einstellungen und Abhängigkeiten für Node.js-Projekte
index.js: Einstiegspunkt für die Cloud Functions-Funktion der Chat-App. Er liest das Chat-Ereignis aus der HTTP-Anfrage, ruft den App-Handler auf und sendet die HTTP-Antwort als JSON-Objekt.
controllers/app.js: Die Hauptanwendungslogik. Verarbeitet die Interaktionsereignisse durch Verarbeitung der Erwähnungen der Chat-App und der Slash-Befehle. Als Reaktion auf Kartenklicks wird app-action-handler.js aufgerufen.
controllers/app-action-handler.js: Anwendungslogik zur Verarbeitung von Chat-Interaktionsereignissen
services/space-service.js, services/user-service.js und services/user-story-service.js: Diese Dateien enthalten die Teile der Anwendungslogik, die für die Arbeit mit Chatbereichen, Nutzern und User Storys spezifisch sind. Die Funktionen in diesen Dateien werden von app.js oder app-action-handler.js aufgerufen. Für Datenbankvorgänge 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: Ruft die Vertex AI API für die Textvorhersage mit generativer KI auf.
model/*.js: Diese Dateien enthalten die Definition von Klassen und Enums, mit denen die Anwendungsdienste Daten speichern und zwischen Funktionen übergeben. 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 Dialogaktion an Chat zurücksendet.
views/widgets/*.js: Jede Datei instanziiert ein Widget-Objekt, mit dem die App die Karten im Verzeichnis views/ erstellt.
test/**/*.test.js: Jede Datei in diesem Verzeichnis und in dessen Unterverzeichnissen enthält die Einheitentests für die entsprechende Funktion, den entsprechenden Controller, den Dienst, die Ansicht oder das Widget. Sie können alle Einheitentests 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-Anwendung für das Projektmanagement umfasst.

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

So erstellen Sie die Cloud Functions-Funktion:

Google Cloud Console

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

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

Der extrahierte Ordner enthält das gesamte Google Workspace-Beispiel-Repository.
Rufen Sie im extrahierten Ordner google-chat-samples-main/node/project-management-app/ auf und komprimieren Sie den Ordner project-management-app in einer 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/
Rufen Sie in der Google Cloud Console die Seite „Cloud Functions“ auf:

Zu Cloud Functions

Achten Sie darauf, dass das Google Cloud-Projekt für Ihre Chat-App ausgewählt ist.
Klicken Sie auf Funktion erstellen.
Richten Sie auf der Seite Funktion erstellen Ihre Funktion ein:
1. Wählen Sie unter Umgebung die Option 2nd gen 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. Klicke 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-Upload aus.
Erstellen Sie unter Ziel-Bucket einen Bucket oder wählen Sie einen aus:
1. Klicke auf Entdecken.
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 die Komponentendateien. Anschließend kopiert Cloud Functions die Komponentendateien in die Cloud Functions-Funktion.
Laden Sie in ZIP-Datei die ZIP-Datei hoch, die Sie von GitHub heruntergeladen, extrahiert und neu komprimiert haben:
1. Klicke auf Entdecken.
2. Gehen Sie zur gewünschten ZIP-Datei und wählen Sie sie 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 bereit.
Bearbeiten Sie den Beispielcode, um Konstanten festzulegen:
1. Klicken Sie auf der Seite Cloud Functions-Details auf Bearbeiten.
2. Klicke auf Weiter.
3. Wählen Sie unter Quellcode den Inline-Editor aus.
4. Öffnen Sie im Inline-Editor die Datei env.js.
5. Ersetzen Sie project-id durch Ihre Cloudprojekt-ID.
6. Optional: Aktualisieren Sie us-central1 mit einem unterstützten Speicherort für Ihre Cloud Functions-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 zum Konfigurieren der Chat-App im folgenden Abschnitt.

gcloud-CLI

Klonen Sie den Code aus GitHub:

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

Wechseln Sie in das Verzeichnis, das den Code für diese Chat-App für die 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 Functions-Funktion 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 einen Speicherort der Cloud Functions-Funktion, an dem die Infrastruktur gehostet wird, z. B. us-central1.

Wenn die Bereitstellung der Funktion abgeschlossen ist, kopieren Sie das Attribut url aus der Antwort. Dies ist die Trigger-URL, mit der Sie im folgenden Abschnitt die Google Chat App konfigurieren.

Google Chat App in der Google Cloud Console konfigurieren

In diesem Abschnitt wird beschrieben, wie Sie die Chat API in der Google Cloud Console mit Informationen zu Ihrer Chat-App konfigurieren. Dazu gehören der Name der Chat-App, unterstützte Slash-Befehle und die Trigger-URL der Cloud Functions-Funktion der Chat-App, an die Chat-Interaktionsereignisse gesendet werden.

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

Zur Konfiguration der Chat API
Geben Sie unter App-Name Project Manager ein.
Geben Sie im Feld Avatar-URL den String https://developers.google.com/chat/images/quickstart-app-avatar.png ein.
Geben Sie unter Beschreibung den Text Manages projects with user stories. ein.
Stellen Sie den Schalter Interaktive Funktionen aktivieren auf „Ein“.
Wählen Sie unter Funktionen die Option 1:1-Nachrichten erhalten und Gruppenbereichen und Gruppenunterhaltungen beitreten aus.
Wählen Sie unter Verbindungseinstellungen die Option App-URL aus.
Fügen Sie unter App-URL die Trigger-URL im Format https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial ein, die Sie aus der Cloud Functions-Bereitstellung kopiert haben. 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 registrieren Sie einen Slash-Befehl:

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

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

Name	Befehls-ID	Beschreibung	Öffnet ein Dialogfeld
`/createUserStory`	1	Erstellt eine Story mit dem angegebenen Titel.	Auswahl aufgehoben
`/myUserStories`	2	Listet alle Geschichten auf, die dem Nutzer zugewiesen sind.	Auswahl aufgehoben
`/userStory`	3	Zeigt den aktuellen Status der angegebenen Story an.	Auswahl aufgehoben
`/manageUserStories`	4	Öffnet ein Dialogfeld, in dem Artikel bearbeitet werden können.	Ausgewählt
`/cleanupUserStories`	5	Alle Geschichten 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 verfügbar machen aus und geben Sie Ihre E-Mail-Adresse ein.
Wählen Sie optional unter Logs die Option Fehler in Logging protokollieren aus.
Klicken Sie auf Speichern. Eine Nachricht zur gespeicherten Konfiguration wird angezeigt, was bedeutet, dass die Chat-Anwendung zum Testen bereit ist.

Chat App testen

Testen Sie die Chat-App für das Projektmanagement, indem Sie ihr eine Nachricht senden und mit den Slash-Befehlen User Stories erstellen, bearbeiten und löschen.

Öffnen Sie Google Chat mit dem Google Workspace-Konto, das Sie bei der Registrierung als Trusted Tester angegeben 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 Ihre Chat-App aus den Ergebnissen aus. Eine Direktnachricht wird geöffnet.

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

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 Geschichte zufrieden sind, klicken Sie auf Speichern.
Testen Sie alle von der App unterstützten Slash-Befehle. Geben Sie / ein oder erwähnen Sie die Chat-App, um sie anzusehen.
Löschen Sie die Test-User Story mit dem Slash-Befehl /cleanupUserStories. Alternativ können Sie die App entfernen oder deinstallieren. Wenn die App entfernt wird, werden alle in diesem Bereich erstellten User Storys gelöscht.

Fehlerbehebung

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

Obwohl eine Fehlermeldung möglicherweise nicht in der Chat-Benutzeroberfläche angezeigt wird, sind beschreibende Fehlermeldungen und Protokolldaten verfügbar, mit denen Sie Fehler beheben können, wenn die Fehlerprotokollierung für Chat-Apps aktiviert ist. Informationen zum Aufrufen, Debuggen und Beheben von Fehlern finden Sie im Hilfeartikel 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 statt des gesamten Projekts löschen.

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

Wechseln Sie in der Google Cloud Console zur Seite Ressourcen verwalten. Klicken Sie auf Menü > IAM und Verwaltung > Ressourcen verwalten.
Zu Resource Manager
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.