Menu
Feedback
Comece aqui
Tutoriais


Visão geral Agent Builder
6 min de leitura

O Agent Builder é uma ferramenta de conversação com o cliente baseada em inteligência artificial. Usando essa funcionalidade, você pode customizar agentes para interagir com seus clientes, que podem pedir informações sobre um pedido em andamento, o catálogo da sua loja e cancelamento de pedidos, por exemplo.

A funcionalidade se concentra em um agente orquestrador, que é o ponto de contato com o cliente e assume o controle do chat. Esse orquestrador aciona agentes colaboradores que retornam dados e informações conforme as necessidades do usuário.

Para saber mais sobre os agentes colaboradores, leia o artigo <a href=”https://help.vtex.com/pt/tutorial/agentes-oficiais-da-weni-by-vtex--7E8wlD3T41CiOexDVH1SIy”>Agentes oficiais da Weni by VTEX.

Além de atribuir e testar esses agentes, você também pode criar agentes próprios que atendam a necessidades específicas da sua empresa.

Para criar agentes customizados, use o CLI da Weni by VTEX. Confira a <a href=”https://weni-ai.github.io/weni-cli/getting-started/installation/”>documentação para criar seu próprio agente.

Agent Builder

Para acessar o Agent Builder, selecione a Organização na página inicial da Weni by VTEX e, em seguida, o Projeto que você quer gerenciar. No menu lateral, clique em Agent Builder.

Você pode acessar as seguintes páginas em Agent Builder:

Supervisor

Nessa página, você pode analisar e revisar as conversas entre agentes e clientes. Ela é dividida em duas seções:

  • Atendido pelo agente
  • Encaminhado para suporte humano

A seção Atendido pelo agente mostra o percentual de conversas atendidas e resolvidas pelos agentes. Já a seção Encaminhado para suporte humano mostra o percentual de atendimentos que precisaram ser encaminhados a humanos.

No campo Pesquisar, você pode buscar conversas e observar os resultados.

No canto superior, estão as datas das interações. Você pode clicar na data para alterar o intervalo de tempo e filtrar os resultados que aparecem.

