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:
- Siga as instruções de configuração, caso ainda não tenha feito isso.
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. |
| Objetivo | As metas são descrições gerais do que o playbook deve realizar. |
| Instruções | As instruções são etapas de alto nível que precisam ser seguidas para alcançar o objetivo do playbook. |
| Exemplos | Os exemplos são conversas entre um usuário final e o agente. Esses exemplos são, de fato, exemplos de comandos de poucos disparos (few-shot) para o LLM. |
Crie um agente
Para criar o agente:
Acesse o console dos Agentes de conversação:
Selecione ou crie um projeto, caso ainda não tenha feito isso.
Clique em Criar agente.
Clique em Crie seu próprio.
Insira "Pedido de camisetas - Playbooks" como nome do agente.
Forneça um local.
Forneça um fuso horário.
Forneça um idioma padrão.
Selecione Playbook para a opção Início da conversa.
Clique em Criar.
A interface do usuário direciona você para o playbook padrão chamado Playbook generativo padrão.
Clique no botão "Voltar" para conferir a lista de playbooks.
Criar o playbook de pedidos
O playbook Pedido processa pedidos de camisetas. Para criar esse 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.Insira as seguintes 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" para retornar à lista de playbooks.
Criar o playbook de informações
O playbook Informações processa perguntas sobre a loja. Para criar esse 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.Insira as seguintes 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" 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 deve 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 esse playbook:
- Clique no playbook padrão. Esse playbook 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.Insira as seguintes 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 são destacadas porque ainda não há exemplos. Elas serão adicionadas na próxima seção.
Clique no botão "Voltar" para retornar à lista de playbooks.
Dê exemplos
Nesse momento, o playbook está funcional. No entanto, você precisa fornecer exemplos para garantir respostas de qualidade.
É possível fornecer exemplos manualmente na guia Exemplos quando um playbook está aberto. No entanto, geralmente é mais fácil conversar com o playbook em funcionamento e salvar a conversa como um exemplo.
Uma conversa de exemplo com um playbook padrão é curta. Esse playbook só precisa direcionar você para outro playbook. Para conversar com o playbook padrão:
- Feche ou cancele qualquer painel que possa estar presente no lado direito da tela.
- Clique no botão do simulador na linha de navegação superior.
- Para o recurso, selecione o playbook padrão.
- Use o modelo padrão ou selecione uma alternativa.
- Na caixa de texto que diz Insira a entrada do usuário,
digite
Hello, e pressione Enter. - O playbook responde com uma saudação.
Para salvar essa conversa como um exemplo:
- Selecione o playbook padrão no menu suspenso Invocações.
- Clique no botão Salvar como exemplo perto do canto superior direito da interface.
- O painel do editor de exemplos é aberto. É possível usar esse editor para adicionar, editar, excluir ou reordenar ações.
- Forneça o nome do exemplo:
Greeting. - Atualize as respostas do playbook conforme necessário.
- Role para baixo até Concluir o exemplo com informações de saída e insira
The user is greeted.na seção Resumo. - Clique no ícone "Salvar".
Adicione um exemplo de local para o playbook de informações:
- Feche ou cancele qualquer painel que possa estar presente no lado direito da tela.
- Se necessário, redefina a conversa com o reset restart_alt botão.
- Selecione o playbook de informações no menu suspenso Recurso inicial do simulador.
- Insira 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 do exemplo:
Location. - Antes de salvar essa conversa como um exemplo, exclua a ação que contém "Where are you located". 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,
expanda a seção Resumo da conversa anterior...
e insira o seguinte
no campo Começa o exemplo com informações de entrada:
The customer asked "Where are you located?". - Para fornecer o exemplo com o contexto que conclui a conversa, expanda a seção Resumo da execução do playbook... e insira o seguinte no campo Concluir o exemplo com informações de saída :
The store is located at 1007 Mountain Drive, Gotham City, NJ.. - Clique no ícone "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
Selection, selecione o playbook de pedidos e envie as seguintes mensagens:I want to buy a shirtLargeGreenYes
Testar o agente
O agente já 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, você pode perguntar a esse agente quais cores estão disponíveis para camisetas. Se você não estiver recebendo o comportamento desejado, refinar seus exemplos e criar novos vai melhorar as respostas.
Interagir com o agente usando a API
Consulte Interações com a API.