{"section":"tutorials","requestedLocale":"pt","requestedSlug":"atribuir-e-testar-agentes","locale":"pt","slug":"atribuir-e-testar-agentes","path":"docs/pt/tutorials/vtex-cx-platform/agent-builder/atribuir-e-testar-agentes.md","branch":"main","content":"A seção **Meus agentes** permite atribuir agentes ao time e testar sua operação. Alguns agentes oficiais exigem credenciais para operar na plataforma. Para mais informações, acesse [Agentes oficiais do VTEX CX Platform e suas credenciais](https://help.vtex.com/pt/docs/tutorials/agentes-oficiais-da-vtex-cx-platform).\n\n> ℹ️ Para criar agentes personalizados, use o CLI do VTEX CX Platform (Weni). Saiba mais em [Using the VTEX CX Platform (Weni) CLI](https://developers.vtex.com/docs/guides/using-the-weni-by-vtex-cli#getting-started-with-your-project).\n\nEste artigo está dividido nas seguintes seções:\n\n- [Atribuir um agente ao time](#atribuir-um-agente-ao-time)\n- [Remover um agente](#remover-um-agente)\n- [Testar um agente](#testar-um-agente)\n\n## Atribuir um agente ao time\n\nPara atribuir um novo agente em sua loja, siga os passos abaixo:\n\n1. Acesse sua organização no [dashboard do VTEX CX Platform](https://dash.weni.ai/orgs).\n2. No menu lateral, clique no ícone **Meus agentes**.\n3. Clique em <i class=\"fas fa-plus\" aria-hidden=\"true\"></i>`Atribuir novos agentes`.\n4. Na página **Atribuir novos agentes**, selecione uma das opções disponíveis:\n - **Agentes oficiais:** agentes da VTEX ou de integrações externas previamente cadastradas na plataforma.\n - **Agentes personalizados:** agentes criados para sua operação.\n\n> ℹ️ Você também pode localizar agentes usando o campo de busca ou filtrando por tipo de categoria.\n\n5. Após escolher um agente, clique em `Ver detalhes`.\n6. No modal do agente, confira as informações sobre os MCPs disponíveis e o exemplo de conversa.\n7. Clique em `Iniciar configuração`.\n8. Em **Atribuir \\{Nome do agente\\}**, na seção **Seleção de sistema**, selecione uma das opções disponíveis e clique em `Avançar`.\n9. Em **Seleção de MCP**, selecione uma das opções disponíveis para definir o comportamento do agente.\n10. Em **Configurar MCP \\{Nome do sistema\\}**, se disponível, preencha ou selecione os parâmetros do agente. Alguns agentes não possuem parâmetros configuráveis.\n11. Em **Revise a configuração e insira as credenciais**, confira as informações, preencha os campos solicitados e clique em `Concluir`.\n\nApós concluir esses passos, o agente será exibido na seção **Agentes atribuídos** da página **Meus Agentes**.\n\n## Remover um agente\n\nPara remover um agente de sua loja, siga os passos abaixo:\n\n1. Acesse sua organização no [dashboard do VTEX CX Platform](https://dash.weni.ai/orgs).\n2. No menu lateral, clique no ícone **Meus agentes**.\n3. Na seção **Agentes atribuídos**, clique sobre o agente desejado.\n4. Clique em `Ver opções`.\n5. Clique em `Remover agente`.\n\n> ℹ️ Caso deseje utilizar novamente este agente, realize a nova atribuição conforme descrito em [Atribuir um agente ao time](#atribuir-um-agente-ao-time).\n\n\n## Testar um agente\n\nPara testar a operação de um agente atribuído, clique em `Teste seus agentes`, no canto inferior direito da tela.\n\nNa seção **Teste seus agentes**, você pode:\n\n- Selecionar, no campo **Versão do Manager**, o modelo que atuará como agente orquestrador durante a conversa.\n- Iniciar uma conversa usando a caixa de diálogo.\n- Enviar uma mensagem de áudio clicando no ícone de microfone ou no botão <i class=\"fas fa-plus\" aria-hidden=\"true\"></i> e, em seguida, em `Áudio`.\n- Enviar arquivos clicando no botão <i class=\"fas fa-plus\" aria-hidden=\"true\"></i> e, em seguida, em `Enviar arquivo`.\n- Na aba **Fluxo visual**, visualizar em formato de diagrama quais agentes estão sendo acionados para produzir a resposta exibida na caixa de diálogo.\n- Na aba **Logs**, verificar o registro detalhado dos eventos processados pelo modelo de IA durante a conversa. Essas informações ajudam a entender o processamento da conversa, identificar possíveis problemas e melhorar o desempenho do agente.\n\nPara buscar eventos específicos, clique em `Filtrar logs` e pesquise por palavras-chave ou pelas seguintes categorias:\n\n| Categoria | Descrição da etapa |\n| --- | :--- |\n| Aplicando regras de segurança | Verificação de segurança do conteúdo, incluindo proteção de dados sensíveis, bloqueio de conteúdos proibidos e aplicação de políticas de uso. |\n| Atribuindo tarefa ao agente | Definição do agente especializado ou recurso interno que será responsável por uma etapa da conversa. |\n| Conhecimento | Consulta à base de conhecimento, como documentação, artigos do Help Center ou conteúdos internos, para buscar informações oficiais antes da resposta. |\n| Encaminhando para o manager | Retorno do controle ao manager para definição da próxima etapa da conversa. |\n| Encaminhando para suporte humano | Encaminhamento da conversa para atendimento humano devido a uma limitação técnica, exceção ou regra de negócio. |\n| Enviando para o manager | Envio do resultado de uma ferramenta, agente ou etapa do fluxo ao Manager para processamento. |\n| Enviando resposta final | Envio da resposta ao usuário após a conclusão da orquestração interna. |\n| Ferramenta | Uso de um recurso externo ou módulo específico, como consulta de pedidos, análise de imagem, transcrição de áudio ou busca em outro sistema. |\n| Pensando | Etapa em que o modelo processa internamente a solicitação, planeja a resposta e decide se deve acionar ferramentas, consultar conhecimento ou encaminhar a conversa para outro fluxo. |\n\n> ℹ️ Para remover o histórico das conversas com o agente orquestrador, clique no menu <i class=\"fas fa-ellipsis-v\" aria-hidden=\"true\"></i> ao lado de **Teste seus agentes** e, em seguida, em `Limpar conversas`."}