Criar um agente usando playbooks

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:

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

  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. Dê o nome "Assistente de pedidos de camisas" para o 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" "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. 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.
    
  5. Clique em Salvar.

    Captura de tela do agente de pedidos

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

  1. Clique em Criar.
  2. Insira o nome: Information.
  3. 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.
    
  4. 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.
    
  5. Clique em Salvar.

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

  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. 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}
    
  4. Clique em Salvar.

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

  1. 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.
  2. Selecione o playbook padrão.
  3. Selecione o modelo: gemini-pro.
  4. Na caixa de texto Enter user input, digite Hello e pressione Enter.
  5. O playbook responde com uma saudação.

Para salvar esta conversa como um exemplo:

  1. Clique no botão Save example perto do 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.

    Captura de tela do exemplo de saudações

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

  1. Feche ou cancele qualquer painel que esteja 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á 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:

  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

    Captura de tela com um exemplo de entrada

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.