Seiten

Eine Unterhaltung (Sitzung) in Conversational Agents (Dialogflow CX) kann als Zustandsmaschine beschrieben und dargestellt werden. Die Zustände einer Sitzung werden durch Seiten dargestellt.

Für jeden Ablauf definieren Sie mehrere Seiten, wobei die Gesamtheit der Seiten eine vollständige Unterhaltung zu den Themen ermöglicht, für die der Ablauf bestimmt ist. Es ist immer genaue eine Seite die aktuelle Seite. Diese aktuelle Seite wird als aktiv bezeichnet. Weiter wird der mit dieser Seite verknüpfte Ablauf als aktiv angesehen. Jeder Ablauf hat eine besondere Startseite. Wird ein Ablauf zum ersten Mal aktiviert, wird die Startseite zur aktuellen Seite. Pro Unterhaltungsrunde bleibt die aktuelle Seite entweder gleich oder wechselt zu einer anderen Seite.

Sie konfigurieren jede Seite so, dass vom Endnutzer Informationen erfasst werden, die für den von der Seite dargestellten Unterhaltungsstatus relevant sind. Sie können beispielsweise die Seiten (in Blau) im folgenden Diagramm erstellen, um einen Essensbestellungsablauf eines Pizza-Lieferdienst-Agents zu sehen. Der Startknoten des Diagramms stellt die Startseite des Essensbestellungsablaufs dar. Wenn der Ablauf abgeschlossen ist, wird zur Bestätigung gewechselt.

Beispiel für ein Diagramm mit mehreren Abläufen.

Lebenszyklus einer Seite

Sobald eine Seite aktiv ist, führt der Agent mehrere Schritte aus, die die Eintragsauftragsausfüllung, das Vorabausfüllen von Formularen, die Zustands-Handler-Evaluierung, die Aufforderung von Formularparametern, das Senden von Antwortnachrichten an den Endnutzer und entweder eine Seitenänderung oder eine Wiederholungsschleife umfassen:

Diagramm zum Lebenszyklus einer Seite.

Dieser Vorgang läuft so ab:

  1. Wenn für die Seite eine Eintragsauftragsausführung vorhanden ist, wird sie aufgerufen. Alle von der Auftragsausführung bereitgestellten statischen Antworten werden der Antwortwarteschlange hinzugefügt.

    Wenn die Teilantwort aktiviert ist, löscht Conversational Agents (Dialogflow CX) die Antwortwarteschlange und sendet alle Nachrichten in der Warteschlange als Teilantwort an den Aufrufer der Streaming API.

    Wenn die Auftragsausführung einen Webhook hat, wird der Webhook aufgerufen, der zusätzliche Antworten an die Warteschlange anhängen kann. Diese zusätzlichen Antworten lösen nicht sofort eine Leerung der Antwortwarteschlange aus.

  2. Wenn die Seite Formularparameter enthält, sind diese möglicherweise bereits ausgefüllt:

    • Alle Sitzungsparameter, deren Namen dem Namen eines Formularparameters entsprechen, werden in den Formularparameter kopiert.
    • Wenn eine Route einen Übergang zu dieser Seite ausgelöst hat und die Route einen übereinstimmenden Intent enthält, wird jeder Intent-Parameter mit demselben Namen wie ein Formularparameter in den Formularparameter kopiert.

  3. Wenn Zustands-Handler dem Bereich entsprechen, werden sie gemäß den Regeln zur Handler-Evaluierungsreihenfolge ausgewertet. Dies kann Routen, Event-Handler oder Reprompt-Handler umfassen, die von der vorherigen Schleifenausführung aufgerufen wurden. Wenn ein Zustands-Handler aufgerufen wird, kann eine oder beide der folgenden Situationen auftreten:

    • Wenn für den Handler eine Auftragsausführung vorhanden ist, wird sie aufgerufen. Alle von der Auftragsausführung bereitgestellten statischen Antworten werden der Antwortwarteschlange hinzugefügt. Teilantworten und Webhook werden ebenfalls ausgeführt, wenn sie aktiviert sind.
    • Wenn ein Zielablauf oder eine Seite für den Handler vorhanden ist, wechselt die Sitzung zum Ziel und die Seite wird inaktiv.

  4. Treffen alle folgenden Bedingungen zu, so wird der Antwortwarteschlange eine Formularparameteraufforderung hinzugefügt:

    • Die Seite enthält ein Formular.
    • Es müssen noch erforderliche Formularparameter ausgefüllt werden.
    • Einem Handler für erneute Eingabeaufforderungen wurde in Schritt 3 nicht gefolgt.
    • Teilantworten und Webhook werden ausgeführt, sofern sie aktiviert sind.

  5. Die Nachrichten in der Antwortwarteschlange werden an den Endnutzer gesendet und der Agent wartet auf die Endnutzereingabe.

  6. Wenn die Endnutzereingabe einen angeforderten Formularparameter bereitstellt, füllen Sie den Parameter aus. Fahren Sie mit Schritt 3 fort.

