Playbooks

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

Ein Playbook ist der grundlegende Baustein von generativen Agents. 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, Anfragen an externe Dienste senden oder die Konversationsbearbeitung an einen Ablauf oder ein anderes Playbook delegieren, um untergeordnete Aufgaben zu erledigen.

Beschränkungen

Es gelten folgende Einschränkungen:

• Bei Agents, die Playbooks verwenden, wird das Senden einer SMS für den Anruf-Companion über die Route „Standard-Begrüßungs-Intent“ im Standardstartablauf nicht unterstützt. Sie können die Option für SMS für den Anruf-Companion jedoch in Standardabläufen aktivieren.
• Playbooks unterstützen keine DTMF-Eingabe von Telefonsystemen.

Sprachunterstützung

Sehen Sie sich die Spalte Playbooks in der Sprachreferenz an. Die für Playbooks markierten Sprachen wurden mit gemini-2.5-flash-Modellen auf Qualität getestet.

Wenn Sie andere Sprachen als Englisch verwenden:

• In den meisten Fällen sollten Sie Englisch für Playbook-Anleitungen verwenden. Bei bestimmten Sprachen und Anwendungsfällen erhalten Sie möglicherweise etwas bessere Antworten, wenn Sie zusätzlich Anweisungen in der Zielsprache angeben.
• Geben Sie in der Playbook-Anleitung an, welche Sprachen Sie unterstützen. Beispiel: „Antworte immer auf Französisch.“
• Definieren Sie Ihre Beispiele in der Zielsprache.

Modellunterstützung

Sie können das im 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 Console unter „Agent setting“ -> „Generative AI“ -> „Playbook“ das Modell anhand des Anzeigenamens aus dem Drop-down-Menü aller 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 (siehe GenerativeSettings).

