Ersten Agent erstellen

Vorbereitung

Agent erstellen

In diesem Leitfaden erfahren Sie, wie Sie mithilfe einer Beispielanwendung einen Agent erstellen. Das Beispiel bietet eine schnelle Möglichkeit, die Funktionalität eines Agents zu erkunden, und kann als Ausgangspunkt für die Entwicklung des Agents dienen. Das Beispiel bietet ein gutes Modell für Ihre Anwendungslogik, wenn Sie eine vorhandene Anwendung so ändern möchten, dass ein Agent enthalten ist.

Dieser Schnellstart erläutert folgende Schritte:

  • Als Partner registrieren
  • Marke und Agent erstellen
  • Optional können Sie Funktionen in einer Unterhaltung mit Business Messages ausprobieren Helper-Bot
  • Agent zum Senden und Empfangen von Nachrichten einrichten

Informationen zum Erstellen eines Agents ohne das Beispiel finden Sie unter Agent erstellen.

Als Partner registrieren

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

  3. Geben Sie Ihre Partnerinformationen ein:

    Feld Wert
    Ihr Name Dein 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, wobei die Business Messages und Business Communications APIs aktiviert sind. Sie haben keinen Zugriff auf dieses Projekt und es wirkt sich nicht auf Ihre bestehenden Google Cloud-Projekte aus.

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 Partnerkonten.
  2. Klicken Sie im linken Navigationsbereich auf Dienstkonto.

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

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

Marke und Agent erstellen

Ein Agent ist eine dialogorientierte Darstellung einer Marke – der dialogorientierten Entität. mit denen Nutzende interagieren. Sie erstellen eine Marke, die das Unternehmen repräsentiert, Erstellen Sie einen Agent, über den Nutzer sich mit ihm unterhalten können.

  1. Öffnen Sie den Business Communications Developer Konsole 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 die Option Business Messages aus.
  4. Geben Sie Werte für Brand name (Markenname) und Agent name (Agent-Name) ein.
  5. Führen Sie einen der folgenden Schritte aus: <ph type="x-smartling-placeholder">
      </ph>
    • Wenn Sie mit Ihrem Agent eine Unterhaltung führen möchten, in der Sie Folgendes erkunden können: wählen Sie Helper-Bot für Business Messages aktivieren aus.
    • Heben Sie die Auswahl auf, um den Agent anzupassen und auf die Nachrichtenverarbeitung vorzubereiten Aktivieren Sie den Helper-Bot für Business Messages.
  6. Klicken Sie auf Agent erstellen.

Wenn Sie den Helper-Bot für Business Messages aktiviert haben, können Sie sofort eine Unterhaltung beginnen. Andernfalls Richten Sie den Agent für die Nachrichtenverarbeitung ein.

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 um zu erfahren, was die Plattform zu bieten hat. Hilfsprogramm aktivieren Der Bot ist optional, wird aber dringend empfohlen, wenn Sie Ihren ersten Agent erstellen.

Mit dem Helper-Bot können Sie

  • Vielfältige Funktionen entdecken
  • Funktionen implementieren
  • Ressourcen für die Einrichtung von Agents

Wenn der Helper-Bot aktiviert ist, sendet und empfängt er Nachrichten für Ihren Agent. ist kein Webhook erforderlich. Sie müssen den Helper-Bot deaktivieren. bevor Sie einen Webhook einrichten 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. Direkt nach dem Erstellen des Agents wird ein Dialogfeld geöffnet, das Ihnen den Einstieg erleichtert.

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

  1. Auf die Test-URLs des Agents zugreifen Dafür gibt es mehrere Möglichkeiten:

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

  2. Öffnen Sie die URL auf Ihrem Mobilgerät. (iOS-Geräte benötigen die Google Maps app.)

Helper-Bot deaktivieren

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

Um den Helper-Bot zu deaktivieren,

  1. Öffnen Sie den Business Communications Developer Console
  2. Wählen Sie den Agent aus.
  3. Klicken Sie im linken Navigationsmenü auf Integrations (Integrationen).
  4. Klicken Sie unter Helper Bot (Helper-Bot) auf Disable (Deaktivieren).

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

Agent für die Nachrichtenverarbeitung einrichten

In dieser Anleitung stellen Sie einen Echo-Bot auf der Google Cloud Platform (GCP) mit einer Webhook, mit dem Nutzernachrichten verarbeitet werden können.

