Eine Unterhaltung (Sitzung) in Dialogflow CX kann als Zustandsmaschine beschrieben und dargestellt werden. Die Zustände einer CX-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.
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:
Dieser Vorgang läuft so ab:
- Wenn für die Seite eine Eintragsauftragsausführung vorhanden ist, wird sie aufgerufen. Alle von der Auftragsausführung bereitgestellten Antworten werden der Antwortwarteschlange hinzugefügt.
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.
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 Antworten werden der Antwortwarteschlange hinzugefügt.
- Wenn ein Zielablauf oder eine Seite für den Handler vorhanden ist, wechselt die Sitzung zum Ziel und die Seite wird inaktiv.
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.
Die Nachrichten in der Antwortwarteschlange werden an den Endnutzer gesendet und der Agent wartet auf die Endnutzereingabe.
Wenn die Endnutzereingabe einen angeforderten Formularparameter bereitstellt, füllen Sie den Parameter aus. Fahren Sie mit Schritt 3 fort.
Seite erstellen
So erstellen Sie eine Seite:
Console
- Öffnen Sie die Dialogflow CX Console.
- Wählen Sie Ihr GCP-Projekt aus.
- Wählen Sie den Agent aus.
- Wählen Sie im Abschnitt Abläufe einen Ablauf für die Seite aus.
- Klicken Sie im Abschnitt Seiten auf die Schaltfläche "add hinzufügen".
- Geben Sie einen Namen für Ihre Seite ein.
- Klicken Sie neben dem Seitennamen auf die Schaltfläche "Einstellungen für more_vert".
- Wählen Sie Bearbeiten aus.
- Geben Sie die Felder im angezeigten Bearbeitungsfeld ein.
- 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 | V3beta1 |
---|---|
REST | Seitenressource |
RPC | Seitenoberfläche |
Java | PagesClient |
Node.js | PagesClient |
Python | PagesClient |
Seitendaten
So greifen Sie auf die Daten einer Seite zu:
Console
- Öffnen Sie die Dialogflow CX Console.
- Wählen Sie das GCP-Projekt für den Agent.
- Wählen Sie den Agent aus.
- Klicken Sie im Abschnitt Abläufe auf den Ablauf.
- Die Seiten des Ablaufs werden im Abschnitt Seiten ausgefüllt.
- Klicken Sie neben dem Seitennamen auf die Schaltfläche "Einstellungen für more_vert".
- Wählen Sie Bearbeiten aus.
- Geben Sie die Felder im angezeigten Bearbeitungsfeld ein.
- 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 | V3beta1 |
---|---|
REST | Seitenressource |
RPC | Seitenoberfläche |
Java | PagesClient |
Node.js | PagesClient |
Python | PagesClient |
Die folgenden Daten sind Seiten zugeordnet:
- Name: Ein Anzeigename für Ihren Ablauf.
- 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.
Seiten löschen
So löschen Sie eine Seite:
Console
- Öffnen Sie die Dialogflow CX Console.
- Wählen Sie Ihr GCP-Projekt aus.
- Wählen Sie den Agent aus.
- Wählen Sie im Abschnitt Abläufe einen Ablauf für die Seite aus.
- Klicken Sie im Abschnitt Seiten neben dem Seitennamen auf die Schaltfläche "Einstellungen für more_vert".
- 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 | V3beta1 |
---|---|
REST | Seitenressource |
RPC | Seitenoberfläche |
Java | PagesClient |
Node.js | PagesClient |
Python | PagesClient |