👤 Para admins do pipe
🔐 Disponível para todos os planos
🎯 Para quem deseja monitorar a performance e a precisão da sua força de trabalho digital.
A área de Logs dos Agentes de IA oferece visibilidade total sobre o comportamento da inteligência artificial no seu processo. Com ela, você entende exatamente como o agente tomou uma decisão, quais dados utilizou e onde ocorreram falhas.
Os Logs ajudam você:
Ver o que o agente fez em cada execução, passo a passo.
Entender por que ele decidiu algo, em linguagem de negócio.
Rastrear a origem de cada decisão, incluindo qual documento ou campo foi usado.
Encontrar erros rapidamente, incluindo o passo em que a falha aconteceu e a causa.
Confirmar ações puladas, para saber quando o agente optou por não agir e por quê.
Como abrir os Logs dos AI Agents
No cabeçalho superior do pipe, clique em AI Agents.
Abra a aba Logs, no canto superior esquerdo. Você verá as execuções mais recentes, cada uma mostrando o nome do agente, o comportamento acionado, o card processado e o status da execução.
Clique em Ver detalhes e depois em Rastreamento.
Antes de começar
Para acessar os logs, você deve:
Ter permissão de Admin do Pipe.
Ter pelo menos um Agente de IA configurado e ativo no pipe.
Passo a passo
1. Acesse a área de Agentes
Dentro do seu pipe, clique no botão Agentes de IA, localizado no cabeçalho superior.
2. Navegue até a aba de Logs
No canto superior esquerdo da tela de agentes, clique na aba Logs. Aqui você verá uma listagem de todas as execuções recentes, incluindo o nome do agente, o comportamento acionado, o card processado, status da execução e horário de início.
3. Analise o Resumo
Para entender uma execução específica, clique no botão Ver detalhes ao lado do log desejado.
A primeira visão é o Resumo do log:
Status: Sucesso, falha ou em processamento.
Contexto: Nome do agente, qual gatilho foi disparado, qual card foi afetado (com o ID do card) e etc.
Datas: Quando a execução começou e terminou.
4. Explore o Rastreamento
Clique na aba Rastreamento para visualizar o passo a passo da execução.
Esta área detalha o fluxo percorrido pelo seu agente e quais passos foram concluídos. Estamos constantemente evoluindo esta seção para trazer, ao longo do tempo, cada vez mais dados e visibilidade sobre o comportamento do seu agente.
Novos Tracing Nodes
📍 Esta área da feature está em constante atualização com novos nodes.
Plano de Execução
Dentro de cada Action, você lê o raciocínio do agente em linguagem de negócio, derivado do que o agente realmente fez durante a execução (não uma explicação genérica criada depois). Você acompanha, em ordem, como o agente foi do gatilho até a ação final, para que uma pessoa de negócio não-técnica entenda uma decisão sem precisar acionar o time de TI.
Se alguma Action específica não expõe raciocínio, o log sinaliza isso de forma explícita, para que você nunca fique em dúvida se a informação está faltando ou simplesmente não está disponível.
Bases de Conhecimento
Para agentes que usam bases de conhecimento (por exemplo, processamento inteligente de documentos, consultas de dados ou documentos anexados), cada Action mostra a origem exata por trás da decisão: o nome do documento, a seção e o trecho específico (chunk) em que o agente se baseou. Assim você confirma que o agente consultou a fonte certa e a usou corretamente.
Ações dos Agents
Cada Ação aparece como um node próprio, com as informações de raciocínio, planejamento ou execução. Por exemplo: Atualizar Card, Mover Card, e outras ações que o seu Agent pode rodar.
Entendendo falhas e decisões
Os Logs são essenciais para ajustar o comportamento do seu agente:
Erros claros: Se um passo falhar, o Rastreamento indicará exatamente qual passo parou e por que (ex: campo obrigatório faltando ou erro de permissão).
Ações puladas (ou Skipped): O agente mostrará quando decidiu não realizar uma ação, acompanhado de uma justificativa lógica para essa decisão.
Checklist de validação
Após configurar ou editar um agente, use os logs para:
Verificar o sucesso: Confirme se o status final é "Success".
Validar a lógica: No Rastreamento, confira se ele consultou as fontes corretas (documentos/campos).
Teste de Erro: Se o agente não se comportou como esperado, identifique o passo no Tracing e ajuste as instruções do agente.
Envie seu feedback
Tem uma sugestão para os Logs dos AI Agents? Use o botão Enviar feedback no canto superior direito. Sua contribuição ajuda a definir o que vamos construir a seguir.