Google Chat-App mit einem ADK-KI-Agenten erstellen

Auf dieser Seite wird beschrieben, wie Sie ein Google Workspace-Add‑on erstellen, das in Google Chat funktioniert und mit einem Agent Development Kit (ADK) KI-Agenten interagiert, der in der Vertex AI Agent Engine gehostet wird.

KI-Agenten nehmen ihre Umgebung selbstständig wahr, ziehen Schlussfolgerungen und führen komplexe, mehrstufige Aktionen aus, um ein definiertes Ziel zu erreichen. In dieser Anleitung stellen Sie das ADK LLM Auditor-Multi-Agenten-Beispiel bereit, das Fakten mit Gemini und Google Search-Fundierung kritisiert und überarbeitet.

Im folgenden Diagramm sind die Architektur und das Messaging-Muster dargestellt:

Im vorherigen Diagramm hat ein Nutzer, der mit einer Chat-App interagiert, die mit einem ADK KI-Agenten implementiert wurde, folgenden Informationsfluss:

1. Ein Nutzer sendet eine Nachricht an eine Chat-App, entweder in einer Direktnachricht oder in einem Chatbereich.
2. Die Chat-App-Logik, die entweder in Apps Script oder als Webserver mit HTTP-Endpunkten implementiert ist, empfängt und verarbeitet die Nachricht.
3. Der KI-Agent, der mit ADK implementiert und mit der Vertex AI Agent Engine gehostet wird, empfängt und verarbeitet die Interaktion.
4. Optional können die Chat-App oder der KI-Agent in Google Workspace-Dienste wie Google Kalender oder Google Sheets oder andere Google-Dienste wie Google Maps oder YouTube eingebunden werden.
5. Die Chat-App sendet asynchron Antworten über die Google Chat API, um den Fortschritt des KI-Agenten zu kommunizieren.
6. Die Antworten werden an den Nutzer gesendet.

Ziele

• die Umgebung einrichten
• den ADK KI-Agenten bereitstellen
• die Chat-App bereitstellen
• die Chat-App konfigurieren
• die Chat-App testen

Vorbereitung

• Ein Google Workspace-Konto für Unternehmen mit Zugriff auf Google Chat.
• Google Cloud-Projekt mit aktivierter Abrechnungsfunktion. Informationen dazu, wie Sie prüfen, ob die Abrechnung für ein vorhandenes Projekt aktiviert ist, finden Sie unter Abrechnungsstatus Ihrer Projekte prüfen. Informationen zum Erstellen eines Projekts und zum Einrichten der Abrechnung finden Sie unter Google Cloud-Projekt erstellen.

Umgebung einrichten

Google Cloud APIs aktivieren

Bevor Sie Google APIs verwenden können, müssen Sie sie in einem Google Cloud-Projekt aktivieren. Sie können eine oder mehrere APIs in einem einzelnen Google Cloud-Projekt aktivieren.

• Aktivieren Sie in der Google Cloud Console die Google Chat API, die Vertex AI API und die Cloud Resource Manager API.

  APIs aktivieren

OAuth-Zustimmungsbildschirm konfigurieren

Für alle Apps, die OAuth 2.0 verwenden, ist eine Konfiguration des Zustimmungsbildschirms erforderlich. Wenn Sie den OAuth-Zustimmungsbildschirm Ihrer App konfigurieren, legen Sie fest, was Nutzern und App-Prüfern angezeigt wird, und registrieren Ihre App, damit Sie sie später veröffentlichen können.

1. Rufen Sie in der Google API Console das Menü menu > Google Auth Platform > Branding auf.

   Zum Branding