Der Echo-Bot ist eine Beispielanwendung, die Nachrichten an den Nutzer zurückgibt. Es können Sie mit Rich-Funktionen wie vorgeschlagene Maßnahmen und Rich Cards, in einer Unterhaltung mit Ihrem Agent. Sie können den Echo-Bot auch als für die Entwicklung Ihres Agents.

Führen Sie die folgenden Schritte aus:

  • Echo Bot-Beispiel auf der GCP bereitstellen
  • Webhook-URL für Ihr Business Messages-Partnerkonto konfigurieren
  • Geben Sie grundlegende Informationen zu Ihrem Agent an

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

Webanwendung auf der GCP bereitstellen

Business Messages leitet Nachrichten von Nutzern an einen Webhook weiter in Ihrer Infrastruktur. In dieser Anleitung stellen Sie das Echo Bot-Beispiel bereit den Quellcode in einen vorkonfigurierten Webhook übertragen. Wenn Sie bereits eine Webinfrastruktur haben, Nachrichten zu empfangen, können Sie einen neuen Webhook in diesem aber Sie müssen die Logik 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 das Google Cloud Console-Projektauswahl

    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 Standort für das neue Projekt ein

    • Ihre Projekt-ID wird automatisch generiert und erscheint unter dem Projektnamen.
    • Klicken Sie im Feld Standort auf Durchsuchen, um sich potenzielle Standorte für Ihr Projekt anzeigen zu lassen. Wenn Sie Ihre Google Workspace-Organisation nicht finden können, 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. Informationen zu den Zahlungsoptionen finden Sie unter Kostenlose Programmfunktionen von Google Cloud.

Echo Bot-Beispiel bereitstellen

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

  2. Echo Bot-Beispiel herunterladen und extrahieren (Node.js, Java Python).

  3. Kopieren Sie die heruntergeladene JSON-Datei mit den Anmeldedaten in Erstellen Sie ein Dienstkonto im Ressourcenordner des Beispiels. und benennen Sie die Anmeldedaten in „bm-agent-service-account-credentials.json“ um. Der Pfad zu dieser Datei mit den Anmeldedaten 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. Wechseln Sie in einem Terminal zum 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 erstellt haben. Cloud-Umgebung erstellen Die Projekt-ID ist 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 erstellt haben. Cloud-Umgebung erstellen Die Projekt-ID ist 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 erstellt haben. Cloud-Umgebung erstellen Die Projekt-ID ist im Projekt-Dashboard in Google Cloud aufgeführt.

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

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

Webhook einrichten

Nachdem der Echo-Bot bereitgestellt wurde, müssen Sie eine Webhook-URL angeben (die Sie Vorgang) zum Starten Nachrichten empfangen.

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

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

    Der Endpunkt hat folgendes Format: &quot;https://PROJECT_ID.appspot.com/callback&quot;.

    Dieser Endpunkt ist in der Anwendungslogik des von Ihnen auf der GCP bereitgestellt werden.

  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

Sie können das Business Messages-Test-Framework verwenden. um zu testen, ob der Webhook erfolgreich auf Business Messages-Nutzlasten reagiert.

Agent-Informationen eingeben

Geben Sie einige grundlegende Informationen an, um die Einrichtung des Agents abzuschließen.

  1. Öffnen Sie den Business Communications Developer Console
  2. Klicken Sie im linken Navigationsbereich auf Agent information (Agent-Informationen).

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

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

  4. Klicken Sie auf Speichern.

Mehr erfahren

So interagieren Sie mit dem Echo Bot:

  1. Öffnen Sie den Business Communications Developer Console
  2. Klicken Sie im linken Navigationsbereich auf Agent information (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 Kopieren Android-URL 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. (iOS-Geräte benötigen die Google Maps App.

Sie werden mit der Willkommensnachricht des Agents begrüßt. Jetzt können Sie mit den Echo-Bot. Es werden die Nachrichten wiedergegeben, die Sie an Sie zurückgesendet haben. Außerdem können Sie Rich-Funktionen durch Senden bestimmter Strings aufrufen: „carousel“, „card“, „chips“.

Nächste Schritte

Nachdem Sie jetzt Ihren ersten Agent erstellt haben, können Sie sich über Business Messages informieren und was du sonst noch auf der Plattform tun kannst.