Projekte mit Google Chat, Vertex AI und Firestore verwalten

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

Vorbereitung

• Unternehmen Google Workspace-Konto 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 Bis können Sie prüfen, ob Sie Zugriff haben, Erforderliche Berechtigungen zum Aktivieren der Abrechnung

  • nicht authentifizierte Google Cloud Functions-Aufrufe verwenden die Sie überprüfen können, indem Sie ermitteln, Organisation verwendet die Freigabe mit Domaineinschränkung.

  Bitten Sie gegebenenfalls Ihren Google Cloud-Administrator um Zugriff oder Berechtigung.

• Wenn Sie die Google Cloud CLI verwenden, ein Node.js-Script Entwicklungsumgebung, die für die Arbeit mit der gcloud CLI konfiguriert ist. Weitere Informationen finden Sie unter Node.js-Entwicklung einrichten Umgebung.

Zielsetzungen

• Chat-App zum Verwalten agiler Software erstellen Projekten.
• Nutzenden helfen, User Storys mit generativer KI zu schreiben KI-gestützte Tools zum Schreiben von Geschichten, die auf Vertex AI basieren: <ph type="x-smartling-placeholder">
  </ph>
  • Story-Beschreibungen generieren und neu generieren
  • Erweitern Sie die Beschreibung der Geschichte von Notizen bis hin zu Anforderungen.
  • Korrigiere 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 erlauben, können Sie Geschichten direkt aus der Unterhaltung erstellen, bearbeiten, zuweisen und starten.

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 Nachrichten empfangen und darauf antworten Chat-Interaktionsereignisse wie Nachrichten Das Projektmanagement Die Google Chat App verwendet die Chat API, um zu empfangen und zu antworten von Google Chat gesendete Interaktionsereignisse zu deaktivieren und Attribute zu konfigurieren, festlegen, wie er in Google Chat angezeigt wird, z. B. Name und Avatar.
• Vertex AI API: Eine Plattform für generative KI. Das Projektmanagement Die Google Chat App verwendet die Vertex AI API, um eine User Story zu schreiben Titel und Beschreibungen.
• Firestore: Serverlose Dokumentendatenbank. Das Projektmanagement Die Google Chat App verwendet Firebase, um Daten zu User Storys zu speichern.

• Cloud Functions: Ein einfacher serverloser Computing-Dienst, mit dem Sie zweckgebundenen, eigenständigen Funktionen, die auf Chat reagieren können Interaktionsereignisse zu erfassen, ohne einen Server oder eine Laufzeitumgebung verwalten zu müssen. Die Projektmanagement Google Chat App nutzt Cloud Functions, um den HTTP-Endpunkt hosten, an den Chat Interaktionsereignisse sendet, und als Computing-Plattform zur Ausführung von Logik, die diese Ereignisse verarbeitet und darauf reagiert.

  Cloud Functions verwendet die folgenden Google Cloud-Produkte zum Erstellen, Interaktionsereignisse verarbeiten und Rechenressourcen hosten:

  • Cloud Build: Eine vollständig verwaltete Plattform für Continuous Integration, Continuous Delivery und Continuous Deployment zum Ausführen automatisierter Builds.
  • Pub/Sub: Asynchroner und skalierbarer Messaging-Dienst, der Dienste entkoppelt die Nachrichten von Diensten erstellen, 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 das Projektmanagement verarbeitet Chat-Interaktionsereignisse an einem HTTP-Endpunkt und nutzt Vertex AI, um Schreiben von User Stories und speichert User Story-Details in einer Firestore-Datenbank. Die Das folgende Diagramm zeigt die Architektur von Google Workspace und Verwendete Google Cloud-Ressourcen.

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

1. Ein Nutzer sendet eine Nachricht in Google Chat und ruft die Projektmanagement Google Chat App hinzu, indem Sie oder einen Slash-Befehl eingeben.

2. Google Chat sendet eine synchrone HTTP-Anfrage an die HTTP-Endpunkt.

