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.

Wichtig: Dialogflow CX-Playbooks werden bei der Verwendung von Vertex AI-Agents. Um Verwirrung zu vermeiden, In diesem Dokument wird der Begriff Playbook verwendet.

Wichtig: Dialogflow CX-Playbooks und die Übergabe von Parametern zwischen Dialogflow CX-Abläufe und Playbooks sind hier dokumentiert. haben aber derzeit eingeschränkten Zugriff. Die Übergabe von Parametern zwischen Vertex AI-Agents ist öffentlich verfügbar.

Playbooks können Kontextinformationen akzeptieren und ausgeben mit explizit definierten Parametern. Mit Parametern werden Informationen zu einer Unterhaltung gespeichert, z. B. Benutzerauswahl, Ergebnisse von Aktionen usw. Sie können die Werte dieser Parameter Playbooks und Dialogflow CX-Abläufen.

Parameterdeklaration

Sie können Eingabeparameter und Ausgabeparameter definieren.

Wenn Sie Vertex AI-Agents verwenden, können Sie Parameter auf der Seite des Agent-Editors definieren.

Wenn Sie Dialogflow CX nutzen, Parameter werden pro Playbook mithilfe der 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. Playbooks haben keine Sichtbarkeit von andere Dialogflow CX-Parametertypen ist standardmäßig aktiviert. Wenn ein Dialogflow CX-Ablauf in ein Playbook übergeht, Seiten- und Sitzungsparameter werden an das Playbook weitergegeben. Das Ziel-Playbook hat einen Eingabeparameter mit demselben Namen. Um während einer Umstellung Informationen aus einem Ablauf an ein Playbook zu kommunizieren, Playbook-Eingabeparameter mit demselben Namen wie eine Sitzung definieren oder Seitenparameter vorhanden ist.

Hinweis: Das Standard-Playbook akzeptiert keine Eingabeparameter. Das Standard-Playbook dient als Einstiegspunkt für Nutzergespräche, Es gibt also keine Möglichkeit, Eingabeparameter zu empfangen.

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

Ausgabeparameter

Ausgabeparameter ermöglichen Playbooks, Informationen auszugeben 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 gibt die Bestätigungsnummer über einen Ausgabeparameter aus.

Beispiele erstellen, um zu steuern, wie das Playbook entscheiden soll den Wert für jeden Ausgabeparameter. Wenn z. B. ein Ausgabeparameter eine Bestätigung Wert einer Zahl aus der Ausgabe einer Toolverwendung ableiten sollte, erstellen 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.

Stellen Sie sich einen Agent vor, der mit den folgenden Playbooks für den Verkauf von Veranstaltungstickets entwickelt wurde:

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

Um in diesem Beispiel sicherzustellen, dass event_id zuverlässig von Event selection nach Ticket ordering und von Ticket ordering nach Ticket sales API, mehrere Beispiele erforderlich sind.

Das Playbook Ticket ordering sollte mehrere Beispiele enthalten, die:

• Der Eingabeparameter event_id wurde mit einem anderen realistischen Wert angegeben in jedem Beispiel.
• Verwenden Sie eine Tool-Aktion mit einem Anfragetext, der dieselbe enthält. realistischer event_id-Wert, wie im Eingabeparameter angegeben

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 wird die Event selection Das Playbook legt ein event_id basierend auf der Auswahl des Nutzers korrekt fest und als Eingabeparameter event_id an den Ticket ordering playbook Dann übergibt Ticket ordering dieselbe event_id im Text einer Anfrage an Ticket sales API. Playbooks sind von Beispielen abhängig mit unterschiedlichen Parameterwerten.