Agent mit Playbooks erstellen

Hinweis: In der Agent Builder-Konsole werden Playbooks weiterhin als Kundenservicemitarbeiter bezeichnet. Dies wird demnächst in der Console auf Playbook aktualisiert.

In dieser Anleitung erfahren Sie, wie Sie mithilfe von Playbooks einen einfachen Agenten für die Bestellung von T-Shirts erstellen und testen. Bei der Interaktion mit diesem Agent können Sie nach dem Filialstandort und den Öffnungszeiten fragen und eine Hemdbestellung aufgeben.

Hinweis

Bevor Sie diese Anleitung lesen, sollten Sie mit Folgendem vertraut sein:

1. Falls noch nicht geschehen, folgen Sie der Anleitung zu Dialogflow Einrichtung Anleitung.

Playbooks

Ein Agent besteht aus einem oder mehreren Playbooks. Jedes Playbook hat einen klar definierten und begrenzten Umfang. Ein Playbook enthält die folgenden Daten:

X	Element
Name	Ein Name, mit dem das Playbook identifiziert wird.
Ziel	Ziele sind allgemeine Beschreibungen dessen, was das Playbook erreichen soll.
Anleitung	Anleitungen sind übergeordnete Schritte, die ausgeführt werden sollten, um das Ziel des Playbooks zu erreichen.
Beispiele	Beispiele sind Beispielunterhaltungen zwischen einem Endnutzer und dem Kundenservicemitarbeiter. Diese Beispiele sind im Grunde Few-Shot-Prompts für das LLM.

Agent erstellen

So erstellen Sie den Agent:

1. Rufen Sie die Agent Builder-Konsole auf:

   Agent Builder-Konsole

2. Wählen Sie Ihr Projekt aus dem Drop-down-Menü der Konsole aus.

3. Falls Sie die API noch nicht aktiviert haben, Lesen und akzeptieren Sie die Nutzungsbedingungen und klicken Sie dann auf Fortfahren und aktivieren der API.

4. Klicken Sie auf Neue App erstellen oder Neue App.

5. Wählen Sie Agent aus.

6. „Assistent zum Bestellen von T-Shirts“ bereitstellen für den App-Namen.

7. Wählen Sie eine Region aus.

8. Klicken Sie auf Erstellen.

9. Über die Benutzeroberfläche gelangen Sie zum Standard-Playbook mit dem Namen Standard-Agent.

10. Klicken Sie auf die Schaltfläche „Zurück“, um die Liste der Playbooks aufzurufen.

Bestell-Playbook erstellen

Bestellungen von T-Shirts werden im Playbook Order verarbeitet. So erstellen Sie dieses Playbook:

1. Klicken Sie auf Erstellen.
2. Geben Sie den Namen ein: Order.

3. Geben Sie das folgende Zielvorhaben ein:

   You are a shirt store ordering assistant. Help customers purchase shirts.
   Help the customer choose a size and color.
   The shirts come in small, medium, and large.
   The shirts can be red, green, or blue.
   

4. Führen Sie die folgenden Schritte aus:

   - If the customer has not provided a size, ask them to choose a size.
   - If the customer has not provided a color, ask them to choose a color.
   - Once the customer has selected a size and color for the shirt,
     repeat the selection to the customer, and ask them to confirm the selection.
   - Once the customer has confirmed their selection,
     let them know that the shirt is now ordered.
   - Do not provide prices or collect payment.
   - Do not collect the customer's name or address.
   

5. Klicken Sie auf Speichern.

   

6. Klicken Sie auf die Schaltfläche „Zurück“, um zur Playbook-Liste zurückzukehren.

Informations-Playbook erstellen

Im Playbook Informationen werden Fragen zum Store beantwortet. So erstellen Sie dieses Playbook:

1. Klicken Sie auf Erstellen.
2. Geben Sie den Namen ein: Information.

3. Geben Sie das folgende Zielvorhaben ein:

   You provide information about a shirt store.
   The store is open between 8 AM and 6 PM every day.
   The store is located at 1007 Mountain Drive, Gotham City, NJ.
   

4. Führen Sie die folgenden Schritte aus:

   - If the customer asks for the store location, provide them with the address.
   - If the customer asks for the store hours, provide them with the hours.
   

5. Klicken Sie auf Speichern.

6. Klicken Sie auf die Schaltfläche „Zurück“, um zur Playbook-Liste zurückzukehren.

Standard-Playbook aktualisieren

Beim Erstellen der Anwendung wurde ein Standard-Playbook für Sie erstellt. Dieses Playbook sollte die Unterhaltung auf die entsprechenden Playbooks mit bestimmten Zielen lenken. In der Anleitung unten sehen Sie, wie das Standard-Playbook auf die anderen Playbooks verweist. So aktualisieren Sie dieses Playbook:

