Agent mithilfe von Playbooks erstellen

Hinweis :In der Agent Builder-Konsole werden Playbooks weiterhin als Kundenservicemitarbeiter bezeichnet. Dieser wird in der Konsole bald 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.

Hinweise

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

1. Folgen Sie der Einrichtungsanleitung für Dialogflow, falls noch nicht geschehen.

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 allgemeine 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 Console

2. Wählen Sie Ihr Projekt im Drop-down-Menü der Console aus.

3. Wenn Sie die API noch nicht aktiviert haben, lesen und akzeptieren Sie die Nutzungsbedingungen und klicken Sie dann auf Fortfahren und API aktivieren.

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

5. Wähle Kundenservicemitarbeiter aus.

6. Geben Sie „Shirt Ordering Assistant“ als App-Namen an.

7. Wählen Sie eine Region aus.

8. Klicken Sie auf Erstellen.

9. Über die Benutzeroberfläche gelangen Sie zum Standard-Playbook namens Default Agent.

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

Playbook für die Bestellung erstellen

Das Playbook Bestellung verarbeitet T-Shirtbestellungen. 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 Zielvorhaben 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 ${PLAYBOOK: Information}
   - If the customer wants to purchase a shirt,
     route them to ${PLAYBOOK: 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.

Ein Beispiel für eine Unterhaltung 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 aus: gemini-pro.
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 schließen Sie alle Bereiche, die sich rechts auf dem Bildschirm befinden. 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 aus: gemini-pro.
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 Standardbeispiele für Playbooks können mit einer Nutzeraktion beginnen. Sie müssen daher die Aktion löschen, die „Wo befinden Sie sich?“ enthält. Geben Sie die Zusammenfassung des vorherigen Konversationskontexts ein: The customer asked "Where are you located?". Geben Sie die Zusammenfassung der Beispielausführung ein: The store is located at 1007 Mountain Drive, Gotham City, NJ.

Fügen Sie dem Informations-Playbook ein Beispiel für Öffnungszeiten 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. Gehen Sie wie oben beschrieben vor, nennen Sie das Beispiel aber Selection, wählen Sie das Bestell-Playbook aus und senden Sie die folgenden Nachrichten:

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

   

Agent testen

Ihr Agent kann jetzt getestet werden. Öffnen Sie den Simulatorbereich und führen Sie ein Gespräch mit dem Kundenservicemitarbeiter. Sie müssen nicht dieselben Unterhaltungen wie oben führen. Sie können diesen Agenten beispielsweise fragen, welche Farben für Hemden verfügbar sind. Wenn Sie das gewünschte Verhalten nicht erzielen, 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.