Rastreo de sesiones

Claude Managed Agents proporciona herramientas de observabilidad en la Claude Console para ayudarte a monitorear, depurar y entender tus sesiones de agentes.

Observabilidad de la Consola

La Consola proporciona una vista de línea de tiempo visual de tus sesiones de agentes. Navega a la sección Claude Managed Agents en la Consola para ver:

• Lista de sesiones - Todas las sesiones con su estado, hora de creación y modelo
• Vista de rastreo - Una vista cronológica de eventos (contenido, marcas de tiempo, uso de tokens) dentro de una sesión. Estos solo son accesibles para Desarrolladores y Administradores.
• Ejecución de herramientas - Detalles de cada llamada de herramienta y su resultado

Eventos sin procesar

Para depuración programática, recupera eventos sin procesar a través de la 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 ),
    "---"
'

Usa el mismo flujo de eventos para mostrar errores y rastrear el consumo de tokens:

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[] | select(.type == "session.error") | "[\(.error.type)] \(.error.message)"),
  (reduce (.data[] | select(.type == "span.model_request_end") | .model_usage) as $u
     ({input: 0, output: 0}; .input += $u.input_tokens | .output += $u.output_tokens)
   | "Total input tokens: \(.input), output tokens: \(.output)")
'

Consejos de depuración

• Verifica eventos de sesión - Los errores de sesión se transmiten a través del evento session.error
• Revisa resultados de herramientas - Los fallos en la ejecución de herramientas a menudo explican el comportamiento inesperado del agente
• Rastrea el uso de tokens - Monitorea el consumo de tokens para optimizar indicaciones y reducir costos
• Usa indicaciones del sistema - Añade instrucciones de registro a la indicación del sistema para que el agente explique su razonamiento