{"section":"tutorials","requestedLocale":"pt","requestedSlug":"visao-geral-agent-builder","locale":"pt","slug":"visao-geral-agent-builder","path":"docs/pt/tutorials/vtex-cx-platform/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 (ou manager), 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 do VTEX CX Platform](https://help.vtex.com/pt/docs/tutorials/agentes-oficiais-da-vtex-cx-platform).\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 do VTEX CX Platform. Confira a [documentação](https://developers.vtex.com/docs/guides/using-the-weni-by-vtex-cli) para criar seu próprio agente.\n\n## Agent Builder\n\nPara acessar o **Agent Builder**, selecione a Organização na página inicial do VTEX CX Platform e, em seguida, o projeto que deseja gerenciar.\n\nEm **Agent Builder**, as seguintes páginas estão disponíveis:\n\n- [**Meus agentes**](#meus-agentes)\n- [**Base de conhecimento**](#base-de-conhecimento)\n- [**Fluxo de automação**](#fluxo-de-automacao)\n\n### Meus agentes\n\n> Nessa página, você pode atribuir e testar agentes para a sua loja, além de editar o manager e as instruções que ele deve seguir.\n\nPara entender como atribuir agentes, leia o artigo [Atribuir e testar um agente](https://help.vtex.com/pt/docs/tutorials/atribuir-e-testar-agentes).\n\n#### Editar manager\n\nA opção **Editar Manager** do agente orquestrador possui as seguintes abas:\n\n- [Perfil](#perfil)\n- [Motor](#motor)\n\n##### Perfil\n\nNessa aba, você encontra campos customizáveis para personalizar a identidade e o comportamento do seu agente orquestrador.\n\nPara customizar o seu agente, preencha os campos a seguir:\n\n- **Qual nome o agente usa para se apresentar?:** 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. Selecione um dos tons de voz predefinidos.\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 empatia e compreensão. |\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| Analítico | Garante que todas as informações estejam dispostas de forma clara e acessível. Ele é lógico e objetivo, guiando o cliente por cada etapa de maneira metodológica, para que nenhum detalhe seja perdido. |\n| Criativo | Utiliza a imaginação para se comunicar, priorizando soluções originais. Ele é capaz de oferecer respostas diferenciadas e adaptar a linguagem para tornar o conteúdo mais relevante e cativante para o cliente. |\n| Informal | É leve, energético e informal. Mantém um tom mais acessível e humano. |\n\n##### Motor\n\nEm **Fonte de motor**, você pode selecionar o modelo de agente nativo do VTEX CX Platform ou um modelo de LLM no qual você possua uma Chave API cadastrada. Caso deseje utilizar o modelo externo, selecione a opção **Chave API própria** e preencha os campos abaixo:\n\n- **Provedor**: empresa proprietária do modelo.\n- **Modelo**: versão disponível do modelo.\n- **API Key**: sua chave de API cadastrada no provedor do modelo.\n\n> ℹ️ Para ativar qualquer modificação realizada nas informações das abas **Perfil** ou **Motor**, é necessário clicar em `Salvar alterações`.\n\nSe você selecionou o motor nativo da plataforma, poderá escolher, em **Versão do manager**, entre duas opções de agente orquestrador:\n\n- **Manager 2.7** (Recomendado).\n- **Manager 2.6** (Modelo legado).\n\nEm **Prévia dos agentes**, existem duas configurações possíveis:\n\n- **Formato de mensagem múltipla:** ative-o <i class=\"fas fa-toggle-on\" aria-hidden=\"true\"></i> se quiser que o agente envie várias mensagens, como respostas rápidas, listas, catálogo. Caso contrário, deixe-o desativado <i class=\"fas fa-toggle-off\" aria-hidden=\"true\"></i>.\n\n- **Feedback progressivo dos agentes:** ative-o <i class=\"fas fa-toggle-on\" aria-hidden=\"true\"></i> 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 <i class=\"fas fa-toggle-off\" aria-hidden=\"true\"></i>.\n\n\n\n#### Editar instruções\n\nAo clicar no botão `Editar instruções` do agente orquestrador, você acessa a página **Instruções**, onde pode adicionar instruções diretas para determinar como seu agente se comporta. Não há limite para a quantidade de instruções que podem ser criadas.\n\n##### Validação por IA\n\nAo criar instruções personalizadas, você pode solicitar a validação da IA, que analisará cada uma delas e indicará possíveis problemas ou pontos de melhoria. Além disso, você também pode solicitar uma sugestão automática, que revisará a instrução e a editará conforme necessário.\n\nPara utilizar a validação de instrução por IA ao criar uma instrução, siga os passos a seguir:\n\n1. Ative o botão <i class=\"fas fa-toggle-on\" aria-hidden=\"true\"></i> **Validar instrução por IA**.\n2. Digite a sua instrução em **Nova instrução personalizada** e clique em `Validar instrução`.\n3. Após a análise da instrução, caso o resultado seja **Nenhum problema encontrado. Pronto para publicar!**, clique em `Publicar`.\n\n> ⚠️ Caso apareça uma mensagem de aviso em **Resultados da validação**, corrija a instrução conforme as orientações exibidas e clique em `Re-validar`.\n\n> ℹ️ É possível criar uma nova instrução personalizada sem a validação da IA. Para realizar esta ação, desative a opção **Validar instrução por IA**, digite a instrução e clique em `Publicar instrução`.\n\n##### Lista de instruções\n\nNa **Lista de instruções**, você pode verificar as seguintes informações:\n\n- **Instruções personalizadas:** instruções criadas para o agente. É possível localizá-las usando a barra de busca ou copiá-las clicando no botão `Copiar instruções`.\n\n- **Instruções padrão:** comportamentos definidos pela plataforma. Essas instruções não podem ser editadas.\n\n- **Temas de segurança:** assuntos não mencionados pelo agente durante um atendimento. Esses temas não podem ser editados.\n\nPara editar ou remover uma instrução personalizada, siga os passos a seguir:\n\n1. Clique no botão de três pontos <i class=\"fas fa-ellipsis-v\" aria-hidden=\"true\"></i> ao lado da instrução desejada.\n2. Para editá-la, clique em `Editar instrução`, faça os ajustes necessários e clique em `Salvar`.\n3. Para excluí-la, clique em `Excluir instrução` e, em seguida, em `Excluir`.\n\n### Base de conhecimento\n\nNessa página, você pode adicionar [arquivos](#arquivos), [sites](#sites) e [textos](#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 <i class=\"fas fa-plus\" aria-hidden=\"true\"></i>`Adicionar arquivo`.\n\n> ⚠️ Os arquivos devem ter extensão `.pdf`, `.doc`, `.docx`, `.txt`, `.xls` ou `.xlsx` e tamanho de até 50 MB.\n\nClicando nos <i class=\"fas fa-ellipsis-v\" aria-hidden=\"true\"></i>três pontos ao lado do nome do arquivo, é possível:\n\n- Baixar o arquivo.\n- Remover o arquivo da base de conhecimento.\n\nVocê também pode usar o campo de busca para encontrar um arquivo na base de conhecimento.\n\n#### Sites\n\nPara inserir um site na base de dados do agente, siga este passo a passo:\n\n1. Clique em <i class=\"fas fa-plus\" aria-hidden=\"true\"></i>`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 <i class=\"fas fa-ellipsis-v\" aria-hidden=\"true\"></i>três pontos ao lado do site, é possível:\n\n- Acessar o site.\n- Remover o site da base de conhecimento.\n\nVocê também pode usar o campo de busca para encontrar um site na base de conhecimento.\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`.\n\n### Fluxo de automação\n\nVocê pode criar fluxos de automação para interagir com um grupo de usuários e determinar as respostas do agente com base nas mensagens dos usuários.\n\nPara mais informações, acesse [Visão geral Fluxo de automação](https://help.vtex.com/pt/docs/tutorials/visao-geral-fluxo-de-automacao)."}