Agentes de IA: Logs e Rastreamento

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ê:

Para acessar os logs, você deve:

Dentro do seu pipe, clique no botão Agentes de IA, localizado no cabeçalho superior.
​

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.

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:

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.

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.

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.

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.

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.

Quando o agente consulta uma fonte de conhecimento do tipo Texto simples, como regras de negócio, listas ou diretrizes estáticas inseridas no agente, o Rastreamento mostra essa consulta em um nó próprio. Você pode ver que o agente utilizou essa fonte e em qual conteúdo ele se baseou para tomar a decisão, sem precisar abrir uma base de dados ou um documento anexado.

Quando o agente consulta um pipe ou uma base de dados por meio de uma fonte de conhecimento do tipo Consulta de dados, o Rastreamento mostra essa consulta em um nó próprio. Você pode ver o campo e a condição ou valor pesquisado, além de saber se a consulta encontrou uma correspondência, com o registro ou as fontes correspondentes, ou se não encontrou resultados.

Observações sobre esta versão:

Quando o agente usa o Web Search, o Rastreamento mostra um nó dedicado com a consulta de busca e, quando disponíveis, os resultados, como resumos e links. Use-o para confirmar que o agente buscou contexto em tempo real fora do pipe e que a pesquisa influenciou a decisão corretamente.

Quando o agente usa Cálculos e análises, você pode inspecionar o código que foi executado no ambiente seguro e o resultado, exibido em um segundo bloco de código. Uma única execução pode incluir mais de um nó. Use esse recurso para verificar cálculos exatos, fazer validações cruzadas ou validações determinísticas e investigar quando um cálculo ou regra não se comportar como esperado.

Quando um comportamento é executado com Esforço máximo habilitado, o Rastreamento mostra um nó com a análise final: resumo do planejamento, tarefas e resultados. Os nós de habilidades relacionadas, como Pesquisa na web, Interpretador de código ou Consulta de dados, aparecem acima dele, na ordem de execução. Os detalhes do plano e das ações aparecem abaixo. A lista de tarefas fica disponível no estado final do nó.

Use esse recurso para entender o percurso iterativo de execuções complexas, como documentos extensos, reconciliação entre documentos ou regras com vários fatores, em vez de uma execução única.

Os Logs são essenciais para ajustar o comportamento do seu agente:

Failed: Se um passo falhar, o Rastreamento mostra qual passo parou. Algumas falhas também mostram a causa, como um campo obrigatório faltando ou um erro de permissão.

Skipped: O agente mostrará quando decidiu não realizar uma ação, acompanhado de uma justificativa lógica para essa decisão.

Conditions not met: o agente foi acionado, mas as condições de acionamento da automação não foram atendidas neste card. Nenhuma ação foi executada.

Após configurar ou editar um agente, use os logs para:

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.