Playbook-Parameter

Vorschau

Dieses Produkt oder diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Funktionen sind unverändert verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Hinweis: In der Agent Builder-Konsole werden Playbooks weiterhin als Kundenservicemitarbeiter bezeichnet. Dies wird demnächst in der Console auf Playbook aktualisiert.

Wichtig: Conversational Agents (Dialogflow CX) Playbooks und die Übergabe von Parametern zwischen Hier werden die Abläufe und Playbooks für Conversational Agents (Dialogflow CX) dokumentiert. haben aber derzeit eingeschränkten Zugriff. Das Übergeben von Parametern zwischen Dialogflow-Agents ist öffentlich verfügbar.

Playbooks können Kontextinformationen mithilfe von explizit definierten Parametern akzeptieren und senden. Mit Parametern werden Informationen zu einer Unterhaltung gespeichert, z. B. Benutzerauswahl, Ergebnisse von Aktionen usw. Sie können die Werte dieser Parameter zwischen Playbooks und Abläufen übergeben.

Parameterdeklaration

Sie können Eingabeparameter und Ausgabeparameter definieren.

Wenn Sie die Agent Builder-Konsole verwenden, können Sie Parameter auf der Seite „Agent-Editor“ definieren.

Wenn Sie die Dialogflow CX-Konsole verwenden, werden die Parameter pro Playbook auf dem Tab Parameter definiert, nachdem Sie ein Playbook erstellt haben.

Parameter haben einen Namen, eine Beschreibung, und einer der folgenden Typen:

• String
• Number
• Boolesch
• Toolspezifischer Parametertyp

Sie können auch angeben, ob ein Parameter eine Liste ist.

Eingabeparameter

Eingabeparameter ermöglichen Playbooks die Verwendung der übergebenen Werte aus Abläufen und anderen Playbooks. Ein Playbook kann beispielsweise den bevorzugten Namen eines Nutzers erhalten. als Parameter verwendet, um den Nutzenden persönlich zu danken. Oder er erhält eine Bestell-ID als Parameter und können damit Bestelldetails mithilfe eines Tool erfasst.

Eingabeparameter werden pro Playbook definiert und Playbooks haben keine Sichtbarkeit von andere Parametertypen der Dialogflow CX-Konsole ist standardmäßig aktiviert. Wenn ein Ablauf zu einem Playbook übergeht, Seiten- und Sitzungsparameter werden an das Playbook weitergegeben. Das Ziel-Playbook hat einen Eingabeparameter mit demselben Namen. Wenn Sie Informationen während eines Übergangs von einem Fluss an ein Playbook senden möchten, definieren Sie Playbook-Eingabeparameter mit demselben Namen wie ein Sitzungs- oder Seitenparameter, der vor dem Übergang vorhanden ist.

Hinweis: Das Standard-Playbook akzeptiert keine Eingabeparameter. Das Standard-Playbook dient als Einstiegspunkt für Nutzerunterhaltungen und kann daher keine Eingabeparameter empfangen.

Erstellen Sie Beispiele, um zu steuern, wie sich der Wert des Eingabeparameters auf Aktionen auswirken soll. Wenn sich ein Eingabeparameter beispielsweise darauf auswirken soll, wie sich der Kundenservicemitarbeiter an den Nutzer wendet, erstellen Sie Beispiele, in denen ein Wert für den Parameter definiert wird, und verwenden Sie dann denselben Wert in Äußerungsaktionen im Beispiel. Weitere Informationen finden Sie unter Parameter übergeben.

Ausgabeparameter

Mit Ausgabeparametern können Playbooks Informationen senden, die von anderen Abläufen oder Playbooks verwendet werden. Ein Playbook könnte beispielsweise eine Bestellnummer von und geben sie über einen Ausgabeparameter oder ein Playbook könnte Tool um einen Flug zu buchen und die Bestätigungsnummer über einen Ausgabeparameter auszugeben.

Erstellen Sie Beispiele, um festzulegen, wie das Playbook den Wert für jeden Ausgabeparameter festlegen soll. Wenn z. B. ein Ausgabeparameter eine Bestätigung der Wert einer Zahl aus der Ausgabe einer Tool-Anwendung abgeleitet werden sollte, Erstellen Sie Beispiele, bei denen die Ausgabe des Tools use entspricht dem Wert des Playbook-Ausgabeparameters.

Parameter übergeben

Im Gegensatz zu Abläufen unterstützen Playbooks das Einfügen von Parameterwerten nicht. mit einer bestimmten Syntax. Playbooks basieren stattdessen auf Anleitungen und Beispiele für Prompts mit wenigen Aufnahmen wie Parameterwerte verwendet und bei der Angabe von Parameterwerten festgelegt wird.

Angenommen, Sie haben einen Agenten für den Verkauf von Veranstaltungstickets mit den folgenden Playbooks erstellt:

1. Ein Playbook mit dem Namen Ticket ordering, das Bestellungen über ein Tool namens Ticket sales API aufgibt.
   1. Dieses Playbook akzeptiert einen Eingabeparameter vom Typ number und mit dem Namen event_id.
   2. Das Ticket sales API-Tool erwartet eine Anfrage, die ein event_id enthält.
2. Ein Playbook namens Event selection, das Nutzern hilft, ein Ereignis auszuwählen und leitet ihn an Ticket ordering mit dem Parameter event_id zum Kauf weiter Tickets.

In diesem Beispiel sind mehrere Beispiele erforderlich, damit event_id zuverlässig von Event selection an Ticket ordering und von Ticket ordering an Ticket sales API übergeben wird.

Das Playbook Ticket ordering sollte mehrere Beispiele enthalten, die:

• Der Eingabeparameter event_id muss mit einem realistischen Wert angegeben werden, der in jedem Beispiel unterschiedlich ist.
• Fügen Sie eine Tool-Verwendungsaktion mit einem Anfragetext hinzu, der denselben realistischen event_id-Wert enthält, der im Eingabeparameter angegeben ist.

Das Playbook Event selection sollte mehrere Beispiele enthalten, die:

• Eine Nutzeräußerung einschließen, bei der der Nutzer ein Ereignis auswählt, das realistisch wirkt event_id, die sich je nach Beispiel unterscheiden.
• Fügen Sie einen Playbook-Aufruf von Ticket ordering ein, der den event_id festlegt. Parameter auf dieselbe realistische event_id, wie sie vom Nutzer festgelegt wurde. Auswahl.

Versuchen Sie, zusätzlich zu den Beispielen spezifische Anweisungen zum Anleitung, Zielvorhaben oder Tool-Details in der die Verwendung von Parametern erklärt wird. Beispiel: Das Playbook Ticket ordering enthält die folgende Anleitung:

- Use parameter event_id to send a buy_tickets request with ${TOOL: Ticket sales API}

Mit den beschriebenen Beispielen und Anleitungen entscheidet das Event selection-Playbook basierend auf der Auswahl des Nutzers korrekt über einen event_id und gibt ihn als Eingabeparameter namens event_id an die Ticket ordering playbook weiter. Anschließend gibt Ticket ordering dieselbe event_id im Anfragetext an die Ticket sales API weiter. Playbooks sind von Beispielen abhängig mit unterschiedlichen Parameterwerten.