Agent mithilfe von Workflows erstellen

In dieser Anleitung wird gezeigt, wie Sie mit der Dialogflow CX-Konsole einen Agenten für die Bestellung von T-Shirts mithilfe von Abläufen erstellen und testen. Wenn Sie mit diesem Agenten interagieren, können Sie nach dem Standort des Geschäfts fragen, die Öffnungszeiten abrufen oder ein Shirt bestellen.

Das folgende Diagramm zeigt den fertigen Agenten für diese Anleitung:

Hinweis

Führen Sie die folgenden Aufgaben aus, bevor Sie diesen Leitfaden lesen:

• Grundlagen zu Abläufen
• Einrichtungsschritte ausführen

Agent erstellen

Erstellen Sie einen KI-Agenten für diesen Leitfaden:

1. Öffnen Sie die Dialogflow CX-Konsole.
2. Erstellen Sie ein Projekt oder wählen Sie ein Projekt aus.
3. Klicken Sie auf KI-Agent erstellen.
4. Wählen Sie Selbst konfigurieren aus.
5. Füllen Sie das Formular für die grundlegenden Agent-Einstellungen aus.
   1. Geben Sie einen Anzeigenamen ein.
   2. Wählen Sie einen Standort aus. Klicken Sie auf den Button Bearbeiten, wenn Sie die erweiterten Standorteinstellungen ändern möchten.
   3. Wählen Sie eine Zeitzone aus.
   4. Wählen Sie die Standardsprache aus.
   5. Optional können Sie Cloud Logging aktivieren.
6. Klicken Sie auf Speichern.

Optionaler Agent-Import

In dieser Anleitung wird beschrieben, wie Sie einen Agenten für die Bestellung von T-Shirts erstellen.

Wenn Sie die Schritte in der Console überspringen möchten, laden Sie den Agenten herunter und importieren Sie ihn.

Standardablauf und -Intents

Der folgende Ablauf und folgende Intents werden automatisch für neue Agents erstellt.

Sie finden die Intents, indem Sie auf Verwalten und dann auf Intents klicken. Den Ablauf finden Sie, indem Sie auf Erstellen klicken.

X	Element
Standard-Begrüßungs-Intent	Der Default Welcome Intent enthält Trainingsformulierungen wie „Hallo“ oder „Hi“, die mit der ersten Eingabe des Endnutzers übereinstimmen sollen. Sie können diesen Intent bei Bedarf bearbeiten.
Standardmäßig auszuschließender Intent	Der standardmäßig auszuschließende Intent kann als Trainingsformulierung für diesen Intent als negatives Beispiel hinzugefügt werden.
Standardstartablauf	Der Standardstartablauf kann als einziger Ablauf verwendet werden. Nur dieser Ablauf wird in der Anleitung genutzt. Für komplexere Agents können Sie weitere Abläufe hinzufügen. Dieser Ablauf hat eine Standard-Intent-Route mit dem Standard-Begrüßungs-Intent als Intent-Anforderung.

Standardmäßige Willkommensnachricht testen

Der Standardablauf und die Intents können eine einfache Unterhaltung mit nur einer Begrüßungsnachricht verarbeiten.

So testen Sie den neuen Agent:

1. Klicken Sie auf den Button Agent testen, um den Simulator zu öffnen.
2. Geben Sie hello in das Textfeld ein und drücken Sie die Eingabetaste.
3. Der Agent antwortet mit einer Standard-Willkommensnachricht.
4. Schließen Sie den Simulator.

Der Agent führt für diese Endnutzereingabe die folgenden Schritte aus:

1. Wenn Sie eine Eingabe machen, wertet der KI-Agent die Zustandshandler im Bereich für den aktiven Standardstartablauf und die Ablaufstartseite aus.
2. Der Agent identifiziert eine Route, die mit dem Default Welcome Intent übereinstimmt, und führt sie aus.
3. Der Agent wählt zufällig eine der Antwortnachrichten aus und fügt sie der Antwortwarteschlange hinzu.
4. Da die Route kein Übergangsziel hat, bleiben der aktive Ablauf und die aktive Seite unverändert.
5. Der Agent sendet Ihnen den Inhalt der Antwortwarteschlange.

