Certains produits et fonctionnalités sont en cours de changement de nom. Les fonctionnalités de playbook et de flux génératifs sont également en cours de migration vers une console unique. Consultez les détails.
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 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.
Sélectionnez Playbook pour l'option Début de la conversation.
Cliquez sur 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 Commande gère les commandes de chemises.
Pour créer ce playbook:
Cliquez sur Créer.
Sélectionnez l'option Playbook de tâche.
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.
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.
Cliquez sur Enregistrer.
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:
Cliquez sur Créer.
Sélectionnez l'option Playbook de tâche.
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.
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.
Cliquez sur Enregistrer.
Cliquez sur le bouton Retour pour revenir à la liste des playbooks.
Modifier 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:
Cliquez sur le playbook par défaut. Une étoile est mise en évidence à côté de ce playbook.
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.
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}
Cliquez sur Enregistrer.
Notez que les références de playbook sont mises en surbrillance, car il n'y a pas encore d'exemples.
Ils seront ajoutés dans la section suivante.
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:
Fermez ou annulez tout panneau qui pourrait être présent sur le côté droit de l'écran.
Cliquez sur le bouton question_answer du simulateur dans la barre de navigation de la ligne supérieure.
Pour la ressource, sélectionnez le playbook par défaut.
Utilisez le modèle par défaut ou sélectionnez un autre modèle.
Dans la zone de texte Enter user input (Saisir l'entrée utilisateur), saisissez Hello, puis appuyez sur Entrée.
Le playbook répond par un message d'accueil.
Pour enregistrer cette conversation en tant qu'exemple:
Sélectionnez le playbook par défaut dans le menu déroulant Invocations.
Cliquez sur le bouton Enregistrer en tant qu'exemple en haut à droite de l'interface.
Le panneau de l'éditeur d'exemple s'ouvre.
Vous pouvez utiliser cet éditeur pour ajouter, modifier, supprimer ou réorganiser des actions.
Indiquez l'exemple de nom: Greeting.
Modifiez les réponses du playbook si nécessaire.
Faites défiler la page jusqu'à l'exemple de fin avec des informations de sortie, puis saisissez The user is greeted. dans la section 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 de réinitialisation restart_alt.
Sélectionnez le playbook d'informations dans la liste déroulante Start Resource (Ressource de démarrage) du simulateur.
Saisissez le message suivant: Where are you located?.
Le playbook répond avec un emplacement.
Sélectionnez le playbook d'informations dans le menu déroulant Invocations.
Cliquez sur le bouton Enregistrer en tant qu'exemple.
Indiquez l'exemple de nom: Location.
Avant d'enregistrer cette conversation en tant qu'exemple, vous devez supprimer l'action contenant "Où vous trouvez-vous ?".
Seuls les exemples de playbook par défaut peuvent commencer par une action de l'utilisateur.
Pour fournir à l'exemple le contexte ayant déclenché la conversation, développez la section Résumé de la conversation précédente, puis saisissez ce qui suit dans le champ Débute l'exemple avec des informations d'entrée : The customer asked "Where are you located?".
Pour fournir à l'exemple le contexte qui termine la conversation, développez la section Résumé de l'exécution du playbook, puis saisissez ce qui suit dans le champ Terminer l'exemple avec des informations de sortie : The store is located at 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, saisissez le message What are your hours? et nommez l'exemple Hours.
Ajoutez un exemple de sélection pour le playbook de commande:
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
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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/18 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/18 (UTC)."],[[["\u003cp\u003eThis guide provides instructions on how to create a shirt ordering agent using playbooks, enabling it to handle requests for store information and shirt orders.\u003c/p\u003e\n"],["\u003cp\u003ePlaybooks are defined by their name, goal, instructions, and examples, and they allow for a structured approach to handling specific tasks within the agent's scope.\u003c/p\u003e\n"],["\u003cp\u003eThe process involves creating separate playbooks for ordering (Order), providing information (Information), and directing conversations (Default Generative Playbook), and each of these playbooks are to be configured with specific goals and instructions.\u003c/p\u003e\n"],["\u003cp\u003eExamples, which are sample conversations, are crucial for improving the quality of the agent's responses and can be added manually or by saving conversations from the simulator.\u003c/p\u003e\n"],["\u003cp\u003eThe agent can be tested within the simulator interface, and the ability to improve the responses are done through refining the provided examples.\u003c/p\u003e\n"]]],[],null,["# Build an agent using playbooks\n\nThis guide shows you how to build and test a simple shirt ordering\nagent using playbooks.\nWhen interacting with this agent,\nyou can ask for the store location,\nget store hours,\nor make a shirt order.\n\nBefore you begin\n----------------\n\nYou should do the following before reading this guide:\n\n1. If you have not already, follow the [setup](/dialogflow/cx/docs/quick/setup) instructions.\n\nAbout playbooks\n---------------\n\nAn agent is composed of one or more playbooks.\nEach playbook has a clearly defined and limited scope.\nA playbook has the following data:\n\nCreate the agent\n----------------\n\nTo create the agent:\n\n1. Go to the Conversational Agents console:\n\n [Conversational Agents console](https://conversational-agents.cloud.google.com)\n2. If you haven't already, select or create a project.\n\n3. Click **Create agent**.\n\n4. Click **Build your own**.\n\n5. Provide \"Shirt Ordering - Playbooks\" for the agent name.\n\n6. Provide a\n [location](/dialogflow/cx/docs/concept/region).\n\n7. Provide a time zone.\n\n8. Provide a\n [default language](/dialogflow/cx/docs/concept/agent-multilingual).\n\n9. Select **Playbook** for the **Conversation start** option.\n\n10. Click **Create**.\n\n11. The user interface takes you to the default playbook\n named **Default Generative Playbook**.\n\n12. Click the back button to see the list of playbooks.\n\nCreate the order playbook\n-------------------------\n\nThe **Order** playbook handles shirt orders.\nTo create this playbook:\n\n1. Click **Create**.\n2. Select the **Task playbook** option.\n3. Enter the playbook name: `Order`.\n4. Enter the following goal:\n\n You are a shirt store ordering assistant. Help customers purchase shirts.\n Help the customer choose a size and color.\n The shirts come in small, medium, and large.\n The shirts can be red, green, or blue.\n\n5. Enter the following instructions:\n\n - If the customer has not provided a size, ask them to choose a size.\n - If the customer has not provided a color, ask them to choose a color.\n - Once the customer has selected a size and color for the shirt,\n repeat the selection to the customer, and ask them to confirm the selection.\n - Once the customer has confirmed their selection,\n let them know that the shirt is now ordered.\n - Do not provide prices or collect payment.\n - Do not collect the customer's name or address.\n\n6. Click **Save**.\n\n7. Click the back button to return to the playbook list.\n\nCreate the information playbook\n-------------------------------\n\nThe **Information** playbook handles questions about the store.\nTo create this playbook:\n\n1. Click **Create**.\n2. Select the **Task playbook** option.\n3. Enter the playbook name: `Information`.\n4. Enter the following goal:\n\n You provide information about a shirt store.\n The store is open between 8 AM and 6 PM every day.\n The store is located at 1007 Mountain Drive, Gotham City, NJ.\n\n5. Enter the following instructions:\n\n - If the customer asks for the store location, provide them with the address.\n - If the customer asks for the store hours, provide them with the hours.\n\n6. Click **Save**.\n\n7. Click the back button to return to the playbook list.\n\nUpdate the default playbook\n---------------------------\n\nWhen you first created the application,\na default playbook was created for you.\nThis playbook should steer the conversation\nto the appropriate playbooks with specific goals.\nIn the instructions below,\nyou can see how the default playbook references the other playbooks.\nTo update this playbook:\n\n1. Click the default playbook. This playbook has a highlighted star.\n2. Enter the following goal:\n\n You are an assistant for a shirt store.\n Your name is \"Samantha\".\n Your job is to direct customers to other playbooks based on the customer's questions.\n\n3. Enter the following instructions:\n\n - If the customer hasn't been greeted yet, greet the customer,\n introduce yourself, and ask the user how you can help.\n - If the customer wants information about the store,\n route them to ${PLAYBOOK: Information}\n - If the customer wants to purchase a shirt,\n route them to ${PLAYBOOK: Order}\n\n4. Click **Save**.\n\n5. Note that the playbook references are highlighted\n because there are no examples yet.\n These will be added in the next section.\n\n6. Click the back button to return to the playbook list.\n\nProvide examples\n----------------\n\nAt this point,\nyour playbook is functional.\nHowever, You must provide\n[examples](/dialogflow/cx/docs/concept/playbook/example)\nto ensure quality responses.\n\nYou can manually provide examples from the **Examples**\ntab when you have a playbook open.\nHowever, it is often easier to have a conversation with the\nfunctioning playbook and save the conversation as an example.\n\nAn example conversation with a default playbook is short.\nThis playbook just needs to direct you to another playbook.\nTo have a conversation with the default playbook:\n\n1. Close or cancel any panel that might be present on the right side of the screen.\n2. Click the simulator question_answer button in the top row navigation.\n3. For resource, select the default playbook.\n4. Use the default model or select an alternative.\n5. In the text box that says **Enter user input** , type `Hello`, then press enter.\n6. The playbook responds with a greeting.\n\nTo save this conversation as an example:\n\n1. Select the default playbook in the **Invocations** dropdown.\n2. Click the **Save as example** button near the top right of the interface.\n3. The example editor panel opens. You can use this editor to add, edit, delete, or reorder actions.\n4. Provide the example name: `Greeting`.\n5. Update the playbook responses as necessary.\n6. Scroll down to the **End example with output information** and enter `The user is greeted.` in the **Summary** section.\n7. Click the save icon.\n\nAdd a location example for the information playbook:\n\n1. Close or cancel any panel that might be present on the right side of the screen.\n2. If necessary, reset the conversation with the reset restart_alt button.\n3. Select the information playbook in the simulator **Start Resource** dropdown.\n4. Enter the message: `Where are you located?`.\n5. The playbook responds with a location.\n6. Select the information playbook in the **Invocations** dropdown.\n7. Click the **Save as example** button.\n8. Provide the example name: `Location`.\n9. Before saving this conversation as an example, you must delete the action that contains \"Where are you located\". Only the default playbook examples can start with a user action.\n10. To provide the example with the context that started the conversation, expand the **Summary of the preceding conversation...** section and enter the following in the **Starts example with input information** field: `The customer asked \"Where are you located?\"`.\n11. To provide the example with the context that completes the conversation, expand the **Summary of the playbook execution...** section and enter the following in the **End example with output information** field: `The store is located at 1007 Mountain Drive, Gotham City, NJ.`.\n12. Click the save icon.\n\nAdd an hours example for the information playbook:\n\n1. Similar to steps above, but enter the message: `What are your hours?` and name the example: `Hours`.\n\nAdd a selection example for the order playbook:\n\n1. Similar to steps above,\n but name the example `Selection`,\n select the order playbook,\n and send the following messages:\n\n - `I want to buy a shirt`\n - `Large`\n - `Green`\n - `Yes`\n\nTest the agent\n--------------\n\nYour agent is now ready to test.\nOpen the simulator panel\nand have a conversation with the agent.\nYou do not need to have the same conversations as above.\nFor example,\nyou can ask this agent which colors are available for shirts.\nIf you are not getting the desired behavior,\nrefining your examples and creating new ones will improve responses.\n\nInteracting with the agent using the API\n----------------------------------------\n\nSee\n[Interactions with the API](/dialogflow/cx/docs/quick/api)."]]
