{"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- [Configurar constantes de agentes personalizados](#configurar-constantes-de-agentes-personalizados)\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. Para agentes personalizados, em **Constantes**, selecione as constantes definidas via CLI e preencha os valores desejados. Saiba mais em [Configurar constantes de agentes personalizados](#configurar-constantes-de-agentes-personalizados).\n12. 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> ℹ️ Os cards de agentes personalizados exibem a data e a hora de criação ou da última atualização do agente. Agentes oficiais não exibem essa informação.\n\n## Configurar constantes de agentes personalizados\n\nConstantes são valores de configuração reutilizáveis, definidos no nível do agente e compartilhados entre todas as suas ferramentas, como URLs de ambiente ou identificadores de loja. Elas são criadas no código do agente e enviadas para a plataforma via [CLI do VTEX CX Platform](https://weni-ai.github.io/weni-cli/core-concepts/constants/).\n\nAo atribuir um agente personalizado, você pode visualizar as constantes disponíveis, definir os valores de cada uma e aplicá-las diretamente na interface, sem precisar da CLI.\n\n> ℹ️ Constantes são diferentes de credenciais. Credenciais são informações confidenciais, como chaves de API, usadas pelo agente ao acionar uma ferramenta específica. Constantes são valores de configuração compartilhados entre as ferramentas do agente.\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`."}