{"base64":"","img":{"width":1464,"height":550,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":104213,"url":"//images.ctfassets.net/alneenqid6w5/5Uqo1q2IiTHirEU2NN3QJl/9302ead016b66680a701634e273a565a/Screenshot_2025-07-25_at_14.10.16.png"}}

Perfil

Essa página contém campos customizáveis para personalizar a identidade e o comportamento do seu agente orquestrador.

Para customizar o seu agente, use os campos a seguir:

  • Como o agente se apresenta?: nome do agente que será exibido para os clientes.
  • Qual é a função principal do agente?: função principal do agente para os usuários entenderem a sua especialidade (por exemplo: Atendente).
  • Qual é o objetivo principal do agente?: objetivo principal do agente (por exemplo: ajudar a tirar dúvidas).
  • Qual é o tom de voz do agente?: tom de voz que o agente vai usar para se comunicar com os usuários. Clique nesse campo e selecione um dos tons de voz predefinidos exibidos no menu dropdown.

Leia a seguir a descrição detalhada de cada tom de voz:

Tom de voz do agenteDescrição
AmigávelInterage de forma calorosa e acolhedora, fazendo o cliente se sentir confortável e bem-vindo e estabelecendo uma conexão baseada na simpatia e compreensão.
CooperativoTrabalha em conjunto com o cliente para encontrar soluções. Prioriza o trabalho em equipe e está focado em garantir que as necessidades do cliente sejam atendidas com o menor esforço possível.
ExtrovertidoCom uma personalidade animada e expressiva, comunica-se de forma aberta e entusiástica. Está sempre motivado e transmite energia positiva durante as interações, tornando as conversas dinâmicas e envolventes.
GenerosoOferece informações adicionais e recursos que podem ser úteis, mesmo antes de serem solicitados.
RelaxadoÉ descontraído e lida com situações difíceis de forma calma. Mantém uma conversa agradável e dá ao cliente o tempo necessário para processar informações e tomar decisões.
OrganizadoGarante que todas as informações estejam dispostas de forma clara e acessível. Ele é meticuloso e eficaz, guiando o cliente por cada etapa de maneira lógica, para que nenhum detalhe seja perdido.
SistemáticoCom um método claro e bem estruturado, segue passos definidos para resolver problemas. Usa uma abordagem lógica e ordenada, com consistência e precisão na comunicação e no suporte ao cliente.
InovadorQuando confrontado com um problema ou situação difícil, propõe novas soluções e apresenta ideias criativas que são eficazes.
CriativoUtiliza a imaginação para se comunicar. Ele é capaz de oferecer respostas diferenciadas e adaptar a linguagem para tornar o conteúdo mais relevante e cativante para o cliente.
IntelectualOferece respostas detalhadas e informadas. Ele fornece uma explicação aprofundada, baseada em fatos e lógica, atendendo às necessidades dos clientes que desejam mais clareza e entendimento.

Na seção de Instruções gerais, você pode adicionar instruções diretas para seu agente, que determinam como ele se comporta.

Se você adicionou uma instrução e quer deletá-la, basta clicar no botão de lixeira ao lado da instrução. Uma mensagem vai aparecer perguntando se você deseja remover a instrução. Clique em Remover para deletá-la ou Cancelar se deseja mantê-la.

Não há um limite para a quantidade de instruções.

Ao final, para salvar as características do seu agente, clique no botão Salvar alterações, no canto direito da tela.

Agentes

Nessa página, você consegue atribuir e testar agentes para a sua loja.

Para entender como fazer isso, leia o artigo Como atribuir e testar um agente.

Conhecimento

Nessa página, você pode adicionar arquivos, sites e textos à base de conhecimento do seu agente. Os agentes vão utilizar os dados desses documentos para responder aos usuários.

Arquivos

Para adicionar um arquivo à base de dados, clique em Adicionar arquivo.

O upload só ocorrerá se os arquivos tiverem extensão .pdf, .doc, .docx, .txt, .xls ou .xlsx e até 50 MB de tamanho.

Clicando nos três pontos ao lado do nome do arquivo, é possível:

  • Ver detalhes (como data em que foi adicionado e conteúdo).
  • Baixar arquivo.
  • Remover arquivo.

Você também consegue usar o campo de busca para encontrar um arquivo.

Sites

Para inserir um site na base de dados do agente, siga este passo a passo:

  1. Clique em Adicionar site.
  2. Em seguida, copie a URL do site que você quer adicionar e cole-a no campo vazio.
  3. Por fim, clique em Concluir.

Clicando nos três pontos ao lado do site, é possível:

  • Ver detalhes (como data em que foi adicionado e conteúdo).
  • Acessar site.
  • Remover site.

Você também consegue usar o campo de busca para encontrar um site.

Textos:

Nessa página, você consegue inserir conteúdos e informações na caixa de texto Escrever conteúdo.

Após inserir um texto, clique em Salvar alterações.

Ajustes

Nessa página, você consegue alterar os ajustes dos seus agentes.

Configurações:

Abaixo de Preview dos agentes, há dois toggles:

  • Feedback progressivo dos agentes: ative o toggle se quiser que o agente envie atualizações em tempo real ao usuário enquanto redige a resposta final. Caso contrário, deixe o toggle desativado .

{"base64":"","img":{"width":864,"height":864,"type":"gif","mime":"image/gif","wUnits":"px","hUnits":"px","length":786587,"url":"//images.ctfassets.net/alneenqid6w5/4nkuKaLyY6mHfASXSxKHYA/52a0ddf2651314b204a1dc5e6c5a3367/PT_gif.gif"}}

  • Formato de mensagem múltipla: ative o toggle se quiser que o agente envie várias mensagens, como respostas rápidas, listas, catálogo. Caso contrário, deixe o toggle desativado .

{"base64":"","img":{"width":344,"height":233,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":15196,"url":"//images.ctfassets.net/alneenqid6w5/UI2s7dILpF11AydI3EZXE/683c3fdf237803a44226c5758853d9da/Screenshot_2025-07-24_at_17.00.49.png"}}

Abaixo de Suporte humano, há um toggle:

  • Suporte humano: ative o toggle para que o agente possa encaminhar a conversa para um humano. Caso contrário, deixe o toggle desativado .

Na caixa de texto Quando o agente deve transferir a conversa para um humano?, adicione uma frase ou texto que exemplifique para o agente em que momento ele deverá encaminhar a conversa.

Credenciais

Nessa seção, você pode visualizar as credenciais utilizadas pelos agentes oficiais e pelos agentes personalizados.

Leia mais sobre o assunto no artigo Agentes oficiais da Weni by VTEX.

Histórico de alterações

Nessa seção, você pode visualizar quais alterações foram feitas nos agentes, quem as fez e a data dessas alterações.

Os registros indicam:

  • Adição, alteração ou remoção de instrução.
  • Adição, alteração ou remoção de conteúdo de conhecimento.
  • Alteração de nome, ocupação e objetivo do agente.

Você também pode utilizar a caixa de filtro do lado direito para visualizar por tipo de alteração, como:

  • Todas alterações
  • Alterações de personalização
  • Alterações de conteúdo
  • Alterações de ações
  • Alterações de configurações
Contribuidores
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Isso foi útil?
Sim
Não
Sugerir edições (GitHub)
Contribuidores
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Nesta página
Ainda tem dúvidas?
Pergunte à comunidade
Encontre soluções e compartilhe ideias na comunidade VTEX.
Junte-se à nossa comunidade
Solicite suporte à VTEX
Para assistência personalizada, entre em contato com nossos especialistas.
Abra um ticket de suporte
GithubDeveloper portalComunidadeFeedback