3. Die Google Chat-App für das Projektmanagement verarbeitet das HTTP Anfrage:

   1. Vertex AI hilft beim Schreiben oder Aktualisieren einer User Story.

   2. Eine Firestore-Datenbank speichert, ruft, aktualisiert oder löscht User Storys Daten.

4. Cloud Functions gibt eine HTTP-Antwort an Google Chat zurück, wird dem Nutzer entweder als Nachricht oder als Dialogfeld angezeigt.

Umgebung vorbereiten

In diesem Abschnitt erfahren Sie, wie Sie ein Google Cloud-Projekt für die Chat-App.

Google Cloud-Projekt erstellen

Google Cloud Console

1. Öffnen Sie in der Google Cloud Console das Menü menu. &gt; IAM und Verwaltung &gt; Projekt erstellen.

   Zur Seite „Projekt erstellen“

2. Geben Sie im Feld Projektname einen aussagekräftigen Namen für Ihr Projekt ein.

   Optional: Klicken Sie zum Bearbeiten der Projekt-ID auf Bearbeiten. Die Projekt-ID kann nicht geändert werden nachdem das Projekt erstellt wurde, wählen Sie also eine ID, die Ihren Anforderungen für die gesamte Lebensdauer des Projekt arbeiten.

3. Klicken Sie im Feld Standort auf Durchsuchen, um die potenziellen Standorte für Ihr Projekt arbeiten. Klicken Sie danach auf Auswählen. <ph type="x-smartling-placeholder">
4. Klicken Sie auf Erstellen. In der Google Cloud Console wird die Dashboard-Seite aufgerufen und Ihr Projekt wurde erstellt. innerhalb weniger Minuten.

gcloud-CLI

Greifen Sie in einer der folgenden Entwicklungsumgebungen auf die Google Cloud Befehlszeile („gcloud“):

• Cloud Shell: Onlineterminal mit der gcloud CLI verwenden aktivieren Sie Cloud Shell.
  Cloud Shell aktivieren
• Lokale Shell: So verwenden Sie eine lokale Entwicklungsumgebung: install und Initialisieren über 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, indem Sie die ID für das Projekt festlegen, das Sie erstellen möchten.

Abrechnung für das Cloud-Projekt aktivieren

<ph type="x-smartling-placeholder">

Google Cloud Console

1. Gehen Sie in der Google Cloud Console zu Abrechnung. Klicken Sie auf Menü menu &gt; Abrechnung &gt; Meine Projekte.

   Zur Abrechnung für meine Projekte

2. Wählen Sie unter Organisation auswählen die Organisation aus, die mit Ihr Google Cloud-Projekt.
3. Öffnen Sie in der Projektzeile das Menü Aktionen. (more_vert), klicken Sie auf Abrechnung ändern und wählen Sie Cloud-Rechnungskonto.
4. Klicken Sie auf Konto festlegen.

gcloud-CLI

1. Führen Sie folgenden Befehl aus, um verfügbare Rechnungskonten aufzulisten:

   gcloud billing accounts list

2. Verknüpfen Sie ein Rechnungskonto 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 für das Cloud-Projekt, für das Sie die Abrechnung aktivieren möchten.
   • BILLING_ACCOUNT_ID ist die ID des Rechnungskontos, mit dem eine Verknüpfung hergestellt werden soll. des Google Cloud-Projekts.

APIs aktivieren

Authentifizierung und Autorisierung

Es ist keine Authentifizierungs- und Autorisierungskonfiguration erforderlich, um dies zu tun .

Zum Aufrufen der Firestore API und der Vertex AI API werden in dieser Anleitung Standardanmeldedaten für Anwendungen mit dem Standarddienstkonto, das mit der Cloud Functions-Funktion verknüpft ist, einrichten müssen. In einer Produktionsumgebung würden Sie in der Regel erstellen und anhängen ein Dienstkonto an die Cloud Functions-Funktion senden.

