Ersten Agent erstellen

Vorbereitung

KI-Agenten erstellen

In dieser Anleitung wird beschrieben, wie Sie mit einer Beispielanwendung einen Agent erstellen. Das Beispiel bietet eine schnelle Möglichkeit, die Funktionen eines Agent zu testen, und kann als Ausgangspunkt für die Entwicklung Ihres Agent dienen. Wenn Sie eine vorhandene Anwendung so ändern möchten, dass sie einen Agent enthält, bietet das Beispiel ein gutes Modell für Ihre Anwendungslogik.

Dieser Schnellstart erläutert folgende Schritte:

  • Als Partner registrieren
  • Marke und Agent erstellen
  • Optional: Funktionen in einer Unterhaltung mit dem Helper-Bot für Business Messages testen
  • Agent zum Senden und Empfangen von Nachrichten einrichten

Informationen zum Erstellen eines Agent ohne Verwendung des Beispiels finden Sie unter KI-Agenten erstellen.

Als Partner registrieren

  1. Öffnen Sie die Business Communications Developer Console.
  2. Klicken Sie unter Business Messages auf Partnerkonto erstellen.

  3. Geben Sie Ihre Partnerinformationen ein:

    Feld Wert
    Ihr Name Ihr vollständiger Name
    Name des Partners Name der Organisation
    Website des Partners Website der Organisation
    Region Die Region, in der Sie den Business Messages-Dienst hosten möchten

  4. Lesen und akzeptieren Sie die Nutzungsbedingungen für Business Messages.

  5. Klicken Sie auf Erstellen.

Sie sind jetzt als Business Messages-Partner registriert. Für Sie wurde ein neues Google Cloud-Projekt erstellt, in dem die Business Messages API und die Business Communications API aktiviert sind. Sie haben keinen Zugriff auf dieses Projekt und es hat keine Auswirkungen auf Ihre vorhandenen Google Cloud-Projekte.

Sie haben jetzt Zugriff auf die Business Messages API und die Business Communications API.

Dienstkonto erstellen

  1. Klicken Sie auf der Startseite der Business Communications Developer Console auf Einstellungen für Partnerkonto.
  2. Klicken Sie in der linken Navigationsleiste auf Dienstkonto.

  3. Klicken Sie auf Schlüssel erstellen und dann auf Erstellen.

    Der Browser lädt den Dienstkontoschlüssel herunter. Bewahren Sie ihn an einem sicheren Ort auf. Sie benötigen diesen Schlüssel später, um eine Webanwendung bereitzustellen und in Zukunft auf die Business Messages API und die Business Communications API zuzugreifen.

Marke und Agent erstellen

Ein Agent ist eine dialogorientierte Darstellung einer Marke – die dialogorientierte Entität, mit der Nutzer interagieren. Sie erstellen eine Marke, um das Unternehmen zu repräsentieren, und einen Agent, damit Kunden auf dialogorientierte Weise mit dem Unternehmen in Kontakt treten können.

  1. Öffnen Sie die Business Communications Developer Console und melden Sie sich mit Ihrem Google-Konto für Business Messages an.
  2. Klicken Sie auf KI-Agent erstellen.
  3. Wählen Sie unter Agent-Typ die Option Business Messages aus.
  4. Geben Sie Werte für Markenname und Agent-Name ein.
  5. Führen Sie einen der folgenden Schritte aus:
    • Wenn Sie eine Unterhaltung mit Ihrem Agent führen und die verfügbaren Funktionen testen möchten, wählen Sie Helper-Bot für Business Messages aktivieren aus.
    • Wenn Sie Ihren Agent anpassen und auf die Nachrichtenbearbeitung vorbereiten möchten, deaktivieren Sie Helper-Bot für Business Messages aktivieren.
  6. Klicken Sie auf KI-Agent erstellen.

Wenn Sie den Helper-Bot für Business Messages aktiviert haben, können Sie sofort eine Unterhaltung starten. Andernfalls fahren Sie mit der Einrichtung Ihres Agent für die Nachrichtenbearbeitung fort.

Funktionen mit dem Helper-Bot für Business Messages testen

Mit dem Helper-Bot für Business Messages können Sie schnell eine Unterhaltung mit Ihrem Agent starten und so die Funktionen der Plattform testen. Das Aktivieren des Helper-Bot ist optional, aber sehr empfehlenswert, wenn Sie Ihren ersten Agent erstellen.

Mit dem Helper-Bot können Sie

  • Rich-Funktionen testen
  • Informationen zum Implementieren von Funktionen erhalten
  • Ressourcen für die Einrichtung von Agent finden

Wenn der Helper-Bot aktiviert ist, sendet und empfängt er Nachrichten für den Agent. Es wird kein Webhook benötigt. Sie müssen den Helper-Bot deaktivieren, bevor Sie einen Webhook festlegen oder Dialogflow aktivieren können, um Nutzernachrichten zu verarbeiten.

Unterhaltung mit dem Helper-Bot starten

Sobald Sie den Helper-Bot für Business Messages aktiviert haben, können Sie eine Unterhaltung starten. Unmittelbar nach der Erstellung des Agent wird ein Dialogfeld geöffnet, das Ihnen den Einstieg erleichtert.

