Best Practices für Playbooks

Mit den folgenden Best Practices können Sie robuste Agents erstellen.

Playbook-Name in natürlicher Sprache

Playbook-Namen sollten klar, beschreibend und in natürlichem Englisch sein. Das trägt zur Leistung des KI-Generators zur Laufzeit bei. Beispielsweise ist „Customer Help Center Playbook“ besser als „company_specialist“.

Alle Namen dürfen maximal 64 Zeichen lang sein, einschließlich Buchstaben des englischen Alphabets und Leerzeichen.

Prägnante Zielvorhaben

Zielvorhaben sollten eine prägnante Beschreibung des Zwecks des Playbooks sein.

Hochwertige Anweisungen bereitstellen

Anweisungen sollten:

  • den schrittweisen Ansatz zur Lösung eines Endnutzerproblems widerspiegeln
  • prägnante Sätze in natürlicher Sprache mit Anweisungen auf hoher Ebene sein
  • einfach sein und die Szenarien für die Toolnutzung angeben

Mindestens ein Beispiel für jedes Playbook

Sie sollten mindestens ein Beispiel für jedes Playbook haben, aber mindestens vier werden empfohlen. Beispiele sollten Happy-Path-Szenarien enthalten.

Ohne genügend Beispiele führt ein Playbook wahrscheinlich zu unvorhersehbarem Verhalten. Wenn Ihr Playbook nicht reagiert oder sich nicht wie erwartet verhält, sind fehlende oder schlecht definierte Beispiele wahrscheinlich die Ursache. Versuchen Sie, Ihre Beispiele zu verbessern oder neue hinzuzufügen.

Genauigkeit von Anweisungen und Beispielen

Es ist zwar hilfreich, klare und beschreibende Anweisungen zu schreiben, aber die Genauigkeit des Playbook-Verhaltens wird hauptsächlich durch die Qualität und Quantität Ihrer Beispiele bestimmt. Mit anderen Worten: Investieren Sie mehr Zeit in das Schreiben umfassender Beispiele als in das Verfassen perfekt präziser Anweisungen.

Tools in Beispielen referenzieren

Wenn das Playbook so konzipiert ist, dass Antworten mithilfe von Tools bereitgestellt werden, referenzieren Sie die Tools in den Beispielen, die dieser Art von Anfrage entsprechen.

Feld operationId des Toolschemas

Beim Definieren von Schemas für Ihre Tools ist der Wert operationId wichtig. In den Anweisungen für Ihr Playbook wird auf diesen Wert verwiesen. Im Folgenden finden Sie Empfehlungen für die Benennung dieses Felds:

  • Nur Buchstaben, Zahlen und Unterstriche.
  • Muss unter allen operationIds, die im Schema beschrieben sind, eindeutig sein.
  • Muss ein aussagekräftiger Name sein, der die bereitgestellte Funktion widerspiegelt.

Toolschema-Validierung

Sie sollten Ihr Toolschema validieren. Mit dem Swagger Editor können Sie die Syntax Ihres OpenAPI 3.0-Schemas prüfen.

Leere Toolergebnisse verarbeiten

Wenn Ihr Playbook auf ein Tool angewiesen ist, um seine Antwort zu formulieren, kann ein leeres Toolergebnis zu unvorhersehbarem Playbook-Verhalten führen. Manchmal halluziniert der KI-Generator des Playbooks Informationen in einer Antwort anstelle eines Toolergebnisses. Um dies zu verhindern, können Sie bestimmte Anweisungen hinzufügen, damit der KI-Generator des Playbooks nicht versucht, selbst zu antworten.

In einigen Anwendungsfällen müssen Playbook-Antworten auf Toolergebnissen oder bereitgestellten Daten basieren und Antworten, die nur auf dem Wissen des KI-Generators des Playbooks beruhen, müssen vermieden werden.

Beispiele für Anweisungen zur Vermeidung von Halluzinationen:

  • „Sie müssen das Tool verwenden, um alle Fragen des Nutzers zu beantworten.“
  • „Wenn Sie keine Daten vom Tool erhalten, antworten Sie, dass Sie die Antwort auf die Anfrage des Nutzers nicht kennen.“
  • „Erfinden Sie keine Antwort, wenn Sie keine Daten vom Tool erhalten.“