Begrüßungsnachricht bearbeiten

So bearbeiten Sie die Begrüßungsantwort:

1. Klicken Sie auf den Tab Erstellen.
2. Wählen Sie im Abschnitt Abläufe den Standardstartablauf aus.
3. Klicken Sie im Diagramm auf den Knoten Startseite.
4. Suchen Sie die Route mit dem Default Welcome Intent als Intent-Anforderung und klicken Sie darauf, um das Bearbeitungsfeld für die Route zu öffnen.
5. Löschen Sie im Abschnitt „Auftragsausführung“ im Unterabschnitt „Antworten des KI-Agenten“ alle vorhandenen Antwortnachrichten.
6. Fügen Sie Hello, this is a shirt ordering virtual agent. How can I help you? als einzige Antwort hinzu.
7. Klicken Sie auf Speichern.
8. Schließen Sie das Bearbeitungsfeld für die Route.

Aktualisierte Begrüßungsnachricht testen

So testen Sie die aktualisierte Antwort:

1. Klicken Sie auf den Button Agent testen, um den Simulator zu öffnen.
2. Geben Sie hello in das Textfeld ein und drücken Sie die Eingabetaste.
3. Der Agent antwortet mit der neuen Nachricht.
4. Schließen Sie den Simulator.

Seite "Filialstandort"

Eine Unterhaltung (Sitzung) in Dialogflow CX kann als Zustandsmaschine beschrieben und dargestellt werden. Die Zustände einer CX-Sitzung werden durch Seiten dargestellt. Da Sie nur eine Seite haben, ist der Agent nicht sehr nützlich. In diesem Abschnitt erstellen Sie eine weitere Seite, auf der Fragen zum Standort des Geschäfts beantwortet werden.

Standort-Intent erstellen

Ein Intent kategorisiert die Absicht eines Endnutzers für eine Unterhaltungsrunde.

So erstellen Sie einen Intent, der abgeglichen wird, wenn die Eingabe des Endnutzers den Standort des Geschäfts anfordert:

1. Wählen Sie den Tab Verwalten.
2. Klicken Sie auf Intents.
3. Klicken Sie auf Erstellen.
4. Geben Sie store.location für den Intent-Anzeigenamen ein.
5. Geben Sie die folgenden Trainingsformulierungen ein:
   • Where is the store?
   • Directions
   • Tell me the address
   • Where do I pick up my order?
   • How do I get there?
   • Where is the store located?
   • What street are you on?
   • What is your address?
   • How do I get to your store?
   • Where are you located?
6. Klicken Sie auf Speichern.

Standortseite erstellen

Erstellen Sie eine neue Seite. Sie können dieser Seite eine Eintragsausführung hinzufügen, die immer dann ausgeführt wird, wenn die Seite aktiv wird. Dieser Einstiegs-Fulfillment sollte eine Antwortnachricht mit dem Standort des Geschäfts enthalten.

So erstellen Sie die Seite mit dem Standort des Geschäfts:

1. Klicken Sie auf den Tab Erstellen.
2. Wählen Sie im Abschnitt Abläufe den Standardstartablauf aus.
3. Klicken Sie im Abschnitt Seiten auf den Button Hinzufügen . Ein Texteintrag für den Anzeigenamen der Seite wird angezeigt.
4. Geben Sie Store Location als Anzeigenamen der Seite ein und drücken Sie die Eingabetaste.
5. Klicken Sie auf den Button more_vert neben dem Seitennamen.
6. Wählen Sie Bearbeiten aus, um den Bearbeitungsbereich für die Seite zu öffnen.
7. Suchen Sie nach Ausführung des Eintrags und klicken Sie auf Ausführung bearbeiten.
8. Klicken Sie auf + Dialogantwort hinzufügen, um Our store is located at 1007 Mountain Drive, Gotham City, NJ. in das Feld Dialog des KI-Agenten im Abschnitt Antworten des KI-Agenten einzugeben.
9. Klicken Sie auf Speichern.
10. Schließen Sie den Bearbeitungsbereich.

