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 unterstützt, verwenden Sie jede dieser Sprachen in Ihren Beispielen.

Beispiele für Eingabe- und Ausgabezusammenfassungen

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 diesen Eingabezusammenfassungen anpassen kann. Fügen Sie Ausgabezusammenfassungen hinzu, die relevante und genaue Details zur Beispielunterhaltung enthalten, 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 Steuerung wird an das übergeordnete Playbook übertragen.
  • CANCELLED: Der Nutzer entscheidet sich, das dem Playbook zugewiesene Ziel nicht weiterzuverfolgen, und die Steuerung wird an das übergeordnete Playbook übertragen. Wenn das übergeordnete Playbook ein CX-Flow ist, erkennt Dialogflow CX die Absicht der Nutzereingabe, bevor der Flow ausgeführt wird.
  • FAILED: Das Playbook kann das Ziel aufgrund eines Fehlers nicht weiterverfolgen (z. B. wenn ein Tool einen 500-Fehler zurückgibt). Die Sitzung endet mit dem Status „Fehler“. Der Antwort wird eine EndInteraction-Nachricht hinzugefügt.
  • ESCALATED: Das Playbook entscheidet, dass es das Ziel nicht erreichen kann und die Situation an einen Menschen weiterleiten muss. Die Sitzung endet mit dem Status „Eskaliert“. Der Antwort wird eine EndInteraction-Nachricht hinzugefügt.
  • PENDING: Die Unterhaltung wird im Playbook fortgesetzt.

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

Auswahlstrategie

Mit der Einstellung für die Auswahlstrategie wird festgelegt, ob ein Beispiel in den Prompt aufgenommen wird, der für das Playbook 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. Sie können das Beispiel weglassen, wenn der Prompt das Tokenlimit erreicht.
  • Immer auswählen: Das Beispiel wird unabhängig vom Kontext der Unterhaltung immer einbezogen. Sie können das Beispiel weglassen, wenn der Prompt das Tokenlimit erreicht.
  • Nie auswählen: Das Beispiel ist nicht im Prompt enthalten. 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 in einem Playbook bereitgestelltes Beispiel enthält eine Reihe von Aktionen. Diese Aktionen können in Kombination variieren, stellen aber hauptsächlich die Interaktion zwischen Ihnen und dem Playbook dar, zusammen mit den dazwischen ausgeführten Aktionen, um Ihre Anfrage oder Anforderungen 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 den Button + oder auf den Button Aktion hinzufügen, wenn Sie den Mauszeiger auf vorhandene Aktionen bewegen. Verwenden Sie diese Optionen, wenn Sie ein neues Beispiel erstellen, indem Sie auf die Option + Beispiel klicken, oder wenn Sie ein vorhandenes Beispiel bearbeiten.
  • Wenn Sie Aktionen automatisch basierend auf den vorhandenen Playbook-Anweisungen generieren möchten, geben Sie unten im rechten Bereich im Feld Nutzereingabe eingeben eine Nutzereingabe ein. Verwenden Sie diese Option, wenn Sie ein Beispiel erstellen oder bearbeiten. Alternativ können Sie diese Option verwenden, wenn Sie Ihr Playbook zur Laufzeit im Bereich Playbook-Vorschau auf der rechten Seite testen. Wenn Sie Aktionen im Bereich Playbook-Vorschau in einem Beispiel 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 Richtigkeit der automatisch generierten Aktionen und bearbeiten Sie sie bei Bedarf. Das ist besonders wichtig für Playbooks mit wenigen oder keinen Beispielen.

Das Playbook unterstützt die folgenden Arten von Aktionen.

Playbook-Antwort

Stellt die Playbook-Antwort auf die Nutzeranfrage bereit.

Nutzereingabe

Geben Sie die Nutzeranfrage ein.

Toolnutzung

Rufen Sie zusätzliche Informationen ab, die zur Beantwortung der Nutzeranfrage erforderlich sind, indem Sie ein Tool aufrufen.

Diese Aktion gibt die folgenden Details an:

  • Tool: Name des Tools, das Sie aufrufen müssen.
  • Aktion: Name des Vorgangs für das OpenAPI-Tool, das Sie aufrufen müssen. Bei Datenspeichertools und Funktionstools entspricht der Aktionsname dem Toolnamen.

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

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

    Beispiel für die requestBody-Eingabe für das OpenAPI-Tool für die Aktion „createPet“:

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

    Für das Datenspeichertool zeigt das Beispiel requestBody, wo die Abfrage erforderlich ist und welche anderen 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 OpenAPI-Tools kann es sich auch um einen Stringfehler handeln (z. B. „404 Nicht gefunden“).

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

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

    Beispiel für die Ausgabe des Datenspeichertools für die Abfrage „Wo ist das nächste Geschäft?“:

    {
  "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 Beispiele dafür einfügen, wie das Playbook reagiert, wenn der Toolaufruf fehlschlägt. Sie können den Fehler beim Aufruf des OpenAPI-Tools als Fehlerstring („404 nicht gefunden“) in der Toolausgabe darstellen. Bei Datenspeicher-Tools können Sie mit der Eingabe fallback angeben, wie reagiert werden soll, wenn keine zusammengefasste Antwort vorhanden ist.

Wenn Ihr Datenspeichertool einen URI in die Playbook-Antwort aufnehmen soll, fügen Sie Beispiele hinzu, die den URI enthalten, mit dem das Playbook antworten soll. Wenn dieser URI vom Datenspeicher-Tool stammt, muss die Ausgabe des Datenspeicher-Tools einen URI enthalten, der mit dem URI in der Playbook-Antwort übereinstimmt.

Beispiele, die Aktionen zur Toolnutzung enthalten, können sehr ausführlich sein und das Tokenlimit für die Eingabe erhöhen. Damit Tokens effizient verwendet werden, sollten die Toolausgaben prägnant sein und Informationen enthalten, die für die Ziele des Playbooks relevant sind. Bei Datenspeicher-Tools sollten Sie Snippets aus Beispielen entfernen, da sie zu einem hohen Verbrauch von Eingabe-Tokens führen.

Playbook-Aufruf

Verwenden Sie diese Aktion, wenn das Playbook ein anderes Aufgaben-Playbook aufrufen muss, um die Nutzeranfrage zu erfüllen.

Geben Sie die folgenden Details für diese Aktion an:

  • 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 Playbook-Aufrufausgabe: 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. Sie gibt an, dass das Routine-Playbook beendet und zu einem Ziel-Routine-Playbook übergegangen werden soll. Da diese Aktion angibt, dass das Playbook beendet wird, fügen Sie die Ausgabeparameter des Playbooks der Playbook-Ausgabe des Beispiels hinzu.

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.
  • Flow-Eingabeparameter: Eingabeparameter, die an den Flow übergeben werden sollen.
  • Rückgabeparameter des Ablaufs: Ausgabeparameter, die vom Ablauf zurückgegeben werden.

Ablaufübergang

Eine Ablaufübergangsaktion ist eine abschließende Aktion, auf die keine weiteren Aktionen folgen sollten. Sie gibt an, 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, fügen Sie die Ausgabeparameter des Playbooks der Playbook-Ausgabe des Beispiels hinzu.

Zurück
Bedingte Playbook-Aktionen
Weiter
Playbook-Parameter