Playbook-Beispiele

Jedes Playbook sollte ein oder mehrere Beispiele enthalten. Diese Beispiele sind Beispielunterhaltungen zwischen einem Endnutzer und dem Playbook, einschließlich des Dialogs und der vom Agenten ausgeführten Aktionen. Dies sind im Grunde Few-Shot-Prompt-Beispiele für das LLM.

Die Konsole bietet eine Oberfläche, über die Sie Aktionen eingeben können.

Mehrsprachige KI-Agenten

Wenn Ihr Agent mehrere Sprachen verarbeiten soll, sollten Ihre Beispiele alle diese Sprachen enthalten.

Beispiel für Eingabe- und Ausgabezusammenfassung

Zusätzlich zu Eingabe- und Ausgabeparametern unterstützen Playbooks den Empfang einer Eingabezusammenfassung und die Ausgabe einer Ausgabezusammenfassung, um Informationen mit anderen Playbooks auszutauschen. Zusammenfassungen sind hilfreich, um abstrakte Kontextinformationen zwischen Playbooks zu übertragen, während Parameter eher für die Übertragung strukturierter, klar definierter Felder zwischen Playbooks geeignet sind. Parameter sind die einzige Möglichkeit, Daten zwischen Abläufen und Playbooks auszutauschen.

Fügen Sie Beispielen relevante Eingabezusammenfassungen hinzu, damit das Playbook seine Aktionen zur Laufzeit basierend auf den Eingabezusammenfassungen anpasst. Fügen Sie Ausgabezusammenfassungen mit relevanten, genauen Details zur Beispielunterhaltung hinzu, um dem Playbook zu zeigen, welche Details wichtig sind.

Beispielstatus

Zu einem bestimmten Zeitpunkt in der Unterhaltung befindet sich ein Playbook in einem der folgenden Status:

  • OK: Das Playbook hat sein Ziel erreicht und die Kontrolle wird jetzt an das übergeordnete Playbook übertragen.
  • CANCELLED: Der Nutzer hat sich entschieden, das dem Playbook zugewiesene Ziel nicht weiterzuverfolgen. Die Steuerung wird jetzt an das übergeordnete Playbook übertragen. Wenn das übergeordnete Playbook ein CX-Flow ist, wird die Absicht der Nutzereingabe erkannt, bevor der Flow ausgeführt wird.
  • FAILED: Das Playbook kann das Ziel aufgrund eines Fehlers nicht erreichen (z.B. gibt das Tool einen 500-Fehler zurück). Die Sitzung wird mit dem Status „Fehler“ beendet. Der Antwort wird eine EndInteraction-Nachricht hinzugefügt.
  • ESCALATED: Das Playbook hat entschieden, dass es das Ziel nicht erreichen kann und die Situation an einen Menschen eskalieren muss. Die Sitzung wird mit dem Status „Eskaliert“ beendet. Der Antwort wird eine EndInteraction-Nachricht hinzugefügt.
  • PENDING: Die Unterhaltung wird im Playbook fortgesetzt.

Das Beispiel auf oberster Ebene und die zugehörigen Playbook-Aufrufe sollten mit einem Status gekennzeichnet werden, der dem Playbook entspricht, auf das sie verweisen.

Auswahlstrategie

Die Einstellung für die Auswahlstrategie steuert, ob ein Beispiel in den Prompt des Playbooks aufgenommen wird, der an das LLM gesendet wird. Folgende Optionen sind verfügbar:

  • Dynamisch auswählen: Das Beispiel wird bedingt einbezogen, je nachdem, wie relevant es für den aktuellen Konversationskontext ist. Das Beispiel kann weggelassen werden, wenn der Prompt sich dem Tokenlimit nähert.

  • Immer auswählen: Das Beispiel wird unabhängig vom Kontext der Unterhaltung immer einbezogen. Das Beispiel kann weggelassen werden, wenn der Prompt das Tokenlimit erreicht.

  • Nie auswählen: Das Beispiel wird nie in den Prompt aufgenommen. Das Beispiel hat keine Auswirkungen auf die Leistung des Playbooks. Diese Einstellung ist nützlich, um ein Beispiel vorübergehend zu Testzwecken auszuschließen.

Aktion hinzufügen

