Traces

Sobre rastreamentos

Os traces são registros detalhados de tudo o que um agente faz durante uma execução, incluindo etapas realizadas, dados processados, decisões tomadas e resultados gerados. Cada trace captura uma linha do tempo completa do comportamento do agente, incluindo carimbos de data/hora, erros, entradas/saídas e metadados contextuais.

Usar traces para:

• Depuração e solução de problemas: identifique exatamente onde um agente falhou ou se comportou de maneira inesperada.

• Análise de desempenho: avalie a latência, os erros e a taxa de transferência em todas as execuções do agente para otimizar o comportamento.

• Conformidade e auditoria: mantenha um registro verificável do que o agente fez, quando e como — essencial para auditorias ou fluxos de trabalho regulados.

• Melhoria contínua: use insights de rastreamento para ajustar a lógica do agente, adaptar comportamento ou treinar novos modelos.

A tabela a seguir descreve casos de uso comuns em que a visualização de rastreamentos pode aprimorar sua capacidade de depurar, analisar e otimizar o comportamento do agente. Cada exemplo destaca como os dados de rastreamento ajudam a descobrir insights e a orientar uma melhor tomada de decisões durante o monitoramento do desenvolvimento e do tempo de execução.

Use case	O que os traces ajudam você a fazer
O agente falha durante a chamada da ferramenta	Encontre e inspecione a etapa, as entradas, as saídas e os erros exatos
O desempenho está lento	Usar carimbos de data/hora para localizar gargalos
Investigação de um pico nos erros	Filtre execuções por status e trace o padrão
Verificando uma correção de produção	Reproduz a execução original e confirme se o problema não ocorre mais
Preparação de um relatório de auditoria	Exportar ou revisar rastreamentos que mostram caminhos de decisão e dados manipulados

Tipos de trace

Os traces vêm em dois tipos distintos, cada um atendendo a um propósito específico na compreensão e análise do comportamento do agente:

• Traces de execução do agente: esses rastreamentos capturam a execução passo a passo de um agente durante uma execução em tempo real ou agendada. Eles mostram como o agente processou dados, invocou ferramentas, lidou com condições e respondeu a diferentes estados em tempo real.
• Traces de execução de avaliação: os traces de avaliação são gerados quando um agente é testado em relação a entradas predefinidas, normalmente durante avaliações de modelos, validações de cenários ou casos de teste. Eles ajudam a avaliar a precisão do agente, a qualidade da decisão e o comportamento sob condições controladas.

Acessando rastreamentos

Você pode acessar ambos os tipos de traces a partir de dois locais importantes:

• Agent Builder: ao projetar ou editar um agente, alterne para as guias Avaliações ou Saída para inspecionar como o agente se comportou durante execuções recentes.

• Página Instâncias de agentes : navegue até a seção Agentes > Instâncias . A partir daqui, selecione um agente específico e selecione qualquer execução para abrir sua exibição de trace, que inclui o trace visual completo e o painel de log. Para obter mais detalhes, consulte a guia Instâncias do agente.

Ao visualizar rastreamentos para execuções de agente ou execuções de avaliação, você obtém visibilidade da execução do agente. Você pode:

• Veja os resultados da execução, conforme indicado pelos nós codificados por cores: sucesso, falha ou nova tentativa.

• Passe o mouse sobre qualquer nó para visualizar: carimbos de data/hora inicial e final, status de execução, fragmentos de entrada e saída.

• Clique em um nó para visualizar os detalhes, incluindo: cargas completas de JSON, logs e erros, métricas de runtime (uso de token, latência).