{"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](/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 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-automação)\n\n### Meus agentes\n\nNessa página, você pode atribuir e testar agentes para a sua loja, editar o manager e editar as instruções que esse manager deve seguir.\n\nPara entender como atribuir agentes, leia o artigo [Atribuir e testar um agente](/pt/docs/tutorials/atribuir-e-testar-agentes).\n\n#### Editar manager\n\nEssa página contém duas abas:\n\n- [Perfil](#perfil)\n- [Configurações](#configurações)\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##### Configurações\n\nEm **Manager**, você pode selecionar o manager do seu agente orquestrador. Oferecemos duas opções:\n\n- Manager 2.6.\n- Vertex Manager.\n\nEm **Prévia dos agentes**, há dois botões de alternância:\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- **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#### Editar instruções\n\nEm **Instruções**, você pode adicionar instruções diretas para determinar como seu agente se comporta.\n\n##### Validação por IA\n\nVocê pode passar todas as instruções pela validação por IA. A IA vai analisar a instrução e . Além disso, você também pode pedir uma sugestão para a IA, que vai analisar a instrução e editá-la conforme achar necessário.\n\nPara validar a instrução por IA, 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 sua instrução e clique em `Validar instrução`.\n3. Ao final, clique em `Publicar`.\n\nSe não quiser passar a instrução por validação da IA, desative a opção **Validar instrução por IA**. Após digitar sua instrução personalizada, clique em `Publicar instrução`.\n\nSe você adicionou uma instrução e deseja removê-la ou editá-la, clique no botão de <i class=\"fas fa-ellipsis-v\" aria-hidden=\"true\"></i>três pontos ao lado da instrução. Para remover, clique em `Remover instrução` e, em seguida, em `Remover`. Para editá-la, clique em `Editar instruções` e em seguida, ao terminar, clique em `Salvar`.\n\n> ℹ️ Não há um limite para a quantidade de instruções.\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 entender como criar fluxos, leia o artigo [Introdução a fluxos](https://help.vtex.com/pt/docs/tutorials/introducao-a-fluxos)."}