Playbooks

Hinweis: Die Funktion Playbook ist vom Dialogflow CX-SLA ausgeschlossen.

Ein Playbook ist der grundlegende Baustein generativer Agenten. Ein generativer KI-Agent hat in der Regel viele Playbooks, wobei jedes Playbook für die Bearbeitung bestimmter Aufgaben definiert ist. Die Playbook-Daten werden dem LLM zur Verfügung gestellt, damit es die Informationen hat, die es zum Beantworten von Fragen und Ausführen von Aufgaben benötigt. Jedes Playbook kann Informationen bereitstellen, Abfragen an externe Dienste senden oder die Gesprächsverarbeitung an einen Ablauf oder ein anderes Playbook weiterleiten, um Unteraufgaben zu bearbeiten.

Beschränkungen

Es gelten folgende Einschränkungen:

• KI-Agenten, die Playbooks verwenden, unterstützen das Senden einer Anruf-Companion-SMS über die Route „Default Welcome Intent“ im Standardstartablauf nicht. Sie können die Option „Anruf-Companion-SMS“ jedoch in Standardabläufen aktivieren.
• Playbooks unterstützen keine DTMF-Eingaben von Telefonsystemen.

Sprachunterstützung

Weitere Informationen finden Sie in der Spalte Playbooks in der Sprachreferenz. Die für Playbooks markierten Sprachen wurden mit gemini-2.5-flash-Modellen auf Qualität getestet.

Wenn Sie andere Sprachen als Englisch verwenden:

• Verwenden Sie für Playbook-Anleitungen in den meisten Fällen Englisch. Bei bestimmten Sprachen und Anwendungsfällen können Sie etwas bessere Antworten erhalten, wenn Sie zusätzlich Anweisungen in der Zielsprache angeben.
• Geben Sie die Sprachunterstützung in den Playbook-Anweisungen an, z. B. „Antworte immer auf Französisch“.
• Definieren Sie Ihre Beispiele in der Zielsprache.

Modellunterstützung

Sie können das in einem Playbook verwendete LLM-Modell an den folgenden Stellen auswählen:

• Wählen Sie das LLM-Modell auf Agentenebene aus:
  • Wählen Sie in der Conversational Agents-Konsole im Abschnitt Agenteneinstellung > Generative KI > Playbook ein Modell anhand seines Anzeigenamens aus der Liste der verfügbaren Modelle aus.
  • Geben Sie den Modellnamen im Feld GenerativeSettings.llm_model_settings.model an, wenn Sie die API zum Aktualisieren der Agent-Einstellungen verwenden. Weitere Informationen finden Sie unter GenerativeSettings.
• Überschreiben Sie die Modellauswahl auf Anfrageebene:
  • Wählen Sie im Simulator der Konsole für Konversations-Agenten beim Testen eines Playbooks ein Modell anhand seines Anzeigenamens aus der Liste aus.
  • Geben Sie den Modellnamen im Feld DetectIntentRequest.query_params.llm_model_settings.model an, wenn Sie die API zum Testen des KI-Agenten verwenden. Siehe DetectIntentRequest.

Modellname	Modellspezifikation	Markteinführungsphase
gemini-2.5-flash	Gemini 2.5 Flash	GA
gemini-2.5-flash-lite	Gemini 2.5 Flash Lite	GA
gemini-3.1-flash-lite	Gemini 3.1 Flash Lite	GA
gemini-3.5-flash-lite	Gemini 3.5 Flash Lite	GA

Unterstützte Regionen

Playbooks werden in den folgenden Regionen unterstützt:

• global
• asia-south1
• asia-southeast1
• asia-southeast2
• asia-northeast1
• australia-southeast1
• eu (multiregional)
• europe-west1
• europe-west2
• europe-west3
• europe-west4
• europe-west6
• northamerica-northeast1
• us (multiregional)
• us-central1
• us-east1
• us-west1

Playbook-Daten

Ein Playbook besteht aus den folgenden Daten:

