Rastreamento de sessão

O Claude Managed Agents fornece ferramentas de observabilidade no Claude Console para ajudá-lo a monitorar, depurar e entender suas sessões de agente.

Observabilidade do Console

O Console fornece uma visualização de linha do tempo visual das suas sessões de agente. Navegue até a seção Claude Managed Agents no Console para ver:

• Lista de sessões - Todas as sessões com seu status, hora de criação e modelo
• Visualização de rastreamento - Uma visualização cronológica de eventos (conteúdo, timestamps, uso de tokens) dentro de uma sessão. Estes são acessíveis apenas para Desenvolvedores e Administradores.
• Execução de ferramentas - Detalhes de cada chamada de ferramenta e seu resultado

Eventos brutos

Para depuração programática, recupere eventos brutos via API:

curl -fsSL "https://api.anthropic.com/v1/sessions/$SESSION_ID/events" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
| jq -r '
  .data[]
  | "Type: \(.type)",
    "Processed: \(.processed_at)",
    ( if .type | IN("user.message", "agent.message") then
        .content[]
        | "  Block: \(.type)",
          (select(.type == "text") | "  Text: \(.text[:100])...")
      elif .type | IN("agent.tool_use", "agent.custom_tool_use", "agent.mcp_tool_use") then
        "  Tool: \(.name)"
      else empty end ),
    "---"
'

Use o mesmo fluxo de eventos para exibir erros e rastrear o consumo de tokens:

Dicas de depuração

• Verifique os eventos da sessão - Erros de sessão são transmitidos através do evento session.error
• Revise os resultados das ferramentas - Falhas na execução de ferramentas frequentemente explicam comportamentos inesperados do agente
• Rastreie o uso de tokens - Monitore o consumo de tokens para otimizar prompts e reduzir custos
• Use prompts de sistema - Adicione instruções de registro ao prompt de sistema para fazer o agente explicar seu raciocínio