👤 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.
O que esta funcionalidade resolve:
Observabilidade: Transparência sobre o que o agente fez durante a execução.
Depuração e Debug: Identificação rápida do local e do motivo de um erro.
Lógica de decisão: Clareza sobre quais passos foram seguidos ou ignorados pelo seu agente.
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 para acessar os Logs
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.
💡 Dica: Sua percepção é valiosa para a evolução desta funcionalidade! Se tiver sugestões ou encontrar algo que possa ser aprimorado, clique no botão Enviar feedback no canto superior direito da tela de detalhes para compartilhar sua opinião diretamente com nosso time.
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.