Criar um agente usando playbooks

Observação: o console do Criador de agentes ainda se refere aos playbooks como agentes. Ela vai ser atualizada para o playbook em breve no console.

Este guia mostra como criar e testar um pedido simples de camisas agente 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:

1. Caso ainda não tenha feito isso, siga as instruções configuração instruções.

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 atingir a meta do playbook.
Exemplos	Os exemplos são conversas de amostra entre um usuário final e o agente. Esses exemplos são de comandos de poucos disparos para o LLM.

Crie um agente

Para criar o agente:

1. Acesse o console do Criador de agentes:

   Console do Criador de agentes

2. Selecione seu projeto no menu suspenso do console.

3. Se você ainda não ativou a API, leia e aceite os Termos de Serviço e clique em Continuar e ativar a API.

4. Clique em Criar um novo app ou Novo app.

5. Selecione Agente.

6. Forneça "Assistente de pedidos de camisas" para o nome do app.

7. Selecione uma região.

8. Clique em Criar.

9. A interface do usuário leva você ao playbook padrão chamado Agente padrão.

10. Clique no botão "Voltar" para ver a lista de playbooks.

Criar o playbook de pedidos

O playbook Pedido processa pedidos de camisetas. Para criar este playbook:

1. Clique em Criar.
2. Insira o nome: Order.

3. 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.
   

4. Digite 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.
   

5. Clique em Salvar.

   

6. Clique no botão "Voltar" para retornar à lista de playbooks.

Criar o playbook de informações

O manual de informações responde a perguntas sobre a loja. Para criar este playbook:

1. Clique em Criar.
2. Digite o nome: Information.

3. Insira a meta a seguir:

   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.
   

4. Digite 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.
   

5. Clique em Salvar.

6. Clique no botão "Voltar" para retornar à lista de playbooks.

Atualizar o playbook padrão

Quando você criou o aplicativo pela primeira vez, 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 playbook:

1. Clique no playbook padrão. Este manual tem uma estrela destacada.

2. 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.
   

3. Digite 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 ${AGENT: Information}
   - If the customer wants to purchase a shirt,
     route them to ${AGENT: Order}
   

4. Clique em Salvar.

5. Clique no botão "Voltar" para retornar à lista de playbooks.

dê exemplos

Neste ponto, seu playbook esteja funcionando. No entanto, Você precisa 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 é breve. Este playbook só precisa direcionar você a outro. Para conversar com o playbook padrão:

1. Feche ou cancele qualquer painel que possa estar no lado direito da tela. Você quer acessar o painel do simulador que contém Enviar uma mensagem para saber como o agente responde.
2. Selecione o playbook padrão.
3. Selecione o modelo: gemini-pro.
4. Na caixa de texto Insira a entrada do usuário, Digite Hello e pressione Enter.
5. O playbook responde com uma saudação.

Para salvar esta conversa como exemplo:

1. Clique no Botão Salvar exemplo próximo ao canto superior direito da interface.
2. O painel de exemplo do editor é aberto. Você pode usar esse editor para adicionar, editar, excluir ou reordenar ações.
3. Forneça o nome de exemplo: Greeting.
4. Atualize as respostas do playbook conforme necessário.

5. Clique em Salvar.

   

Adicione um exemplo de local para o playbook de informações:

1. Feche ou cancele qualquer painel que possa estar no lado direito da tela. Se necessário, redefina a conversa com o botão restart_alt.
2. Selecione o playbook de informações.
3. Selecione o modelo: gemini-pro.
4. Digite a mensagem: Where are you located?.
5. O playbook responde com um local.
6. 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á?".

Adicione um exemplo de horas para o playbook de informações:

1. 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:

1. 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 tiver o comportamento desejado, refinar os exemplos e criar outros vai melhorar as respostas.

Como interagir com o agente usando a API

Consulte Interações com a API.