Playbooks

Ein Playbook ist der grundlegende Baustein generativer Agents. Ein generativer Agent hat in der Regel viele Playbooks, wobei jedes Playbook für die Verarbeitung 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 den Modellen gemini-2.0-flash und gemini-1.5-flash-002 auf Qualität getestet.

Wenn Sie andere Sprachen als Englisch verwenden, sollten Sie Ihre Beispiele in der Zielsprache definieren, während die Anweisungen auf Englisch bleiben. Bei bestimmten Sprachen und Anwendungsfällen erhalten Sie möglicherweise etwas bessere Antworten, wenn Sie zusätzlich Anweisungen in der Zielsprache angeben.

Modellunterstützung

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

• Wählen Sie das LLM-Modell auf Agent-Ebene aus.

  • Wählen Sie in der Conversational Agents Console unter „Agent-Einstellung“ > „Generative KI“ > „Playbook“ das Modell anhand des Anzeigenamens aus dem Drop-down-Menü mit allen verfügbaren Modellen 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 Agent 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 Agenten über die API testen (siehe DetectIntentRequest).

Modellname	Modellspezifikation	Markteinführungsphase
gemini-2.0-flash-001	Gemini 2.0 Flash	GA
gemini-2.0-flash-lite-001	Gemini 2.0 Flash Lite	Öffentliche Vorschau
gemini-2.5-flash	Gemini 2.5 Flash	Öffentliche Vorschau
gemini-1.5-flash-001	Gemini 1.5 Flash	Alt
gemini-1.5-flash-002	Gemini 1.5 Flash	Alt

Unterstützung von 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: Definiert die Prozessschritte, die zur Erreichung 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, Nutzer-Systeminformationen und Ergebnisse von Aktionen.

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 Unteraufgaben aufzuteilen. Sie werden für die Modellierung von kompositionellen Unterhaltungsphasen verwendet, in denen jede Phase über Ein- und Ausgabeparameter kommuniziert.

Im Folgenden sehen Sie ein Aufgaben-Playbook (Aufrufer), das ein anderes Aufgaben-Playbook (aufgerufene Funktion) aufruft:

1. Der Anrufer ruft den Empfänger an.
2. Der Aufrufer stellt dem Aufgerufenen die erforderlichen Eingabeparameter zur Verfügung.
3. Der Aufgerufene verarbeitet diese Informationen, führt die 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 Unterhaltungsphasen verwendet, wobei jede Phase abgeschlossen und unabhängig ist. Sie können Task-Playbooks aufrufen, um größere Aufgaben in kleinere Unteraufgaben zu zerlegen, und zu anderen Routine-Playbooks oder ‑Abläufen wechseln.

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

1. Im Ablauf A können Sitzungsparameter gelesen werden, wenn er gestartet wird, und Sitzungsparameter können kurz vor dem Beenden geschrieben werden.
2. Der Ablauf A wird beendet und es wird zum Ablauf B gewechselt.
3. Im Routine-Playbook B können Sitzungsparameter beim Start gelesen und kurz vor dem Beenden geschrieben werden.
4. Der 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, kehrt die Sitzung zum letzten aktiven Ablauf zurück oder wird beendet, wenn kein solcher Ablauf vorhanden ist.

Für Routine-Playbooks gilt Folgendes in Bezug auf die 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 seine Ausgabeparameter generiert und Sitzungsparametern mit demselben Namen zugewiesen.

Standard-Leitfaden

Wenn Sie einen generativen Agenten mit der Konsole für Konversations-Agenten 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 die Schaltfläche Neu 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. Damit können Sie Playbook-Daten generieren lassen.

Playbooks importieren und exportieren

Nachdem Sie Playbooks mit der Konsole für Konversations-Agents erstellt haben, können Sie sie exportieren, um sie in einem anderen Agent zu verwenden. So exportieren Sie ein Playbook:

1. Rufen Sie die Liste der Playbooks auf.
2. Klicken Sie auf die Schaltfläche „Exportieren“ 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.