• Playbook-Name: Ein prägnanter Name in natürlicher Sprache, der Entwicklern und dem LLM hilft, zu verstehen, welche Aufgaben das Playbook übernimmt.
• Ziele: Eine allgemeine Beschreibung dessen, was mit dem Playbook erreicht werden soll.
• Anweisungen: Die Prozessschritte, die der Agent ausführen muss, um das Ziel zu erreichen.
• Beispiele: Beispielunterhaltungen, die als Few-Shot-Prompt-Beispiele für das LLM dienen.
• Parameter: Variablen, in denen Informationen zu einer Unterhaltung gespeichert werden, z. B. Nutzereingaben, Informationen zum Nutzersystem und Aktionsergebnisse.

LLM-Prompt

Für jeden Gesprächsabschnitt verwendet Dialogflow CX Ihre Playbook-Daten aus der Entwurfszeit und die Gesprächsdaten aus der Laufzeit, um einen LLM-Prompt innerhalb der Tokenlimits zu erstellen.

In der folgenden Liste wird der Inhalt dieses Prompts zusammengefasst. Die Überschriften dienen nur zur Veranschaulichung und sind nicht unbedingt Teil des Prompts:

# INTERNAL_SYSTEM_PROMPT
<you cannot see or edit this>

# INTERNAL_SYSTEM_EXAMPLES
<you cannot see or edit this>

# AVAILABLE_TOOLS_TO_CURRENT_PLAYBOOK
<tool names and schemas, for example...>

## Tool: my_datastore
   description: blah
   input: blah
   output: blah

## Tool: some_other_custom_tool
   description: blah
   input: blah
   output: blah

# PLAYBOOK
<verbatim Goal and Instructions that you provide in the console>

# PLAYBOOK_EXAMPLES
<as many Examples for the current Playbook as can fit in the prompt>

## Example 1

## Example 2
..
..
..
## Example N (up to the input token limit)

# CURRENT_CONVERSATION
<the conversation up to this point w/ some caveats...>

* Caveat 1: If there was a transition from Playbook A -> Playbook B, the
  Conversation that happened in Playbook A is summarized and provided as context
* Caveat 2: If there was a transition from Flow A -> Playbook A, the
  Conversation that happened prior to the entry of Playbook A is summarized and
  provided to the Playbook

Playbook-Typen

Wenn Sie ein Playbook erstellen, wählen Sie den Typ aus: ein Aufgaben-Playbook oder ein Routine-Playbook.

Aufgaben-Playbooks

Aufgaben-Playbooks sind der ursprüngliche Playbook-Typ. Sie können damit komplexe Aufgaben in kleinere, wiederverwendbare Teilaufgaben aufteilen und zusammengesetzte Gesprächsphasen modellieren, wobei jede Phase über Eingabe- und Ausgabeparameter kommuniziert.

Ein Aufgaben-Playbook, das als Aufrufer fungiert, ruft ein anderes Aufgaben-Playbook auf, das als Aufgerufener fungiert:

1. Der Aufrufer startet den Aufgerufenen.
2. Der Aufrufer stellt dem Aufgerufenen die erforderlichen Eingabeparameter zur Verfügung.
3. Der Aufgerufene verarbeitet diese Informationen, führt die vorgesehene Funktion aus und gibt Ausgabeparameter zurück.
4. Der Aufrufer empfängt Parameter vom Aufgerufenen.

Jedes Routine- oder Aufgaben-Playbook kann ein anderes Aufgaben-Playbook aufrufen, aber ein Aufgaben-Playbook kann kein anderes Routine-Playbook aufrufen.

Routine-Playbooks

Routine-Playbooks sind eine neue Art von Playbook. Sie werden für die Modellierung von sequenziellen Gesprächsphasen verwendet, wobei jede Phase abgeschlossen und unabhängig ist. Diese können Aufgaben-Playbooks aufrufen, um größere Aufgaben in kleinere Teilaufgaben zu zerlegen, und zu anderen Routine-Playbooks oder ‑Abläufen wechseln.

In der folgenden Liste wird der Übergang von Routine-Playbook A zu Routine-Playbook B und dann zu Ablauf C dargestellt:

1. Routine-Playbook A liest Sitzungsparameter beim Start und schreibt Sitzungsparameter kurz vor dem Beenden.
2. Routine-Playbook A wird beendet und es wird zu Routine-Playbook B gewechselt.
3. Routine-Playbook B liest Sitzungsparameter beim Start und schreibt Sitzungsparameter kurz vor dem Beenden.
4. Routine-Playbook B wird beendet und wechselt zu Flow C.
5. Ablauf C liest und schreibt Sitzungsparameter.

