Google Chat-Add-on mit Dialogflow ES erstellen

Auf dieser Seite wird beschrieben, wie Sie eine Google Chat-App als Google Workspace-Add‑on erstellen, die Dialogflow ES verwendet, um natürliche Sprache zu verstehen und darauf zu reagieren. Sie können auch Dialogflow CX verwenden, das direkt in Google Chat integriert ist, um eine Dialogflow CX Google Chat-App zu erstellen. Folgen Sie dazu der Anleitung für Dialogflow CX Google Chat.

Ziele

  • die Umgebung einrichten
  • Erstellen und stellen Sie einen Dialogflow ES-Agenten bereit.
  • Erstellen und stellen Sie eine Chat-App bereit, die vom Dialogflow ES-Agent unterstützt wird.
  • Chat App testen

Vorbereitung

Architektur

Das folgende Diagramm zeigt die Architektur einer Chat-App, die mit Dialogflow erstellt wurde:

Architektur einer mit Dialogflow implementierten Chat-App.

Im vorherigen Diagramm sieht der Informationsfluss bei der Interaktion eines Nutzers mit einer Dialogflow-Chat-App so aus:

  1. Ein Nutzer sendet eine Nachricht in Google Chat an eine Chat-App, entweder in einer Direktnachricht oder in einem Chatbereich.
  2. Ein virtueller Dialogflow-Kundenservicemitarbeiter, der sich in befindet, empfängt und verarbeitet die Nachricht, um eine Antwort zu generieren.
  3. Optional kann der Dialogflow-Agent über einen Dialogflow-Webhook mit externen Drittanbieterdiensten wie einem Projektmanagementsystem oder einem Ticketing-Tool interagieren.
  4. Der Dialogflow-Agent sendet eine Antwort an den Chat App-Dienst in Chat zurück.
  5. Die Antwort wird an den Chatbereich gesendet.

Umgebung einrichten

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.

  1. Aktivieren Sie in der Google API Console die Google Chat API und die Dialogflow API.

    APIs aktivieren

  2. Bestätigen Sie, dass Sie die APIs im richtigen Cloud-Projekt aktivieren, und klicken Sie auf Weiter.

  3. Prüfen Sie, ob Sie die richtigen APIs aktivieren, und klicken Sie dann auf Aktivieren.

Dialogflow ES-Agent erstellen

Wenn Sie noch keinen Dialogflow ES-Agenten haben, gehen Sie so vor:

  1. Rufen Sie die Dialogflow ES-Konsole auf.
  2. Klicken Sie auf Create Agent (Agent erstellen).
  3. Geben Sie einen Namen ein und wählen Sie eine Standardsprache und eine Zeitzone aus.
  4. Verknüpfen Sie sie mit Ihrem Cloud-Projekt.
  5. Klicken Sie auf Erstellen.
  6. Erstellen Sie Intents und Entitäten nach Bedarf für den Konversationsablauf Ihrer Chat-App. Sie können mit einer Begrüßungsabsicht beginnen.
  7. Notieren Sie sich die Projekt-ID.

Eine ausführliche Anleitung finden Sie unter Agent erstellen.

Chat-App erstellen und mit dem Dialogflow-Agent verbinden

Nachdem Sie einen Dialogflow ES-Agent erstellt haben, gehen Sie so vor, um ihn in eine Chat-App umzuwandeln:

  1. Rufen Sie in der Google API Console die Google Chat API auf. Suchen Sie nach „Google Chat API“, klicken Sie auf Google Chat API und dann auf Verwalten.

    Zur Chat API

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

    1. Geben Sie unter App-Name Dialogflow App ein.
    2. Geben Sie unter Avatar URL (Avatar-URL) https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png ein.
    3. Geben Sie unter Beschreibung Responds to real human conversation ein.
    4. Wählen Sie unter Funktionsweise die Option Gruppenbereichen und Gruppenunterhaltungen beitreten aus.
    5. Wählen Sie unter Verbindungseinstellungen die Option Dialogflow aus.
    6. Wählen Sie unter Dialogflow-Einstellungen die Option Dialogflow ES aus.
    7. Diese Chat-App bestimmten Personen und Gruppen zur Verfügung stellen: Wählen Sie diese Option aus und geben Sie Ihre E-Mail-Adresse ein.
    8. Wählen Sie unter Logs die Option Fehler in Logging protokollieren aus.

  3. Klicken Sie auf Speichern.

