Ersten Agent erstellen

Voraussetzungen

Agent erstellen

In diesem Leitfaden erfahren Sie, wie Sie einen Agent mit einer Beispielanwendung erstellen. Das Beispiel bietet eine schnelle Möglichkeit, die Funktionalität eines Agents zu entdecken, und kann als Ausgangspunkt für die Agent-Entwicklung 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 können Sie mit dem Bot für Business Messages Funktionen in einer Unterhaltung entdecken
  • Agent zum Senden und Empfangen von Nachrichten einrichten

Informationen zum Erstellen eines Agents ohne Verwendung des Beispiels finden Sie unter Agent 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. Ein neues Google Cloud-Projekt wurde für Sie erstellt und die Business Messages und Business Communications APIs sind aktiviert. Sie haben keinen Zugriff auf dieses Projekt und es hat keine Auswirkungen auf vorhandene Google Cloud-Projekte.

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

Dienstkonto erstellen

  1. Klicken Sie auf der Startseite der Business Communications Developer Console auf Partnerkontoeinstellungen.
  2. Klicken Sie im linken Navigationsbereich auf Dienstkonto.

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

    Ihr Dienstkonto lädt den Dienstkontoschlüssel herunter. Speichern Sie sie an einem sicheren Ort. Sie benötigen diesen Schlüssel später, um eine Webanwendung bereitzustellen und später auf die Business Messages und Business Communications APIs zuzugreifen.

Marke und Agent erstellen

Ein Agent ist eine dialogorientierte Entität einer Marke, mit der Nutzer interagieren. Sie erstellen eine Marke, die das Unternehmen repräsentiert, und erstellen einen Agent, damit Nutzer mit ihr kommunizieren 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 Agent erstellen.
  3. Wählen Sie als Agent-Typ Business Messages aus.
  4. Geben Sie Werte für Markenname und Agent-Name ein.
  5. Führen Sie einen der folgenden Schritte aus:
    • Wählen Sie Helper-Bot für Business Messages aktivieren aus, um eine Unterhaltung mit Ihrem Agent zu führen, in dem Sie die verfügbaren Funktionen kennenlernen können.
    • Entfernen Sie das Häkchen bei Helper-Bot für Business Messages aktivieren, um den Agent anzupassen und für die Nachrichtenverarbeitung vorzubereiten.
  6. Klicken Sie auf Agent erstellen.

Wenn Sie den Helper-Bot für Business Messages aktiviert haben, können Sie sofort eine Unterhaltung starten. Fahren Sie andernfalls mit dem Einrichten des Agents für die Nachrichtenverarbeitung fort.

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

Mit dem Helper-Bot für Business Messages können Sie schnell eine Unterhaltung mit Ihrem Agent starten und so sehen, was die Plattform zu bieten hat. Das Aktivieren des Helper-Bots ist optional, wird aber dringend empfohlen, wenn Sie Ihren ersten Agent erstellen.

Mit dem Helper-Bot können Sie

  • Umfangreiche Funktionen entdecken
  • Funktionen implementieren
  • Ressourcen für die Agent-Einrichtung

Wenn der Helper-Bot aktiviert ist, sendet und empfängt er Nachrichten für Ihren Agent. Es ist kein Webhook erforderlich. Sie müssen den Helper-Bot deaktivieren, bevor Sie einen Webhook festlegen oder Dialogflow für die Verarbeitung von Nutzernachrichten aktivieren können.

Unterhaltung mit dem Helper-Bot starten

Nachdem Sie den Helper-Bot für Business Messages aktiviert haben, können Sie eine Unterhaltung beginnen. Nach dem Erstellen des Agents wird ein Dialogfeld geöffnet, das Sie beim Einstieg unterstützt.

Führen Sie in diesem Dialogfeld die folgenden Schritte aus, um mit dem Helper-Bot zu interagieren:

  1. Rufen Sie die Test-URLs des Agents auf. Dafür gibt es verschiedene Möglichkeiten:

    • Klicken Sie auf die Schaltfläche Android bzw. iOS. Scannen Sie dann den QR-Code mit dem entsprechenden Mobilgerät und klicken Sie auf Starten. Klicken Sie alternativ auf Android-URL kopieren oder iOS-URL kopieren, um die Test-URL des Agents 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. Für iOS-Geräte ist die Google Maps App erforderlich.

Helper-Bot deaktivieren

Bevor Sie Ihren Agent anpassen und für die Einführung 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 im linken Navigationsbereich auf Integrations (Integrationen).
  4. Klicken Sie bei 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 den Agent für die Verarbeitung des Nachrichtenflusses einrichten.

