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 do Dialogflow.
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 de alto nível 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. |
Crie um agente
Para criar o agente:
Acesse o console do Criador de agentes:
Selecione seu projeto no menu suspenso do console.
Se você ainda não ativou a API, leia e aceite os Termos de Serviço e clique em Continuar e ativar a API.
Clique em Criar um novo app ou Novo app.
Selecione Agente.
Dê o nome "Assistente de pedidos de camisas" para o app.
Selecione uma região.
Clique em Criar.
A interface do usuário leva você ao playbook padrão chamado Agente 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.
- Insira o nome:
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.
- Insira o nome:
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.
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 estratégias 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. Você quer acessar o painel do simulador que contém Enviar uma mensagem para saber como o agente responde.
- Selecione o playbook padrão.
- Selecione o modelo:
gemini-pro
. - 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:
- Clique no botão Save example perto do canto superior direito da interface.
- O painel de exemplo do editor é aberto. Você pode usar 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.
Clique em 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.
- Selecione o modelo:
gemini-pro
. - Digite a mensagem:
Where are you located?
. - O playbook responde com um local.
- Salve esta conversa como um exemplo com o nome
Location
. Somente os exemplos de playbook padrão podem começar com uma ação do usuário. Portanto, exclua a ação que contém "Onde você está localizado". Insira o resumo do contexto da conversa anterior:The customer asked "Where are you located?"
. Insira o resumo de execução de exemplo:The store is located at 1007 Mountain Drive, Gotham City, NJ.
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 camisas. Se você não estiver recebendo o comportamento desejado, refinar seus exemplos e criar novos vai melhorar as respostas.
Como interagir com o agente usando a API
Consulte Interações com a API.