Standort-Intent-Route zum Ablauf hinzufügen

Erstellen Sie jetzt eine Route, die die Seite „Store Location“ als Übergangsziel hat. Wenn diese Route aufgerufen wird, wechselt die Sitzung zur Seite „Store Location“. Diese Route wird auf den Standardstart-Flow angewendet und ist daher so lange im Bereich, wie der Flow aktiv ist.

Bei einem Agenten mit einem einzelnen Ablauf bedeutet dies, dass die Route immer im Bereich ist. An jedem Punkt der Unterhaltung kann ein Endnutzer nach dem Standort des Geschäfts fragen und diese Route wird aufgerufen.

So erstellen Sie die Route:

1. Klicken Sie auf den Tab Erstellen.
2. Wählen Sie im Abschnitt Abläufe den Standardstartablauf aus.
3. Klicken Sie im Diagramm auf den Knoten Startseite. Dies ist die Startseite für den Standardstartablauf.
4. Fügen Sie die folgende Intent-Route hinzu:
   • Absicht: store.location
   • Übergangsseite: Store Location
5. Klicken Sie auf Speichern.
6. Schließen Sie das Bearbeitungsfeld für Intent-Routen.

Nachdem Sie den Bearbeitungsbereich geschlossen haben, wird im Diagramm ein Knoten für die neue Seite angezeigt. Der Pfeil vom Knoten Start zum Knoten Store Location zeigt, wie die Sitzung zwischen den Knoten wechselt.

Seite "Filialstandort" testen

So testen Sie Ihre Seite:

1. Klicken Sie auf den Button Agent testen, um den Simulator zu öffnen.
2. Geben Sie What is the store location? ein und drücken Sie die Eingabetaste.
3. Der Agent stellt die Adresse bereit.
4. Schließen Sie den Simulator.

Der Agent führt für diese Endnutzereingabe die folgenden Schritte aus:

1. Wenn Sie eine Eingabe machen, wertet der KI-Agent die Zustandshandler im Bereich für den aktiven Standardstartablauf und die Ablaufstartseite aus.
2. Der Agent identifiziert eine Route, die dem Intent store.location entspricht, und führt sie aus.
3. Da die Route keine Antwortnachrichten für die Auftragsausführung enthält, fügt der Agent der Antwortwarteschlange nichts hinzu.
4. Der Agent wechselt die Sitzung zur Seite Geschäftsstandort.
5. Der Agent fügt die Antwortnachricht für die Einstiegs-Ausführung von der Seite Store Location der Antwortwarteschlange hinzu.
6. Der Agent sendet Ihnen den Inhalt der Antwortwarteschlange.

Seite" Öffnungszeiten" mit Inline-Erstellung

In diesem Abschnitt erstellen Sie eine Seite Öffnungszeiten, auf der Fragen von Endnutzern zu den Öffnungszeiten beantwortet werden. Zuvor haben Sie Seiten und Intents auf den Tabs Erstellen und Verwalten erstellt. In diesem Abschnitt wird eine schnellere Methode zum Erstellen dieser Komponenten mit der Inline-Erstellung beschrieben.

So erstellen Sie eine Intent-Route, einen Intent und eine Seite:

1. Klicken Sie im Diagramm auf den Knoten Startseite.
2. Klicken Sie neben Routen auf Hinzufügen. Das Bearbeitungsfeld für die Intent-Route wird geöffnet.
3. Wählen Sie im Abschnitt Intent die Option Neuer Intent aus. Das Bearbeitungsfeld für Intents wird geöffnet.

4. Erstellen Sie einen Intent store.hours mit den folgenden Trainingsformulierungen:

   • What are your store hours?
   • What time do you close?
   Hinweis: Produktions-Agents müssen mindestens 10 Trainingsformulierungen pro Intent haben.

5. Klicken Sie auf Speichern. Das Bearbeitungsfeld für Intents wird geschlossen.

6. Gehen Sie im Bereich zum Bearbeiten der Route zum Abschnitt Übergang.

7. Wählen Sie für den Übergang Seite die Option Neue Seite aus.

8. Geben Sie Store Hours in das nun angezeigte Texteingabefeld ein.