Google Chat App erstellen und bereitstellen

Nachdem Sie Ihr Google Cloud-Projekt erstellt und konfiguriert haben, können Sie und stellen Sie die Google Chat App bereit. In diesem Abschnitt führen Sie Folgendes:

1. Erstellen Sie eine Firestore-Datenbank, in der Sie User Storys speichern und abrufen können.
2. Sehen Sie sich optional den Beispielcode an.
3. Erstellen Sie eine Cloud Functions-Funktion zum Hosten und Ausführen der Chat-App-Code als Reaktion auf Ereignisse von Google Chat als HTTP-Anfragen empfangen.
4. Google Chat-App in der Google Chat API erstellen und bereitstellen Konfigurationsseite aufrufen.

Firestore-Datenbank erstellen

In diesem Abschnitt erstellen Sie eine Firestore-Datenbank, die beibehalten und abgerufen werden soll User Storys erstellen, aber Sie definieren das Datenmodell nicht selbst. Das Datenmodell ist Im Beispielcode durch model/user-story.js und model/user.js Dateien.

Die Projektmanagement-Datenbank der Chat-App nutzt eine NoSQL-Datenbank. Datenmodell basierend auf class Dokumente organisiert in collections_bookmark Sammlungen. Weitere Informationen finden Sie unter Firestore-Datenmodell:

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

Die Stammsammlung ist spaces, wobei jedes Dokument ein Leerzeichen darstellt, Die Chat-App hat Stories erstellt in. Jede User Story ist wird durch ein Dokument in der Untersammlung userStories dargestellt und jeder Nutzer wird dargestellt durch ein Dokument in der Untersammlung users.

So erstellen Sie die Firestore-Datenbank:

Beispielcode ansehen

Optional: Bevor Sie die Cloud Functions-Funktion erstellen, nehmen Sie sich einen Moment Zeit, mit dem auf GitHub gehosteten Beispielcode vertraut machen.

Auf GitHub ansehen

Hier ein Überblick über die einzelnen Dateien:

env.js

Umgebungsvariablen für die Umgebungsvariablen zum Bereitstellen der Chat-App in ein angegebenes Google Cloud-Projekt und 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 Functions-Funktion der Chat-App. Es liest die Chatereignis von der HTTP-Anfrage, ruft den Anwendungs-Handler auf und sendet die HTTP-Antwort als JSON-Objekt.

controllers/app.js

Die Hauptlogik der Anwendung. Verarbeitet die Interaktionsereignisse erfassen, indem der Erwähnungen von Chat-Apps und Slash-Befehle Um auf Kartenklicks zu reagieren, wird app-action-handler.js angerufen.

controllers/app-action-handler.js

Anwendungslogik zur Verarbeitung von Kartenklicks Chatinteraktionsereignisse

:

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

Diese Dateien enthalten die Teile der Anwendungslogik für die Arbeit mit Chatbereichen Nutzenden und User Storys. Die Funktionen in diesen Dateien werden von app.js aufgerufen oder app-action-handler.js. Zur Durchführung von Datenbankvorgängen werden die Funktionen in Diese Dateien rufen 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

services/aip-service.js

Ruft die Vertex AI API für Generative AI-Text auf Vorhersagen treffen.

model/*.js

Diese Dateien enthalten die Definition von Klassen und Enums, die von der Anwendung in welchen Diensten Daten zwischen Funktionen gespeichert und übertragen werden. Sie legten die Datenmodell für die Firestore-Datenbank.

views/*.js

Jede Datei in diesem Verzeichnis wird instanziiert Ein Kartenobjekt, das vom Die Chat-App sendet sie dann an Google Chat zurück als eine Kartennachricht oder Antwort auf Dialogaktion.

views/widgets/*.js

Jede Datei wird instanziiert eine Art Widget Objekt, mit dem die App die Karten im Verzeichnis views/ erstellt.

test/**/*.test.js