Agent für die Nachrichtenverarbeitung einrichten

In dieser Anleitung stellen Sie einen Echo-Bot auf der Google Cloud Platform (GCP) mit einem Webhook bereit, der für die Verarbeitung von Nutzernachrichten entwickelt wurde.

Der Echo Bot ist eine Beispielanwendung, die Nachrichten an den Nutzer zurückgibt. Sie können in einer Unterhaltung mit Ihrem Agent umfangreiche Funktionen wie vorgeschlagene Aktionen und Rich Cards ausprobieren. Sie können den Echo Bot auch als Ausgangspunkt für die Entwicklung Ihres Agents verwenden.

Dazu sind folgende Schritte erforderlich:

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

Am Ende dieses Leitfadens kann der Agent Nachrichten senden und empfangen.

Webanwendung auf der GCP bereitstellen

Business Messages leitet Nachrichten von Nutzern an einen Webhook in Ihrer Infrastruktur weiter. In dieser Anleitung stellen Sie den Beispielcode des Echo-Bots in einem vorkonfigurierten Webhook bereit. Wenn Sie bereits eine Webinfrastruktur für den Empfang von Nachrichten haben, können Sie einen neuen Webhook für diesen Webdienst erstellen, müssen die Logik aber selbst konfigurieren. Weitere Informationen finden Sie unter Webhook auf Partnerebene festlegen.

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 Projektauswahl der Google Cloud Console.

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

  2. Klicke auf Projekt erstellen.

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

    • Die Projekt-ID wird automatisch generiert und unter dem Projektnamen angezeigt.
    • Klicken Sie im Feld Speicherort auf Suchen, um potenzielle Standorte für Ihr Projekt aufzurufen. Wenn Sie Ihre Google Workspace-Organisation nicht finden, sind Sie nicht in einem Google Workspace-Konto angemeldet. Sie können ein Projekt auch ohne Organisation erstellen, allerdings sind einige Funktionen eingeschränkt. Weitere Informationen finden Sie unter Vorteile der Organisationsressource.

  4. Klicken Sie auf Erstellen.

  5. Klicken Sie auf 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 hinzu. Weitere Informationen zu Zahlungsoptionen finden Sie unter Funktionen des kostenlosen Google Cloud-Programms.

Echo Bot-Beispiel bereitstellen

  1. Installieren Sie die gcloud CLI. Damit können Sie den Beispielcode in Google Cloud bereitstellen.

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

  3. Kopieren Sie die JSON-Anmeldedatendatei, die Sie unter Dienstkonto erstellen heruntergeladen haben, in den Ressourcenordner des Beispiels und benennen Sie die Anmeldedaten in „bm-agent-service-account-credentials.json“ um. Der Pfad zu dieser Datei mit Anmeldedaten ist vom Beispiel abhängig, das Sie heruntergeladen haben.

    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. Rufen Sie in einem Terminal das Verzeichnis „full_sample“ der Stichprobe auf.

  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 wird im Projekt-Dashboard in Google Cloud aufgeführt.

    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 wird im Projekt-Dashboard in Google Cloud aufgeführt.

    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 wird im Projekt-Dashboard in Google Cloud aufgeführt.

  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, damit Sie Nachrichten empfangen können.

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

  4. Geben Sie unter Webhook-Endpunkt-URL die URL der Anwendung und „/callback“ ein.

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

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

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

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

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

Mit dem Test-Framework für Business Messages können Sie testen, ob der Webhook erfolgreich auf die Nutzlasten von Business Messages reagiert.

Agent-Informationen eingeben

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

  1. Öffnen Sie die Business Communications Developer Console.
  2. Klicken Sie im linken Navigationsmenü auf Agent-Informationen.

  3. Aktualisieren Sie die Werte wie gewünscht oder nutzen 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 beginnen

So interagieren Sie mit dem Echo Bot:

  1. Öffnen Sie die Business Communications Developer Console.
  2. Klicken Sie im linken Navigationsmenü auf Agent-Informationen.
  3. Klicken Sie unter Agent-Test-URLs 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 Agents 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. Für iOS-Geräte ist die Google Maps App erforderlich.

Die Begrüßungsnachricht Ihres Agents begrüßt Sie. Jetzt kannst du mit dem Echo Bot interagieren. Die Nachrichten, die Sie zurücksenden, werden wieder angezeigt. Außerdem können Sie Rich-Features durch Senden bestimmter Strings aufrufen: „carousel“, „card“, „chips“.

Nächste Schritte

Nachdem Sie nun Ihren ersten Agent erstellt haben, erfahren Sie mehr über Business Messages und was Sie sonst noch auf der Plattform tun können.