Créer un agent à l'aide de playbooks

Créer et tester un agent de commande de t-shirts à l'aide de playbooks Utilisez l'agent pour demander l'adresse du magasin, obtenir ses horaires d'ouverture ou commander un t-shirt.

Avant de commencer

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

À propos des playbooks

Un agent se compose d'un ou de plusieurs playbooks. Chaque playbook a un champ d'application clairement défini et limité. Le tableau suivant décrit les données d'un playbook :

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 de haut niveau à suivre pour atteindre l'objectif du playbook.
Exemples	Les exemples sont des exemples de conversations entre un utilisateur final et l'agent. Ces exemples sont en fait des exemples de prompts few-shot pour le LLM.

Créer un agent

Pour créer un agent, procédez comme suit :

1. Accédez à https://conversational-agents.cloud.google.com.
2. Si ce n'est pas déjà fait, sélectionnez ou créez un projet.
3. Cliquez sur Create agent (Créer un agent).
4. Cliquez sur Build your own.
5. Saisissez "Shirt Ordering - Playbooks" comme nom d'agent.
6. Saisissez un emplacement.
7. Saisissez un fuseau horaire.
8. Saisissez une langue par défaut.
9. Sélectionnez Playbook pour l'option Début de la conversation.
10. Cliquez sur Créer.
11. L'interface utilisateur vous redirige vers le playbook par défaut nommé Default Generative Playbook (Playbook génératif par défaut).
12. Cliquez sur Retour pour revenir à la liste des playbooks.

Créer le playbook de commande

Le playbook Order (Commande) gère les commandes de t-shirts.

Pour créer le playbook :

1. Cliquez sur Créer.
2. Sélectionnez l'option Playbook de tâche.
3. Saisissez le nom du playbook : Order.

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

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

6. Cliquez sur Enregistrer.

7. Cliquez sur Retour pour revenir à la liste des playbooks.

Créer le playbook d'informations

Le playbook Information gère les questions sur le magasin.

Pour créer le playbook :

1. Cliquez sur Créer.
2. Sélectionnez l'option Playbook de tâche.
3. Saisissez le nom du playbook : Information.

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

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

6. Cliquez sur Enregistrer.

7. Cliquez sur Retour pour revenir à la liste des playbooks.

Mettre à jour le playbook par défaut

Lorsque vous créez l'agent, un playbook par défaut est créé pour vous. Ce playbook oriente la conversation vers les playbooks appropriés avec des objectifs spécifiques. Vous pouvez voir comment le playbook par défaut fait référence aux autres playbooks dans les instructions suivantes.

Pour mettre à jour le playbook :

1. Cliquez sur le playbook par défaut, marqué d'une étoile.

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

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

5. Notez que les références du playbook sont mises en surbrillance, car il n'y a pas encore d'exemples. Vous les ajouterez dans la section suivante.

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

Donnez des exemples

Le playbook est fonctionnel, mais fournir des exemples garantit des réponses de qualité.

Vous pouvez fournir des exemples à partir de l'onglet Exemples lorsqu'un playbook est ouvert. Toutefois, il est souvent plus facile d'avoir une conversation avec l'agent et de l'enregistrer en tant qu'exemple.

Une conversation de playbook par défaut est courte. Ce playbook doit rediriger la conversation 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.
2. Appuyez sur le bouton du simulateur  dans la barre de navigation supérieure.
3. Pour la ressource, sélectionnez le playbook par défaut.
4. Utilisez le modèle par défaut ou sélectionnez-en un autre.
5. Dans le champ Saisir une entrée utilisateur, saisissez Hello, puis appuyez sur Entrée.
6. Le playbook répond par un message d'accueil.

Pour enregistrer cette conversation en tant qu'exemple :

1. Sélectionnez le playbook par défaut dans la liste Invocations.
2. Cliquez sur Enregistrer comme exemple.
3. Dans le panneau de l'éditeur d'exemples, ajoutez, modifiez, supprimez ou réorganisez des actions.
4. Saisissez Greeting comme nom de l'exemple.
5. Mettez à jour les réponses du playbook si nécessaire.
6. Dans la section End example with output information (Terminer l'exemple avec des informations sur la sortie), saisissez The user is greeted. dans le champ Summary (Résumé).
7. Cliquez sur Enregistrer.

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

1. Fermez ou annulez tout panneau sur le côté droit de l'écran.
2. Si nécessaire, réinitialisez la conversation à l'aide du bouton Réinitialiser restart_alt.
3. Sélectionnez le playbook d'informations dans le menu Ressource de démarrage du simulateur.
4. Saisissez Where are you located? et appuyez sur Entrée.
5. Sélectionnez le playbook d'informations dans le menu Invocations.
6. Cliquez sur Enregistrer comme exemple.
7. Saisissez Location comme nom de l'exemple.
8. Supprimez l'action contenant Where are you located?, car seuls les exemples de playbook par défaut peuvent commencer par une action utilisateur.
9. Développez la section Summary of the preceding conversation (Résumé de la conversation précédente) et saisissez The customer asked "Where are you located?" dans le champ Starts example with input information (Commencer l'exemple avec des informations d'entrée).
10. Développez la section Summary of the playbook execution (Résumé de l'exécution du playbook) et saisissez The store is located at 1007 Mountain Drive, Gotham City, NJ. dans le champ End example with output information (Terminer l'exemple avec des informations sur la sortie).
11. Cliquez sur Enregistrer.

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

1. Sélectionnez le playbook d'informations dans le simulateur.
2. Saisissez le message What are your hours?.
3. Enregistrez la conversation en tant qu'exemple nommé Hours.

Pour ajouter un exemple de sélection pour le playbook de commande, procédez comme suit :

1. Nommez l'exemple Selection.
2. Sélectionnez le playbook de commande.
3. Envoyez les messages suivants :
   • I want to buy a shirt
   • Large
   • Green
   • Yes

Tester l'agent

Votre agent est maintenant prêt à être testé. Ouvrez le panneau du simulateur et discutez avec l'agent. Vous pouvez avoir des conversations différentes de celles décrites précédemment. Par exemple, vous pouvez demander à cet agent quelles couleurs sont disponibles pour les chemises. Si vous n'obtenez pas les résultats souhaités, affinez ou ajoutez des exemples pour améliorer les réponses.

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

Pour en savoir plus sur l'interaction avec l'API, consultez Interactions avec l'API.