Agent mithilfe von Playbooks erstellen

Mit Playbooks einen Agenten zum Bestellen von T-Shirts erstellen und testen Mit dem Agenten nach dem Filialstandort und den Öffnungszeiten fragen oder ein T-Shirt bestellen

Hinweis

Folgen Sie gegebenenfalls der Einrichtungs anleitung.

Playbooks

Ein Agent besteht aus einem oder mehreren Playbooks. Jedes Playbook hat einen klar definierten und begrenzten Umfang. In der folgenden Tabelle werden die Daten in einem Playbook beschrieben:

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

Agent erstellen

So erstellen Sie einen Agent:

1. Rufen Sie https://conversational-agents.cloud.google.com auf.
2. Wählen Sie gegebenenfalls ein Projekt aus oder erstellen Sie eines.
3. Klicken Sie auf Agent erstellen.
4. Klicken Sie auf Selbst konfigurieren.
5. Geben Sie als Agent-Namen „Shirt Ordering - Playbooks“ ein.
6. Geben Sie einen Ort ein.
7. Geben Sie eine Zeitzone ein.
8. Geben Sie eine Standardsprache ein.
9. Wählen Sie für die Option Unterhaltungsbeginn die Option Playbook aus.
10. Klicken Sie auf Erstellen.
11. Die Benutzeroberfläche führt Sie zum Standard-Playbook Generatives Standard-Playbook.
12. Klicken Sie auf Zurück , um zur Playbook-Liste zurückzukehren.

Bestell-Playbook erstellen

Das Playbook Bestellung verarbeitet T-Shirt-Bestellungen.

So erstellen Sie das Playbook:

1. Klicken Sie auf Erstellen.
2. Wählen Sie die Option Aufgaben-Playbook aus.
3. Geben Sie den Playbook-Namen ein: Order.

4. Geben Sie das folgende Ziel 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.
   

5. Geben Sie die folgende Anleitung ein:

   - 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.
   

6. Klicken Sie auf Speichern.

7. Klicken Sie auf Zurück , um zur Playbook-Liste zurückzukehren.

Informations-Playbook erstellen

Das Playbook Informationen verarbeitet Fragen zum Geschäft.

So erstellen Sie das Playbook:

1. Klicken Sie auf Erstellen.
2. Wählen Sie die Option Aufgaben-Playbook aus.
3. Geben Sie den Playbook-Namen ein: Information.

4. Geben Sie das folgende Ziel 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.
   

5. Geben Sie die folgende Anleitung ein:

   - 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.
   

6. Klicken Sie auf Speichern.

7. Klicken Sie auf Zurück , um zur Playbook-Liste zurückzukehren.

Standard-Playbook aktualisieren

Wenn Sie den Agenten zum ersten Mal erstellen, wird automatisch ein Standard-Playbook erstellt. Dieses Playbook leitet die Unterhaltung zu den entsprechenden Playbooks mit bestimmten Zielen weiter. In der folgenden Anleitung sehen Sie, wie das Standard-Playbook auf die anderen Playbooks verweist.

So aktualisieren Sie das Playbook:

1. Klicken Sie auf das Standard-Playbook, das mit einem Stern markiert ist.

2. Geben Sie das folgende Ziel 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. Geben Sie die folgende Anleitung ein:

   - If the customer hasn't been greeted yet, greet the customer,
     introduce yourself, and ask 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. Die Playbook-Verweise sind hervorgehoben, da noch keine Beispiele vorhanden sind. Diese fügen Sie im nächsten Abschnitt hinzu.

6. Klicken Sie auf Zurück , um zur Playbook-Liste zurückzukehren.

Beispiele nennen

Das Playbook ist funktionsfähig, aber Beispiele sorgen für qualitativ hochwertige Antworten.

Sie können Beispiele auf dem Tab Beispiele hinzufügen, wenn ein Playbook geöffnet ist. Oft ist es jedoch einfacher, eine Unterhaltung mit dem Agenten zu führen und die Unterhaltung als Beispiel zu speichern.