2. Wenn Sie die Google Auth Platform bereits konfiguriert haben, können Sie die folgenden Einstellungen für den OAuth-Zustimmungsbildschirm unter Branding, Zielgruppe und Datenzugriff konfigurieren. Wenn Sie die Meldung Google Auth Platform noch nicht konfiguriert sehen, klicken Sie auf Jetzt starten:
1. Geben Sie unter Anwendungsinformationen im Feld Anwendungsname einen Namen für die App ein.
2. Wählen Sie unter E‑Mail-Adresse für Nutzersupport eine E‑Mail-Adresse für den Support aus, über die Nutzer Sie kontaktieren können, wenn sie Fragen zu ihrer Einwilligung haben.
3. Klicken Sie auf Weiter.
4. Wählen Sie unter Zielgruppe die Option Intern aus.
5. Klicken Sie auf Weiter.
6. Geben Sie unter Kontaktdaten eine E‑Mail-Adresse ein, unter der Sie über Änderungen an Ihrem Projekt benachrichtigt werden können.
7. Klicken Sie auf Weiter.
8. Lesen Sie unter Abschließen die Nutzerdatenrichtlinie für Google API-Dienste und wählen Sie bei Zustimmung Ich akzeptiere die Richtlinie zu Nutzerdaten für Google API-Dienste aus.
9. Klicken Sie auf Weiter.
10. Klicken Sie auf Erstellen.
3. Sie können das Hinzufügen von Bereichen vorerst überspringen. Wenn Sie später eine App für die Verwendung außerhalb Ihrer Google Workspace-Organisation erstellen, müssen Sie den Nutzertyp in Extern ändern. Fügen Sie dann die Autorisierungsbereiche hinzu, die Ihre App benötigt. Weitere Informationen finden Sie in der vollständigen Anleitung zum Konfigurieren des OAuth-Zustimmungsbildschirms.

Dienstkonto in der Google Cloud Console erstellen

Erstellen Sie ein neues Dienstkonto mit der Rolle Vertex AI User so:

Google Cloud Console

1. Rufen Sie in der Google Cloud Console das Menü menu > IAM und Verwaltung > Dienstkonten auf.

   Zur Seite „Dienstkonten“

   Die verbleibenden Schritte werden in der Google Cloud Console angezeigt.

2. Wählen Sie ein Google Cloud-Projekt aus.
3. Klicken Sie auf Dienstkonto erstellen.
4. Geben Sie einen Dienstkontonamen ein, der in der Google Cloud Console angezeigt werden soll.
5. Wenn Sie die Zugriffssteuerungen derzeit nicht festlegen möchten, klicken Sie auf Fertig , um das Erstellen des Dienstkontos abzuschließen. Wenn Sie die Zugriffssteuerungen jetzt festlegen möchten, klicken Sie auf Erstellen und fortfahren und fahren Sie mit dem nächsten Schritt fort.
6. Optional: Weisen Sie Ihrem Dienstkonto Rollen zu, um zusätzlich zu Google Workspace-Ressourcen Zugriff auf die Ressourcen Ihres Google Cloud-Projekts zu gewähren. Weitere Informationen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
7. Klicken Sie auf Weiter.
8. Optional: Geben Sie Nutzer oder Gruppen ein, die dieses Dienstkonto verwalten und Aktionen damit ausführen können. Weitere Informationen finden Sie unter Identitätsübernahme des Dienstkontos.
9. Klicken Sie auf Fertig , um das Erstellen des Dienstkontos abzuschließen.

   Notieren Sie sich die E‑Mail-Adresse des Dienstkontos.

gcloud-CLI

1. Erstellen Sie das Dienstkonto:

   gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
     --display-name="SERVICE_ACCOUNT_NAME"

2. Optional: Weisen Sie Ihrem Dienstkonto Rollen zu, um zusätzlich zu Google Workspace-Ressourcen Zugriff auf die Ressourcen Ihres Google Cloud-Projekts zu gewähren. Weitere Informationen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Das Dienstkonto wird auf der Seite „Dienstkonto“ angezeigt.

Privaten Schlüssel erstellen

So erstellen und laden Sie einen privaten Schlüssel für das Dienstkonto herunter:

1. Rufen Sie in der Google Cloud Console das Menü menu > IAM und Verwaltung > Dienstkonten auf.

   Zur Seite „Dienstkonten“

   Die verbleibenden Schritte werden in der Google Cloud Console angezeigt.