Navigation im Seitenlebenszyklus

Der Betrachter der Ausführungsschritte für den Simulator ermöglicht Ihnen, zwischen den Schritten für eine bestimmte Unterhaltungsrunde zu wechseln und die zugehörigen Agent-Builder-Elemente für jeden Schritt in den Fokus zu rücken. Im folgenden Beispiel löst die Endnutzereingabe "Ich möchte ein Auto mieten" fünf Ausführungs- und Umstellungsschritte aus:

  1. Der Viewer für Ausführungsschritte führt Sie zur Startseite der Unterhaltung für den ersten Schritt. In diesem Fall ist es die Standardstartseite. Schritt 1 für die Seitenausführung

  2. Die Transition-Route für den Intent car_rental.reservation_create wird ausgelöst. Der Betrachter der Ausführungsschritte zeigt diese Route im Mittelpunkt, wo Sie sehen können, dass das Umstellungsziel die Seite Pickup Location ist. Schritt 2 für die Seitenausführung

  3. Der Agent gibt die Seite Pickup Location ein. Schritt 3 zur Seitenausführung

  4. Der Agent wertet die Eingabeauftragsausführung der Seite Pickup Location aus. Die Auftragsausführung ist leer, sodass nichts geschieht.Seitenausführungsschritt 4:

  5. Der Agent versucht, den erforderlichen Formularparameter pickup_location zu erfassen, und der Endnutzer zeigt die erste Auftragsausführungsnachricht für diesen Parameter an. Seitenausführungsschritt 5:

Sie können auch die letzte Äußerung rückgängig machen und versuchen, andere Seitenübergänge zu testen.

Äußerung rückgängig machen

Seite erstellen

So erstellen Sie eine Seite:

Console

  1. Öffnen Sie die Dialogflow CX Console.
  2. Wählen Sie Ihr Google Cloud-Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Wählen Sie im Abschnitt Abläufe einen Ablauf für die Seite aus.
  5. Klicken Sie im Abschnitt Seiten auf die Schaltfläche " hinzufügen".
  6. Geben Sie einen Anzeigenamen für Ihren Agent ein
  7. Klicken Sie neben dem Seitennamen auf die Schaltfläche "Einstellungen für ".
  8. Wählen Sie Bearbeiten aus.
  9. Geben Sie die Felder im angezeigten Bearbeitungsfeld ein.
  10. Klicken Sie auf Speichern.

API

Siehe die Methode create für den Typ Page.

Wählen Sie ein Protokoll und eine Version für die Seitenreferenz aus:

Protokoll V3 V3beta1
REST Seitenressource Seitenressource
RPC Seitenoberfläche Seitenoberfläche
C++ PagesClient Nicht verfügbar
C# PagesClient Nicht verfügbar
Go PagesClient Nicht verfügbar
Java PagesClient PagesClient
Node.js PagesClient PagesClient
PHP Nicht verfügbar Nicht verfügbar
Python PagesClient PagesClient
Ruby Nicht verfügbar Nicht verfügbar

Seitendaten

So greifen Sie auf die Daten einer Seite zu:

Console

  1. Öffnen Sie die Dialogflow CX Console.
  2. Wählen Sie das Google Cloud-Projekt für den Agenten aus.
  3. Wählen Sie den Agent aus.
  4. Klicken Sie im Abschnitt Abläufe auf den Ablauf.
  5. Die Seiten des Ablaufs werden im Abschnitt Seiten ausgefüllt.
  6. Klicken Sie neben dem Seitennamen auf die Schaltfläche "Einstellungen für ".
  7. Wählen Sie Bearbeiten aus.
  8. Geben Sie die Felder im angezeigten Bearbeitungsfeld ein.
  9. Klicken Sie auf Speichern, um die Änderungen zu speichern.