So interagieren Sie über dieses Dialogfeld mit dem Helper-Bot:

  1. Rufen Sie die Test-URLs des Agent auf. Hierfür gibt es mehrere Möglichkeiten:

    • Klicken Sie auf die Schaltfläche Android oder iOS. Scannen Sie dann den QR-Code mit dem entsprechenden Mobilgerät und klicken Sie auf Starten. Alternativ können Sie auf Android-URL kopieren oder iOS-URL kopieren klicken, um die Test-URL des Agent zu kopieren.
    • Klicken Sie auf Senden , um die URLs an Ihre E-Mail-Adresse zu senden.

  2. Öffnen Sie die URL auf Ihrem Mobilgerät. Auf iOS-Geräten ist die Google Maps App erforderlich.

Helper-Bot deaktivieren

Bevor Sie Ihren Agent anpassen und auf die Aktivierung vorbereiten können, müssen Sie den Helper-Bot für Business Messages deaktivieren.

So deaktivieren Sie den Helper-Bot:

  1. Öffnen Sie die Business Communications Developer Console.
  2. Wählen Sie den Agent aus.
  3. Klicken Sie in der linken Navigationsleiste auf Integrationen.
  4. Klicken Sie für Helper-Bot auf Deaktivieren.

Wenn der Helper-Bot deaktiviert ist, sendet und empfängt er keine Nachrichten mehr für Ihren Agent. Jetzt können Sie Ihren Agent so einrichten, dass er den Nachrichtenfluss verarbeitet.

Agent für die Nachrichtenbearbeitung einrichten

In dieser Anleitung stellen Sie einen Echo-Bot in der Google Cloud Platform (GCP) mit einem Webhook bereit, der Nutzernachrichten verarbeitet.

Der Echo-Bot ist eine Beispielanwendung, die Nachrichten an den Nutzer zurücksendet. So können Sie in einer Unterhaltung mit Ihrem Agent Rich-Funktionen wie Vorschläge für Aktionen und interaktive Chat-Nachrichten, testen. Sie können den Echo-Bot auch als Ausgangspunkt für die Entwicklung Ihres Agent verwenden.

Führen Sie die folgenden Schritte aus:

  • Echo-Bot-Beispiel in der GCP bereitstellen
  • Webhook-URL für Ihr Business Messages-Partnerkonto konfigurieren
  • Grundlegende Informationen zu Ihrem Agent angeben

Am Ende dieser Anleitung ist Ihr Agent bereit, Nachrichten zu senden und zu empfangen.

Webanwendung in der GCP bereitstellen

Business Messages leitet Nachrichten von Nutzern an einen Webhook in Ihrer Infrastruktur weiter. In dieser Anleitung stellen Sie den Quellcode des Echo-Bot-Beispiels in einem vorkonfigurierten Webhook bereit. Wenn Sie bereits eine Webinfrastruktur haben, die Sie zum Empfangen von Nachrichten nutzen können, können Sie in diesem Webdienst einen neuen Webhook erstellen. Sie müssen die Logik jedoch selbst konfigurieren. Weitere Informationen finden Sie unter Einrichten Ihres Webhooks auf Partnerebene.

Cloud-Umgebung erstellen

Sie benötigen eine Cloud-Umgebung, um das Echo-Bot-Beispiel bereitzustellen.

So erstellen Sie ein GCP-Projekt als Cloud-Umgebung:

  1. Öffnen Sie die Google Cloud Console-Projektauswahl.

    Wenn Sie noch nie ein Google Cloud-Projekt erstellt haben, müssen Sie die Nutzungsbedingungen akzeptieren.

  2. Klicken Sie auf Projekt erstellen.

  3. Geben Sie einen Namen und einen Speicherort für das neue Projekt ein.

    • Ihre Projekt-ID wird automatisch generiert und unter dem Projektnamen angezeigt.
    • Klicken Sie im Feld Speicherort auf Durchsuchen, um mögliche Speicherorte für Ihr Projekt anzuzeigen. Wenn Sie Ihre Google Workspace-Organisation nicht finden, sind Sie nicht in einem Google Workspace-Konto angemeldet. Sie können ein Projekt ohne Organisation erstellen, aber einige Funktionen sind eingeschränkt. Weitere Informationen zu Vorteilen der Organisationsressource.

  4. Klicken Sie auf Erstellen.

  5. Klicken Sie auf das Dreistrich-Menü Menü.

  6. Klicken Sie auf Abrechnung.

  7. Klicken Sie auf Rechnungskonto verknüpfen.

  8. Erstellen Sie ein neues Rechnungskonto oder fügen Sie dem Projekt ein vorhandenes Rechnungskonto hinzu. Informationen zu den Zahlungsoptionen finden Sie unter Funktionen des kostenlosen Google Cloud-Programms.