Die Chat-App ist bereit, Nachrichten in Google Chat zu empfangen und darauf zu antworten.

Chat App testen

Testen Sie die Dialogflow ES-Chat-App, indem Sie ihr in Google Chat Nachrichten senden.

  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  Neuer Chat.
  3. Geben Sie im Feld Eine oder mehrere Personen hinzufügen den Namen Ihrer Chat-App ein.

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

  5. Geben Sie in der neuen Direktnachricht mit der App Hello ein und drücken Sie enter.

    Die Dialogflow Chat App antwortet mit einer Begrüßungsnachricht.

Textantworten

Textantworten werden als Nachrichten an Google Chat gesendet. Mit dieser Formatierung können Sie Text fett oder kursiv formatieren, indem Sie den Text in bestimmte (Markdown-Light) Symbole zusammenfassen.

Die Textnachrichtenantwort sieht in etwa genauso aus wie die Standard-Textantwort in der Dialogflow-Konsole. Die ursprüngliche API-Antwort sieht jedoch etwas anders aus. Außerdem wird die Plattformkonfiguration auf GOOGLE_HANGOUTS gesetzt, was beim Erstellen von Agents für mehrere Integrationen interessant sein könnte.

"fulfillmentMessages": [
{
   "text": {
   "text": [
        "This is a test."
   ]
},
  "platform": "GOOGLE_HANGOUTS"
},

Karten

Kartenantworten werden als Kartennachrichten an Google Chat gesendet.

Bilder

Bildantworten werden als Google Chat-Bild-Widgets an Google Chat gesendet.

Benutzerdefinierte Nutzlast

Wenn Sie andere Google Chat-Nachrichten senden möchten, können Sie eine benutzerdefinierte Nutzlast verwenden.

Mit der benutzerdefinierten Google Chat-Nutzlast können Sie erweiterte Karten erstellen. Eine Karte kann einen oder mehrere Abschnitte enthalten. Jeder Abschnitt kann eine Kopfzeile haben. Im Referenzhandbuch für die Nachrichtenformate von Google Chat finden Sie eine Liste mit möglichen Kombinationen. Wenn Sie jedoch benutzerdefinierte Nutzlasten verwenden, müssen Sie das JSON-Format bereitstellen.

Hier ist ein Beispiel für eine benutzerdefinierte Nutzlast zum Erstellen einer Nachricht mit einer Karte:

{ "hangouts": { "hostAppDataAction": { "chatDataAction": {
  "createMessageAction": { "message": { "cardsV2": [{
    "cardId": "pizza",
    "card": {
      "header": {
        "title": "Pizza Delivery Customer Support",
        "subtitle": "pizzadelivery@example.com",
        "imageUrl": "https://goo.gl/aeDtrS"
      },
      "sections": [{ "widgets": [{ "textParagraph": {
        "text": " Your pizza is here!"
      }}]}]
    }
  }]}}
}}}}

Einschränkungen und Überlegungen

Fehlerbehebung

Sehen Sie sich zuerst die Fehlerlogs an, um Fehler in Ihrer Chat-App zu beheben. Da in dieser App Dialogflow verwendet wird, stehen Ihnen mehrere Ressourcen für die Protokollierung und Fehlerbehebung zur Verfügung:

Bereinigen

Damit Ihrem -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ü > IAM & Verwaltung > Ressourcen verwalten.

    Zum Ressourcenmanager

  2. Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen .
  3. Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Beenden, um das Projekt zu löschen.
  • Dialogflow CX ist eine weitere Möglichkeit, Dialogflow mit einer Chat-App zu verwenden.