Ce guide 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 :
- Si ce n'est pas déjà fait, suivez les instructions de configuration.
À 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 des étapes générales à suivre pour atteindre l'objectif du playbook. |
| Exemples | Les exemples sont des conversations entre un utilisateur final et l'agent. Il s'agit en fait d'exemples de prompts few-shot pour le LLM. |
Créer l'agent
Pour créer l'agent :
Accédez à la console Conversational Agents :
Si ce n'est pas déjà fait, sélectionnez ou créez un projet.
Cliquez sur Create agent (Créer un agent).
Cliquez sur Build your own (Créer votre propre agent).
Indiquez "Shirt Ordering - Playbooks" (Commande de t-shirts – Playbooks) comme nom de l'agent.
Indiquez un emplacement.
Indiquez un fuseau horaire.
Indiquez une langue par défaut.
Sélectionnez Playbook pour l'option Conversation start (Début de la conversation).
Cliquez sur Create (Créer).
L'interface utilisateur vous redirige vers le playbook par défaut nommé Default Generative Playbook (Playbook génératif par défaut).
Cliquez sur le bouton Retour pour afficher la liste des playbooks.
Créer le playbook de commande
Le playbook Order (Commande) gère les commandes de t-shirts. Pour créer ce playbook :
- Cliquez sur Create (Créer).
- Sélectionnez l'option Task playbook (Playbook de tâches).
- Saisissez le nom du playbook :
Order. 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.Saisissez 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.Cliquez sur Save (Enregistrer).
Cliquez sur le bouton Retour pour revenir à la liste des playbooks.
Créer le playbook d'informations
Le playbook Information gère les questions concernant le magasin. Pour créer ce playbook :
- Cliquez sur Create (Créer).
- Sélectionnez l'option Task playbook (Playbook de tâches).
- Saisissez le nom du playbook :
Information. 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.Saisissez 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.Cliquez sur Save (Enregistrer).
Cliquez sur le bouton Retour pour revenir à la liste des playbooks.
Mettre à jour le playbook par défaut
Lorsque vous avez créé l'application, 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 :
- Cliquez sur le playbook par défaut. Ce playbook est marqué d'une étoile.
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.Saisissez 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}Cliquez sur Save (Enregistrer).
Notez que les références au playbook sont mises en surbrillance, car aucun exemple n'a encore été fourni. Elles seront ajoutées dans la section suivante.
Cliquez sur le bouton Retour pour revenir à la liste des playbooks.
Donner des exemples
À ce stade, votre playbook est fonctionnel. Toutefois, vous devez fournir des exemples pour garantir des réponses de qualité.
Vous pouvez fournir manuellement des exemples à partir de l'onglet Examples (Exemples) lorsque vous ouvrez un playbook. Cependant, il est souvent plus facile d'avoir une conversation avec le playbook fonctionnel et d'enregistrer la conversation comme exemple.
Une conversation d'exemple avec un playbook par défaut est courte. Ce playbook doit simplement vous rediriger vers un autre playbook. Pour avoir une conversation avec le playbook par défaut :
- Fermez ou annulez tout panneau qui pourrait être présent sur le côté droit de l'écran.
- Cliquez sur le simulateur bouton dans la barre de navigation en haut.
- Pour la ressource, sélectionnez le playbook par défaut.
- Utilisez le modèle par défaut ou sélectionnez une autre option.
- Dans la zone de texte qui indique Enter user input,
saisissez
Hello, puis appuyez sur Entrée. - Le playbook répond par un message d'accueil.
Pour enregistrer cette conversation comme exemple :
- Sélectionnez le playbook par défaut dans le menu déroulant Invocations.
- Cliquez sur le bouton Save as example (Enregistrer comme exemple) en haut à droite de l'interface.
- Le panneau de l'éditeur d'exemples s'ouvre. Vous pouvez utiliser cet éditeur pour ajouter, modifier, supprimer ou réorganiser des actions.
- Indiquez le nom de l'exemple :
Greeting. - Modifiez les réponses du playbook si nécessaire.
- Faites défiler la page jusqu'à End example with output information (Terminer l'exemple avec des informations sur la sortie), puis saisissez
The user is greeted.(L'utilisateur est accueilli) dans la section Summary (Résumé). - Cliquez sur l'icône Enregistrer.
Ajoutez un exemple d'emplacement pour le playbook d'informations :
- 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 restart_altrestart_alt.
- Sélectionnez le playbook d'informations dans le menu déroulant Start Resource (Ressource de démarrage) du simulateur.
- Saisissez le message :
Where are you located?(Où êtes-vous situé ?). - Le playbook répond par un emplacement.
- Sélectionnez le playbook d'informations dans le menu déroulant Invocations.
- Cliquez sur le bouton Save as example (Enregistrer comme exemple).
- Indiquez le nom de l'exemple :
Location. - Avant d'enregistrer cette conversation comme exemple, vous devez supprimer l'action qui contient "Where are you located" (Où êtes-vous situé ?). Seuls les exemples de playbook par défaut peuvent commencer par une action utilisateur.
- Pour fournir l'exemple avec le contexte qui a lancé la conversation,
développez la section Summary of the preceding conversation... (Résumé de la conversation précédente)
et saisissez ce qui suit
dans le champ Starts example with input information (Commencer l'exemple avec des informations sur l'entrée) :
The customer asked "Where are you located?". - Pour fournir l'exemple avec le contexte qui termine la conversation, développez la section Summary of the playbook execution... (Résumé de l'exécution du playbook...), puis saisissez ce qui suit dans le champ End example with output information (Terminer l'exemple avec des informations sur la sortie) :
The store is located at 1007 Mountain Drive, Gotham City, NJ.(Le magasin est situé au 1007 Mountain Drive, Gotham City, NJ.). - Cliquez sur l'icône Enregistrer.
Ajoutez un exemple d'horaires pour le playbook d'informations :
- Comme pour les étapes ci-dessus, mais saisissez le message :
What are your hours?(Quels sont vos horaires ?) et nommez l'exemple :Hours.
Ajoutez un exemple de sélection pour le playbook de commande :
Comme pour les étapes ci-dessus, mais nommez l'exemple
Selection, sélectionnez le playbook de commande et envoyez les messages suivants :I want to buy a shirtLargeGreenYes
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 d'avoir les mêmes conversations que ci-dessus. Par exemple, vous pouvez demander à cet agent quelles couleurs sont disponibles pour les t-shirts. 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 Interactions avec l'API.