{"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 mostre atualizações curtas enquanto prepara a resposta final. Essas atualizações não alteram a resposta final e não exigem desenvolvimento adicional na loja. Caso contrário, deixe-o desativado <i class=\"fas fa-toggle-off\" aria-hidden=\"true\"></i>.\n\n> ⚠️ As opções **Feedback progressivo dos agentes** e **Formato de mensagem múltipla** não podem ser ativadas ao mesmo tempo.\n\nEm **Mensagens do sistema**, você pode personalizar a mensagem de erro enviada ao cliente quando um erro de API impede o agente de gerar uma resposta. Cada projeto pode ter a sua própria mensagem, adaptada ao tom de voz da marca.\n\n> ⚠️ A mensagem de erro é enviada exatamente como configurada e não é traduzida automaticamente. Escreva o texto no idioma em que o seu agente atende os clientes.\n\nPara salvar seus ajustes, clique em `Salvar alterações`.\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\nToda instrução personalizada é revisada por IA antes de ser salva. A revisão analisa a instrução em busca de problemas, sugere uma reescrita quando necessário e atribui uma categoria para que você possa organizar instruções relacionadas.\n\n##### Criar uma instrução\n\nPara criar uma instrução personalizada, siga os passos a seguir:\n\n1. Na página **Instruções**, clique em `Nova instrução`.\n2. Digite a instrução.\n3. Clique em `Validar`.\n4. Em **Categoria sugerida**, mantenha a categoria atribuída pela IA, selecione outra opção em **Outras categorias** ou selecione **Sem categoria**.\n5. Clique em `Salvar`.\n\n> ℹ️ O botão `Salvar` fica disponível após a conclusão da revisão por IA. Quando nenhum problema é encontrado, o campo **Problemas encontrados** exibe **Tudo certo. Nenhum problema encontrado.** Para adicionar uma categoria antes de salvar, confira [Criar uma categoria](#criar-uma-categoria).\n\n> ⚠️ Se o campo **Problemas encontrados** listar algum problema, atualize a instrução ou clique em `Aplicar` em **Sugestão de reescrita**. Clique em `Desfazer` para restaurar o texto anterior. Depois de alterar o texto, clique em `Re-validar` e, em seguida, em `Salvar`.\n\n##### Criar uma categoria\n\nVocê pode criar uma categoria durante a criação ou edição de uma instrução e depois reutilizá-la em outras instruções.\n\nPara criar uma categoria, siga os passos a seguir:\n\n1. No painel lateral da instrução, abra **Categoria** ou **Categoria sugerida**.\n2. Clique em `Nova categoria`.\n3. Em **Nome da categoria**, digite um nome.\n4. Clique em `Criar`.\n5. Clique em `Salvar` para armazenar a instrução nessa categoria.\n\n> ℹ️ O nome da categoria pode ter até 50 caracteres e incluir letras, números, espaços e hifens. Use um nome exclusivo. A opção **Sem categoria** é reservada para instruções sem categoria. Uma categoria criada no painel lateral fica marcada com a tag **Novo** até que você salve a instrução.\n\n##### Componentes interativos\n\nCom o **Manager 2.7**, o agente orquestrador pode responder usando componentes interativos nativos do WhatsApp:\n\n| Componente | Descrição |\n| --- | --- |\n| Respostas rápidas (`quick_reply`) | Botões com opções predefinidas para o cliente escolher. |\n| Botões de ação (`call_to_action`) | Botões que direcionam o cliente para um link externo. |\n| Lista de mensagens (`list_message`) | Menu com uma lista de opções selecionáveis. |\n\nPara orientar o agente a usar um componente, cite-o diretamente em uma instrução personalizada. Por exemplo: \"Ao perguntar sobre o status do pedido, use o componente `quick_reply` com as opções Rastrear pedido, Cancelar pedido e Falar com atendente\".\n\n> ℹ️ Para que o agente envie componentes interativos, a opção **Formato de mensagem múltipla** deve estar ativada em **Editar Manager > Motor**.\n\n> ⚠️ O catálogo de produtos não é um componente nativo do Manager 2.7. Quando há um agente Concierge atribuído ao time, o orquestrador aciona o Concierge para enviar o catálogo. Os agentes Concierge oficiais da VTEX já possuem essa capacidade.\n\n##### Visualizar instruções\n\nSelecione `Categorias` ou `Lista` para alterar o modo de exibição das instruções:\n\n- **Categorias:** agrupa as instruções por categoria. Uma categoria personalizada sem instruções permanece visível e exibe **Nenhuma instrução nesta categoria ainda**.\n\n- **Lista:** exibe cada instrução existente com a sua respectiva categoria.\n\nUse o campo de busca para encontrar uma instrução. Para baixar as instruções, clique em `Exportar instruções`.\n\nA página inclui os seguintes grupos:\n\n- **Sem categoria:** instruções personalizadas que não possuem uma categoria. Você pode editá-las e excluí-las. Este grupo não pode ser removido.\n\n- **Instruções padrão:** comportamentos definidos pela plataforma. Essas instruções não podem ser editadas ou removidas.\n\nPara editar ou excluir 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.\n2. Para editá-la, clique em `Editar instrução`, altere o texto ou a categoria e clique em `Salvar`.\n3. Para excluí-la, clique em `Excluir instrução` e confirme a exclusão.\n\n> ℹ️ O campo **Categoria** fica disponível assim que você abre a instrução. Clique em `Re-validar` para revisar o texto novamente. A revalidação mantém a categoria já selecionada.\n\n> ⚠️ A exclusão de uma instrução é permanente, e o agente deixa de segui-la.\n\nPara excluir uma categoria personalizada, siga os passos a seguir:\n\n1. Selecione `Categorias`.\n2. Abra o menu de ações da categoria.\n3. Clique em `Excluir categoria` e confirme a exclusão.\n\n> ℹ️ As instruções de uma categoria excluída são movidas para **Sem categoria**. Uma categoria vazia é removida da lista.\n\nPara escolher quais tópicos sensíveis o agente deve recusar, confira [Configurar camadas extras de segurança por projeto](https://help.vtex.com/pt/docs/tutorials/configurar-camadas-extras-de-seguranca-por-projeto).\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 aba, você pode adicionar conteúdos em texto à base de conhecimento, organizados em segmentos nomeados. Cada segmento tem um título próprio, e a lista é ordenada pela edição mais recente, com a indicação de quando cada segmento foi modificado.\n\nPara criar um segmento de texto, siga os passos a seguir:\n\n1. Clique em <i class=\"fas fa-plus\" aria-hidden=\"true\"></i> `Adicionar texto`.\n2. Digite um título para identificar o segmento.\n3. Insira o conteúdo na caixa de texto.\n4. Clique em `Salvar`.\n\nClicando nos <i class=\"fas fa-ellipsis-v\" aria-hidden=\"true\"></i>três pontos ao lado do segmento, é possível:\n\n- Editar o conteúdo.\n- Renomear o título.\n- Excluir o segmento. A exclusão exige confirmação.\n\nVocê também pode usar o campo de busca para encontrar um segmento pelo título.\n\n> ℹ️ Bases de conhecimento criadas antes dessa organização mantêm o texto original como um único segmento, com um título padrão. Nenhum conteúdo é perdido. A divisão em segmentos é apenas uma mudança de interface e não altera a forma como o agente usa o conteúdo da base.\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)."}