In diesem Tutorial erstellen Sie eine Google Chat-App, die Fragen auf der Grundlage von Unterhaltungen in Chatbereichen mit generativer KI beantwortet, die von Vertex AI mit Gemini betrieben wird. Die Chat-App verwendet die Google Workspace Events API und Pub/Sub, um in Chatbereichen gepostete Fragen zu erkennen und in Echtzeit zu beantworten, auch wenn sie nicht erwähnt wird.
Die Chat-App verwendet alle im Gruppenbereich gesendeten Nachrichten als Datenquelle und Wissensdatenbank: Wenn jemand eine Frage stellt, sucht die Chat-App nach zuvor geteilten Antworten und gibt dann eine Antwort frei. Wenn keine Antwort gefunden wird, wird angezeigt, dass keine Antwort möglich ist. Nutzer können bei jeder Antwort auf eine zusätzliche Aktionsschaltfläche klicken, um einen Administrator des Gruppenbereichs zu @erwähnen und um eine Antwort zu bitten. Mithilfe von Gemini-KI passt sich die Wissensdatenbank der Google Chat App an und erweitert sie, während sie kontinuierlich für Unterhaltungen in Gruppenbereichen trainiert wird, denen sie hinzugefügt wird.
So funktioniert die Chat-App in einem Onboarding- und Supportbereich für Mitarbeiter:
-
Abbildung 2: Dana fragt, ob das Unternehmen Schulungen für Vorträge anbietet. -
Abbildung 3 Die KI-Chat-App mit Wissensassistenten bittet Vertex AI mit Gemini, Danas Frage anhand des Unterhaltungsverlaufs des Chatbereichs zu beantworten, und gibt dann die Antwort weiter.
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. Siehe Node.js-Entwicklungsumgebung einrichten.
Zielsetzungen
- Erstellen Sie eine Chat-App, die mithilfe von generativer KI Fragen beantwortet, die auf dem in Chatbereichen geteilten Wissen basieren.
- Mit generativer KI:
- Mitarbeiterfragen erkennen und beantworten
- Lernen Sie kontinuierlich aus laufenden Unterhaltungen in einem Chatbereich.
- Sie können in Echtzeit auf Nachrichten in einem Gruppenbereich reagieren, auch wenn die Chat-App nicht direkt kontaktiert wird.
- Nachrichten durch Schreiben und Lesen aus einer Firestore-Datenbank beibehalten.
- Erleichtern Sie die Zusammenarbeit in einem Chatbereich, indem Sie die Administratoren des Gruppenbereichs erwähnen, wenn keine Antwort auf eine Frage gefunden wird.
Architektur
Das folgende Diagramm zeigt die Architektur der Google Workspace- und Google Cloud-Ressourcen, die vom KI-Wissensassistenten in der Chat-App verwendet werden.
Die Chat-App des KI-Wissensassistenten funktioniert so:
Ein Nutzer fügt die Chat-App des KI-Wissensassistenten einem Chatbereich hinzu:
In der Chat-App wird der Nutzer, der die App dem Chat-Gruppenbereich hinzugefügt hat, aufgefordert, die Authentifizierung und Autorisierung zu konfigurieren.
Die Chat-App ruft die Nachrichten des Gruppenbereichs ab, indem sie die Methode
spaces.messages.list
in der Chat API aufruft, und speichert die abgerufenen Nachrichten dann in einer Firestore-Datenbank.Die Chat-App ruft die Methode
subscriptions.create
in der Google Workspace Events API auf, um auf Ereignisse wie Nachrichten im Gruppenbereich zu warten. Der Benachrichtigungsendpunkt des Abos ist ein Pub/Sub-Thema, das das Ereignis über Eventarc an die Chat-App weiterleitet.Die Chat-App postet eine Einführungsnachricht im Gruppenbereich.
Ein Nutzer im Chatbereich postet eine Nachricht:
Die Chat-App empfängt die Nachricht in Echtzeit vom Pub/Sub-Thema.
Die Chat-App fügt die Nachricht der Firestore-Datenbank hinzu.
Wenn ein Nutzer die Nachricht später bearbeitet oder löscht, empfängt die Chat-App das aktualisierte oder gelöschte Ereignis in Echtzeit und aktualisiert oder löscht die Nachricht dann in der Firestore-Datenbank.
Die Chat-App sendet die Nachricht mit Gemini an Vertex AI:
Der Prompt weist Vertex AI mit Gemini an, zu prüfen, ob die Nachricht eine Frage enthält. Ist das der Fall, beantwortet Gemini die Frage anhand des Nachrichtenverlaufs des Chatbereichs, der in Firestore gespeichert ist. Die Google Chat App sendet die Nachricht dann an den Chatbereich. Andernfalls antworten Sie nicht.
Wenn Vertex AI mit Gemini die Frage beantwortet, sendet die Chat-App die Antwort durch Aufrufen der Methode
spaces.messages.create
in der Chat API mithilfe der Anwendungsauthentifizierung.Wenn Vertex AI mit Gemini die Frage nicht beantworten kann, postet die Chat-App eine Nachricht, dass sie im Verlauf des Chatbereichs keine Antwort auf diese Frage finden kann.
Nachrichten enthalten immer eine zusätzliche Aktionsschaltfläche, auf die Nutzer klicken können. Dadurch wird in der Chat-App ein Administrator des Gruppenbereichs @erwähnt, der ihn um eine Antwort bittet.
Die Chat-App erhält von der Google Workspace Events API eine Lebenszyklusbenachrichtigung darüber, dass das Chatbereichsabo bald abläuft:
- Die Chat-App sendet eine Anfrage zur Verlängerung des Abos. Dazu ruft sie in der Google Workspace Events API die Methode
subscriptions.patch
auf.
- Die Chat-App sendet eine Anfrage zur Verlängerung des Abos. Dazu ruft sie in der Google Workspace Events API die Methode
Die Chat-App wird aus einem Chat-Gruppenbereich entfernt:
Die Chat-App löscht das Abo, indem sie die Methode
subscriptions.delete
in der Google Workspace Events API aufruft.Die Chat-App löscht die Daten des Chatbereichs aus Firestore.
Von der KI-Wissensassistenten-Chat-App verwendete Produkte ansehen
Für die Chat-App mit KI-Wissensassistent werden die folgenden Google Workspace- und Google Cloud-Produkte verwendet:
- Vertex AI API mit Gemini: Eine generative KI-Plattform, die auf Gemini basiert. Der KI-Wissensassistent der Chat-App verwendet die Vertex AI API mit Gemini, um Fragen von Mitarbeitern zu erkennen, zu verstehen und zu beantworten.
-
Chat API: API zum Entwickeln von Google Chat-Apps, die Chat-Interaktionsereignisse wie Nachrichten empfangen und darauf reagieren. Die Chat-App des KI-Wissensassistenten nutzt die Chat API für Folgendes:
- Von Google Chat gesendete Interaktionsereignisse empfangen und darauf reagieren.
- In einem Gruppenbereich gesendete Nachrichten auflisten.
- Sie können in einem Gruppenbereich Antworten auf Nutzerfragen posten.
- Konfigurieren Sie Attribute, die festlegen, wie das Profil in Google Chat angezeigt wird, z. B. Name und Avatarbild.
- Google Workspace Events API: Mit dieser API können Sie Ereignisse abonnieren und Änderungsbenachrichtigungen für alle Google Workspace-Anwendungen verwalten. Die Chat-App mit KI-Wissensassistent verwendet die Google Workspace Events API, um auf in einem Chatbereich gepostete Nachrichten zu hören. So kann sie Fragen erkennen und beantworten, auch wenn sie nicht erwähnt wird.
- Firestore: Eine serverlose Dokumentendatenbank. Der KI-Wissensassistent der Chat-App verwendet Firestore, um Daten zu Nachrichten zu speichern, die in einem Chatbereich gesendet wurden.
- Pub/Sub: Pub/Sub ist ein asynchroner und skalierbarer Messaging-Dienst, der Dienste, die Nachrichten erzeugen, von Diensten entkoppelt, die diese Nachrichten verarbeiten. Die Chat-App des KI-Wissensassistenten verwendet Pub/Sub, um Aboereignisse aus Chatbereichen zu empfangen.
- Eventarc: Mit Eventarc können Sie ereignisgesteuerte Architekturen erstellen, ohne die zugrunde liegende Infrastruktur implementieren, anpassen oder verwalten zu müssen. Die Chat-App mit KI-gestütztem Wissensassistenten verwendet Eventarc, um Ereignisse von Pub/Sub an einen Chatbereich und die Cloud Function weiterzuleiten, die die Aboereignisse empfängt und verarbeitet.
-
Cloud Functions: Ein einfacher serverloser Computing-Dienst, mit dem Sie zweckgebundene, eigenständige Funktionen erstellen können, die auf Chat-Interaktionen und Aboereignisse reagieren können, ohne einen Server oder eine Laufzeitumgebung verwalten zu müssen. Die Chat-App des KI-Wissensassistenten verwendet zwei Cloud Functions-Funktionen:
-
app
: Hosten Sie den HTTP-Endpunkt, an den Chat Interaktionsereignisse sendet, sowie als Computing-Plattform, um Logik auszuführen, die diese Ereignisse verarbeitet und darauf reagiert. -
eventsApp
: Empfängt und verarbeitet Ereignisse für Chatbereiche wie Nachrichten aus einem Pub/Sub-Abo.
- Cloud Build: Eine vollständig verwaltete Plattform für Continuous Integration, Delivery und Deployment, auf der automatisierte Builds ausgeführt werden.
- Cloud Run: Vollständig verwaltete Umgebung zum Ausführen von Containeranwendungen.
-
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.
-
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 nach dem Erstellen des Projekts nicht mehr geändert werden. Wählen Sie daher eine ID aus, die Ihren Anforderungen während der gesamten Lebensdauer des Projekts entspricht.
- Klicken Sie im Feld Standort auf Durchsuchen, um mögliche Standorte für Ihr Projekt zu sehen. Klicken Sie danach auf Auswählen.
- Klicken Sie auf Erstellen. In der Google Cloud Console wird die Dashboard-Seite aufgerufen 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 Befehlgcloud projects create
, um ein Cloud-Projekt zu erstellen: Ersetzen Sie PROJECT_ID, indem Sie die ID für das Projekt festlegen, das Sie erstellen möchten.gcloud projects create PROJECT_ID
Abrechnung für das Cloud-Projekt aktivieren
Google Cloud Console
- Klicken Sie in der Google Cloud Console auf Abrechnung. Klicken Sie auf das Dreistrich-Menü > Abrechnung > 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 eine Liste der verfügbaren Rechnungskonten aufzurufen:
gcloud billing accounts list
- 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 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, die Google Workspace Events API, die Eventarc API und die Cloud Run Admin API.
Prüfen Sie, ob Sie die APIs im richtigen Cloud-Projekt aktivieren, und klicken Sie dann auf Weiter.
Aktivieren Sie die richtigen APIs und klicken Sie dann auf Aktivieren.
gcloud-CLI
Legen Sie gegebenenfalls das aktuelle Cloud-Projekt auf das von Ihnen erstellte Projekt fest:
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, die Google Workspace Events API, die Eventarc 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 \ workspaceevents.googleapis.com \ eventarc.googleapis.com \ run.googleapis.com
Authentifizierung und Autorisierung einrichten
Durch Authentifizierung und Autorisierung kann die Chat-App auf Ressourcen in Google Workspace und Google Cloud zugreifen.
In dieser Anleitung veröffentlichen Sie die Google Chat App intern, sodass Sie Platzhalterinformationen verwenden können. Bevor Sie die Google Chat App extern veröffentlichen, ersetzen Sie die Platzhalterinformationen durch echte Informationen für den Zustimmungsbildschirm.
OAuth-Zustimmungsbildschirm konfigurieren, Bereiche angeben und App registrieren
Rufen Sie in der Google Cloud Console das Menü > APIs und Dienste > OAuth-Zustimmungsbildschirm auf.
Wählen Sie unter Nutzertyp die Option Intern aus und klicken Sie dann auf Erstellen.
Geben Sie unter Anwendungsname
AI knowledge assistant
ein.Wählen Sie unter Nutzersupport-E-Mail Ihre E-Mail-Adresse oder eine entsprechende Google-Gruppe aus.
Geben Sie unter Kontaktdaten des Entwicklers Ihre E-Mail-Adresse ein.
Klicken Sie auf Speichern und fortfahren.
Klicken Sie auf Bereiche hinzufügen oder entfernen. Für jede API, die Sie in Ihrem Cloud-Projekt aktiviert haben, wird ein Feld mit einer Liste der Bereiche angezeigt.
Fügen Sie unter Bereiche manuell hinzufügen den folgenden Bereich ein:
https://www.googleapis.com/auth/chat.messages
Klicken Sie auf Zur Tabelle hinzufügen.
Klicken Sie auf Aktualisieren.
Klicken Sie auf Speichern und fortfahren.
Sehen Sie sich die Zusammenfassung der App-Registrierung an und klicken Sie dann auf Zurück zum Dashboard.
OAuth-Client-ID-Anmeldedaten erstellen
Öffnen Sie in der Google Cloud Console das Dreistrich-Menü > APIs und Dienste > Anmeldedaten.
Klicken Sie auf Anmeldedaten erstellen > OAuth-Client-ID.
Klicken Sie auf Anwendungstyp > Webanwendung.
Geben Sie in das Feld Name einen Namen für die Anmeldedaten ein. Dieser Name wird nur in der Google Cloud Console angezeigt.
Klicken Sie unter Autorisierte Weiterleitungs-URIs auf URI hinzufügen.
Geben Sie unter URIs 1 Folgendes ein:
https://REGION-PROJECT_ID.cloudfunctions.net/app/oauth2
Ersetzen Sie Folgendes:
- REGION: Region der Cloud Functions-Funktion, z. B.
us-central1
Wenn Sie später die beiden Cloud Functions erstellen, müssen Sie deren Region auf diesen Wert festlegen. - PROJECT_ID: Die Projekt-ID des von Ihnen erstellten Cloud-Projekts.
- REGION: Region der Cloud Functions-Funktion, z. B.
Klicken Sie auf Erstellen.
Klicken Sie im Fenster OAuth-Client erstellt auf JSON herunterladen.
Speichern Sie die heruntergeladene Datei als
client_secrets.json
. Wenn Sie später die beiden Cloud Functions-Funktionen erstellen, fügen Sie die Dateiclient_secrets.json
in jede Bereitstellung ein.Klicken Sie auf OK.
Pub/Sub-Thema erstellen
Das Pub/Sub-Thema arbeitet mit der Google Workspace Events API, um Ereignisse in einem Chatbereich wie Nachrichten zu abonnieren und die Chat-App in Echtzeit zu benachrichtigen.
So erstellen Sie das Pub/Sub-Thema:
Google Cloud Console
Klicken Sie in der Google Cloud Console auf Menü > Pub/Sub.
Klicken Sie auf Thema erstellen.
Geben Sie unter Themen-ID
events-api
ein.Entfernen Sie das Häkchen bei Standardabo hinzufügen.
Wählen Sie unter Verschlüsselung die Option Von Google verwalteter Verschlüsselungsschlüssel aus.
Klicken Sie auf Erstellen. Das Pub/Sub-Thema wird angezeigt.
Damit dieses Pub/Sub-Thema und die Google Workspace Events API zusammenarbeiten, müssen Sie dem IAM-Nutzer von Chat die Berechtigung zum Posten im Pub/Sub-Thema erteilen:
Klicken Sie im Bereich events-api unter BERECHTIGUNGEN auf Hauptkonto hinzufügen.
Geben Sie unter Hauptkonten hinzufügen in Neue Hauptkonten den Wert
chat-api-push@system.gserviceaccount.com
ein.Wählen Sie unter Rollen zuweisen unter Rolle auswählen die Option Pub/Sub > Pub/Sub-Publisher aus.
Klicken Sie auf Speichern.
gcloud-CLI
Erstellen Sie ein Pub/Sub-Thema mit der Themen-ID
events-api
:gcloud pubsub topics create events-api
Gewähren Sie dem IAM-Nutzer von Google Chat die Berechtigung, im Pub/Sub-Thema zu posten:
gcloud pubsub topics add-iam-policy-binding events-api \ --member='serviceAccount:chat-api-push@system.gserviceaccount.com' \ --role='roles/pubsub.publisher'
Firestore-Datenbank erstellen
Die Firestore-Datenbank speichert und ruft Daten aus Chatbereichen ab, z. B. Nachrichten. Sie definieren das Datenmodell nicht, das implizit im Beispielcode durch die Dateien model/message.js
und services/firestore-service.js
festgelegt wird.
Die Datenbank der Chat-App des KI-Wissensassistenten verwendet ein NoSQL-Datenmodell, das auf Firestore-Datenmodell.
-Dokumenten basiert, die in -Sammlungen organisiert sind. Weitere Informationen finden Sie unterDas folgende Diagramm bietet einen Überblick über das Datenmodell der Chat-App des KI-Wissensassistenten:
Die Wurzel enthält zwei Sammlungen:
spaces
, wobei jedes Dokument einen Chatbereich darstellt, dem die Chat-App hinzugefügt wird. Jede Nachricht wird durch ein Dokument in der Untersammlungmessages
dargestellt.users
, wobei jedes Dokument einen Nutzer darstellt, der die Chat-App einem Chatbereich hinzugefügt hat.
Sammlungs-, Dokument- und Felddefinitionen ansehen
spaces
Ein Chatbereich mit der Chat-App des KI-Wissensassistenten.
Felder | |
---|---|
Document ID | String Eindeutige ID eines bestimmten Gruppenbereichs. Ein Teil des Ressourcennamens des Gruppenbereichs in der Chat API. |
messages | Subcollection of Documents ( Nachrichten, die im Chatbereich gesendet wurden. Entspricht dem Document ID einer message in Firebase. |
spaceName | String Der eindeutige Name des Gruppenbereichs in der Chat API. Entspricht dem Ressourcennamen des Gruppenbereichs in der Chat API. |
messages
Nachrichten, die im Chatbereich gesendet wurden.
Felder | |
---|---|
Document ID | String Die eindeutige ID einer bestimmten Nachricht. |
name | String Der eindeutige Name einer Nachricht in der Chat API. Entspricht dem Ressourcennamen der Nachricht in der Chat API. |
text | String Der Textkörper der Nachricht. |
time | String (Timestamp format) Die Uhrzeit, zu der die Nachricht erstellt wurde. |
users
Nutzer, die die Chat-App des KI-Wissensassistenten einem Chatbereich hinzugefügt haben.
Felder | |
---|---|
Document ID | String Eindeutige ID eines bestimmten Nutzers. |
accessToken | String Das Zugriffstoken, das während der OAuth 2.0-Nutzerautorisierung zum Aufrufen von Google Workspace APIs gewährt wurde. |
refreshToken | String Das Aktualisierungstoken, das während der OAuth 2.0-Nutzerautorisierung gewährt wurde. |
So erstellen Sie die Firestore-Datenbank:
Google Cloud Console
Klicken Sie in der Google Cloud Console auf das Dreistrich-Menü > Firestore.
Klicken Sie auf Datenbank erstellen.
Klicken Sie unter Firestore-Modus auswählen auf Nativer Modus.
Klicken Sie auf Weiter.
Konfigurieren Sie die Datenbank:
Lassen Sie unter Datenbank benennen die Datenbank-ID bei
(default)
.Wählen Sie unter Standorttyp die Option Region aus.
Geben Sie unter Region eine Region für Ihre Datenbank an, z. B.
us-central1
. Wählen Sie für eine optimale Leistung denselben oder einen Standort in der Nähe wie die Cloud Functions-Funktionen der Chat-App aus.
Klicken Sie auf Datenbank erstellen.
gcloud-CLI
Erstellen Sie 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
. Für eine optimale Leistung sollten Sie denselben Speicherort oder einen Speicherort in der Nähe der Cloud Functions der Chat-App auswählen.
Chat-App erstellen und bereitstellen
Ihr Google Cloud-Projekt ist jetzt erstellt und konfiguriert. Sie können also mit dem Erstellen und Bereitstellen der Chat-App beginnen. In diesem Abschnitt führen Sie die folgenden Schritte aus:
- Zwei Cloud Functions-Funktionen erstellen und bereitstellen. Eine für Chatinteraktionsereignisse und eine für Pub/Sub-Ereignisse.
- Erstellen und stellen Sie eine Chat-App auf der Konfigurationsseite der Google Chat API bereit.
Cloud Functions-Funktionen erstellen und bereitstellen
In diesem Abschnitt erstellen und stellen Sie zwei Cloud Functions mit den folgenden Namen bereit:
app
: Hostt den Code der Chat-App und führt ihn aus, der auf Ereignisse reagiert, die von Google Chat als HTTP-Anfragen empfangen werden.eventsApp
: Empfängt und verarbeitet Ereignisse im Chatbereich wie Nachrichten von Pub/Sub.
Zusammen bilden diese Cloud Functions die Anwendungslogik des KI-Wissensassistenten der Chat-App.
Optional: Bevor Sie Cloud Functions-Funktionen erstellen, nehmen Sie sich einen Moment Zeit, um sich den auf GitHub gehosteten Beispielcode anzusehen und sich damit vertraut zu machen.
app
erstellen und bereitstellen
Google Cloud Console
Laden Sie den Code als ZIP-Datei von GitHub herunter.
Extrahieren Sie die heruntergeladene ZIP-Datei.
Der extrahierte Ordner enthält das gesamte Google Workspace-Beispiel-Repository.
Rufen Sie im extrahierten Ordner das Verzeichnis
google-chat-samples-main/node/ai-knowledge-assistant
auf.Fügen Sie im Verzeichnis
google-chat-samples/node/ai-knowledge-assistant
die Dateiclient_secrets.json
hinzu, die Sie beim Erstellen von OAuth-Client-ID-Anmeldedaten für die Authentifizierung und Autorisierung heruntergeladen haben.Komprimieren Sie den Inhalt des Ordners
ai-knowledge-assistant
in eine ZIP-Datei.Das Stammverzeichnis der ZIP-Datei muss die folgenden Dateien und Ordner enthalten:
.gcloudignore
.gitignore
README.md
deploy.sh
env.js
events_index.js
http_index.js
index.js
client_secrets.json
package-lock.json
package.json
controllers/
model/
services/
test/
Klicken Sie in der Google Cloud Console auf das Dreistrich-Menü > 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 auf der Seite Funktion erstellen Ihre Funktion ein:
- Wählen Sie unter Umgebung die Option Cloud Run-Funktion aus.
- Geben Sie unter Funktionsname
app
ein. - Wählen Sie unter Region eine Region aus, z. B.
us-central1
. Diese Region muss mit der Region übereinstimmen, die Sie im autorisierten Weiterleitungs-URI festgelegt haben, als Sie OAuth-Client-ID-Anmeldedaten für die Authentifizierung und Autorisierung erstellt haben. - Wählen Sie unter Triggertyp die Option HTTPS aus.
- Wählen Sie unter Authentifizierung die Option Nicht authentifizierte Aufrufe zulassen aus.
- 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
app
ein.Wählen Sie unter Quellcode die Option ZIP-Upload aus.
create unter Ziel-Bucket oder wählen Sie einen aus:
- Klicken Sie auf Durchsuchen.
- Wählen Sie einen Bucket aus.
- Klicken Sie auf Auswählen.
Google Cloud lädt die ZIP-Datei in diesen Bucket hoch und extrahiert die Komponentendateien. Cloud Functions kopiert dann die Komponentendateien in die Cloud Functions-Funktion.
Laden Sie unter Zip-Datei die ZIP-Datei hoch, die Sie von GitHub heruntergeladen, extrahiert und neu komprimiert haben:
- Klicken Sie auf Durchsuchen.
- Gehen Sie zur ZIP-Datei und wählen Sie sie aus.
- 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:
- Klicken Sie auf der Seite Cloud Function-Details auf Bearbeiten.
- Klicken Sie auf Weiter.
- Wählen Sie unter Quellcode den Inline-Editor aus.
- Öffnen und bearbeiten Sie die Datei
env.js
im Inline-Editor:- Legen Sie den Wert von project auf Ihre Cloud-Projekt-ID fest.
- Legen Sie für location die Region der Cloud-Funktion fest, z. B.
us-central1
.
Klicken Sie auf Bereitstellen.
gcloud-CLI
Klonen Sie den Code aus GitHub:
git clone https://github.com/googleworkspace/google-chat-samples.git
Wechseln Sie in das Verzeichnis mit dem Code für diese Chat-App mit KI-Wissensassistent:
cd google-chat-samples/node/ai-knowledge-assistant
Fügen Sie im Verzeichnis
google-chat-samples/node/ai-knowledge-assistant
die Dateiclient_secrets.json
hinzu, die Sie beim Erstellen von OAuth-Client-ID-Anmeldedaten für die Authentifizierung und Autorisierung heruntergeladen haben.Bearbeiten Sie die Datei
env.js
, um Umgebungsvariablen festzulegen:- Legen Sie den Wert von project auf Ihre Cloud-Projekt-ID fest.
- Legen Sie für location die Region der Cloud-Funktion fest, z. B.
us-central1
.
Stellen Sie die Cloud Function in Google Cloud bereit:
gcloud functions deploy app \ --gen2 \ --region=REGION \ --runtime=nodejs20 \ --source=. \ --entry-point=app \ --trigger-http \ --allow-unauthenticated
Ersetzen Sie REGION durch den Wert der Region der Cloud-Funktion, damit er mit dem in der Datei
env.js
festgelegten Wert übereinstimmt, z. B.us-central1
.
eventsApp
erstellen und bereitstellen
Google Cloud Console
Rufen Sie in der Google Cloud Console das Dreistrich-Menü > Cloud Functions auf.
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:
- Wählen Sie unter Umgebung die Option Cloud Run-Funktion aus.
- Geben Sie unter Funktionsname
eventsApp
ein. - Wählen Sie unter Region eine Region aus, z. B.
us-central1
. Diese Region muss mit der Region übereinstimmen, die Sie im autorisierten Weiterleitungs-URI beim Erstellen von OAuth-Client-ID-Anmeldedaten für die Authentifizierung und Autorisierung festgelegt haben. - Wählen Sie unter Triggertyp die Option Cloud Pub/Sub aus.
- Wählen Sie unter Cloud Pub/Sub-Thema den Namen des von Ihnen erstellten Pub/Sub-Themas im Format
projects/PROJECT/topics/events-api
aus, wobei PROJECT Ihre Cloud-Projekt-ID ist. - Wenn eine Nachricht angezeigt wird, die mit
Service account(s) might not have enough permissions to deploy the function with the selected trigger.
beginnt, klicken Sie auf Alle gewähren. - 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
eventsApp
ein.Wählen Sie unter Quellcode die Option Zip aus Cloud Storage aus.
Klicken Sie unter Cloud Storage-Speicherort auf Durchsuchen.
Wählen Sie den Bucket aus, in den Sie die ZIP-Datei hochgeladen haben, als Sie die Cloud Function
app
erstellt haben.Klicken Sie auf die hochgeladene ZIP-Datei.
Klicken Sie auf Auswählen.
Klicken Sie auf Bereitstellen.
Die Seite Cloud Functions-Details wird geöffnet. Ihre Funktion wird mit drei Fortschrittsanzeigen angezeigt: eine für den Build, eine für den Dienst und eine für den Trigger. Wenn alle drei Fortschrittsanzeigen verschwinden und durch ein Häkchen ersetzt werden, ist die Funktion bereitgestellt und einsatzbereit.
Bearbeiten Sie den Beispielcode, um Konstanten festzulegen:
- Klicken Sie auf der Seite Cloud Function-Details auf Bearbeiten.
- Klicken Sie auf Weiter.
- Wählen Sie unter Quellcode den Inline-Editor aus.
- Öffnen und bearbeiten Sie die Datei
env.js
im Inline-Editor:- Legen Sie den Wert von project auf Ihre Cloud-Projekt-ID fest.
- Legen Sie den Wert von location auf die Region der Cloud Functions-Funktion fest, z. B.
us-central1
.
Klicken Sie auf Bereitstellen.
gcloud-CLI
Wechseln Sie in der gcloud CLI, falls noch nicht geschehen, zum Verzeichnis mit dem Code für diese Chat-App mit KI-Wissensassistent, die Sie zuvor von GitHub geklont haben:
cd google-chat-samples/node/ai-knowledge-assistant
Fügen Sie im Verzeichnis
google-chat-samples/node/ai-knowledge-assistant
die Dateiclient_secrets.json
hinzu, die Sie beim Erstellen von OAuth-Client-ID-Anmeldedaten für die Authentifizierung und Autorisierung heruntergeladen haben.Bearbeiten Sie die Datei
env.js
, um Umgebungsvariablen festzulegen:- Legen Sie den Wert von project auf Ihre Cloud-Projekt-ID fest.
- Legen Sie den Wert von location auf die Region der Cloud Functions-Funktion fest, z. B.
us-central1
.
Stellen Sie die Cloud Function in Google Cloud bereit:
gcloud functions deploy eventsApp \ --gen2 \ --region=REGION \ --runtime=nodejs20 \ --source=. \ --entry-point=eventsApp \ --trigger-topic=events-api
Ersetzen Sie REGION durch den Wert der Region der Cloud-Funktion, damit er mit dem in der Datei
env.js
festgelegten Wert übereinstimmt, z. B.us-central1
.
Trigger-URL der Cloud Functions-Funktion app
kopieren
Sie fügen die Trigger-URL der app
-Cloud-Funktion im nächsten Abschnitt ein, wenn Sie die Chat-App in der Google Cloud Console konfigurieren.
Google Cloud Console
Klicken Sie in der Google Cloud Console auf das Dreistrich-Menü > Cloud Functions.
Klicken Sie in der Liste der Cloud Functions-Funktionen in der Spalte Name auf
app
.Klickbasierter Trigger
Kopieren Sie die URL.
gcloud-CLI
Beschreiben Sie die Cloud Functions-Funktion
app
:gcloud functions describe app
Kopieren Sie die Property
url
.
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 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ü > Weitere Produkte > Google Workspace > Produktbibliothek > Google Chat API > Verwalten > Konfiguration.
und dann aufGeben Sie unter App-Name
AI knowledge assistant
ein.Geben Sie unter Avatar-URL
https://fonts.gstatic.com/s/i/short-term/release/googlesymbols/live_help/default/24px.svg
ein.Geben Sie unter Beschreibung den Wert
Answers questions with AI
ein.Stellen Sie die Ein/Aus-Schaltfläche Interaktive Funktionen aktivieren auf „Ein“.
Wählen Sie unter Funktionsweise die Option 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 aus der
app
-Cloud-Funktion ein. Die URL muss folgendermaßen formatiert sein:https://
REGION-
PROJECT_ID.cloudfunctions.net/app
. Dabei ist REGION die Region der Cloud-Funktion, z. B.us-central1
, und PROJECT_ID die Projekt-ID des von Ihnen erstellten Cloud-Projekts.Wählen Sie unter Sichtbarkeit die Option Diese Chat-App für bestimmte Personen und Gruppen in Ihrer Workspace-Domain verfügbar machen 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 des KI-Wissensassistenten in einem Chatbereich mit Nachrichten, indem Sie Fragen stellen, die die Chat-App des KI-Wissensassistenten beantworten kann.
So können Sie die KI-Chat-App testen:
- Fügen Sie der Chat-App „KI-Wissensassistent“ einen vorhandenen Chatbereich hinzu und stellen Sie Fragen, die für diesen Bereich relevant sind.
- Erstellen Sie einen Chatbereich und posten Sie einige Nachrichten, die als Datenquelle verwendet werden sollen. Nachrichten können durch einen Prompt wie
Answer 20 common onboarding questions employees ask their teams.
aus Gemini stammen. Du kannst auch ein paar Absätze aus dem Leitfaden Mit Chat entwickeln einfügen und dann Fragen dazu stellen.
Erstellen Sie für diese Anleitung einen Chatbereich und fügen Sie einige Absätze aus der Übersicht zum Entwickeln mit Chat ein.
Öffnen Sie Google Chat.
So erstellen Sie einen Chatbereich:
Klicken Sie auf > Gruppenbereich erstellen.
Neuer ChatGeben Sie unter Name des Gruppenbereichs den Wert
Testing AI knowledge assistant app
ein.Wählen Sie unter Wofür soll dieser Gruppenbereich genutzt werden? die Option Zusammenarbeit aus.
Wählen Sie unter Zugriffseinstellungen aus, wer auf den Gruppenbereich zugreifen kann.
Klicken Sie auf Erstellen.
Fügen Sie Nachrichten hinzu, die als Datenquelle verwendet werden sollen:
Rufen Sie in einem Webbrowser die Übersicht zum Entwickeln mit Chat auf.
Kopieren Sie den Inhalt des Leitfadens und fügen Sie ihn in den von Ihnen erstellten Google Chat-Gruppenbereich ein.
Fügen Sie die Chat-App des KI-Wissensassistenten hinzu:
Geben Sie in die Zeile zum Verfassen von Nachrichten die Taste
@AI knowledge assistant
ein. Wählen Sie dann im angezeigten Vorschlagsmenü die Chat-App mit KI-Wissensassistenten aus und drücken Sie die Tasteenter
.Es wird eine Meldung angezeigt, in der Sie gefragt werden, ob Sie dem Gruppenbereich die Chat-App mit dem KI-Wissensassistenten hinzufügen möchten. Klicken Sie auf Zu Gruppenbereich hinzufügen.
Wenn Sie die Chat-App zum ersten Mal einem Gruppenbereich hinzufügen, müssen Sie die Authentifizierung und Autorisierung für die Chat-App konfigurieren:
- Klicken Sie auf Konfigurieren.
- Ein neues Browserfenster oder ein neuer Tab wird geöffnet, in dem Sie aufgefordert werden, ein Google-Konto auszuwählen. Wählen Sie das Konto aus, mit dem Sie testen möchten.
- Prüfen Sie die Berechtigungen, die der KI-Wissensassistent in der Chat-App anfordert. Klicken Sie auf Zulassen, um die Berechtigungen zu gewähren.
- Die Meldung
You may close this page now.
wird angezeigt. Schließen Sie das Browserfenster oder den Tab und kehren Sie zum Chatbereich zurück.
Fragen stellen:
Geben Sie in die Eingabezeile für Nachrichten eine Frage wie
What are Google Chat apps?
ein.Der KI-Wissensassistent in der Chat App antwortet.
Wenn die Antwort nicht korrekt oder nicht ausreichend ist, können Sie auf
Hilfe erhalten klicken, um den Konversationsverlauf der KI zu verbessern. Der KI-Wissensassistent in der Chat-App erwähnt einen Gruppenbereichsmanager und bittet ihn, die Frage zu beantworten. Beim nächsten Mal weiß der KI-Wissensassistent in der Chat-App die Antwort.
Überlegungen, alternative Architekturoptionen und nächste Schritte
In diesem Abschnitt werden weitere Möglichkeiten der Chat-App für KI-Wissensassistent beschrieben.
Firestore, Cloud Storage oder Aufruf von „List Messages“ in der Chat API
In dieser Anleitung wird empfohlen, Daten von Chatbereich wie Nachrichten in einer Firestore-Datenbank zu speichern, da dies die Leistung verbessert, als wenn die Methode list
für die Ressource Message
mit der Chat API jedes Mal aufgerufen wird, wenn die Chat-App eine Frage beantwortet. Außerdem kann das wiederholte Aufrufen von list messages
dazu führen, dass die Chat-App die API-Kontingentlimits erreicht.
Wenn der Chatverlauf eines Chatbereichs jedoch zu lang wird, kann die Verwendung von Firestore kostspielig werden.
Cloud Storage ist eine Alternative zu Firestore. Jeder Gruppenbereich, in dem der KI-Wissensassistent aktiv ist, erhält ein eigenes Objekt. Jedes Objekt ist eine Textdatei, die alle Nachrichten im Gruppenbereich enthält. Der Vorteil dieses Ansatzes besteht darin, dass der vollständige Inhalt der Textdatei mit Gemini auf einmal in Vertex AI eingespeist werden kann. Der Nachteil ist jedoch, dass das Aktualisieren des Unterhaltungsverlaufs mehr Arbeit erfordert, da Sie kein Objekt in Cloud Storage anhängen können, sondern nur ersetzen. Dieser Ansatz ist nicht sinnvoll, wenn Sie den Nachrichtenverlauf regelmäßig aktualisieren. Er wäre jedoch eine gute Wahl, wenn Sie den Nachrichtenverlauf regelmäßig im Batch aktualisieren, beispielsweise einmal pro Woche.
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-UI keine Fehlermeldung angezeigt, aber die Chat-App oder -Karte liefert ein unerwartetes Ergebnis. So kann z. B. keine Kartenmeldung angezeigt werden.
Obwohl eine Fehlermeldung möglicherweise nicht in der Chat-UI angezeigt wird, sind beschreibende Fehlermeldungen und Protokolldaten verfügbar, um Sie beim Beheben von Fehlern zu unterstützen, wenn das Fehler-Logging 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, empfehlen wir Ihnen, das Cloud-Projekt zu löschen.
- Wechseln Sie in der Google Cloud Console zur Seite Ressourcen verwalten. Klicken Sie auf das Dreistrich-Menü > IAM & Verwaltung > Ressourcen verwalten.
- 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.
Weitere Informationen
- Projekte mit Google Chat, Vertex AI und Firestore verwalten
- Auf Vorfälle mit Google Chat, Vertex AI und Apps Script reagieren