Eine Standard-Playbook-Unterhaltung ist kurz. Dieses Playbook muss die Unterhaltung zu einem anderen Playbook weiterleiten.

So führen Sie eine Unterhaltung mit dem Standard-Playbook:

1. Schließen oder beenden Sie alle Bereiche, die sich möglicherweise auf der rechten Seite des Bildschirms befinden.
2. Klicken Sie in der obersten Navigationsleiste auf die Schaltfläche für den Simulator .
3. Wählen Sie für die Ressource das Standard-Playbook aus.
4. Verwenden Sie das Standardmodell oder wählen Sie eine Alternative aus.
5. Geben Sie im Feld Nutzereingabe eingeben Hello ein und drücken Sie die Eingabetaste.
6. Das Playbook antwortet mit einer Begrüßung.

So speichern Sie diese Unterhaltung als Beispiel:

1. Wählen Sie in der Liste Aufrufe das Standard-Playbook aus.
2. Klicken Sie auf Als Beispiel speichern.
3. Fügen Sie im Bereich des Beispiel-Editors Aktionen hinzu, bearbeiten, löschen oder ordnen Sie sie neu an.
4. Geben Sie Greeting als Beispielnamen ein.
5. Aktualisieren Sie die Playbook-Antworten nach Bedarf.
6. Geben Sie im Abschnitt Beispiel mit Ausgabedetails beenden im Feld Zusammenfassung The user is greeted. ein.
7. Klicken Sie auf Speichern.

Ein Standortbeispiel für das Informations-Playbook hinzufügen:

1. Schließen oder beenden Sie alle Bereiche auf der rechten Seite des Bildschirms.
2. Setzen Sie die Unterhaltung gegebenenfalls mit der Schaltfläche Zurücksetzen restart_alt zurück.
3. Wählen Sie im Simulator-Menü Startressource das Informations-Playbook aus.
4. Geben Sie Where are you located? ein und drücken Sie die Eingabetaste.
5. Wählen Sie im Menü Aufrufe das Informations-Playbook aus.
6. Klicken Sie auf Als Beispiel speichern.
7. Geben Sie Location als Beispielnamen ein.
8. Löschen Sie die Aktion, die Where are you located? enthält, da nur Beispiele für Standard-Playbooks mit einer Nutzeraktion beginnen können.
9. Maximieren Sie den Abschnitt Zusammenfassung der vorherigen Unterhaltung und geben Sie The customer asked "Where are you located?" im Feld Beispiel mit Eingabedetails beginnen ein.
10. Maximieren Sie den Abschnitt Zusammenfassung der Playbook-Ausführung und geben Sie The store is located at 1007 Mountain Drive, Gotham City, NJ. im Feld Beispiel mit Ausgabedetails beenden ein.
11. Klicken Sie auf Speichern.

Ein Beispiel für die Öffnungszeiten für das Informations-Playbook hinzufügen:

1. Wählen Sie im Simulator das Informations-Playbook aus.
2. Geben Sie die Nachricht What are your hours? ein.
3. Speichern Sie die Unterhaltung als Beispiel mit dem Namen Hours.

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

1. Geben Sie dem Beispiel den Namen Selection.
2. Wählen Sie das Bestell-Playbook aus.
3. Senden Sie die folgenden Nachrichten:
   • I want to buy a shirt
   • Large
   • Green
   • Yes

KI-Agenten testen

Ihr Agent kann jetzt getestet werden. Öffnen Sie den Simulatorbereich und führen Sie eine Unterhaltung mit dem Agenten. Sie können Unterhaltungen führen, die sich von den zuvor beschriebenen unterscheiden. Sie können diesen Agenten beispielsweise fragen, welche Farben für T-Shirts verfügbar sind. Wenn Sie nicht die gewünschten Ergebnisse erzielen, können Sie die Antworten verbessern, indem Sie Beispiele verfeinern oder hinzufügen.

Über die API mit dem Agenten interagieren

Weitere Informationen zur Interaktion mit der API finden Sie unter Interaktionen mit der API.