Créer un agent à l'aide de playbooks

Ce guide vous explique comment créer et tester un agent de commande de t-shirts simple à l'aide de playbooks. Lorsque vous interagissez avec cet agent, vous pouvez demander l'emplacement du magasin, obtenir les horaires d'ouverture ou passer commande.

Avant de commencer

Avant de lire ce guide, procédez comme suit :

  1. Si ce n'est pas déjà fait, suivez les instructions de configuration de Dialogflow.

À propos des playbooks

Un agent est composé d'un ou de plusieurs playbooks. Chaque playbook a une portée clairement définie et limitée. Un playbook contient les données suivantes:

X Élément
Nom Nom utilisé pour identifier le playbook.
Objectif Les objectifs sont des descriptions générales de ce que le playbook doit accomplir.
Instructions Les instructions sont les grandes étapes à suivre pour atteindre l'objectif du playbook.
Examples Les exemples sont des exemples de conversations entre un utilisateur final et l'agent. Ces exemples sont en fait des exemples de requêtes few-shot pour le LLM.

Créer l'agent

Pour créer l'agent:

  1. Accédez à la console Agent Builder:

    Console Agent Builder

  2. Sélectionnez votre projet dans le menu déroulant de la console.

  3. Si vous n'avez pas encore activé l'API, lisez et acceptez les conditions d'utilisation, puis cliquez sur Continuer et activer l'API.

  4. Cliquez sur Create a New App (Créer une application) ou New App (Nouvelle application).

  5. Sélectionnez Agent.

  6. Indiquez "Assistant de commande de chemises" comme nom de l'application.

  7. Sélectionnez une région.

  8. Cliquez sur Créer.

  9. L'interface utilisateur vous redirige vers le playbook par défaut nommé Agent par défaut.

  10. Cliquez sur le bouton Retour pour afficher la liste des playbooks.

Créer le playbook de commande

Le playbook Commande gère les commandes de chemises. Pour créer ce playbook:

  1. Cliquez sur Créer.
  2. Saisissez le nom: Order.

  3. Saisissez l'objectif suivant:

    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. Suivez les instructions suivantes:

    - 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. Cliquez sur Enregistrer.

    Capture d'écran de l'agent de commande

  6. Cliquez sur le bouton Retour pour revenir à la liste des playbooks.

Créer le playbook d'informations

Le playbook Informations traite les questions sur le magasin. Pour créer ce playbook:

  1. Cliquez sur Créer.
  2. Saisissez le nom: Information.

  3. Saisissez l'objectif suivant:

    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. Suivez les instructions suivantes:

    - 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. Cliquez sur Enregistrer.

  6. Cliquez sur le bouton Retour pour revenir à la liste des playbooks.

Mettre à jour le playbook par défaut

Lorsque vous avez créé l'application pour la première fois, un playbook par défaut a été créé pour vous. Ce playbook doit orienter la conversation vers les playbooks appropriés avec des objectifs spécifiques. Dans les instructions ci-dessous, vous pouvez voir comment le playbook par défaut fait référence aux autres playbooks. Pour mettre à jour ce playbook:

  1. Cliquez sur le playbook par défaut. Une étoile est mise en évidence à côté de ce playbook.

  2. Saisissez l'objectif suivant:

    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. Suivez les instructions suivantes:

    - 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. Cliquez sur Enregistrer.

  5. Cliquez sur le bouton Retour pour revenir à la liste des playbooks.

Fournir des exemples

À ce stade, votre playbook est fonctionnel. Toutefois, vous devez fournir des exemples pour garantir la qualité des réponses.

Vous pouvez fournir manuellement des exemples à partir de l'onglet Exemples lorsque vous avez un playbook ouvert. Toutefois, il est souvent plus facile d'avoir une conversation avec le playbook opérationnel et d'enregistrer la conversation en tant qu'exemple.

Un exemple de conversation avec un playbook par défaut est court. Ce playbook doit simplement vous rediriger vers un autre playbook. Pour avoir une conversation avec le playbook par défaut:

  1. Fermez ou annulez tout panneau qui pourrait être présent sur le côté droit de l'écran. Vous souhaitez afficher le panneau du simulateur contenant Envoyer un message pour voir comment votre agent répond.
  2. Sélectionnez le playbook par défaut.
  3. Sélectionnez le modèle: gemini-pro.
  4. Dans la zone de texte Enter user input (Saisir l'entrée utilisateur), saisissez Hello, puis appuyez sur Entrée.
  5. Le playbook répond par un message d'accueil.

Pour enregistrer cette conversation en tant qu'exemple:

  1. Cliquez sur le bouton Enregistrer l'exemple en haut à droite de l'interface.
  2. Le panneau de l'éditeur d'exemple s'ouvre. Vous pouvez utiliser cet éditeur pour ajouter, modifier, supprimer ou réorganiser des actions.
  3. Indiquez l'exemple de nom: Greeting.
  4. Modifiez les réponses du playbook si nécessaire.

  5. Cliquez sur Enregistrer.

    Capture d'écran d'un exemple de salutation

Ajoutez un exemple de lieu pour le playbook d'informations:

  1. Fermez ou annulez tout panneau qui pourrait être présent sur le côté droit de l'écran. Si nécessaire, réinitialisez la conversation à l'aide du bouton de réinitialisation restart_alt.
  2. Sélectionnez le playbook d'informations.
  3. Sélectionnez le modèle: gemini-pro.
  4. Saisissez le message suivant: Where are you located?.
  5. Le playbook répond avec un emplacement.
  6. Enregistrez cette conversation en tant qu'exemple nommé Location. Seuls les exemples de playbook par défaut peuvent commencer par une action de l'utilisateur. Vous devez donc supprimer l'action contenant "Où vous trouvez-vous ?". Saisissez le résumé du contexte de la conversation précédente : The customer asked "Where are you located?". Saisissez l'exemple de récapitulatif d'exécution: The store is located at 1007 Mountain Drive, Gotham City, NJ.

Ajoutez un exemple d'horaires pour le playbook d'informations:

  1. Comme pour les étapes ci-dessus, saisissez le message What are your hours? et nommez l'exemple Hours.

Ajoutez un exemple de sélection pour le playbook de commande:

  1. Comme pour les étapes ci-dessus, nommez l'exemple Selection, sélectionnez le playbook de commande et envoyez les messages suivants:

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

    Capture d'écran d'un exemple d'entrée

Tester l'agent

Votre agent est maintenant prêt à être testé. Ouvrez le panneau du simulateur et discutez avec l'agent. Vous n'avez pas besoin de répéter les mêmes conversations que ci-dessus. Par exemple, vous pouvez demander à cet agent quelles couleurs sont disponibles pour les chemises. Si vous n'obtenez pas le comportement souhaité, affinez vos exemples et créez-en de nouveaux pour améliorer les réponses.

Interagir avec l'agent à l'aide de l'API

Consultez la section Interactions avec l'API.

Précédent
Configuration et nettoyage
Suivant
Créer un agent à l'aide de flux