Трассировка сеансов

Наблюдаемость Console

Console предоставляет визуальное представление временной шкалы ваших сеансов агентов. Перейдите в раздел Claude Managed Agents в Console, чтобы увидеть:

Список сеансов - Все сеансы с их статусом, временем создания и моделью

Представление трассировки - Хронологическое представление событий (содержание, временные метки, использование токенов) в сеансе. Доступны только для разработчиков и администраторов.

Выполнение инструментов - Детали каждого вызова инструмента и его результат

Необработанные события

Для программной отладки получите необработанные события через 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 ),
    "---"
'

Используйте тот же поток событий для отображения ошибок и отслеживания потребления токенов:

Советы по отладке

Проверьте события сеанса - Ошибки сеанса передаются через событие session.error

Просмотрите результаты инструментов - Сбои при выполнении инструментов часто объясняют неожиданное поведение агента

Отслеживайте использование токенов - Мониторьте потребление токенов для оптимизации подсказок и снижения затрат

Используйте системные подсказки - Добавьте инструкции логирования в системную подсказку, чтобы агент объяснил свои рассуждения