Agent mithilfe von Playbooks erstellen

KI-Agenten für die Bestellung von T-Shirts mit Playbooks erstellen und testen Sie können den Agenten nach dem Standort des Geschäfts, den Öffnungszeiten oder der Bestellung eines Shirts fragen.

Hinweis

Falls noch nicht geschehen, folgen Sie der Einrichtungsanleitung.

Playbooks

Ein KI-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	Anweisungen sind allgemeine Schritte, die ausgeführt werden sollten, um das Ziel des Playbooks zu erreichen.
Beispiele	Beispiele sind Beispielunterhaltungen zwischen einem Endnutzer und dem KI-Agenten. Diese Beispiele sind im Grunde Few-Shot-Prompt-Beispiele 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 ein Projekt aus oder erstellen Sie eines, falls noch nicht geschehen.
3. Klicken Sie auf KI-Agent erstellen.
4. Klicken Sie auf Selbst konfigurieren.
5. Geben Sie „Shirt Ordering – Playbooks“ als Namen für den KI-Agenten ein.
6. Geben Sie einen Standort 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 mit dem Namen Generatives Standard-Playbook.
12. Klicken Sie auf Zurück, um zur Playbook-Liste zurückzukehren.

Playbook für Bestellungen erstellen

Das Playbook Order 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 folgenden Anweisungen 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 Information 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 folgenden Anweisungen 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 ein Standard-Playbook für Sie erstellt. Dieses Playbook leitet die Unterhaltung an die 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 gekennzeichnet 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 folgenden Anweisungen 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 durch die Bereitstellung von Beispielen werden qualitativ hochwertige Antworten sichergestellt.

Sie können Beispiele auf dem Tab Beispiele angeben, wenn ein Playbook geöffnet ist. Es ist jedoch oft 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 an ein anderes Playbook weiterleiten.

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

1. Schließen Sie alle Bereiche, die auf der rechten Seite des Bildschirms angezeigt werden, oder brechen Sie sie ab.
2. Tippen Sie in der oberen Navigationsleiste auf die Schaltfläche „Simulator“ .
3. Wählen Sie als Ressource das Standard-Playbook aus.
4. Verwenden Sie das Standardmodell oder wählen Sie eine Alternative aus.
5. Geben Sie im Feld Nutzereingabe eingeben den Wert 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. Im Beispiel-Bearbeitungsfeld können Sie Aktionen hinzufügen, bearbeiten, löschen oder neu anordnen.
4. Geben Sie Greeting als Beispielnamen ein.
5. Aktualisieren Sie die Playbook-Antworten nach Bedarf.
6. Geben Sie im Abschnitt Beispiel mit Ausgabeinformationen beenden im Feld Zusammenfassung den Wert The user is greeted. ein.
7. Klicken Sie auf Speichern.

Fügen Sie dem Informations-Playbook ein Standortbeispiel hinzu:

1. Schließen oder brechen Sie alle Bereiche auf der rechten Seite des Bildschirms ab.
2. Setzen Sie die Unterhaltung bei Bedarf mit dem Button Zurücksetzen restart_alt zurück.
3. Wählen Sie im Simulator im 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 Standard-Playbook-Beispiele 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?" in das Feld Beispiel mit Eingabeinformationen starten 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. in das Feld Beispiel mit Ausgabeinformationen beenden ein.
11. Klicken Sie auf Speichern.

Fügen Sie dem Informations-Playbook ein Beispiel für Öffnungszeiten hinzu:

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 Playbook „Bestellung“ hinzu:

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

KI-Agenten testen

Der Agent kann jetzt getestet werden. Öffnen Sie den Simulatorbereich und führen Sie eine Unterhaltung mit dem KI-Agenten. Sie können andere Unterhaltungen als die oben beschriebenen führen. Sie können diesen Agenten beispielsweise fragen, welche Farben für Hemden verfügbar sind. Wenn Sie nicht die gewünschten Ergebnisse erzielen, können Sie die Antworten durch Verfeinern oder Hinzufügen von Beispielen verbessern.

Über die API mit dem KI-Agenten interagieren

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