Ein Beispiel in einem Playbook besteht aus einer Reihe von Aktionen. Diese Aktionen können in verschiedenen Kombinationen auftreten, stellen aber hauptsächlich die Interaktion zwischen dem Nutzer und dem Playbook dar, zusammen mit den dazwischen ausgeführten Aktionen, um die Anfrage oder Anforderungen des Nutzers zu erfüllen.

Es gibt zwei Möglichkeiten, einem Beispiel Aktionen hinzuzufügen:

  • Wenn Sie eine Aktion manuell hinzufügen möchten, klicken Sie unten im rechten Bereich auf das Pluszeichen + oder auf den Button Aktion hinzufügen, wenn Sie den Mauszeiger auf vorhandene Aktionen bewegen. Sie können diese Optionen verwenden, wenn Sie ein neues Beispiel erstellen, indem Sie auf die Option + Beispiel klicken, oder wenn Sie ein vorhandenes Beispiel bearbeiten.
  • Wenn Sie Aktionen automatisch anhand der vorhandenen Playbook-Anweisungen generieren möchten, geben Sie unten im rechten Bereich im Feld Nutzereingabe eingeben eine Nutzereingabe ein. Sie können diese Option beim Erstellen oder Bearbeiten eines Beispiels verwenden. Alternativ können Sie diese Option verwenden, wenn Sie Ihr Playbook zur Laufzeit im Bereich Playbook-Vorschau rechts testen. Wenn Sie Aktionen in einem Beispiel im Bereich Playbook-Vorschau speichern möchten, klicken Sie auf Beispiel speichern, nachdem Sie den Playbook-Aufruf aus der Aufrufliste links im Bereich Playbook-Vorschau ausgewählt haben.

Prüfen Sie die automatisch generierten Aktionen auf Richtigkeit und bearbeiten Sie sie bei Bedarf. Das ist besonders wichtig für Playbooks mit wenigen oder keinen Beispielen.

Die folgenden Arten von Aktionen werden vom Playbook unterstützt:

Playbook-Antwort

Die Playbook-Antwort auf die Nutzeranfrage.

Nutzereingabe

Die Nutzeranfrage.

Toolnutzung

Dies ist ein Toolaufruf, um zusätzliche Informationen zu erhalten, die für die Beantwortung der Nutzeranfrage erforderlich sind. Diese Aktion sollte die folgenden Details enthalten:

  • Tool: Name des Tools, das aufgerufen werden soll.

  • Aktion: Name des Vorgangs für das OpenAPI-Tool, das aufgerufen werden soll. Bei Datenspeichertools und Funktionstools ist der Aktionsname mit dem Toolnamen identisch.

  • Tool-Eingabe: Eingaben, die in den Toolaufruf einbezogen werden sollen. Diese werden in der Regel aus den vorherigen Unterhaltungsrunden mit dem Nutzer abgeleitet.

    Für Open API-Tools ist requestBody-JSON für die Methodentypen POST, PUT und PATCH erforderlich.

    Beispiel für die requestBody-Eingabe des OpenAPI-Tools für die Aktion „createPet“:

    {
  "id": 1,
  "name": "Luna"
}

    Für das Datenspeichertool ist das Beispiel requestBody, bei dem die Abfrage erforderlich ist und andere Felder optional sind.

    {
  "query": "Where is my nearest store?",
  "filter": "country: ANY(\"United States\")",
  "userMetadata": {
    "userCity": "San Francisco",
  },
  "fallback": "We don't have any stores in your area."
}

  • Toolausgabe: Die Antwort des Toolaufrufs. Dies ist eine gültige JSON-Antwort des Tools auf die angegebene Eingabe. Bei Open API-Tools kann es sich auch um einen Stringfehler handeln (z. B. „404 Nicht gefunden“).

    Beispiel für die Ausgabe des OpenAPI-Tools für die Aktion „listPets“:

    {
  "pets": [
    {
      "id": 1,
      "name": "Luna"
    },
    {
      "id": 2,
      "name": "Charlie"
    }]
}

    Beispielausgabe des Datenspeichertools:

    {
  "answer": "Here's the address to your nearest store ...",
  "snippets": [
    {
      "title": "San Francisco Downtown",
      "uri": "https://www.example.com/San_Francisco_Downtown",
      "text": "Address for San Francisco Downtown .."
    }
  ]
}

