Ein Playbook ist der grundlegende Baustein generativer Bots. 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, Abfragen an externe Dienste senden oder die Unterhaltungsverwaltung an einen Ablauf oder ein anderes Playbook übergeben, um untergeordnete Aufgaben zu erledigen.
Beschränkungen
Es gelten folgende Einschränkungen:
- Bei Kundenservicemitarbeitern, die Playbooks verwenden, wird das Senden einer Anruf-Begleiter-SMS über die Route „Standard-Begrüßungs-Intent“ im Standardstartablauf nicht unterstützt. Sie können die Option für Anruf-Begleiter-SMS jedoch in Standardabläufen aktivieren.
Sprachunterstützung
Weitere Informationen finden Sie in der Sprachreferenz in der Spalte Playbooks.
Die für Playbooks gekennzeichneten Sprachen wurden mit gemini-2.0-flash- und gemini-1.5-flash-002-Modellen auf Qualität getestet.
Wenn Sie eine andere Sprache als Englisch verwenden, sollten Sie Ihre Beispiele in der Zielsprache definieren und die Anleitung auf Englisch belassen. Bei bestimmten Sprachen und Anwendungsfällen erhalten Sie möglicherweise etwas bessere Antworten, wenn Sie zusätzlich eine Anleitung 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 Agentebene aus.
- Wählen Sie in der Konsole für Konversationsagenten unter „Agent-Einstellungen“ -> „Generative KI“ -> „Playbook“ im Drop-down-Menü mit allen verfügbaren Modellen das gewünschte Modell anhand des Anzeigenamens aus.
- Geben Sie den Modellnamen im Feld „GenerativeSettings.llm_model_settings.model“ an, wenn Sie die Kundenservicemitarbeitereinstellung mithilfe der API aktualisieren (siehe GenerativeSettings).
Modellauswahl auf Anfrageebene überschreiben
- Wählen Sie im Simulator der Conversational Agent Console beim Testen eines Playbooks das Modell im Drop-down-Menü nach dem Anzeigenamen aus.
- Geben Sie den Modellnamen im Feld „DetectIntentRequest.query_params.llm_model_settings.model“, wenn Sie den Kundenservicemitarbeiter über die API testen (siehe DetectIntentRequest).
| Modellname | Anzeigename des Modells | Modellspezifikation | Markteinführungsphase | Verfügbare Region |
|---|---|---|---|---|
| gemini-pro | gemini-1.0-pro-001 | Gemini 1.0 Pro | GA | Alle Playbook-Regionen |
| gemini-1.5-flash | gemini-1.5-flash-001 | Gemini 1.5 Flash | GA | Alle Playbook-Regionen |
| gemini-1.5-flash-002 | gemini-1.5-flash-002 | Gemini 1.5 Flash 002 | Öffentliche Vorschau | Alle Playbook-Regionen |
| gemini-2.0-flash-001 | gemini-2.0-flash-001 | Gemini 2.0 Flash | Öffentliche Vorschau | In mehreren Regionen in der EU, in den USA und in einzelnen Regionen, die von Vertex AI unterstützt werden. |
Regionsunterstützung
Playbooks werden in den folgenden Regionen unterstützt:
globalasia-south1asia-southeast1asia-northeast1australia-southeast1eu(mehrere Regionen)europe-west1europe-west2europe-west3northamerica-northeast1us(mehrere Regionen)us-central1us-east1us-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 das Playbook erreichen soll.
- Anleitung: Hier werden die Prozessschritte definiert, die zum Erreichen des Ziels erforderlich sind.
- Beispiele: Konversationsbeispiele, die effektiv als Few-Shot-Prompts für das LLM dienen
- Parameter: Sie werden verwendet, um Informationen zu einer Unterhaltung zu speichern, z. B. Nutzereingaben, Nutzersysteminformationen und Ergebnisse von Aktionen.
Playbook-Typen
Wenn Sie ein Playbook erstellen, wählen Sie den gewünschten Playbook-Typ aus: Playbook für Aufgaben oder Playbook für Abläufe.
Playbooks für Aufgaben
Aufgaben-Playbooks sind der ursprüngliche Playbook-Typ. Sie werden verwendet, um komplexe Aufgaben in kleinere, wiederverwendbare Teilaufgaben aufzuteilen. Sie werden zum Modellieren von zusammengesetzten Unterhaltungsphasen verwendet, bei denen jede Phase über Eingabe- und Ausgabeparameter kommuniziert.
Im Folgenden wird ein Aufgaben-Playbook (Caller) gezeigt, das ein anderes Aufgaben-Playbook (Callee) aufruft:
- Der Anrufer startet den Anruf.
- Der Aufrufer stellt dem Gerufenen die erforderlichen Eingabeparameter zur Verfügung.
- Der aufgerufene Code verarbeitet diese Informationen, führt die angegebene Funktion aus und gibt Ausgabeparameter zurück.
- Der Aufrufer empfängt Parameter vom Gerufenen.
Jedes Playbook für Abläufe oder Aufgaben kann ein anderes Playbook für Aufgaben aufrufen, ein Playbook für Aufgaben kann jedoch kein anderes Playbook für Abläufe aufrufen.
Playbooks für Abläufe
Playbooks für Abläufe sind eine neue Art von Playbook. Sie werden zum Modellieren sequenzieller Unterhaltungsphasen verwendet, wobei jede Phase vollständig und unabhängig ist. Sie können Aufgaben-Playbooks aufrufen, um größere Aufgaben in kleinere Teilaufgaben aufzuteilen, und zu anderen Routine-Playbooks oder ‑Abläufen wechseln.
Im Folgenden wird ein Ablauf-Playbook (A) gezeigt, das zu einem anderen Ablauf-Playbook (B) und dann zu einem Ablauf (C) übergeht:
- Das Ablauf-Playbook A kann Sitzungsparameter beim Starten lesen und kurz vor dem Beenden Sitzungsparameter schreiben.
- Das Routine-Playbook A wird beendet und es erfolgt ein Übergang zu Routine-Playbook B.
- Das Routine-Playbook B kann Sitzungsparameter beim Starten lesen und kurz vor dem Beenden Sitzungsparameter schreiben.
- Das Ablauf-Playbook B wird beendet und es wird zu Ablauf C gewechselt.
- Ablauf C kann Sitzungsparameter lesen und schreiben.
Wenn ein Playbook für Abläufe nicht zu einem anderen Playbook oder Ablauf für Abläufe wechselt, kehrt die Sitzung zum letzten aktiven Ablauf zurück oder wird beendet, falls es keinen gibt.
Bei Routine-Playbooks gilt für die Parameterverwaltung Folgendes:
- Wenn ein Routine-Playbook eingegeben wird, werden seinen Eingabeparametern Werte zugewiesen, die den Sitzungsparametern mit demselben Namen entsprechen.
- Wenn ein Routine-Playbook beendet wird, generiert es Werte für seine Ausgabeparameter und weist sie Sitzungsparametern mit demselben Namen zu.
Standard-Playbook
Wenn Sie einen generativen Agenten mit der Conversational Agents Console erstellen, wird automatisch ein Standard-generatives 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ächsschritte.
- Das Standard-Playbook kann keine Eingabeparameter definieren oder empfangen.
Playbooks importieren und exportieren
Nachdem Sie Playbooks mit der Konsole für Konversations-Agenten erstellt haben, können Sie diese Playbooks zur Verwendung in einem anderen Agenten exportieren. So exportieren Sie ein Playbook:
- Rufen Sie die Liste der Playbooks auf.
- Klicken Sie auf die Schaltfläche „Exportieren“ für das Playbook, das Sie exportieren möchten.
- Wählen Sie die Exportoptionen aus.
- Klicken Sie auf Exportieren.
So importieren Sie ein zuvor exportiertes Playbook:
- Rufen Sie die Liste der Playbooks auf.
- Klicken Sie auf Importieren.
- Wählen Sie die Importoptionen aus.
- Klicken Sie auf Importieren.