Criar um agente usando playbooks

Criar e testar um agente de pedidos de camisetas usando playbooks. Use o agente para perguntar o local da loja, o horário de funcionamento ou fazer um pedido de camiseta.

Antes de começar

Se ainda não fez isso, siga as instruções de configuração.

Sobre os playbooks

Um agente consiste em um ou mais playbooks. Cada playbook tem um escopo claramente definido e limitado. A tabela a seguir descreve os dados em um playbook:

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 gerais que devem ser seguidas para alcançar o objetivo do playbook.
Exemplos	Os exemplos são conversas entre um usuário final e o agente. Eles são, de fato, exemplos de comandos de poucos disparos (few-shot) para o LLM.

Criar um agente

Para criar um agente, siga estas etapas:

1. Acesse https://conversational-agents.cloud.google.com/.
2. Se ainda não fez isso, selecione ou crie um projeto.
3. Clique em Criar agente.
4. Clique em Crie seu próprio.
5. Insira "Pedido de camisetas - Playbooks" como nome do agente.
6. Insira um local.
7. Insira um fuso horário.
8. Insira um idioma padrão.
9. Selecione Playbook para a opção Início da conversa.
10. Clique em Criar.
11. A interface do usuário leva você ao playbook padrão chamado Playbook generativo padrão.
12. Clique em Voltar para retornar à lista de playbooks.

Criar o playbook de pedidos

O playbook Pedido processa pedidos de camisetas.

Para criar o playbook:

1. Clique em Criar.
2. Selecione a opção Playbook de tarefas.
3. Insira o nome do playbook: Order.

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

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

6. Clique em Salvar.

7. Clique em Voltar para retornar à lista de playbooks.

Criar o playbook de informações

O playbook Informações processa perguntas sobre a loja.

Para criar o playbook:

1. Clique em Criar.
2. Selecione a opção Playbook de tarefas.
3. Insira o nome do playbook: Information.

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

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

6. Clique em Salvar.

7. Clique em Voltar para retornar à lista de playbooks.

Atualizar o playbook padrão

Quando você cria o agente pela primeira vez, um playbook padrão é criado para você. Esse playbook direciona a conversa para os playbooks apropriados com metas específicas. Você pode conferir como o playbook padrão faz referência aos outros playbooks nas instruções a seguir.

Para atualizar o playbook:

1. Clique no playbook padrão, que está marcado com uma estrela.

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. Insira as seguintes instruções:

   - If the customer hasn't been greeted yet, greet the customer,
     introduce yourself, and ask 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}
   

4. Clique em Salvar.

5. Observe que as referências do playbook estão destacadas porque ainda não há exemplos. Você vai adicioná-los na próxima seção.

6. Clique em Voltar para retornar à lista de playbooks.

Dê exemplos

O playbook é funcional, mas fornecer exemplos garante respostas de qualidade.

É possível fornecer exemplos na guia Exemplos quando um playbook está aberto. No entanto, geralmente é mais fácil conversar com o agente e salvar a conversa como um exemplo.

Uma conversa de playbook padrão é curta. Esse playbook precisa direcionar a conversa para outro playbook.

Para conversar com o playbook padrão:

1. Feche ou cancele qualquer painel que possa estar presente no lado direito da tela.
2. Toque no botão do simulador na navegação da linha superior.
3. Para o recurso, selecione o playbook padrão.
4. Use o modelo padrão ou selecione uma alternativa.
5. No campo Inserir entrada do usuário , digite Hello e pressione Enter.
6. O playbook responde com uma saudação.

Para salvar essa conversa como um exemplo:

1. Selecione o playbook padrão na lista Invocações.
2. Clique em Salvar como exemplo.
3. No painel do editor de exemplos, adicione, edite, exclua ou reordene ações.
4. Insira Greeting como nome do exemplo.
5. Atualize as respostas do playbook conforme necessário.
6. Na seção Concluir o exemplo com informações de saída, insira The user is greeted. no campo Resumo.
7. Clique em Salvar.

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

1. Feche ou cancele qualquer painel no lado direito da tela.
2. Se necessário, redefina a conversa com o reset restart_alt botão.
3. Selecione o playbook de informações no menu Recurso inicial do simulador.
4. Digite Where are you located? e pressione Enter.
5. Selecione o playbook de informações no menu Invocações.
6. Clique em Salvar como exemplo.
7. Insira Location como nome do exemplo.
8. Exclua a ação que contém Where are you located?, porque apenas exemplos de playbook padrão podem começar com uma ação do usuário.
9. Expanda a seção Resumo da conversa anterior e insira The customer asked "Where are you located?" no campo Começa o exemplo com informações de entrada.
10. Expanda a seção Resumo da execução do playbook e insira The store is located at 1007 Mountain Drive, Gotham City, NJ. no campo Concluir o exemplo com informações de saída.
11. Clique em Salvar.

Adicione um exemplo de horário para o playbook de informações:

1. Selecione o playbook de informações no simulador.
2. Insira a mensagem What are your hours?.
3. Salve a conversa como um exemplo chamado Hours.

Adicione um exemplo de seleção para o playbook de pedidos seguindo estas etapas:

1. Nomeie o exemplo Selection.
2. Selecione o playbook de pedidos.
3. Envie as seguintes mensagens:
   • I want to buy a shirt
   • Large
   • Green
   • Yes

Testar o agente

Seu agente já está pronto para ser testado. Abra o painel do simulador e converse com o agente. Você pode ter conversas diferentes das descritas anteriormente. Por exemplo, você pode perguntar a esse agente quais cores estão disponíveis para camisetas. Se você não estiver alcançando os resultados necessários, refinar ou adicionar exemplos vai melhorar as respostas.

Interagir com o agente usando a API

Para mais informações sobre como interagir com a API, consulte Interações com a API.