Damit das Playbook ausfallsicher ist, sollten Sie auch Beispiele dafür aufnehmen, wie das Playbook reagieren soll, wenn der Toolaufruf fehlschlägt. Ein Fehler beim Aufruf des Open API-Tools kann in der Toolausgabe als Fehlerstring („404 nicht gefunden“) dargestellt werden. Bei Datenspeicher-Tools kann mit der Eingabe fallback angegeben werden, wie reagiert werden soll, wenn keine zusammengefasste Antwort vorhanden ist.

Wenn Sie möchten, dass Ihr Datenspeichertool den URI in die Playbook-Antwort einfügt, fügen Sie Beispiele hinzu, die den URI enthalten, mit dem das Playbook antworten soll. Wenn dieser URI vom Datenspeichertool stammt, sollte die Ausgabe des Datenspeichertools einen URI enthalten, der mit dem URI in der Playbook-Antwort übereinstimmt. Hinweis: fallback kann in diesem Szenario nicht verwendet werden, da dadurch die Fähigkeit des LLM-Playbooks deaktiviert wird, die Antwort des Datenspeichertools so umzuformulieren, dass URIs in der Playbook-Antwort enthalten sind.

Beispiele mit Toolnutzungsaktionen können sehr ausführlich sein und zu einem erhöhten Verbrauch des Tokenlimits für die Eingabe beitragen. Damit Tokens effizient genutzt werden, sollten die Toolausgaben prägnant sein und Informationen enthalten, die für die Ziele des Playbooks relevant sind. Bei Datenspeichertools sollten Sie Snippets aus Beispielen entfernen, da sie zu einem hohen Verbrauch von Eingabetokens beitragen können.

Playbook-Aufruf

Diese Aktion wird verwendet, wenn das Playbook ein anderes Aufgaben-Playbook aufrufen soll, um die Nutzeranfrage zu erfüllen. Diese Aktion sollte die folgenden Details enthalten:

  • Playbook: Name des aufzurufenden Playbooks.
  • Zusammenfassung der Eingabe für den Playbook-Aufruf: Eine Zusammenfassung der relevanten Teile der vorherigen Unterhaltung, die für das aufgerufene Playbook nützlich sind.
  • Eingabeparameter: Eingabeparameter, die an das Playbook übergeben werden sollen.
  • Zusammenfassung der Ausgabe des Playbook-Aufrufs: Eine Zusammenfassung dessen, was das Playbook nach Erreichen des Ziels generieren soll.
  • Ausgabeparameter: Ausgabeparameter, die vom Playbook nach Erreichen des Ziels generiert werden.

Playbook-Übergang

Eine Playbook-Übergangsaktion ist eine abschließende Aktion (auf die keine weiteren Aktionen folgen sollten), die angibt, dass das Routine-Playbook beendet und zu einem Ziel-Routine-Playbook übergegangen werden soll. Da diese Aktion angibt, dass das Playbook beendet wird, müssen Sie die Ausgabeparameter des Playbooks der Playbook-Ausgabe des Beispiels hinzufügen.

Flow-Aufruf

Diese Aktion wird verwendet, wenn das Aufgaben-Playbook einen Ablauf aufrufen soll. Diese Aktion sollte die folgenden Details enthalten:

  • Flow: Name des aufzurufenden Flows.
  • Eingabeparameter für den Ablauf: Eingabeparameter, die an den Ablauf übergeben werden sollen.
  • Flow-Rückgabeparameter: Ausgabeparameter, die vom Flow zurückgegeben werden.

Ablaufübergang

Eine Ablaufübergangsaktion ist eine abschließende Aktion (auf die keine weiteren Aktionen folgen sollten), die angibt, dass das Routine-Playbook entschieden hat, den Ablauf zu beenden und zu einem Zielablauf zu wechseln. Da diese Aktion angibt, dass das Playbook beendet wird, müssen Sie die Ausgabeparameter des Playbooks der Playbook-Ausgabe des Beispiels hinzufügen.

Zurück
Bedingte Playbook-Aktionen
Weiter
Playbook-Parameter