9. Klicken Sie auf Speichern. Die neue Seite wird im Diagramm angezeigt, da es jetzt einen Übergang gibt, der zu ihr führt.

10. Schließen Sie das Bearbeitungsfeld für die Route.

11. Fügen Sie eine Einstiegs-Ausführung hinzu, die die Öffnungszeiten angibt, wie Sie es für Store Location getan haben.

12. Schließen Sie alle geöffneten Bearbeitungsfelder.

Seite "Bestellartikel"

Erstellen Sie als Nächstes eine Seite, die Formularparameter verwendet. Wenn Sie eine neue T-Shirt-Bestellung anfordern, wechselt die Sitzung zu dieser Seite, auf der die Größe und Farbe für die T-Shirt-Bestellung erfasst werden.

Benutzerdefinierten Entitätstyp für Hemdgröße erstellen

Entitätstypen steuern, wie Daten aus Endnutzereingaben extrahiert werden. Dialogflow CX bietet vordefinierte Systementitäten, die gängigen Datentypen wie Datumsangaben, Uhrzeiten, Farben und E‑Mail-Adressen entsprechen. Sie können auch benutzerdefinierte Entitäten für bestimmte Daten erstellen.

Für diesen Agenten können Sie eine Systementität für die T-Shirt-Farbe verwenden, müssen aber eine benutzerdefinierte Entität für die T-Shirt-Größe erstellen.

Der Entitätstyp für die Größe sollte die folgenden Entitätseinträge enthalten:

Entity	Synonyme
Klein	klein, winzig, schmal
Mittel	mittel, normal, Durchschnitt
Groß	groß, breit, extragroß

So erstellen Sie die Entität:

1. Wählen Sie den Tab Verwalten.
2. Klicken Sie auf Entitätstypen.
3. Klicken Sie auf Erstellen.
4. Legen Sie für den Anzeigenamen size fest.
5. Fügen Sie die in der Tabelle aufgeführten Entitätseinträge hinzu.
6. Klicken Sie auf Speichern.

Bestell-Intent mit Intent-Parametern erstellen

Sie benötigen einen Intent, der abgeglichen wird, wenn der Endnutzer eine neue Hemdbestellung anfordert. Dieser Intent sollte optional auch die ausgewählte Hemdfarbe oder -größe erfassen, wenn der Endnutzer diese Informationen zu Beginn angibt.

Parameter werden zum Erfassen und Referenzieren von Werten verwendet, die Endnutzer während einer Sitzung bereitgestellt haben. Jeder Parameter hat einen Anzeigenamen und einen Entitätstyp. Im Unterschied zu unstrukturierten Endnutzereingaben sind Parameter strukturierte Daten, mit denen Sie eine bestimmte Logik ausführen oder Antworten generieren können.

Sie steuern, wie Endnutzerdaten mit Intent-Zuordnungen extrahiert werden. Dazu werden Teile Ihrer Trainingsformulierungen annotiert und die zugehörigen Intent-Parameter konfiguriert.

Beispiel: „Wie ist die Wettervorhersage für morgen in Tokio?“ Sie können „morgen“ mit dem Parameter date und „Tokio“ mit dem Parameter location annotieren. Wenn Sie Teile einer Trainingsphrase annotieren, erkennt Dialogflow CX, dass diese Teile nur Beispiele für tatsächliche Werte sind, die von Endnutzern zur Laufzeit bereitgestellt werden können.

Bei einer Endnutzereingabe wie „Wie ist die Vorhersage für Freitag in Sydney?“ Dialogflow CX kann den Parameter date aus „Freitag“ und den Parameter location aus „Sydney“ extrahieren.

So annotieren Sie eine Trainingsphrase in der Console:

1. Markieren Sie den Teil der Trainingsformulierung, den Sie mit einer Anmerkung versehen möchten.
2. Wählen Sie den gewünschten Entitätstyp aus der Liste aus.
3. Dialogflow erstellt einen Parameter in der folgenden Parametertabelle.

So erstellen Sie einen Intent mit dem Namen order.new:

