Créer un agent à l'aide de playbooks

Créez et testez un agent de commande de chemises à l'aide de playbooks. Utilisez l'agent pour demander l'emplacement du magasin, obtenir les horaires d'ouverture ou passer commande.

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 une portée clairement définie et limitée. 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 de haut niveau 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 conversations entre un utilisateur final et l'agent. Il s'agit en fait d'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 (Créer votre propre agent).
5. Saisissez "Shirt Ordering - Playbooks" (Commande de chemises - Playbooks) comme nom de l'agent.
6. Saisissez un lieu.
7. Saisissez un fuseau horaire.
8. Saisissez une langue par défaut.
9. Sélectionnez Playbook pour l'option Conversation start (Début de la conversation).
10. Cliquez sur Create (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 Back (Retour) pour revenir à la liste des playbooks.

Créer le playbook de commande

Le playbook Order (Commande) gère les commandes de chemises.

Pour créer le playbook :

1. Cliquez sur Create (Créer).
2. Sélectionnez l'option Task playbook (Playbook de tâches).
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 Save (Enregistrer).

7. Cliquez sur Back (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 le playbook :

1. Cliquez sur Create (Créer).
2. Sélectionnez l'option Task playbook (Playbook de tâches).
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 Save (Enregistrer).

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

Mettre à jour le playbook par défaut

Lorsque vous créez l'agent pour la première fois, un playbook par défaut est créé pour vous. Ce playbook dirige la conversation vers les playbooks appropriés avec des objectifs spécifiques. Vous pouvez voir comment le playbook par défaut référence les 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 Save (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 Back (Retour) pour revenir à la liste des playbooks.

Donner 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 Examples (Exemples) lorsqu'un playbook est ouvert. Toutefois, il est souvent plus facile d'avoir une conversation avec l'agent et d'enregistrer la conversation comme exemple.

Une conversation de playbook par défaut est courte. Ce playbook doit diriger 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 une autre option.
5. Dans le champ Enter user input (Saisir l'entrée utilisateur), saisissez Hello, puis appuyez sur Entrée.
6. Le playbook répond par un message de bienvenue.

Pour enregistrer cette conversation comme exemple :

1. Sélectionnez le playbook par défaut dans la liste Invocations.
2. Cliquez sur Save as example (Enregistrer comme exemple).
3. Dans le panneau de l'éditeur d'exemples, ajoutez, modifiez, supprimez ou réorganisez les actions.
4. Saisissez Greeting comme nom de l'exemple.
5. Modifiez 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. (L'utilisateur est accueilli) dans le champ Summary (Résumé).
7. Cliquez sur Save (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 avec le bouton reset restart_alt.
3. Sélectionnez le playbook d'informations dans le menu Start Resource (Ressource de démarrage) du simulateur.
4. Saisissez Where are you located? (Où êtes-vous situé ?) et appuyez sur Entrée.
5. Sélectionnez le playbook d'informations dans le menu Invocations.
6. Cliquez sur Save as example (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 sur l'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 Save (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? (Quels sont vos horaires ?).
3. Enregistrez la conversation comme exemple nommé Hours (Horaires).

Ajoutez un exemple de sélection pour le playbook de commande en procédant 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, affiner ou ajouter des exemples améliorera les réponses.

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

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