API

Siehe die Methoden get und patch/update für den Typ Page.

Wählen Sie ein Protokoll und eine Version für die Seitenreferenz aus:

Protokoll V3 V3beta1
REST Seitenressource Seitenressource
RPC Seitenoberfläche Seitenoberfläche
C++ PagesClient Nicht verfügbar
C# PagesClient Nicht verfügbar
Go PagesClient Nicht verfügbar
Java PagesClient PagesClient
Node.js PagesClient PagesClient
PHP Nicht verfügbar Nicht verfügbar
Python PagesClient PagesClient
Ruby Nicht verfügbar Nicht verfügbar

Die folgenden Daten sind Seiten zugeordnet:

  • Anzeigename: Ein von Menschen lesbarer Name für Ihre Seite.
  • Einstiegs-Auftragsausführung (auch als Einstiegsdialog bezeichnet): Dies ist die Auftragsausführung, die aufgerufen wird, wenn die Seite erstmals aktiv wird.
  • Parameter: Dies sind die Parameterwerte in einem Seitenformular, das strukturierte Eingaben vom Endnutzer erfasst.
  • Routen: Diese Status-Handler können aufgerufen werden, wenn die Seite aktiv ist. Weitere Informationen finden sich unter Handler-Routen auf Seitenebene.
  • Routengruppen: Die Routen innerhalb dieser Gruppen können aufgerufen werden, wenn die Seite aktiv ist. Ausführliche Informationen dazu finden Sie unter Routengruppen
  • Ereignis-Handler: Diese Ereignis-Handler sind aufrufbar, wenn die Seite aktiv ist. Weitere Informationen finden Sie unter Event-Handler auf Seitenebene.

Seiteneinstellungen

Die folgenden Einstellungen sind für Seiten verfügbar:

So rufen Sie die Seiteneinstellungen auf:

Console

  1. Öffnen Sie die Dialogflow CX Console.
  2. Wählen Sie Ihr Google Cloud-Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Bewegen Sie den Mauszeiger im Abschnitt Seiten über die Seite.
  5. Klicken Sie auf die Schaltfläche "Optionen" .
  6. Wählen Sie Seiteneinstellungen aus.
  7. Suchen oder bearbeiten Sie die Einstellungen.
  8. Klicken Sie auf Speichern, um die Änderungen zu speichern.

API

Siehe die Methoden get und patch/update für den Typ Page.

Wählen Sie ein Protokoll und eine Version für die Seitenreferenz aus:

Protokoll V3 V3beta1
REST Seitenressource Seitenressource
RPC Seitenoberfläche Seitenoberfläche
C++ PagesClient Nicht verfügbar
C# PagesClient Nicht verfügbar
Go PagesClient Nicht verfügbar
Java PagesClient PagesClient
Node.js PagesClient PagesClient
PHP Nicht verfügbar Nicht verfügbar
Python PagesClient PagesClient
Ruby Nicht verfügbar Nicht verfügbar

Seiten löschen

So löschen Sie eine Seite:

Console

  1. Öffnen Sie die Dialogflow CX Console.
  2. Wählen Sie Ihr Google Cloud-Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Wählen Sie im Abschnitt Abläufe einen Ablauf für die Seite aus.
  5. Klicken Sie im Abschnitt Seiten neben dem Seitennamen auf die Schaltfläche "Einstellungen für ".
  6. Wählen Sie Löschen aus.

API

Siehe die Methode delete für den Typ Page.

Wählen Sie ein Protokoll und eine Version für die Seitenreferenz aus:

Protokoll V3 V3beta1
REST Seitenressource Seitenressource
RPC Seitenoberfläche Seitenoberfläche
C++ PagesClient Nicht verfügbar
C# PagesClient Nicht verfügbar
Go PagesClient Nicht verfügbar
Java PagesClient PagesClient
Node.js PagesClient PagesClient
PHP Nicht verfügbar Nicht verfügbar
Python PagesClient PagesClient
Ruby Nicht verfügbar Nicht verfügbar

Zurück
Abläufe
Weiter
Zustands-Handler