1. Annotieren Sie für jede Wortgruppe, die eine Farbe enthält, die Farbe mit einem color-Parameter und dem Systementitätstyp @sys.color.
2. Annotieren Sie für jede Formulierung, die eine Hemdgröße enthält, die Größe mit einem size-Parameter und dem benutzerdefinierten Entitätstyp @size, den Sie zuvor erstellt haben.

Die Trainingsformulierungen und -parameter sollten in etwa so aussehen:

Bestellseite erstellen

So erstellen Sie eine neue Bestellseite:

• Anzeigename: New Order
• Einstiegs-Fulfillment: Ok, let's start a new order.

Ein Formular zur Bestellseite hinzufügen

Für jede Seite können Sie ein Formular definieren. Das ist eine Liste von Parametern, die für die Seite von Endnutzern erfasst werden sollen. Der KI-Agent interagiert über mehrere Gesprächsrunden mit dem Endnutzer, bis alle erforderlichen Formularparameter, auch Seitenparameter genannt, erfasst wurden. Für jeden Formularparameter geben Sie auch Prompts an, mit denen der Agent diese Informationen vom Endnutzer anfordert. Dieser Vorgang wird als Formularausfüllung bezeichnet.

Wenn ein Endnutzer Intent-Parameter für eine Intent-Übereinstimmung angibt, werden die Intent-Parameter zu Sitzungsparametern. Wenn eine Seite zum ersten Mal aktiviert wird, werden alle Formularparameter mit allen Sitzungsparametern mit demselben Namen vorausgefüllt. Wenn der Endnutzer also Größe oder Farbe angibt, wenn der Intent order.new übereinstimmt, werden diese Werte automatisch für das Formular ausgefüllt.

Definieren Sie zwei erforderliche Formularparameter für die Seite Neue Bestellung:

Erforderlich	Anzeigename	Entitätstyp	Is list	Eingabeaufforderung
	Farbe	@sys.color		Welche Farbe wünschen Sie?
	Größe	@size		Welche Größe wünschen Sie?

So fügen Sie dieses Formular hinzu:

1. Klicken Sie in der Grafik auf die Seite Neue Bestellung.
2. Klicken Sie auf den Button zum Hinzufügen von Parametern, um das Parameter-Bearbeitungsfeld zu öffnen.
3. Fügen Sie die Parameter wie in der Tabelle oben beschrieben hinzu.
4. Klicken Sie auf Speichern.
5. Schließen Sie das Bearbeitungsfeld für Parameter.

Bestell-Intent-Route zum Ablauf hinzufügen

Fügen Sie dem Default Start Flow eine Route hinzu, die zur Seite New Order wechselt, wenn der Endnutzer eine neue Bestellung aufgeben möchte:

• Intent: order.new
• Zielseite für die Umstellung: Neuer Auftrag

Seite "Bestätigung"

Auf der letzten Seite wird die Bestellung bestätigt und die Sitzung beendet.

Bestätigungsseite erstellen

Erstellen Sie eine Bestätigungsseite mit einer Antwort, die die Sitzungsparameter verwendet, um die Bestellung zu bestätigen:

• Anzeigename: Order Confirmation
• Eingabeauftragsausführung: You can pick up your order for a $session.params.size, $session.params.color shirt in 7 to 10 business days. Goodbye.

Bedingungsrouten zur Bestellseite hinzufügen

Sie können Bedingungen verwenden, um festzulegen, ob eine Route aufgerufen wird. Bedingungen werden häufig verwendet, um zu prüfen, ob ein Formular vollständig ist, oder sie werden so konfiguriert, dass sie bei der Auswertung immer aufgerufen werden.

Informationen zum Festlegen von Bedingungen in der Console finden Sie in der Dokumentation unter Bedingungen festlegen.

Fügen Sie der Bestellseite die folgende Route hinzu, die aufgerufen wird, wenn das Formular auf der Bestellseite ausgefüllt wird. Diese Bedingungsroute verwendet Parameterreferenzen in ihrer Antwort an die Endnutzerin bzw. den Endnutzer und leitet die Sitzung zur Seite Order Confirmation weiter.

