Tracciamento della sessione

Claude Managed Agents fornisce strumenti di osservabilità nella Claude Console per aiutarti a monitorare, eseguire il debug e comprendere le tue sessioni di agenti.

Osservabilità della Console

La Console fornisce una visualizzazione della timeline visiva delle tue sessioni di agenti. Accedi alla sezione Claude Managed Agents nella Console per vedere:

Elenco sessioni - Tutte le sessioni con il loro stato, ora di creazione e modello
Visualizzazione tracciamento - Una visualizzazione cronologica degli eventi (contenuto, timestamp, utilizzo dei token) all'interno di una sessione. Questi sono accessibili solo a Sviluppatori e Amministratori.
Esecuzione dello strumento - Dettagli di ogni chiamata dello strumento e il suo risultato

Eventi grezzi

Per il debug programmatico, recupera gli eventi grezzi tramite l'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 ),
    "---"
'

Utilizza lo stesso flusso di eventi per visualizzare gli errori e tracciare il consumo dei token:

Suggerimenti per il debug

Controlla gli eventi della sessione - Gli errori della sessione vengono comunicati tramite l'evento session.error
Rivedi i risultati dello strumento - I guasti nell'esecuzione dello strumento spesso spiegano il comportamento inaspettato dell'agente
Traccia l'utilizzo dei token - Monitora il consumo dei token per ottimizzare i prompt e ridurre i costi
Utilizza i prompt di sistema - Aggiungi istruzioni di logging al prompt di sistema per far sì che l'agente spieghi il suo ragionamento

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)")
'