Просмотр сессий и отслеживание использования

Используйте средство просмотра сессий в Claude Console, чтобы изучить, что агент сделал в сессии, не написав ни строчки кода. Используйте итоговые значения usage сессии, чтобы увидеть, сколько ресурсов потребовала эта работа.

Просмотр сессии в Console

Средство просмотра сессий доступно только разработчикам (Developers) и администраторам (Admins). Чтобы открыть его, перейдите на боковую панель Console и выберите Sessions в разделе Managed Agents. В списке отображаются все сессии в рабочем пространстве с их статусом, агентом, использованием токенов, стоимостью и временем создания. Выберите сессию, чтобы открыть её.

Средство просмотра сессий показывает:

• Мини-карта временной шкалы (Timeline minimap): масштабируемый обзор активности сессии во времени, с отдельной дорожкой для каждого потока в мультиагентных сессиях. Выберите дорожку, чтобы просмотреть этот поток, или выберите отметку, чтобы перейти к её событию.
• Стенограмма (Transcript): диалог, сгруппированный по запросам к модели, включая размышления, вызовы инструментов с их входными данными и результатами, а также текст сообщений по мере его потоковой передачи. Вы можете фильтровать события, а также копировать или скачивать их в формате JSON.
• Инспектор (Inspector): боковая панель с изменяемым размером, содержащая сведения о сессии на пяти вкладках.

Добавьте ?event={event_id} к URL сессии, чтобы открыть сессию на определённом событии.

С помощью ant beta:sessions connect вы можете открыть то же средство просмотра из CLI ant или следить за сессией в терминале. См. Подключение к сессии Managed Agents из терминала.

Отслеживание использования

Объект сессии включает поле usage с накопленным использованием сессии: количеством токенов, использованием серверных инструментов, активным временем и отслеживаемой стоимостью по прейскуранту. Получите сессию после того, как она перейдёт в состояние простоя, чтобы прочитать актуальные итоговые значения.

{
  "id": "sesn_01...",
  "status": "idle",
  "usage": {
    "input_tokens": 5000,
    "output_tokens": 3200,
    "cache_read_input_tokens": 20000,
    "cache_creation": {
      "ephemeral_5m_input_tokens": 2000,
      "ephemeral_1h_input_tokens": 0
    },
    "list_cost": {
      "amount": "187",
      "currency": "USD"
    },
    "active_seconds": 342.5,
    "server_tool_use": {
      "web_search_requests": 3,
      "web_fetch_requests": 0
    }
  }
}

Записи кэша по умолчанию используют TTL в 5 минут, поэтому последовательные ходы в пределах этого окна выигрывают от чтения из кэша, что снижает стоимость за токен.

Объект stats сессии имеет собственное поле active_seconds, которое суммирует активное время каждого потока, а не учитывает перекрывающуюся активность один раз.

Использование по потокам

Собственное поле usage каждого потока сессии также содержит list_cost и active_seconds. Значения по потокам округляются независимо и не включают стоимость времени выполнения сессии, поэтому их сумма не совпадает в точности с list_cost сессии. Авторитетным является значение для сессии.

Чтение использования из потока

Вам не нужно опрашивать сессию, чтобы отслеживать эти итоговые значения. Событие session.usage содержит тот же накопленный снимок в потоке сессии и в истории событий. Снимок содержит объект usage, а также budget сессии, который равен null, если бюджет у сессии не задан.

Событие генерируется при переходах в состояние простоя, а не по таймеру:

• Сессия генерирует его непосредственно перед переходом в состояние простоя, независимо от причины остановки.
• Сессия генерирует его, когда поток приостанавливается при достижении бюджета сессии.

Применение лимита расходов

Чтобы применить лимит расходов, задайте бюджет сессии, вместо того чтобы опрашивать использование и останавливать сессию самостоятельно. Платформа непрерывно рассчитывает стоимость потребления сессии и приостанавливает каждый поток перед его следующим запросом к модели, как только стоимость по прейскуранту достигает лимита. См. Когда сессия достигает бюджета, чтобы узнать, как это выглядит в потоке.

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

• Проверяйте события сессии: сессия сообщает об ошибках через события session.error.
• Изучайте результаты инструментов: сбои выполнения инструментов часто объясняют неожиданное поведение агента. Вкладка Tools инспектора показывает сбои каждого инструмента.
• Используйте системные подсказки: добавьте в системную подсказку инструкции по ведению журнала, чтобы агент кратко описывал, что он сделал и что обнаружил.
• Устраняйте неполадки с предварительным просмотром: если поток, в котором включены дельты событий, ведёт себя не так, как вы ожидаете, см. Устранение неполадок с предварительным просмотром.

Следующие шаги