Schema mit Gemini generieren

Gemini kann ein Schema für Sie generieren. Versuchen Sie beispielsweise „Kannst du ein Beispiel für ein OpenAPI 3.0-Schema für Google Kalender erstellen?“.

Fokussierte Playbooks

Vermeiden Sie es, sehr große und komplexe Playbooks zu erstellen. Jedes Playbook sollte eine bestimmte und klare Aufgabe erfüllen. Wenn Sie ein komplexes Playbook haben, sollten Sie es in kleinere Unter-Playbooks aufteilen.

Schleifen und Rekursion vermeiden

Erstellen Sie keine Schleifen oder Rekursionen, wenn Sie Agents in Ihren Anweisungen verknüpfen. Eine Schleife kann auftreten, wenn Sie versuchen, zu einem übergeordneten Playbook weiterzuleiten, das das aktuelle Playbook direkt oder indirekt aufgerufen hat.

Routinginformationen für Beispiele bereitstellen

Wenn ein Playbook zu einem anderen Playbook weiterleiten soll, müssen Sie diese Informationen für die Beispiele bereitstellen. Diese Informationen werden einem Beispiel aus dem Feld Beispiel mit Ausgabedaten beenden des Beispielabschnitts Ein- und Ausgabe bereitgestellt.

Der letzte Satz dieses Felds könnte beispielsweise „Leiten Sie weitere Anfragen an das Standard-Playbook weiter“ lauten.

Dialogflow CX Messenger-JavaScript-Funktionen für die Personalisierung verwenden

Wenn Sie Dialogflow CX Messenger verwenden, sind die folgenden Funktionen nützlich, um Informationen zur Nutzerpersonalisierung über die Weboberfläche an das Playbook zu senden:

Leistung planen

Generative Funktionen benötigen in der Regel mehrere Sekunden oder sogar Dutzende von Sekunden, um eine Antwort zu generieren. Playbooks verbessern zwar die Natürlichkeit von Unterhaltungen, aber es ist wichtig, die Antwortzeiten zu verwalten, um eine positive Endnutzererfahrung zu gewährleisten. Hier sind einige Strategien zur Leistungsoptimierung:

  • Verwendung generativer Funktionen ausbalancieren

    Berücksichtigen Sie sorgfältig den Kompromiss zwischen der Zeit, die für die Ausführung mehrerer generativer Funktionen erforderlich ist, und dem Wert, den sie für die Unterhaltung bringen. Vermeiden Sie die übermäßige Verwendung dieser Funktionen, wenn sie nicht wesentlich zum Ziel des Nutzers beitragen.

  • Eingabe für generative Funktionen minimieren

    Erheben und verarbeiten Sie nur die Mindestmenge an Informationen, die ein KI-Generator benötigt, um eine nützliche Antwort zu generieren. Dadurch kann die Verarbeitungszeit erheblich verkürzt werden.

  • Kontext-Caching verwenden

    Wenn Sie Gemini über ein Tool verwenden und einen großen anfänglichen Kontext haben, können Sie Informationen mit Vertex AI Context Caching im Cache speichern, um wiederholte Anfragen nach denselben Daten zu vermeiden. Feste Antworten für mehr Geschwindigkeit implementieren:

    Wenn Ihre Anwendung keine eindeutigen, dynamischen Inhalte erfordert, können Sie häufig verwendete Antworten in einer herkömmlichen Datenbank wie Firebase speichern. Da diese festen Antworten vordefiniert und sofort verfügbar sind, bieten sie viel schnellere Antwortzeiten als eine generative Funktion, die eine Antwort spontan berechnen muss.

  • KI-Generator anweisen, prägnante Playbook-Antworten zu erstellen

    Bei der Texteingabe und -ausgabe hängt die Antwortzeit des KI-Generators stark vom verwendeten Modell und der Länge der Ausgabe ab. Kurze Antworten können die Leistung erheblich verbessern. Die Länge der Eingabe spielt zwar auch eine Rolle, aber die Länge der Ausgabe hat einen größeren Einfluss.