{"section":"tutorials","requestedLocale":"pt","requestedSlug":"visao-geral-agent-builder","locale":"pt","slug":"visao-geral-agent-builder","path":"docs/pt/tutorials/weni-by-vtex/agent-builder/visao-geral-agent-builder.md","branch":"main","content":"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, permitindo que eles solicitem informações sobre um pedido em andamento, o catálogo da sua loja e o cancelamento de um pedido, por exemplo.\n\nA 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.\n\n> ℹ️ Para saber mais sobre os agentes colaboradores, leia o artigo [Agentes oficiais da Weni by VTEX](/pt/docs/tutorials/agentes-oficiais-da-weni-by-vtex).\n\nAlém de atribuir e testar esses agentes, você também pode criar agentes próprios que atendam a necessidades específicas da sua empresa.\n\n> ⚠️ Para criar agentes customizados, use o CLI da Weni by VTEX. Confira a [documentação](https://weni-ai.github.io/weni-cli/getting-started/installation/) para criar seu próprio agente.\n\n## Agent Builder\n\nPara acessar o **Agent Builder**, selecione a Organização na página inicial da Weni by VTEX e, em seguida, o projeto que deseja gerenciar. No menu lateral, clique em **Agent Builder**.\n\nEm **Agent Builder**, as seguintes páginas estão disponíveis:\n\n- [**Supervisor**](#supervisor)\n- [**Perfil**](#perfil)\n- [**Agentes**](#agentes)\n- [**Conhecimento**](#conhecimentos)\n- [**Ajustes**](#ajustes)\n\n### Supervisor\n\nNessa página, você pode analisar e revisar as conversas entre agentes e clientes. Ela é dividida em duas seções:\n\n- **Atendido pelo agente**\n- **Encaminhado para suporte humano**\n\nA 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.\n\nNo campo `Buscar`, você pode buscar conversas e observar os resultados.\n\nNo canto superior, estão as datas das interações. Você pode clicar na data para alterar o intervalo de tempo e filtrar os resultados exibidos.\n\n\n\n### Perfil\n\nEssa página contém campos customizáveis para personalizar a identidade e o comportamento do seu agente orquestrador.\n\nPara customizar o seu agente, use os campos a seguir:\n\n**Como o agente se apresenta?:** nome do agente que será exibido aos clientes.\n**Qual é a função principal do agente?:** função principal do agente para os usuários entenderem a sua especialidade (por exemplo: atendente).\n**Qual é o objetivo principal do agente?:** objetivo principal do agente (por exemplo: ajudar a tirar dúvidas).\n**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 no menu dropdown.\n\nLeia a seguir a descrição detalhada de cada tom de voz:\n\n| Tom de voz do agente | Descrição |\n| :-------------: | :------------- |\n| Amigável | Interage de forma calorosa e acolhedora, fazendo o cliente se sentir confortável e bem-vindo, estabelecendo uma conexão com simpatia e compreensão. |\n| 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. |\n| 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. |\n| Generoso | Oferece informações adicionais e recursos que podem ser úteis, mesmo antes de serem solicitados. |\n| 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. |\n| 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. |\n| 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. |\n| Inovador | Quando confrontado com um problema ou situação difícil, propõe novas soluções e apresenta ideias criativas e eficazes. |\n| 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. |\n| 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. |\n\nNa seção **Instruções gerais**, você pode adicionar instruções diretas para seu agente para determinar como ele se comporta.\n\nSe você adicionou uma instrução e deseja excluí-la, clique no botão de lixeira ao lado da instrução. Será exibida uma mensagem perguntando se você deseja excluir a instrução. Clique em `Excluir` para excluí-la ou `Cancelar` se deseja mantê-la. \n\n> ℹ️ Não há um limite para a quantidade de instruções.\n\nAo final, para salvar as características do seu agente, clique no botão `Salvar alterações`, no canto direito da tela.\n\n### Agentes\n\nNessa página, você pode atribuir e testar agentes para a sua loja.\n\nPara entender como fazer isso, leia o artigo [Como atribuir e testar um agente](/pt/docs/tutorials/atribuir-e-testar-agentes).\n\n### Conhecimento\n\nNessa 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.\n\n#### Arquivos\n\nPara adicionar um arquivo à base de dados, clique em `Adicionar arquivo`.\n\n> ⚠️ O envio do arquivo só ocorrerá se os arquivos tiverem extensão `.pdf`, `.doc`, `.docx`, `.txt`, `. xls` ou `.xlsx` e tamanho de até 50 MB.\n\nClicando nos três pontos ao lado do nome do arquivo, é possível:\n\n- Ver detalhes (como a data em que foi adicionado e o conteúdo).\n- Baixar o arquivo.\n- Remover o arquivo.\n\nVocê também pode usar o campo de busca para encontrar um arquivo.\n\n#### Sites\n\nPara inserir um site na base de dados do agente, siga este passo a passo:\n\n1. Clique em `Adicionar site`.\n2. Em seguida, copie a URL do site que deseja adicionar e cole-a no campo vazio.\n3. Clique em `Concluir`.\n\nClicando nos três pontos ao lado do site, é possível:\n\n- Ver detalhes (como a data em que foi adicionado e o conteúdo).\n- Acessar o site.\n- Remover o site.\n\nVocê também pode usar o campo de busca para encontrar um site.\n\n#### Textos:\n\nNessa página, você pode inserir conteúdos e informações na caixa de texto **Escrever conteúdo.**\n\nApós inserir um texto, clique em `Salvar alterações`. \n\n### Ajustes\n\nNessa página, você pode alterar os ajustes dos seus agentes.\n\n#### Configurações:\n\nAbaixo de **Prévia dos agentes,** há dois botões de alternância:\n\n- **Feedback progressivo dos agentes:** ative-o se quiser que o agente envie atualizações em tempo real ao usuário enquanto redige a resposta final. Caso contrário, deixe-o desativado .\n\n\n\n- **Formato de mensagem múltipla:** ative-o se quiser que o agente envie várias mensagens, como respostas rápidas, listas, catálogo. Caso contrário, deixe-o desativado . \n\n\n\nAbaixo de **Suporte humano,** há um botão de alternância:\n\n**Suporte humano:** ative-o para que o agente possa encaminhar a conversa para um humano. Caso contrário, deixe-o desativado .\n\nNa 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.\n\n#### Credenciais\n\nNessa seção, você pode visualizar as credenciais utilizadas pelos agentes oficiais e personalizados.\n\n> ℹ️ Leia mais sobre o assunto no artigo [Agentes oficiais da Weni by VTEX](/pt/docs/tutorials/agentes-oficiais-da-weni-by-vtex).\n\n#### Histórico de alterações\n\nNessa seção, você pode visualizar quais alterações foram feitas nos agentes, quem as fez e a data dessas alterações.\n\nOs logs indicam:\n\n- Adição, alteração ou remoção de instrução.\n- Adição, alteração ou remoção de conteúdo de conhecimento.\n- Alteração de nome, função e objetivo do agente.\n\nVocê também pode utilizar a caixa de filtro do lado direito para visualizar por tipo de alteração, como:\n\n- Todas as alterações\n- Alterações de personalização\n- Alterações de conteúdo\n- Alterações de ações\n- Alterações de configurações"}