Jede Datei in diesem Verzeichnis und seinen Unterverzeichnissen enthält die Einheitentests für die entsprechende Funktion, den entsprechenden Controller, Dienst, die Ansicht oder das Widget. Sie können alle Einheitentests ausführen, indem Sie npm run test ausführen, während das Stammverzeichnis des Projekts.

Cloud Functions-Funktion erstellen und bereitstellen

In diesem Abschnitt erstellen Sie eine Cloud Functions-Funktion, die das Projektmanagement-Anwendungslogik der Chat-App.

Die Cloud Functions-Funktion wird daraufhin ausgeführt auf eine HTTP-Anfrage von Google Chat mit einem Chat Interaktionsereignis. Bei der Ausführung verarbeitet der Cloud Functions-Code das Ereignis und gibt eine Antwort an Google Chat zurück, die als Nachrichten, Dialogen oder anderen Arten der Nutzerinteraktion. Gegebenenfalls hat die Cloud Die Funktion liest auch aus der Firestore-Datenbank oder schreibt in diese.

So erstellen Sie die Cloud Functions-Funktion:

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

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, einschließlich des Namens der Chat-App, unterstützter Schrägstrich und die Trigger-URL der Chat-App-Cloud Funktion, an die Chat-Interaktionsereignisse gesendet werden.

1. Klicken Sie in der Google Cloud Console auf das Dreistrich-Menü. menu &gt; Weitere Produkte &gt; Google Workspace &gt; Produktbibliothek &gt; Google Chat API &gt; Verwalten &gt; Konfiguration.

   Zur Chat API-Konfiguration

2. Geben Sie unter App-Name Project Manager ein.

3. Geben Sie unter Avatar-URL https://developers.google.com/chat/images/quickstart-app-avatar.png ein.

4. Geben Sie unter Beschreibung Manages projects with user stories. ein.

5. Stellen Sie die Ein/Aus-Schaltfläche Interaktive Funktionen aktivieren auf „Ein“.

6. Wählen Sie unter Funktionen die Option 1:1-Nachrichten empfangen und Gruppenbereichen und Gruppenunterhaltungen beitreten aus.

7. Wählen Sie unter Verbindungseinstellungen die Option App-URL aus.

8. Fügen Sie unter App-URL die Trigger-URL ein, die Sie aus der Cloud kopiert haben. Funktionsbereitstellung, formatiert als https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial Wenn Sie die Cloud Functions-Funktion mit der gcloud CLI bereitgestellt haben, ist dies die url Property.

9. Registrieren Sie die Slash-Befehlen. So registrieren Sie einen Slash-Befehl:

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

   2. Für jeden in der folgenden Tabelle aufgeführten Slash-Befehl Geben Sie Name, Befehls-ID und Beschreibung ein und wählen Sie aus, ob den Slash-Befehl Öffnet ein Dialogfeld und klicken Sie dann auf Fertig:

      Name	Befehls-ID	Beschreibung	Öffnet ein Dialogfeld
      /createUserStory	1	Erstellt eine Geschichte mit dem angegebenen Titel.	Auswahl aufgehoben
      /myUserStories	2	Listet alle Stories auf, die dem Nutzer zugewiesen sind.	Auswahl aufgehoben
      /userStory	3	Zeigt den aktuellen Status der angegebenen Geschichte an.	Auswahl aufgehoben
      /manageUserStories	4	Öffnet ein Dialogfeld, in dem Geschichten bearbeitet werden können.	Ausgewählt
      /cleanupUserStories	5	Löscht alle Geschichten im Gruppenbereich.	Auswahl aufgehoben

10. Wähle unter Sichtbarkeit die Option Diese Chat-App für bestimmte Personen und Gruppen in Ihrem Workspace-Domain und geben Sie Ihre E-Mail-Adresse ein.

11. Wählen Sie optional unter Logs die Option Fehler in Logging protokollieren aus.