2. Wählen Sie ein Google Cloud-Projekt aus.
3. Klicken Sie auf die E‑Mail-Adresse des Dienstkontos, für das Sie einen Schlüssel erstellen möchten.
4. Klicken Sie auf den Tab Schlüssel.
5. Klicken Sie auf das Drop-down-Menü Schlüssel hinzufügen und wählen Sie Neuen Schlüssel erstellen aus.
6. Wählen Sie als Schlüsseltyp die Option JSON aus und klicken Sie dann auf Erstellen.

   Ihr neues öffentliches/privates Schlüsselpaar wird generiert und als Dienstkontoschlüsseldatei auf Ihren Computer heruntergeladen. Speichern Sie die heruntergeladene JSON-Datei als credentials.json in Ihrem Arbeitsverzeichnis. Diese Datei ist die einzige Kopie dieses Schlüssels. Nachdem Sie die Schlüsseldatei heruntergeladen haben, können Sie sie nicht noch einmal herunterladen. Informationen zum sicheren Speichern Ihres Schlüssels finden Sie unter Best Practices für die Verwaltung von Dienstkontoschlüsseln.

Weitere Informationen zu Dienstkonten finden Sie in der Google Cloud IAM-Dokumentation unter Dienstkonten.

Den ADK KI-Agenten bereitstellen

1. Öffnen Sie das LLM Auditor-Beispiel im Vertex AI Agent Garden:

   Beispiel öffnen

2. Klicken Sie auf Bereitstellen.

3. Wählen Sie bei entsprechender Aufforderung Ihr Google Cloud-Projekt aus.

4. Klicken Sie auf In Cloud Shell bereitstellen.

5. Klicken Sie bei entsprechender Aufforderung auf Autorisieren und führen Sie den OAuth-Ablauf für die Cloud Shell aus.

6. Wenn die Cloud Shell vollständig geladen ist, drücken Sie die Eingabetaste , um die vorab geladene Befehlszeile auszuführen und die Bereitstellung zu starten.

7. Wenn Sie aufgefordert werden, eine Region einzugeben, drücken Sie die Eingabetaste , um die Standardeinstellung zu verwenden.

8. Rufen Sie nach Abschluss des Vorgangs die Vertex AI Agent Engine auf:

   Vertex AI Agent Engine öffnen

9. Klicken Sie auf , um den Ressourcennamen des neu bereitgestellten Agenten aus der Tabelle zu kopieren.

Das Chat-App-Projekt erstellen und konfigurieren

1. Klicken Sie auf die folgende Schaltfläche, um das Apps Script-Projekt ADK AI Agent Quickstart zu öffnen.

   Projekt öffnen

2. Klicken Sie auf info_outline Übersicht > Kopie erstellen.

3. Klicken Sie in Ihrem Apps Script-Projekt auf Projekteinstellungen > Skripteigenschaften bearbeiten > Skripteigenschaft hinzufügen, um die folgenden Skripteigenschaften hinzuzufügen:

   1. REASONING_ENGINE_RESOURCE_NAME mit dem in den vorherigen Schritten kopierten Ressourcennamen des Vertex AI-KI-Agenten.
   2. SERVICE_ACCOUNT_KEY mit dem in den vorherigen Schritten heruntergeladenen JSON-Schlüssel des Dienstkontos, z. B. { ... }.

4. Klicken Sie auf Skripteigenschaften speichern.

5. Rufen Sie in der Google API Console das Menü menu > IAM und Verwaltung > Einstellungen auf.

   Weiter zur Seite "IAM &Verwaltung"

6. Kopieren Sie den Wert im Feld Projektnummer.

7. Klicken Sie in Ihrem Apps Script-Projekt auf Projekteinstellungen.

8. Klicken Sie unter Google Cloud Platform-Projekt (GCP) auf Projekt wechseln.

9. Fügen Sie unter GCP-Projektnummer die in den vorherigen Schritten kopierte Google Cloud-Projektnummer ein.

10. Klicken Sie auf Projekt festlegen. Das Cloud-Projekt und das Apps Script-Projekt sind jetzt verbunden.

Testbereitstellung erstellen

Sie benötigen eine Bereitstellungs-ID für dieses Apps Script-Projekt, damit Sie sie im nächsten Schritt verwenden können.

So rufen Sie die Bereitstellungs-ID für das Head-Deployment ab:

1. Klicken Sie im Apps Script-Projekt der Chat-App auf Bereitstellen > Bereitstellungen testen.
2. Klicken Sie unter Bereitstellungs-ID für das Head-Deployment auf Kopieren.
3. Klicken Sie auf Fertig.

Die Chat-App konfigurieren

Folgen Sie dieser Anleitung, um die Google Chat-App mit Ihrer Apps Script-Bereitstellung zum Testen bereitzustellen:

