{"section":"tutorials","requestedLocale":"pt","requestedSlug":"atribuir-e-testar-agentes","locale":"pt","slug":"atribuir-e-testar-agentes","path":"docs/pt/tutorials/weni-by-vtex/agent-builder/atribuir-e-testar-agentes.md","branch":"main","content":"A seção **Agentes** permite que o usuário atribua agentes ao time e teste-os.\n\nAlguns agentes oficiais solicitam credenciais. Veja a lista completa no artigo [Agentes oficiais da Weni by VTEX e suas credenciais](/pt/docs/tutorials/agentes-oficiais-da-weni-by-vtex).\n\n> ℹ️ Para criar agentes customizados, use o CLI da Weni by VTEX. Confira a [documentação](https://weni-ai.github.io/weni-cli/getting-started/installation/) para criar seu próprio agente.\n\nEste artigo está dividido em duas partes:\n- [Atribuir um agente ao time](#como-atribuir-um-agente)\n- [Testar um agente](#como-testar-um-agente)\n\n## Atribuir um agente ao time\n\n1. No menu lateral, clique em **Agent Builder**.\n2. Em seguida, clique em **Agentes**.\n3. Na barra de ferramentas superior, clique em <i class=\"fas fa-plus\"></i>`Atribuir agentes`.\n4. Na Galeria de agentes, selecione **Agentes oficiais** ou **Agentes personalizados**. Você pode selecionar dentre os agentes listados ou usar o campo de busca para procurar por um agente específico.\n5. Após escolher seu agente, clique em `Atribuir ao time`.\n\n> ⚠️ Se o agente solicitar uma credencial, preencha os campos necessários e, em seguida, clique em `Atribuir`.\n\n## Testar um agente\n\nPara testar um agente, clique em `Prévia`.\n\nNessa tela, você pode:\n- Iniciar uma conversa utilizando a caixa de diálogo.\n- Enviar uma mensagem de áudio clicando no ícone de microfone.\n- Enviar uma imagem clicando no ícone de mais <i class=\"fas fa-plus\"></i> e em seguida em `Fotos`.\n\nEm **Fluxo visual**, é possível observar os agentes que estão sendo acionados a partir das perguntas feitas.\n\nEm **Logs**, fica registrado o histórico detalhado de eventos processados pela inteligência artificial (IA). A partir dessas informações, você consegue identificar como a IA funciona e diagnosticar problemas, melhorando sua performance. Clique em `Filtrar logs` para buscar por palavras-chave ou pesquisar entre as seguintes categorias:\n\n| Categoria | Descrição da etapa |\n| ------------- | :-------------- |\n| Aplicando regras de segurança | Aplica proteções e grades de segurança. |\n| Conhecimento | Busca informações na base de conhecimento do agente. |\n| Atribuindo tarefa ao agente | Aciona o agente com tarefas. |\n| Encaminhando para o manager | Encaminha mensagens do usuário para o manager, agente principal que prepara a resposta final para o usuário. |\n| Enviando resposta final | Envia a resposta final para o usuário. |\n| Enviando resposta ao manager | Encaminha informação para o manager, agente principal que conversa com o usuário. |\n| Pensando | Raciocina sobre os próximos passos. |\n| Ferramenta | Aciona ferramenta usada pelo agente para interagir com outros sistemas. |\n\nPara limpar a conversa, clique no menu <i class=\"fas fa-ellipsis-v\"></i> ao lado de **Prévia dos agentes** e selecionar `Limpar conversas`."}