Wenn ein Routine-Playbook nicht zu einem anderen Routine-Playbook oder Ablauf wechselt, kehrt die Sitzung zum letzten aktiven Ablauf zurück oder wird beendet, wenn es keinen gibt.

Für Routine-Playbooks gilt das folgende Verhalten bei der Parameterverwaltung:

• Wenn ein Routine-Playbook aufgerufen wird, werden seinen Eingabeparametern Werte zugewiesen, die den Sitzungsparametern mit demselben Namen entsprechen.
• Wenn ein Routine-Playbook beendet wird, werden Werte für die Ausgabeparameter generiert und Sitzungsparametern mit demselben Namen zugewiesen.

Playbook-Typen vergleichen

Kategorie	Aufgaben-Playbook	Routine-Playbook
Latenz	Jedes Mal, wenn ein Aufgaben-Playbook ein anderes Aufgaben-Playbook aufruft, wird ein LLM-Aufruf ausgeführt. Bei einer langen Kette von Aufgaben-Playbooks in einer Gesprächsrunde kann dies die Latenz erhöhen.	Jedes Routine-Playbook in einer Reihe von Übergängen wird innerhalb eines einzelnen Gesprächsbeitrags ausgeführt. Es gibt also nur einen einzigen LLM-Aufruf und die Latenz ist geringer.
Parameterneugenerierung	Wenn ein Aufgaben-Playbook ein anderes Aufgaben-Playbook aufruft, müssen die Parameterwerte neu generiert werden. Wenn es eine lange Kette von Aufgaben-Playbooks gibt, kann diese Neugenerierung zu Kontextverlust führen.	Routine-Playbooks verwenden den Sitzungsspeicher für Parameter, was einen zuverlässigeren Kontext schafft.
Integration von Sitzungsparametern	Aufgaben-Playbooks funktionieren nicht gut mit Sitzungsparametern. Stattdessen müssen Eingabe- und Rückgabeparameter definiert werden.	Routine-Playbooks lassen sich gut mit Sitzungsparametern kombinieren.
Wiederverwendung	Da jedes Aufgaben-Playbook eine feste über-/untergeordnete Beziehung hat, sind die Aufgaben eng gekoppelt.	Routine-Playbooks können unabhängig voneinander definiert werden.

Standard-Playbook

Wenn Sie einen generativen Agenten mit der Conversational Agents-Konsole erstellen, erstellt Dialogflow CX automatisch ein generatives Standard-Playbook.

Das Standard-Playbook ist der Ausgangspunkt für Unterhaltungen und unterscheidet sich in einigen wichtigen Punkten von anderen Playbooks:

• Das Standard-Playbook erhält keine Zusammenfassung der vorherigen Gesprächsrunden.
• Das Standard-Playbook kann keine Eingabeparameter definieren oder empfangen.

Playbook erstellen

So erstellen Sie ein Playbook:

1. Klicken Sie im Navigationsmenü der Console auf das Playbook-Symbol.
2. Klicken Sie auf Erstellen.
3. Wählen Sie entweder den Playbook-Typ Routine oder Aufgabe aus.
4. Playbook-Daten angeben.

Playbook mit KI erstellen

Wenn Sie ein Playbook erstellen, wird ein Bereich für generative KI geöffnet. So können Sie Playbook-Daten generieren.

Playbooks importieren und exportieren

Nachdem Sie Playbooks mit der Conversational Agents-Konsole erstellt haben, können Sie diese Playbooks für die Verwendung in einem anderen Agenten exportieren.

So exportieren Sie ein Playbook:

1. Rufen Sie die Playbook-Liste auf.
2. Wählen Sie das Playbook aus, das Sie exportieren möchten, und klicken Sie auf Exportieren.
3. Wählen Sie die Exportoptionen aus und klicken Sie auf Exportieren.

So importieren Sie ein zuvor exportiertes Playbook:

1. Rufen Sie die Playbook-Liste auf.
2. Wählen Sie das Playbook aus, das Sie importieren möchten, und klicken Sie auf Importieren.
3. Wählen Sie die Importoptionen aus und klicken Sie auf Importieren.