Agent mithilfe von Playbooks erstellen

In dieser Anleitung erfahren Sie, wie Sie mit Playbooks einen einfachen Agenten für Hemdbestellungen 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. Folgen Sie der Einrichtungsanleitung, 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 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 Few-Shot-Prompt-Beispiele für das LLM.

KI-Agenten erstellen

So erstellen Sie den Agent:

  1. Rufen Sie die Konsole für Konversations-Agenten auf:

    Konsole für Konversations-Agenten

  2. Falls noch kein Projekt ausgewählt ist, wählen Sie ein Projekt aus oder erstellen Sie eines.

  3. Klicken Sie auf KI-Agent erstellen.

  4. Klicken Sie auf Selbst konfigurieren.

  5. Geben Sie „Shirt Ordering – Playbooks“ als Namen des Agents an.

  6. Geben Sie einen Standort an.

  7. Geben Sie eine Zeitzone an.

  8. Geben Sie eine Standardsprache an.

  9. Wählen Sie für die Option Unterhaltungsbeginn die Option Playbook aus.

  10. Klicken Sie auf Erstellen.

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

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

Bestell-Playbook erstellen

Das Playbook Order (Bestellung) verarbeitet T-Shirt-Bestellungen. So erstellen Sie dieses Playbook:

  1. Klicken Sie auf Erstellen.
  2. Wählen Sie die Option Task-Playbook aus.
  3. Geben Sie den Namen des Playbooks ein: Order.
  4. 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.
    
  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 die Schaltfläche „Zurück“, um zur Playbook-Liste zurückzukehren.

Informations-Playbook erstellen

Das Playbook Information behandelt Fragen zum Geschäft. So erstellen Sie dieses Playbook:

  1. Klicken Sie auf Erstellen.
  2. Wählen Sie die Option Task-Playbook aus.
  3. Geben Sie den Namen des Playbooks ein: Information.
  4. 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.
    
  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 die Schaltfläche „Zurück“, um zur Playbook-Liste zurückzukehren.

Standard-Playbook aktualisieren

Als Sie die Anwendung zum ersten Mal erstellt haben, wurde automatisch ein Standard-Playbook für Sie erstellt. Dieses Playbook soll das Gespräch zu den entsprechenden Playbooks mit spezifischen 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 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. Geben Sie die folgenden Anweisungen ein:

    - 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. Die Playbook-Referenzen sind hervorgehoben, da es noch keine Beispiele gibt. Diese werden im nächsten Abschnitt hinzugefügt.

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

Beispiele nennen

An diesem Punkt ist Ihr Playbook funktionsfähig. Sie müssen jedoch Beispiele angeben, um qualitativ hochwertige Antworten zu erhalten.

Sie können manuell Beispiele auf dem Tab Beispiele angeben, wenn Sie ein Playbook geöffnet haben. Oft ist es jedoch 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. In diesem Playbook werden Sie nur zu einem anderen Playbook weitergeleitet. So führen Sie eine Unterhaltung mit dem Standard-Playbook:

  1. Schließen oder beenden Sie alle Felder, die möglicherweise auf der rechten Seite des Bildschirms angezeigt werden.
  2. Klicken Sie in der oberen 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 Textfeld Enter user input (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 im Drop-down-Menü Aufrufe das Standard-Playbook aus.
  2. Klicken Sie rechts oben auf der Benutzeroberfläche auf die Schaltfläche Als Beispiel speichern.
  3. Das Steuerfeld „Beispiel-Editor“ wird geöffnet. Mit diesem Editor können Sie Aktionen hinzufügen, bearbeiten, löschen oder neu anordnen.
  4. Geben Sie den Beispielnamen Greeting ein.
  5. Aktualisieren Sie die Playbook-Antworten nach Bedarf.
  6. Scrollen Sie nach unten zu End example with output information (Beispiel mit Ausgabedaten beenden) und geben Sie im Abschnitt Summary (Zusammenfassung) The user is greeted. ein.
  7. Klicken Sie auf das Symbol „Speichern“.

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

  1. Schließen oder beenden Sie alle Felder, die möglicherweise auf der rechten Seite des Bildschirms angezeigt werden.
  2. Setzen Sie die Unterhaltung bei Bedarf mit der Schaltfläche „Zurücksetzen“ restart_alt zurück.
  3. Wählen Sie das Informations-Playbook im Drop-down-Menü Startressource des Simulators aus.
  4. Geben Sie die Nachricht ein: Where are you located?.
  5. Das Playbook antwortet mit einem Standort.
  6. Wählen Sie das Informations-Playbook im Drop-down-Menü Aufrufe aus.
  7. Klicken Sie auf die Schaltfläche Als Beispiel speichern.
  8. Geben Sie den Beispielnamen Location ein.
  9. Bevor Sie diese Unterhaltung als Beispiel speichern können, müssen Sie die Aktion löschen, die „Wo befindest du dich?“ enthält. Nur die Standard-Playbook-Beispiele können mit einer Nutzeraktion beginnen.
  10. Um dem Beispiel den Kontext zu geben, der die Unterhaltung ausgelöst hat, maximieren Sie den Abschnitt Zusammenfassung der vorherigen Unterhaltung… und geben Sie Folgendes in das Feld Beispiel beginnt mit Eingabeinformationen ein: The customer asked "Where are you located?".
  11. Um dem Beispiel den Kontext zu geben, der das Gespräch abschließt, maximieren Sie den Abschnitt Zusammenfassung der Playbook-Ausführung… und geben Sie Folgendes in das Feld Beispiel mit Ausgabedaten beenden ein: The store is located at 1007 Mountain Drive, Gotham City, NJ..
  12. Klicken Sie auf das Symbol „Speichern“.

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

  1. Ähnlich wie oben, aber geben Sie 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. Führen Sie ähnliche Schritte wie oben aus, nennen Sie das Beispiel jedoch Selection, wählen Sie das Order Playbook aus und 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 KI-Agenten. Sie müssen nicht dieselben Unterhaltungen wie oben führen. Sie können diesen Agent 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 Agent interagieren

Weitere Informationen finden Sie unter Interaktionen mit der API.