GitHub добавил в API Copilot usage metrics возможность отслеживать активность агентских приложений (например, Claude и Codex) в рабочих процессах. Теперь метрики использования можно разбивать по отдельным агентам — данные доступны в отчётах за 1 и 28 дней для предприятия, организации, пользователя предприятия и пользователя организации.
В API появилась новая необязательная структура totalsby3rdpartyagent — в ней для каждого распознанного агентского приложения есть запись с такими данными:
- agentname — отображаемое имя агента (его можно менять, поэтому для группировки лучше использовать agentid);
- agentid — стабильный идентификатор агента, который подходит для сопоставления данных за разные периоды;
- userinitiatedinteractioncount — количество запусков заданий агентского приложения, инициированных пользователем;
- session_count — количество сессий агентского приложения (учитывается только в агрегированных отчётах для предприятия и организации, в пользовательских записях это поле отсутствует).
Раньше активность агентов в метриках использования отображалась единым блоком — нельзя было отличить работу с агентом кодирования Copilot от работы с другими агентами. Теперь можно чётко отслеживать каждое агентское приложение, сравнивать их популярность и принимать решения о развёртывании и лицензировании на основе реальных данных.
Некоторые важные нюансы:
- значение userinitiatedinteractioncount вложенной структуры отражает запуск заданий агентского приложения — его нельзя суммировать с одноимённым полем верхнего уровня (оно учитывает явные запросы из другой поддерживаемой телеметрии);
- активность агрегируется по агентам — несколько приложений одного агента объединяются в одну запись; активность неустановленных агентов не учитывается;
- доступ к метрикам есть у владельцев предприятий и менеджеров по биллингу, владельцев организаций и пользователей с кастомной ролью, которая даёт разрешение View Copilot Metrics (при этом должна быть включена политика Copilot usage metrics);
- изменение обратно совместимо: существующие поля сохраняют прежний вид, а в отчётах поле totalsby3rdparty_agent отсутствует, если за отчётный период не было активности агентских приложений.
Подробнее можно узнать в документации Copilot usage metrics API или в разделе Agent apps metrics fields.