Session-Verfolgung

Claude Managed Agents bietet Observability-Tools in der Claude Console an, um Sie bei der Überwachung, dem Debugging und dem Verständnis Ihrer Agent-Sitzungen zu unterstützen.

Console-Observability

Die Console bietet eine visuelle Zeitleistenansicht Ihrer Agent-Sitzungen. Navigieren Sie zum Claude Managed Agents-Bereich in der Console, um Folgendes zu sehen:

• Sitzungsliste - Alle Sitzungen mit ihrem Status, Erstellungszeit und Modell
• Verfolgungsansicht - Eine chronologische Ansicht von Ereignissen (Inhalt, Zeitstempel, Token-Nutzung) innerhalb einer Sitzung. Diese sind nur für Entwickler und Administratoren zugänglich.
• Tool-Ausführung - Details zu jedem Tool-Aufruf und dessen Ergebnis

Raw Events

Für programmgesteuerte Fehlersuche rufen Sie Raw Events über die API ab:

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

Verwenden Sie denselben Event-Stream, um Fehler zu erfassen und den Token-Verbrauch zu verfolgen:

Debugging-Tipps

• Sitzungsereignisse überprüfen - Sitzungsfehler werden durch das Ereignis session.error übermittelt
• Tool-Ergebnisse überprüfen - Tool-Ausführungsfehler erklären oft unerwartet Agent-Verhalten
• Token-Nutzung verfolgen - Überwachen Sie den Token-Verbrauch, um Prompts zu optimieren und Kosten zu senken
• Systemaufforderungen verwenden - Fügen Sie Logging-Anweisungen zur Systemaufforderung hinzu, um den Agent zu veranlassen, sein Denken zu erklären