Alguns produtos e recursos estão sendo renomeados. Os recursos de playbook generativo e de fluxo também estão sendo migrados para um único console consolidado. Confira os detalhes.
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Este guia mostra como criar e testar um agente simples de pedidos de camisetas
usando playbooks.
Ao interagir com esse agente,
é possível ver o local da loja,
o horário de funcionamento
ou fazer um pedido de camiseta.
Antes de começar
Faça o seguinte antes de ler este guia:
Se ainda não tiver feito isso, siga as instruções de
configuração.
Sobre os playbooks
Um agente é composto por um ou mais playbooks.
Cada playbook tem um escopo claramente definido e limitado.
Um playbook tem os seguintes dados:
X
Item
Nome
Um nome usado para identificar o playbook.
Meta
As metas são descrições gerais do que o playbook precisa alcançar.
Instruções
As instruções são etapas gerais que precisam ser seguidas para alcançar a meta do playbook.
Exemplos
Os exemplos são conversas entre um usuário final e o agente. Esses exemplos são exemplos de comando de poucos disparos para o LLM.
Selecione Playbook para a opção Início da conversa.
Clique em Criar.
A interface do usuário leva você ao playbook padrão
chamado playbook generativo padrão.
Clique no botão "Voltar" "Voltar" para ver a lista de playbooks.
Criar o playbook de pedidos
O playbook Pedido processa pedidos de camisetas.
Para criar este playbook:
Clique em Criar.
Selecione a opção Playbook de tarefas.
Insira o nome do playbook: Order.
Insira a seguinte meta:
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.
Siga estas instruções:
- 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.
Clique em Salvar.
Clique no botão "Voltar" "Voltar" para retornar à lista de playbooks.
Criar o playbook de informações
O manual Informações responde a perguntas sobre a loja.
Para criar este playbook:
Clique em Criar.
Selecione a opção Playbook de tarefas.
Insira o nome do playbook: Information.
Insira a seguinte meta:
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.
Siga estas instruções:
- 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.
Clique em Salvar.
Clique no botão "Voltar" "Voltar" para retornar à lista de playbooks.
Atualizar o playbook padrão
Quando você criou o aplicativo,
um playbook padrão foi criado para você.
Esse playbook precisa direcionar a conversa
para os playbooks apropriados com metas específicas.
Nas instruções abaixo,
você pode conferir como o playbook padrão faz referência aos outros playbooks.
Para atualizar este manual:
Clique no playbook padrão. Este manual tem uma estrela destacada.
Insira a seguinte meta:
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.
Siga estas instruções:
- 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}
Clique em Salvar.
As referências do playbook estão destacadas
porque ainda não há exemplos.
Eles serão adicionados na próxima seção.
Clique no botão "Voltar" "Voltar" para retornar à lista de playbooks.
dê exemplos
Nesse ponto,
seu playbook está funcional.
No entanto, é necessário fornecer
exemplos
para garantir respostas de qualidade.
Você pode fornecer exemplos manualmente na guia Examples
quando um playbook estiver aberto.
No entanto, muitas vezes é mais fácil ter uma conversa com o
livro de referência em funcionamento e salvar a conversa como um exemplo.
Um exemplo de conversa com um playbook padrão é curto.
Este playbook só precisa direcionar você para outro.
Para conversar com o playbook padrão:
Feche ou cancele qualquer painel que esteja no lado direito da tela.
Clique no botão question_answer
do simulador na navegação da linha superior.
Em "Recurso", selecione o playbook padrão.
Use o modelo padrão ou selecione uma alternativa.
Na caixa de texto Enter user input,
digite Hello e pressione Enter.
O playbook responde com uma saudação.
Para salvar esta conversa como um exemplo:
Selecione o playbook padrão no menu suspenso Invocations.
Clique no botão Salvar como exemplo no canto superior direito da interface.
O painel do editor de exemplo é aberto.
Use esse editor para adicionar, editar, excluir ou reordenar ações.
Forneça o nome de exemplo: Greeting.
Atualize as respostas do playbook conforme necessário.
Role para baixo até o Exemplo final com informações de saída
e insira The user is greeted. na seção Resumo.
Clique no ícone de salvar.
Adicione um exemplo de local para o playbook de informações:
Feche ou cancele qualquer painel que esteja no lado direito da tela.
Se necessário, redefina a conversa com o botão
restart_alt.
Selecione o playbook de informações no menu suspenso Start Resource do simulador.
Digite a mensagem: Where are you located?.
O playbook responde com um local.
Selecione o playbook de informações no menu suspenso Invocações.
Clique no botão Salvar como exemplo.
Forneça o nome de exemplo: Location.
Antes de salvar essa conversa como exemplo,
exclua a ação que contém "Onde você está?".
Somente os exemplos de playbook padrão podem começar com uma ação do usuário.
Para fornecer o exemplo com o contexto que iniciou a conversa,
abra a seção Sumário da conversa anterior
e insira o seguinte
no campo Inicia o exemplo com informações de entrada:
The customer asked "Where are you located?".
Para fornecer o exemplo com o contexto que completa a conversa,
abra a seção Resumo da execução do playbook...
e insira o seguinte
no campo Finalizar exemplo com informações de saída:
The store is located at 1007 Mountain Drive, Gotham City, NJ..
Clique no ícone de salvar.
Adicione um exemplo de horário para o playbook de informações:
Semelhante às etapas acima,
mas insira a mensagem: What are your hours? e
nomeie o exemplo: Hours.
Adicione um exemplo de seleção para o playbook de pedidos:
Semelhante às etapas acima,
mas nomeie o exemplo como Selection,
selecione o modelo de pedido
e envie as seguintes mensagens:
I want to buy a shirt
Large
Green
Yes
Testar o agente
Seu agente está pronto para ser testado.
Abra o painel do simulador
e converse com o agente.
Não é necessário ter as mesmas conversas acima.
Por exemplo,
é possível perguntar a esse agente quais cores estão disponíveis para as camisas.
Se você não estiver recebendo o comportamento desejado,
refinar seus exemplos e criar novos vai melhorar as respostas.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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)."]]