12. Klicken Sie auf Speichern. Es wird eine Meldung angezeigt, in der die Konfiguration gespeichert ist. Die Chat-App ist testen können.

Chat App testen

Projektmanagement-Chat-App durch Senden von Nachrichten testen und mithilfe der Slash-Befehle User Stories erstellen, bearbeiten und löschen.

1. Öffnen Sie Google Chat mit dem Google Workspace-Konto, das Sie wenn Sie sich als Trusted Tester hinzugefügt haben.

   Zu Google Chat

2. Klicken Sie auf add Neuer Chat.
3. Geben Sie im Feld Eine oder mehrere Personen hinzufügen den Namen Ihres Chat-App.

4. Wählen Sie aus den Ergebnissen Ihre Chat-App aus. Eine direkte wird die Nachricht geöffnet.

5. Geben Sie in der neuen Direktnachricht an die App Hello ein und drücken Sie enter. Das Projektmanagement Die Chat-App antwortet mit einem Hilfemenü mit Details können.
6. Um eine Geschichte zu erstellen, geben Sie /createUserStory Test story in das Feld und senden Sie die Nachricht. Das Projektmanagement Die Chat-App antwortet mit einer Kartennachricht, in der die User Story, die es mit generativer KI von Vertex AI für Sie erstellt.

7. Rufen Sie in der Console die Firestore-Datenbank auf, um die wird über den Gruppenbereich gespeichert, den Sie Chat-App an die Nutzer, die mit ihr interagiert haben, und der von Ihnen erstellten User Story.

   Firestore aufrufen

8. Kehren Sie zu Google Chat zurück.

   Zu Google Chat

9. Optional: Wenn Sie die Geschichte bearbeiten möchten, klicken Sie auf Bearbeiten. Wenn Sie mit der auf Speichern.
10. Testen Sie jeden von der App unterstützten Slash-Befehl. Um sie anzuzeigen, geben Sie / oder erwähne die Chat App.
11. Test-User Story löschen, indem du das /cleanupUserStories ausgibst Slash-Befehl. Alternativ können Sie die App zu entfernen oder zu deinstallieren. Wenn die App entfernt wird, löscht sie alle in diesem Gruppenbereich erstellten User Storys.

Fehlerbehebung

Wenn eine Google Chat-App oder card gibt einen Fehler zurück. Der Parameter In der Chatoberfläche wird die Meldung „Ein Fehler ist aufgetreten“ angezeigt. oder „Ihre Anfrage kann nicht verarbeitet werden.“ Manchmal kann die Chat-UI Es wird zwar keine Fehlermeldung angezeigt, aber die Chat-App oder die Karte zu einem unerwarteten Ergebnis führt. z. B. wird eine Kartennachricht erscheinen.

Auch wenn in der Chat-Benutzeroberfläche möglicherweise keine Fehlermeldung angezeigt wird, beschreibende Fehlermeldungen und Protokolldaten stehen zur Fehlerbehebung zur Verfügung. wenn die Fehlerprotokollierung für Chat-Apps aktiviert ist. Hilfe bei der Anzeige: Debugging und Beheben von Fehlern finden Sie unter Google Chat-Fehler beheben

Bereinigen

Um zu vermeiden, dass Ihrem Google Cloud-Konto Gebühren für Ressourcen, die in dieser Anleitung verwendet werden, empfehlen wir, dass Sie den Cloud-Projekt

1. Wechseln Sie in der Google Cloud Console zur Seite Ressourcen verwalten. Klicken Sie auf Menü menu &gt; IAM und Verwaltung &gt; Ressourcen verwalten.

   <ph type="x-smartling-placeholder"></ph> Zu Resource Manager

2. Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie auf delete löschen.
3. Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie zum Löschen auf Beenden. für das Projekt.

Weitere Informationen

• Mit der Gemini AI Chat App Fragen zu Chat-Unterhaltungen beantworten
• Mit Google Chat, Vertex AI und Apps Script auf Vorfälle reagieren