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.

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 agente | Descrição |
---|---|
Amigável | Interage 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. |
Cooperativo | Trabalha 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. |
Extrovertido | Com 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. |
Generoso | Oferece 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. |
Organizado | Garante 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ático | Com 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. |
Inovador | Quando confrontado com um problema ou situação difícil, propõe novas soluções e apresenta ideias criativas que são eficazes. |
Criativo | Utiliza 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. |
Intelectual | Oferece 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
.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:
- Clique em
Adicionar site
. - Em seguida, copie a URL do site que você quer adicionar e cole-a no campo vazio.
- 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 .

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

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