1. Suchen Sie in der API Console nach Google Chat API, und klicken Sie auf Google Chat API.
2. Klicken Sie auf Verwalten.

3. Klicken Sie auf Konfiguration und richten Sie die Chat-App ein:

   1. Geben Sie im Feld Anwendungsname ADK Quickstart ein.
   2. Geben Sie im Feld Avatar-URL https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.png ein.
   3. Geben Sie im Feld Beschreibung ADK Quickstart ein.
   4. Wählen Sie unter Funktionen die Option Gruppenbereichen und Gruppenunterhaltungen beitreten aus.
   5. Wählen Sie unter „Verbindungseinstellungen“ die Option Apps Script-Projekt aus.
   6. Fügen Sie im Feld Bereitstellungs-ID die zuvor kopierte Bereitstellungs-ID für das Head-Deployment ein.
   7. Wählen Sie unter „Sichtbarkeit“ die Option Bestimmte Personen und Gruppen in Ihrer Domain aus und geben Sie Ihre E‑Mail-Adresse ein.

4. Klicken Sie auf Speichern.

Die Chat-App ist bereit, auf Nachrichten zu antworten.

Die Chat-App testen

Öffnen Sie zum Testen Ihrer Chat-App einen Direktnachrichtenbereich mit der Chat-App und senden Sie eine Nachricht:

1. Ö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 wechseln

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

4. Wählen Sie Ihre Chat-App in den Ergebnissen aus. Eine Direktnachricht wird geöffnet.

5. Geben Sie in der neuen Direktnachricht mit der App The Eiffel Tower was completed in 1900 ein und drücken Sie die enter.

   Die Chat-App antwortet mit den Antworten der Unteragenten Critic und Reviser.

Informationen zum Hinzufügen vertrauenswürdiger Tester und zum Testen interaktiver Funktionen finden Sie unter Interaktive Funktionen für Google Chat-Apps testen.

Fehlerbehebung

Wenn eine Google Chat-App oder Karte einen Fehler zurückgibt, wird in der Chat-Oberfläche die Meldung „Ein Fehler ist aufgetreten.“ oder „Ihre Anfrage kann nicht verarbeitet werden.“ Manchmal wird in der Chat-UI keine Fehlermeldung angezeigt, aber die Chat-App oder Karte liefert ein unerwartetes Ergebnis. Beispielsweise wird möglicherweise keine Kartenmeldung angezeigt.

Auch wenn in der Chat-UI keine Fehlermeldung angezeigt wird, beschreibende Fehlermeldungen und Logdaten sind verfügbar, mit denen Sie Fehler beheben können, wenn die Fehlerprotokollierung für Chat-Apps aktiviert ist. Informationen zum Ansehen, Debuggen und Beheben von Fehlern finden Sie unter Fehler in Google Chat beheben.

Bereinigen

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

1. Rufen Sie in der Google API Console die Seite Ressourcen verwalten auf. Klicken Sie auf das Menü menu > IAM und Verwaltung > Ressourcen verwalten.

   Zum Resource Manager

2. Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen delete.
3. Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Herunterfahren, um das Projekt zu löschen.

Weitere Informationen

• Google Chat-App mit einem ADK KI-Agenten erstellen, der über A2A verfügbar gemacht wird
• Google Chat-App mit einem ADK KI-Agenten erstellen, der über A2UI verfügbar gemacht wird
• Gemini Enterprise-Agenten erstellen, die eng in Workspace-Datenspeicher, APIs und Chat-Apps eingebunden sind
• Vertex AI-Agenten erstellen, die eng in Workspace-Datenspeicher, APIs und Chat-Apps eingebunden sind
• Aussagen mit einem ADK KI-Agenten und dem Gemini-Modell auf ihren Wahrheitsgehalt prüfen
• Reisen mit einem KI-Agenten planen, der in Google Workspace verfügbar ist
• Google Chat-App mit einem Gemini Enterprise KI-Agenten erstellen
• Grundlegende KI-Konzepte in Chat-Apps einbinden
• Antworten auf Fragen basierend auf Chat-Unterhaltungen mit einer KI-Chat-App von Gemini
• Mit Google Chat, Vertex AI, Apps Script und Nutzerauthentifizierung auf Vorfälle reagieren
• Projekte mit Google Chat, Vertex AI und Firestore verwalten