Echo-Bot-Beispiel bereitstellen

  1. Installieren Sie die gcloud CLI. Damit stellen Sie den Beispielcode in Google Cloud bereit.

  2. Laden Sie das Echo-Bot-Beispiel herunter und extrahieren Sie es (Node.js, Java, Python).

  3. Kopieren Sie die JSON-Datei mit den Anmeldedaten, die Sie unter Dienstkonto erstellen heruntergeladen haben, in den Ordner „resources“ des Beispiels und benennen Sie die Anmeldedaten in „bm-agent-service-account-credentials.json“ um. Der Pfad zu dieser Anmeldedatendatei hängt vom heruntergeladenen Beispiel ab.

    Node.js

    ./bm-nodejs-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

    Java

    ./bm-java-echo-bot/full_sample/src/main/resources/bm-agent-service-account-credentials.json

    Python

    ./bm-python-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

  4. Öffnen Sie in einem Terminal das Verzeichnis „full_sample“ des Beispiels.

  5. Führen Sie die folgenden Befehle in einem Terminal aus, um das Beispiel bereitzustellen:

    Node.js

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID ist die Projekt-ID für das Projekt, das Sie unter Cloud-Umgebung erstellen erstellt haben. Die Projekt-ID finden Sie in Google Cloud im Projektdashboard.

    Java

    gcloud config set project PROJECT_ID
gcloud app create
mvn appengine:deploy

    PROJECT_ID ist die Projekt-ID für das Projekt, das Sie unter Cloud-Umgebung erstellen erstellt haben. Die Projekt-ID finden Sie in Google Cloud im Projektdashboard.

    Python

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID ist die Projekt-ID für das Projekt, das Sie unter Cloud-Umgebung erstellen erstellt haben. Die Projekt-ID finden Sie in Google Cloud im Projektdashboard.

  6. Notieren Sie sich die URL der bereitgestellten Anwendung in der Ausgabe des letzten Befehls. Dies ist die Basis Ihrer Webhook-URL:

    Deployed service [default] to [https://PROJECT_ID.appspot.com]

Webhook festlegen

Nachdem der Echo-Bot bereitgestellt wurde, müssen Sie eine Webhook-URL angeben (die Sie betreiben), um Nachrichten zu empfangen.

  1. Öffnen Sie die Kontoeinstellungen in der Business Communications Developer Console.
  2. Prüfen Sie, ob das richtige Partnerkonto ausgewählt ist.
  3. Klicken Sie für Webhook-URL für Business Messages auf Konfigurieren.

  4. Geben Sie für Webhook-Endpunkt-URL die URL Ihrer Anwendung + „/callback“ ein.

    Ihr Endpunkt hat das Format: „https://PROJECT_ID.appspot.com/callback“.

    Dieser Endpunkt ist in der Anwendungslogik des Beispiels vordefiniert, das Sie in der GCP bereitgestellt haben.

  5. Klicken Sie in der Developer Console auf Bestätigen.

    Wenn Business Messages Ihren Webhook bestätigt hat, wird das Dialogfeld geschlossen.

Informationen zum Konfigurieren Ihres Webhook mit der Business Communications API finden Sie unter Beispiel: Webhook-URL aktualisieren.

Mit dem Business Messages-Testframework können Sie testen, ob Ihr Webhook erfolgreich auf Business Messages-Nutzdaten antwortet.

Agent-Informationen eingeben

Geben Sie einige grundlegende Informationen an, um die Einrichtung Ihres Agent abzuschließen.

  1. Öffnen Sie die Business Communications Developer Console.
  2. Klicken Sie in der linken Navigationsleiste auf Agent-Informationen.

  3. Aktualisieren Sie die Werte nach Belieben oder verwenden Sie die folgenden Vorschläge:

    Feld Wert
    Willkommensnachricht Willkommen zur Unterhaltung mit dem Echo-Bot!
    Datenschutzerklärung https://policies.google.com/privacy

  4. Klicken Sie auf Speichern.

Unterhaltung starten

So interagieren Sie mit dem Echo-Bot:

  1. Öffnen Sie die Business Communications Developer Console.
  2. Klicken Sie in der linken Navigationsleiste auf Agent-Informationen.
  3. Klicken Sie unter Test-URLs für Agent auf die Schaltfläche Android oder iOS.

  4. Scannen Sie den QR-Code mit dem entsprechenden Mobilgerät oder klicken Sie auf Android-URL kopieren oder iOS-URL kopieren, um die Test-URL des Agent zu kopieren.

    Sie können auch auf Senden klicken, um die URLs an Ihre E-Mail-Adresse zu senden.

  5. Öffnen Sie die URL auf Ihrem Mobilgerät. Auf iOS-Geräten ist die Google Maps App erforderlich.

Sie werden mit der Willkommensnachricht Ihres Agent begrüßt. Jetzt können Sie mit dem Echo-Bot interagieren. Er sendet die Nachrichten, die Sie senden, an Sie zurück. Außerdem können Sie Rich-Funktionen aufrufen, indem Sie bestimmte Strings senden: „carousel“, „card“, „chips“.

Nächste Schritte

Nachdem Sie Ihren ersten Agent erstellt haben, erfahren Sie mehr über Business Messages und die weiteren Möglichkeiten auf der Plattform.