1. Klicken Sie auf das Standard-Playbook. Dieses Playbook ist mit einem hervorgehobenen Stern gekennzeichnet.

2. Geben Sie das folgende Zielvorhaben ein:

   You are an assistant for a shirt store.
   Your name is "Samantha".
   Your job is to direct customers to other playbooks based on the customer's questions.
   

3. Führen Sie die folgenden Schritte aus:

   - If the customer hasn't been greeted yet, greet the customer,
     introduce yourself, and ask the user how you can help.
   - If the customer wants information about the store,
     route them to ${AGENT: Information}
   - If the customer wants to purchase a shirt,
     route them to ${AGENT: Order}
   

4. Klicken Sie auf Speichern.

5. Klicken Sie auf die Schaltfläche „Zurück“, um zur Playbook-Liste zurückzukehren.

Beispiele nennen

Ihr Playbook ist jetzt einsatzbereit. Sie müssen jedoch Beispiele angeben, um qualitativ hochwertige Antworten zu erhalten.

Wenn Sie ein Playbook geöffnet haben, können Sie auf dem Tab Beispiele manuell Beispiele angeben. Es ist jedoch oft einfacher, ein Gespräch mit dem funktionierenden Playbook zu führen und das Gespräch als Beispiel zu speichern.

Eine Beispielunterhaltung mit einem Standard-Playbook ist kurz. Dieses Playbook muss Sie nur zu einem anderen Playbook weiterleiten. So führen Sie eine Unterhaltung mit dem Standard-Playbook:

1. Schließen oder schließen Sie alle Bereiche, die sich rechts auf dem Bildschirm befinden. Sie möchten den Simulatorbereich mit der Option Nachricht senden, um zu sehen, wie der Kundenservicemitarbeiter reagiert sehen.
2. Wählen Sie das Standard-Playbook aus.
3. Wählen Sie das Modell gemini-pro aus.
4. Geben Sie im Textfeld Nutzerinput eingeben den Wert Hello ein und drücken Sie die Eingabetaste.
5. Das Playbook antwortet mit einer Begrüßung.

So speichern Sie diese Unterhaltung als Beispiel:

1. Klicken Sie rechts oben auf der Benutzeroberfläche auf die Schaltfläche Beispiel speichern.
2. Der Beispieleditor wird geöffnet. Mit diesem Editor können Sie Aktionen hinzufügen, bearbeiten, löschen oder neu anordnen.
3. Geben Sie den Beispielnamen an: Greeting.
4. Aktualisieren Sie die Playbook-Antworten nach Bedarf.

5. Klicken Sie auf Speichern.

   

Fügen Sie dem Informations-Playbook ein Beispiel für einen Standort hinzu:

1. Schließen oder brechen Sie alle Bereiche auf der rechten Seite des Bildschirms ab. Setzen Sie die Unterhaltung bei Bedarf mit der Schaltfläche „Neu starten“ restart_alt zurück.
2. Wählen Sie das Informations-Playbook aus.
3. Wählen Sie das Modell gemini-pro aus.
4. Geben Sie die Nachricht ein: Where are you located?.
5. Das Playbook antwortet mit einem Standort.
6. Speichern Sie diese Unterhaltung als Beispiel mit dem Namen Location. Nur die Standard-Playbook-Beispiele können mit einer Nutzeraktion beginnen. Sie müssen daher die Aktion mit „Wo befindest du dich“ löschen.

Fügen Sie ein Stundenbeispiel für das Informations-Playbook hinzu:

1. Gehen Sie wie oben beschrieben vor, geben Sie aber die Nachricht What are your hours? ein und nennen Sie das Beispiel Hours.

Fügen Sie ein Auswahlbeispiel für das Bestell-Playbook hinzu:

1. Ähnlich wie bei den oben genannten Schritten aber nennen Sie das Beispiel Selection, wählen Sie das Playbook für die Reihenfolge aus, und sende die folgenden Nachrichten:

   • I want to buy a shirt
   • Large
   • Green
   • Yes

   

Agent testen

Der Agent kann jetzt getestet werden. Bereich „Simulator“ öffnen und ein Gespräch mit dem Kundenservicemitarbeiter führen. Es sind nicht dieselben Unterhaltungen wie oben erforderlich. Sie können diesen Agenten beispielsweise fragen, welche Farben für Hemden verfügbar sind. Wenn Sie nicht das gewünschte Verhalten erhalten, können Sie die Antworten verbessern, indem Sie Ihre Beispiele optimieren und neue erstellen.

Über die API mit dem Kundenservicemitarbeiter interagieren

Weitere Informationen finden Sie unter Interaktionen mit der API.