• Bedingung: $page.params.status = "FINAL"
• Agent sagt: You have selected a $session.params.size, $session.params.color shirt.
• Übergangsseite: Order Confirmation

Fügen Sie der Bestellseite die folgende Route hinzu. Diese Route wird für jeden Gesprächswechsel ausgeführt, während die Seite aktiv ist und die Bedingungsroute ausgewertet wird. Wenn die oben genannte Bedingung ausgewertet und aufgerufen wird, wird die Seite inaktiv. Daher wird diese true-Bedingungsroute nicht ausgewertet:

• Bedingung: true
• Agent sagt: I'd like to collect a bit more information from you.

Bedingungsroute zum Beenden der Sitzung erstellen

Fügen Sie der Seite Bestellbestätigung die folgende Bedingungsroute hinzu, um die Sitzung zu beenden, nachdem die Seite aktiv geworden ist und die Eingabeauftragsausführung verarbeitet wurde:

• Bedingung: true
• Zielseite für den Übergang: End Session

Fertiggestellten Agent testen

Testen Sie den Agent mit dem folgenden Dialog:

Dialog	Erklärung
Endnutzer: Hallo Agent: Hallo, dies ist ein virtueller Kundenservicemitarbeiter für eine Hemdbestellung. Wie können wir Ihnen helfen?	Die Route Standard-Begrüßungs-Intent im Standardstartablauf wird aufgerufen. Die Auftragsausführung für diesen Status-Handler ("Hello, this...") wird der Antwortwarteschlange hinzugefügt. Der Agent sendet die Antwortwarteschlange an den Endnutzer.
Endnutzer:Ich möchte ein blaues Hemd kaufen Agent: Ok, starten wir eine neue Bestellung. Agent: Ich brauche noch ein paar Informationen. Agent: Welche Größe möchten Sie?	Die Intent-Route order.new im Standardstartablauf wird ausgewertet. Der Intent order.new wird zugeordnet und der Intent-Parameter color auf "blau" gesetzt. Die Sitzung wechselt zur Seite Neue Bestellung und der Intent-Parameter color wird zu einem Sitzungsparameter. Die Seite Neue Bestellung enthält eine Eingabeauftragsausführung ("Ok, starten wir..."), die der Antwortwarteschlange hinzugefügt wird. Mit dem color-Sitzungsparameter wird der gleichnamige Formularparameter ausgefüllt. Die zutreffende Bedingungsroute auf der Seite Neue Bestellung wird ausgewertet und aufgerufen. Sie enthält eine Antwortnachricht ("Ich benötige..."), die der Antwortwarteschlange hinzugefügt wird. Das Formular der Seite ist nicht ausgefüllt. Der Agent verwendet also die Größeneingabeaufforderung ("Welche Größe...") und fügt sie der Antwortwarteschlange hinzu. Der Agent sendet die Antwortwarteschlange an den Endnutzer.
Endnutzer: groß Agent: Sie haben ein großes blaues T-Shirt ausgewählt. Agent: Sie können Ihre Bestellung für ein großes blaues T-Shirt in 7 bis 10 Werktagen abholen. Auf Wiedersehen.	Der Parameter size wird mit der Endnutzereingabe ausgefüllt, die der Agent in der vorherigen Unterhaltungsrunde angefordert hat. Die Formularausführungsroute auf der Seite Neue Bestellung wird ausgewertet und aufgerufen. Sie enthält eine Auftragsausführung ("Sie haben ... ausgewählt"), die der Antwortwarteschlange hinzugefügt wird, wobei Parameterverweise in tatsächliche vom Endnutzer bereitgestellte Werte aufgelöst werden. Die Sitzung wechselt zur Seite Bestellbestätigung. Die Seite Bestellbestätigung enthält eine Eingabeauftragsausführung ("Sie können ... abholen"), die der Antwortwarteschlange hinzugefügt wird. Der Agent sendet die Antwortwarteschlange an den Endnutzer. Die Sitzung wechselt zu Sitzung beenden.

Auf die Produktion vorbereiten

Bevor Sie Ihren Agenten in der Produktion ausführen, sollten Sie die Best Practices für die Produktion implementieren.