Criar um app do agente

Este guia mostra como criar e testar um app simples de agente de pedidos de camisas. Ao interagir com esse app de agente, é possível solicitar o local da loja, saber o horário de funcionamento ou fazer um pedido de camisa.

Antes de começar

Faça o seguinte antes de ler este guia:

  1. Siga as instruções de setup do Dialogflow, caso ainda não tenha feito isso.

Sobre os apps de agentes

Um app de agente é composto por um ou mais agentes. Cada agente tem um escopo limitado e claramente definido. Um agente tem os seguintes dados:

X Item
Nome Um nome usado para identificar o agente.
Meta As metas são descrições resumidas do que o agente precisa realizar.
Instruções As instruções são etapas gerais que precisam ser seguidas para alcançar a meta do agente.
Examples Os exemplos são conversas de exemplo entre um usuário final e o agente. Esses são exemplos de comandos few-shot para o LLM.

Criar aplicativo

Para criar o aplicativo:

  1. Acesse o console da Vertex AI para Conversação:

    Console de conversação da Vertex AI

  2. Selecione o projeto no menu suspenso do console.

  3. Se você ainda não tiver ativado a API, leia e concorde com 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 Agent.

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

  7. Selecione uma região.

  8. Clique em Criar.

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

  10. Clique no botão "Voltar" "Voltar" para exibir a lista de agentes.

Criar o agente de pedido

O agente Order processa os pedidos de camisas. Para criar esse agente:

  1. Clique em Criar.
  2. Digite o nome: Order.
  3. Insira a meta a seguir:

    You are a shirt store ordering agent. 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. 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.
    
  5. Clique em Salvar.

    Captura de tela do app do agente de pedidos

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

Criar o agente de informações

O agente Informações lida com perguntas sobre a loja. Para criar esse agente:

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

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

Atualizar o agente padrão

Quando você criou o aplicativo, um agente padrão foi criado para você. Esse agente precisa direcionar a conversa para os agentes apropriados com metas específicas. Nas instruções abaixo, é possível ver como o agente padrão referencia os outros. Para atualizar esse agente:

  1. Clique no agente padrão. Este agente tem uma estrela destacada.
  2. Insira a meta a seguir:

    You are an agent for a shirt store.
    Your name is "Samantha".
    Your job is to direct customers to other agents 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 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" "Voltar" para retornar à lista de agentes.

dê exemplos

Neste ponto, seu agente já está funcionando. No entanto, você precisa fornecer exemplos para garantir respostas de qualidade.

É possível fornecer exemplos manualmente na guia Exemplos quando um agente estiver aberto. No entanto, muitas vezes é mais fácil conversar com o agente funcional e salvar a conversa como um exemplo.

Um exemplo de conversa com um agente padrão é curto. Este agente só precisa direcionar você a outro agente. Para conversar com o agente padrão:

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

Para salvar esta conversa como um exemplo:

  1. Clique no botão Salvar como exemplo perto do canto superior direito da interface.
  2. O painel do editor de exemplo será aberto. Você pode usar este editor para adicionar, editar, excluir ou reordenar ações.
  3. Forneça o nome do exemplo: Greeting.
  4. Atualize as respostas do agente conforme necessário.
  5. Clique em Salvar.

    Captura de tela com um exemplo de saudação

Adicione um exemplo de local para o agente 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 de redefinição restart_alt.
  2. Selecione o agente de informações.
  3. Selecione o modelo: gemini-pro.
  4. Digite a mensagem: Where are you located?.
  5. O agente responde com um local.
  6. Salve a conversa como um exemplo chamado Location. Somente os exemplos de agente padrão podem começar com uma ação do usuário. Portanto, exclua a ação que contém "Onde você está localizado".

Adicione um exemplo de horário de funcionamento para o agente 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 agente de pedido:

  1. Semelhante às etapas acima, mas nomeie o exemplo como Selection, selecione o agente de ordenação e envie as seguintes mensagens:

    • I want to buy a shirt
    • Large
    • Green
    • Yes

    Captura de tela do exemplo de entrada

Testar o app do agente

Seu app do agente está pronto para teste. Abra o painel do simulador e converse com o agente. Você não precisa ter as mesmas conversas acima. Por exemplo, você pode perguntar a esse app de agente quais cores estão disponíveis para camisas. Se você não estiver obtendo o comportamento desejado, refinar os exemplos e criar novos melhorará as respostas.

Como interagir com o app do agente usando a API

Consulte Interações com a API.