• Überschreiben der Modellauswahl auf Anfrageebene.

  • Wählen Sie im Simulator der Conversational Agents Console beim Testen eines Playbooks das Modell anhand des Anzeigenamens aus dem Drop-down-Menü aus.
  • Geben Sie den Modellnamen im Feld „DetectIntentRequest.query_params.llm_model_settings.model“ an, wenn Sie den Agent über die API testen (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

Unterstützte Regionen

Playbooks werden in den folgenden Regionen unterstützt:

• global
• asia-south1
• asia-southeast1
• asia-southeast2
• asia-northeast1
• australia-southeast1
• eu (mehrere Regionen)
• europe-west1
• europe-west2
• europe-west3
• europe-west4
• europe-west6
• northamerica-northeast1
• us (mehrere Regionen)
• 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: Allgemeine Beschreibung dessen, was mit dem Playbook erreicht werden soll
• Anleitung: Hier werden die Prozessschritte definiert, die zum Erreichen des Ziels erforderlich sind.
• Beispiele: Beispielunterhaltungen, die effektiv Beispiele für Few-Shot-Prompts für das LLM sind
• Parameter: Dienen zum Speichern von Informationen zu einer Unterhaltung, z. B. Nutzereingaben, Systeminformationen des Nutzers und Ergebnisse von Aktionen.

LLM-Prompt

Für jede Unterhaltung verwendet Dialogflow CX Ihre Playbook-Daten für die Designzeit und die Unterhaltungsdaten für die Laufzeit, um einen LLM-Prompt innerhalb der Token-Limits zu erstellen. Der Inhalt dieses Prompts wird im Folgenden 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 gewünschten Typ aus: Aufgaben-Playbook oder Routine-Playbook.

Aufgaben-Playbooks

Aufgaben-Playbooks sind der ursprüngliche Playbook-Typ. Sie werden verwendet, um komplexe Aufgaben in kleinere, wiederverwendbare Teilaufgaben aufzuteilen. Sie werden für die Modellierung von zusammengesetzten Gesprächsphasen verwendet, wobei jede Phase über Eingabe- und Ausgabeparameter kommuniziert.

Im Folgenden sehen Sie, wie ein Aufgaben-Playbook (Aufrufer) ein anderes Aufgaben-Playbook (Aufgerufener) aufruft:

1. Der Anrufer ruft den Angerufenen an.
2. Der Aufrufer stellt dem Empfänger die erforderlichen Eingabeparameter zur Verfügung.
3. Der Aufgerufene verarbeitet diese Informationen, führt seine zugewiesene Funktion aus und gibt Ausgabeparameter zurück.
4. Der Anrufer erhält Parameter vom Angerufenen.

In jedem Routine- oder Aufgaben-Playbook kann ein anderes Aufgaben-Playbook aufgerufen werden, aber in einem Aufgaben-Playbook kann kein anderes Routine-Playbook aufgerufen werden.

Routine-Playbooks

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

Das folgende Beispiel zeigt ein Routine-Playbook (A), das in ein anderes Routine-Playbook (B) und dann in einen Ablauf (C) übergeht:

1. Routine-Playbook A kann beim Start Sitzungsparameter lesen und kurz vor dem Beenden Sitzungsparameter schreiben.
2. Routine-Playbook A wird beendet und es wird zu Routine-Playbook B gewechselt.
3. Routine-Playbook B kann beim Start Sitzungsparameter lesen und kurz vor dem Beenden Sitzungsparameter schreiben.
4. Routine-Playbook B wird beendet und es wird zu Ablauf C gewechselt.
5. In Flow C können Sitzungsparameter gelesen und geschrieben werden.

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

Routine-Playbooks haben das folgende Verhalten bei der Parameterverwaltung:

• Wenn ein Routine-Playbook aufgerufen wird, werden seinen Eingabeparametern Werte zugewiesen, die 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, erfolgt ein LLM-Aufruf. Bei einer langen Kette von Aufgaben-Playbooks in einem Konversationsdurchgang kann dies die Latenz erhöhen.	Jedes Routine-Playbook in einer Reihe von Übergängen erfolgt in einem einzigen Gesprächsbeitrag. Es gibt also nur einen einzigen LLM-Aufruf und eine verbesserte Latenz.
Parameter neu generieren	Wenn in einem Aufgaben-Playbook ein anderes Aufgaben-Playbook aufgerufen wird, müssen die Parameterwerte neu generiert werden. Wenn es eine lange Kette von Task-Playbooks gibt, kann diese Neuerstellung zu einem Kontextverlust führen.	Routine-Playbooks verwenden den Sitzungsspeicher für Parameter, wodurch ein zuverlässigerer Kontext entsteht.
Integration von Sitzungsparametern	Aufgaben-Playbooks sind nicht gut mit Sitzungsparametern kompatibel. Stattdessen müssen Ein- 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 miteinander verknüpft.	Routine-Playbooks können unabhängig voneinander definiert werden.

Standard-Leitfaden

Wenn Sie einen generativen Agenten mit der Conversational Agents-Konsole erstellen, wird automatisch ein Standard-Generative-Playbook erstellt.

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

• Das Standard-Playbook erhält keine Zusammenfassung der vorherigen Gesprächsrunden.
• Im Standard-Playbook können keine Eingabeparameter definiert oder empfangen werden.

Playbook erstellen

So erstellen Sie ein Playbook:

1. Klicken Sie in der Konsolen-Navigation auf der linken Seite auf das Playbook-Symbol.
2. Klicken Sie auf den Button Neu erstellen.
3. Wählen Sie entweder Routine oder Aufgabe als Playbook-Typ aus.
4. Playbook-Daten bereitstellen

Playbook mit KI erstellen

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

Playbooks importieren und exportieren

Nachdem Sie Playbooks mit der Conversational Agents-Konsole erstellt haben, können Sie sie exportieren, um sie in einem anderen Agenten zu verwenden. So exportieren Sie ein Playbook:

1. Rufen Sie die Liste der Playbooks auf.
2. Klicken Sie auf den Exportbutton für das Playbook, das Sie exportieren möchten.
3. Wählen Sie Exportoptionen aus.
4. Klicken Sie auf Exportieren.

So importieren Sie ein Playbook, das Sie zuvor exportiert haben:

1. Rufen Sie die Liste der Playbooks auf.
2. Klicken Sie auf Importieren.
3. Wählen Sie Importoptionen aus.
4. Klicken Sie auf Importieren.