Skip to main content

Данные, доступные в метриках использования Copilot

Copilot Данные метрик использования доступны через дашборд и API, используя единый набор полей для представления активности по внедрению, использованию и генерации кода.

Кто может использовать эту функцию?

Владельцы предприятий, администраторы организаций, менеджеры по биллингу и люди с корпоративной кастомной ролью с разрешением «Просмотреть корпоративные Copilot метрики».

Copilot Дашборд метрик использования и API отображают и экспортируют данные с помощью единого набора полей. В этом справочнике перечислены все доступные метрики и описано, как интерпретировать их значения как в визуальных элементах панели мониторинга, так и при экспорте NDJSON или API.

  • Copilot Дашборды с метриками использования доступны как на уровне предприятия, так и на уровне организации.
  • Copilot API-интерфейсы метрик использования возвращают отчеты в области предприятия или организации с агрегированными, уровнями репозитория и отдельными детализациями отчетов на уровне пользователя. Фигуры зависят от области и детализации.
  • Метрики на уровне команд не агрегируются заранее; Вы создаёте их, объединяя отчет User-Teams с отчётом по метрикам использования пользователя. См . раздел AUTOTITLE.
  • Отчеты уровня репозитория содержат одну запись для каждого репозитория с действием запроса на вытягивание в течение запрошенного дня. См. поля уровня репозитория (ТОЛЬКО API) далее в этой статье.

Рекомендации по чтению и интерпретации этих метрик см. в разделе AUTOTITLE.

Copilot Метрики панели использования

Эти метрики отображаются непосредственно в панели Copilot использования. Эти графики не учитывают Copilot CLI использование.

Единица измеренияDescription
Внедрение агентовПроцент Copilotлицензированных активных пользователей, которые попробовали агента в текущем календарном месяце.
Среднее количество запросов в чате на одного активного пользователяСреднее количество запросов в чате на одного активного пользователя.
Автодополнения кода (рекомендуется/принимается)Общее количество предложений встроенного кода, которые были показаны и приняты.
Процент принятия доработок кодаПроцент предложений, принятых пользователями.
Ежедневные активные пользователиКоличество уникальных пользователей, которые использовали Copilot в определённый день.
Еженедельные активные пользователиКоличество уникальных пользователей, использовавших Copilot их в течение семидневного окна.
Всего активных пользователейЛицензированные пользователи, активные в текущем календарном месяце.
Использование языкаРаспределение языков программирования, используемых с Copilot.
Использование языка в деньЕжедневная разбивка используемых языков.
Использование моделиРаспространение моделей ИИ, используемых для чата.
Использование модели в деньЕжедневная разбивка использования модели чата.
Моделирование использования в каждом режиме чатаИспользование модели по Copilot функциям (спросить, редактировать, планировать, агент).
Использование модели для каждого языкаРаспределение языков с разбивкой по моделям.
Наиболее часто используемая модель чатаСамая часто используемая модель чата за последние 28 дней.
Количество запросов в каждом режиме чатаКоличество запросов на чат по режиму (запрос, редактирование, планирование, агент).

Влияние метрик панели мониторинга

Эти метрики отображаются на панели мониторинга влияния, которая группирует пользователей в когорты внедрения и подключается к выводу запроса на вытягивание. Рекомендации по интерпретации кохортов внедрения см. в разделе GitHub Copilot метрики использования.

Единица измеренияDescription
Тенденции взаимодействияКак в течение последних шести месяцев смешивание и пропускная способность запросов на вытягивание организации (общий объем запросов на вытягивание, объединенных в месяц) изменилась.
Распространение когорты внедренияДоля лицензированных пользователей, сгруппированных на каждом этапе внедрения (пассивные пользователи, этап 1, этап 2, этап 3) в течение периода. Пассивные пользователи соответствуют значению No Cohort в API.
Умножение внедренияСравнивает заинтересованных пользователей (этап 1, 2 или 3) с пассивными пользователями по коду, отправленным (запросы на вытягивание, объединенные на каждого пользователя в месяц) и временем слияния запросов на вытягивание, чтобы показать относительное влияние более Copilot глубокого внедрения.
RecommendationsПредлагаемые действия, такие как настройка Copilot cloud agent или включение Copilot code review, на основе текущего дистрибутива организации.

Метрики панели генерации кода

Эти метрики отображаются в панели генерации кода и дают разбор того, как генерируется код в рамках инициированных пользователями и агентами активностей. Все значения получаются из строк кода (LoC), добавленных или удаленных в IDE.

Единица измеренияDescription
Строки кода, изменённые с помощью ИИВсего строки кода, добавленных и удаленных во всех режимах за последние 28 дней.
Вклад агентаПроцент строк кода, добавленных и удалённых агентами (включая редактирование, агент и пользовательские режимы) за последние 28 дней.
Средние строки, удалённые агентомСреднее количество строк, автоматически удаляемых агентами от имени активных пользователей в течение текущего календарного месяца.
Ежедневное количество добавленных и удаленных строкОбщее количество строк, добавленных и удалённых из кодовой базы по всем режимам за каждый день.
Изменения кода, инициированные пользователемСтроки, предложенные или вручную добавленные пользователями через завершение кода и действия в чат-панели (вставить, скопировать или применить).
Изменения кода, инициируемые агентамиСтроки автоматически добавляются или удаляются из кодовой базы агентами от имени пользователей в режимах редактирования, агента и пользовательских режимов.
Изменения кода, инициируемые пользователем для каждой моделиПользовательские строки кода, сгруппированные по моделям, используемым в IDE.
Изменения кода, инициируемые агентом для каждой моделиСтроки кода, инициируемые агентом, сгруппированные по моделям, выполняющими действия агента.
Изменения кода, инициируемые пользователем по языкамСтроки кода, инициированные пользователем, сгруппированные по языкам программирования.
Изменения кода, инициируемые агентом по языкамСтроки кода, инициируемые агентом, сгруппированные по языкам программирования.

API и поля экспорта

Эти поля появляются в экспортируемых отчётах NDJSON и в Copilot API метрик использования. Большинство таблиц ниже показывают название поля, тип JSON, возможность значения быть null, а также описание.

Отчёты бывают разных форм в зависимости от их объёма и детализации, поэтому доступные поля в записи зависят от того, из какого отчёта они взяты:

  • Отчёты на пользователя (*-users-1-day и *-users-28-day) содержат одну запись на пользователя, включая user_id, user_login, ai_credits_used, , индикаторы used_* и ai_adoption_phase. Они не содержат активного числа pull_requestsпользователей, или totals_by_ai_adoption_phase.
  • Агрегированные отчёты (enterprise-1-day и org-1-day) содержат одну агрегированную запись на каждое предприятие или организацию, включая количество активных пользователей, pull_requests, и totals_by_ai_adoption_phase. Они не содержат user_id, user_loginили индикаторов used_* .
  • 28-дневные отчёты (enterprise-28-day и org-28-day) охватывают массу ежедневных агрегированных записей в поле day_totals , с окном отчетности на верхнем уровне.
  • Отчёты пользовательских команд (*-user-teams-1-day) отображают пользователей с командами, к которым они принадлежат, чтобы вы могли строить метрики на уровне команд.
  • Отчеты уровня репозитория (*-repos-1-day) содержат одну запись для каждого репозитория с действием запроса на вытягивание в течение дня, включая запросы на вытягивание, созданные Copilot cloud agent и проверенные Copilot code review.

Отчёты по сфере деятельности организации также включают organization_id вместе enterprise_id. Например, схемы данных, возвращаемых API, см. Пример схемы для метрик использования Copilot.

Столбец Type использует типы схемы JSON: string, integer, number``boolean``arrayи .object Столбец Nullable указывает, может ли значение поля быть null или отсутствовать в записи, где оно в противном случае применимо. Массивы разбивки действий всегда присутствуют, но могут быть пустыми ([]). Необязательные массивы помечены как допускающие значение NULL и могут быть отсутствуют.

Поля идентификации и разбиения отчётов

Эти поля определяют область действия, дату и (для экспорта) раздел каждой записи. Точный набор зависит от формы отчёта.

ПолеТипНуллибельныйDescription
daystringNoКалендарный день, который представляет эта запись, в YYYY-MM-DD формате. В 28-дневных отчетах она day появляется внутри каждой day_totals записи, а не на верхнем уровне.
enterprise_idstringNoУникальный идентификатор предприятия. Включено как в отчеты по корпоративному, так и в организационном масштабе.
organization_idstringДаУникальный идентификатор организации. Включено только в отчёты по организационному масштабу; Опущено в отчётах масштаба предприятия.
etl_id / day_partitionstringNoРазделочные поля, используемые для уборки. Включено в экспортированные файлы NDJSON и возвращаемое API метрик использования.
entity_id_partitionintegerNoРаздел сущности, используемый для уборки. Включено в экспортированные файлы NDJSON и возвращаемое API метрик использования.

Поля отчёта для каждого пользователя

Отчёты на пользователя содержат одну запись на каждого пользователя за отчетный период. 28-дневный отчет на пользователя также включает report_start_day и report_end_day отмечает окно отчётности.

ПолеТипНуллибельныйDescription
user_idintegerNoУникальный идентификатор пользователя.
user_loginstringNo
GitHub Имя пользователя.
ai_credits_usednumberNoОбщее количество кредитов ИИ, потраченных пользователем за отчетный период. Это поле включено только в отчёты для каждого пользователя и не разбивается по функциям, модели или поверхности. Эта метрика предназначена для анализа потребления, а не для выставления сумм.
user_initiated_interaction_countintegerNoКоличество явных подсказок, отправленных на Copilot.

Подсчитываются только сообщения или приглашения, активно отправленные в модель.
Не включает открытие панели чата, переключение режимов (например, запрос, редактирование, планирование или агент), использование клавиатурных ярлыков для открытия встроенного интерфейса или внесение изменений в конфигурацию.
code_generation_activity_countintegerNoКоличество генерируемых отдельных Copilot выходных событий.

Включает: Весь сгенерированный контент, включая комментарии и строки документации.
Несколько блоков: Каждый отдельный блок кода из приглашения одного пользователя считается отдельным поколением.
Заметка: Эту метрику нельзя напрямую сравнивать с user_initiated_interaction_count, так как один запрос может привести к нескольким поколениям.
code_acceptance_activity_countintegerNoКоличество предложений или блоков кода, принятых пользователями.

Рассчитывает: Все встроенные действия принятия, такие как «применить к файлу», «вставить при курсоре», «вставить в терминал» и использование кнопки «Копировать ».
Не считается: Ручные действия с буфером обмена ОС (например, Ctrl+C).
Зернистость: При каждом действии принятия счетчик увеличивается один раз, независимо от того, сколько блоков кода было создано первоначальным запросом.
loc_suggested_to_add_sumintegerNoПредложенные строки кода Copilot (завершения, встроенный чат, чат-панель и так далее; исключает правки агента).
loc_suggested_to_delete_sumintegerNoПредложено удалить строки Copilot кода (планируется поддержка в будущем).
loc_added_sumintegerNoСтроки кода, фактически добавляемые в редактор (принимаемые завершения, применяемые блоки кода, режим агента и редактирования).
loc_deleted_sumintegerNoСтроки кода удаляются из редактора (в настоящее время из правок агентов).
used_agentbooleanNoИспользовал ли пользователь режим агента в IDE в тот день. Не включает Copilot code review активность, которая фиксируется отдельно в used_copilot_code_review_active и used_copilot_code_review_passive.
used_chatbooleanNoПользовался ли пользователь в IDE Chat в тот день.
used_clibooleanNoПользовался Copilot CLI ли пользователь в тот день.
used_copilot_appbooleanNoИспользуется ли пользователь в Copilot app тот день.
used_copilot_coding_agentbooleanNoПользовался ли Copilot cloud agent пользователь (ранее кодинговым агентом Copilot) в тот день.
used_copilot_cloud_agentbooleanNoПользовался Copilot cloud agent ли пользователь в тот день. Имеет то же значение, что used_copilot_coding_agentи ; оба имена сохраняются для обратной совместимости.
used_copilot_code_review_activebooleanДаАктивно ли пользователь участвовал в Copilot code review этом дне. Пользователь считается активным, если он вручную запросил Copilot отзыв или применил Copilot предложение по отзыву. Null, если у пользователя в этот день нет Copilot code review сигнала.
used_copilot_code_review_passivebooleanДаБыл ли пользователь Copilot автоматически назначен для просмотра своего pull-запроса в тот день, не участвуя в этом обзоре. Null, если у пользователя в этот день нет Copilot code review сигнала.
ai_adoption_phaseobjectNoФаза внедрения ИИ пользователем на сегодня. Всегда рядом; по умолчанию переходит на фазу «Нет когорты». См. поля фазы внедрения ИИ.
totals_by_cliobjectДаМетрики, специфичные для CLI, для пользователя. Опущено, когда пользователь не Copilot CLI пользовался этим в тот день. См. Copilot CLI поля метрик.
totals_by_copilot_appobjectДа
Copilot app Метрики для пользователя. Опущено, когда пользователь не Copilot app пользовался этим в тот день. См. Copilot app поля метрик.
totals_by_3rd_party_agentarrayДаМетрики использования для распознанных agent appsданных для каждого агента. Опущен, когда пользователь не agent app распознал действия в течение отчетного периода. См. Agent apps поля метрик.
totals_by_idearrayNoPer-IDE разбивку активности пользователя. См. Объекты разбивки активности.
totals_by_featurearrayNoРазбивка активности пользователя по функциям. См. Объекты разбивки активности.
totals_by_language_featurearrayNoРазбивка, объединяющая язык и размерность функции. См. Объекты разбивки активности.
totals_by_language_modelarrayNoРазбор с сочетанием языковых и модельных измерений для активности в чате. См. Объекты разбивки активности.
totals_by_model_featurearrayNoРазбор комбинирующих размеров модели и функций для активности чата. См. Объекты разбивки активности.

Агрегированные поля отчётов о предприятиях и организациях

Агрегированные отчёты содержат одну запись на каждое предприятие или организацию, суммируя всех пользователей за день. Количество активных пользователей включает пользователей, идентифицированных как с помощью клиентской, так и серверной телеметрии. Пользователи, выявленные только с помощью телеметрии на стороне сервера, учитываются в общем числе активных пользователей, но могут не появляться в массивах разбивания размеров (totals_by_ide, totals_by_feature, и аналогично). В следующих таблицах приведены подсчёты активных пользователей, затем итоги активности и разбивки.

Количество активных пользователей:

ПолеТипНуллибельныйDescription
daily_active_usersintegerNoЧисло уникальных пользователей, которые использовались Copilot в данный день, включая пользователей, активных только в этом Copilot appслучае.
weekly_active_usersintegerNoЧисло уникальных пользователей, которые использовались Copilot в течение следующего семидневного окна, включая пользователей, активных только в этом режиме Copilot app.
monthly_active_usersintegerNoЧисло уникальных пользователей, которые использовались Copilot во время 28-дневного окна, включая пользователей, активных только в этом режиме Copilot app.
monthly_active_chat_usersintegerNoКоличество уникальных пользователей, которые использовали чат в течение оставшихся 28 дней.
monthly_active_agent_usersintegerNoКоличество уникальных пользователей, использовавших режим агента в течение оставшегося 28-дневного окна.
daily_active_copilot_cloud_agent_usersintegerNoКоличество уникальных пользователей, которые использовали Copilot cloud agent в определённый день.
weekly_active_copilot_cloud_agent_usersintegerNoКоличество уникальных пользователей, использовавших Copilot cloud agent их в течение семидневного окна.
monthly_active_copilot_cloud_agent_usersintegerNoКоличество уникальных пользователей, использовавших Copilot cloud agent их в течение оставшегося 28-дневного окна.
daily_active_copilot_code_review_usersintegerNoКоличество уникальных пользователей, которые активно использовали Copilot code review их в определённый день. Активное использование означает ручной запрос на проверку или применение предложения. Если у пользователя есть как активные, так и пассивные сигналы в одном периоде, они считаются активными только так.
weekly_active_copilot_code_review_usersintegerNoКоличество уникальных пользователей, которые активно использовали Copilot code review это в течение семидневного окна. Если у пользователя есть как активные, так и пассивные сигналы в одном периоде, они считаются активными только так.
monthly_active_copilot_code_review_usersintegerNoКоличество уникальных пользователей, которые активно использовали Copilot code review в течение оставшихся 28-дневного окна. Если у пользователя есть как активные, так и пассивные сигналы в одном периоде, они считаются активными только так.
daily_passive_copilot_code_review_usersintegerNoКоличество уникальных пользователей, которые автоматически Copilot code review назначили просмотр своего pull-запроса в определённый день без активного взаимодействия.
weekly_passive_copilot_code_review_usersintegerNoКоличество уникальных пользователей, которые автоматически были Copilot code review назначены для просмотра их pull-запроса в течение оставшихся семи дней без активного взаимодействия.
monthly_passive_copilot_code_review_usersintegerNoКоличество уникальных пользователей, которые автоматически были Copilot code review назначены для просмотра своего pull-запроса в течение оставшихся 28 дней без активного взаимодействия.
daily_active_cli_usersintegerДаКоличество уникальных пользователей, которые использовали Copilot CLI в определённый день. Этот счёт независим от подсчёта активных пользователей IDE и не входит в определения активных пользователей на основе IDE. Опущено для предприятий или организаций без использования CLI в этот день.
daily_active_copilot_app_usersintegerДаЧисло уникальных пользователей, которые использовали Copilot app этот день. Значение NULL, если предприятие или организация не Copilot app имеет действий в этот день.

Итоги активности и разбивки:

ПолеТипНуллибельныйDescription
user_initiated_interaction_countintegerNoОбщее количество явных запросов, отправленных Copilot всем пользователям за день.
code_generation_activity_countintegerNoОбщее количество отдельных Copilot выходных событий, генерируемых всеми пользователями за день.
code_acceptance_activity_countintegerNoОбщее количество предложений или блоков кода, принятых всеми пользователями за день.
loc_suggested_to_add_sumintegerNoСобранные строки кода, предложенные для добавления на день. То же определение, что и поле для каждого пользователя.
loc_suggested_to_delete_sumintegerNoАгрегированные строки кода предложили удалить на день. То же определение, что и поле для каждого пользователя.
loc_added_sumintegerNoДобавлены агрегированные строки кода за день. То же определение, что и поле для каждого пользователя.
loc_deleted_sumintegerNoАгрегированные строки кода удалены за день. То же определение, что и поле для каждого пользователя.
totals_by_idearrayNoАгрегированный разбивка активности по IDE. См. Объекты разбивки активности.
totals_by_featurearrayNoАгрегированный разбивка активности по объектам. См. Объекты разбивки активности.
totals_by_language_featurearrayNoАгрегированный разбор языковой и функциональной активности. См. Объекты разбивки активности.
totals_by_language_modelarrayNoАгрегированная разбивка языковой и модельной активности. См. Объекты разбивки активности.
totals_by_model_featurearrayNoАгрегированная разбивка активности по моделям и характеристикам. См. Объекты разбивки активности.
totals_by_cliobjectДаАгрегированные Copilot CLI метрики за день. Опускается, если в тот день нет использования CLI. В отличие от формы для каждого пользователя, она не включает last_known_cli_version. См. Copilot CLI поля метрик.
totals_by_copilot_appobjectДаАгрегированные Copilot app метрики за день. Значение NULL, если предприятие или организация не Copilot app имеет действий в этот день. См. Copilot app поля метрик.
totals_by_3rd_party_agentarrayДаАгрегированные метрики использования для распознанных agent appsданных для каждого агента. Опущен, когда предприятие или организация не признали agent app активность в тот день. См. Agent apps поля метрик.
totals_by_ai_adoption_phasearrayДаАгрегаты пользователей по фазам и их средняя активность. Опускается, когда отсутствуют данные фазы внедрения. См. поля фазы внедрения ИИ.
pull_requestsobjectNoЕжедневная активность pull request для компании или организации. См. поля активности Pull request.

28-дневные поля отчёта

28-дневные отчёты (enterprise-28-day и org-28-day) — это обёртки: они содержат окно отчётности на верхнем уровне и массив ежедневных агрегированных записей.

ПолеТипНуллибельныйDescription
report_start_daystringNoПервый календарный день 28-дневного окна отчетности, в YYYY-MM-DD формате.
report_end_daystringNoПоследний календарный день 28-дневного окна отчетности, в YYYY-MM-DD формате.
created_atstringNoВременная метка (ISO 8601) при формировании отчёта.
day_totalsarrayNoМассив ежедневных агрегированных записей. Каждая запись содержит те же поля, что и агрегированный однодневный отчет. См. поля отчётов по агрегированному предпринимательству и организации.

Поля пользовательских команд

Эти поля появляются в ежедневном отчете пользовательских команд (доступном через REST API на уровне организации и предприятия) и используются для построения метрик на уровне команды путём объединения с отчётом по показателям использования на каждого пользователя. Полный рецепт join и URL конечных точек см. Показатели использования Copilot на уровне команд.

Команды с менее чем 5 сидящими Copilot пользователями в определённый день исключены из отчета user-teams.

ПолеТипНуллибельныйDescription
user_idintegerNoУникальный идентификатор пользователя.
user_loginstringNo
GitHub Имя пользователя.
daystringNoКалендарный день, который представляет эта запись.
organization_idstringNoУникальный идентификатор организации, к которой принадлежит команда. Только по сфере деятельности.
enterprise_idstringNoУникальный идентификатор предприятия, к которому принадлежит команда. Только для корпоративного масштаба. Отчет с корпоративным охватом включает как корпоративные команды, так и бизнес-команды.
team_idintegerNoУникальный идентификатор команды, к которой принадлежит пользователь.
slugstringNoИдентификатор, удобный для команды.

Поля уровня репозитория (только API)

Отчеты уровня репозитория показывают ежедневное создание запроса на вытягивание, проверку, слияние и действие предложений для репозиториев в организации или предприятии, включая запросы на вытягивание, созданные Copilot cloud agent и проверенные Copilot code review. Каждая строка представляет один репозиторий, который имел действие запроса на вытягивание в течение запрошенного дня; репозитории без действия опущены. Эти отчеты сосредоточены на действии жизненного цикла запроса на вытягивание и могут содержать данные, даже если метрики использования интегрированной среды разработки отсутствуют.

Эти поля возвращаются ежедневным отчетом уровня репозитория (repos-1-day), доступным через REST API в организациях и корпоративных областях. URL-адреса конечных точек, конверт ответа, разрешения и рабочий процесс скачивания см. в разделе Конечные точки REST API для метрик использования Copilot. Примеры строк см. в разделе Пример схемы для метрик использования Copilot.

ПолеТипНуллибельныйDescription
daystringNoКалендарный день, который представляет эта запись, в YYYY-MM-DD формате.
enterprise_idstringNoУникальный идентификатор предприятия. Заполнены в отчетах с областью предприятия и в отчетах с областью действия организации для организаций, принадлежащих предприятиям. Пусто для организаций, не принадлежащих предприятиям.
organization_idstringNoУникальный идентификатор организации, владеющей репозиторием. Включен как в отчеты, так и в области организации.
repo_idintegerNoУникальный идентификатор репозитория.
repo_owner_namestringNoВход владельца репозитория.
repo_namestringNoИмя репозитория.
repo_visibilitystringNoВидимость репозитория. Возможные значения: PRIVATE, INTERNALи PUBLIC.
pull_requestsobjectNoЕжедневное действие запроса на вытягивание для репозитория. См. поля активности Pull request.

Объекты разбивки активности

Поля totals_by_* представляют собой массивы объектов поломки. Массив всегда присутствует, но может быть пустым. Внутри каждого объекта метрические поля (*_count и loc_*_sum) следуют тем же определениям, что и поля верхнего уровня для каждого пользователя, а поля размерности содержат значения, задокументированные в значениях размерности разбивки.

ОбъектРазмерные поляDescription
totals_by_ide[]ideРазбор по IDE. В отчётах для каждого пользователя каждая запись также включает last_known_ide_version и last_known_plugin_version.
totals_by_feature[]featureРазбивка по Copilot функциям (например, встроенный чат или панель чата).
totals_by_language_feature[]
language, featureРазбор, сочетая язык и особенности. Не включает user_initiated_interaction_count.
totals_by_language_model[]
language, modelРазбор комбинирования языка и модели, для активности чата (не завершения).
totals_by_model_feature[]
model, featureКомбинирование модели и функций разбивки для активности чата (не завершения).

В отчётах totals_by_ide[] для каждого пользователя каждая запись также содержит самые недавно обнаруженные версии IDE и Copilot Chat расширений для пользователя.

ПолеТипНуллибельныйDescription
last_known_ide_versionobjectДаСамая последняя версия IDE, обнаруженная для пользователя, как { ide_version, sampled_at }. Опущено для агрегированных строк разбивки, таких как ограниченный bucket IDE «другие».
last_known_ide_version.ide_versionstringNoСтрока версии IDE. Присутствует, когда last_known_ide_version присутствует.
last_known_ide_version.sampled_atstringДаВременная метка (ISO 8601), когда версия была сэмплирована.
last_known_plugin_versionobjectДаСамое последнее Copilot расширение, обнаруженное для пользователя, как { plugin, plugin_version, sampled_at }. Опущено для агрегированных строк разбивки.
last_known_plugin_version.pluginstringNoИмя расширения (например copilot , или copilot-chat). Присутствует, когда last_known_plugin_version присутствует.
last_known_plugin_version.plugin_versionstringNoСтрока версии расширения. Присутствует, когда last_known_plugin_version присутствует.
last_known_plugin_version.sampled_atstringДаВременная метка (ISO 8601), когда версия была сэмплирована.

Copilot CLI Метричные поля

Объект totals_by_cli содержит следующие вложенные поля при Copilot CLI наличии использования; объект опускается при отсутствии использования CLI. Использование CLI не зависит от метрик IDE — оно не отражается в полях, таких как totals_by_ide или totals_by_feature. Объект last_known_cli_version появляется только в отчётах для каждого пользователя.

ПолеТипНуллибельныйDescription
totals_by_cli.session_countintegerNoВ этот день инициировано несколько отдельных сессий CLI.
totals_by_cli.request_countintegerNoОбщее количество запросов, сделанных Copilot через CLI в этот день, включая как пользовательские подсказки, так и автоматические агентские последующие звонки.
totals_by_cli.prompt_countintegerNoОбщее количество пользовательских подсказок, команд или запросов, выполненных в течение сессии.
totals_by_cli.token_usage.output_tokens_sumintegerNoОбщее количество выводных токенов, сгенерированных по всем запросам CLI в этот день.
totals_by_cli.token_usage.prompt_tokens_sumintegerNoОбщее количество токенов prompt, отправленных по всем запросам CLI в этот день.
totals_by_cli.token_usage.avg_tokens_per_requestnumberДаСреднее количество токенов вывода и запросов на запрос CLI, вычисленное как (output_tokens_sum + prompt_tokens_sum) ÷ request_count. Нулевый, когда в тот день не было никаких просьб.
totals_by_cli.last_known_cli_versionobjectNoСамая последняя Copilot CLI версия, обнаруженная для пользователя в тот день, как { cli_version, sampled_at }. Только отчёты по пользователю.
totals_by_cli.last_known_cli_version.cli_versionstringNo
Copilot CLI Строка версии. По умолчанию unknown — если версия не обнаружена.
totals_by_cli.last_known_cli_version.sampled_atstringДаВременная метка (ISO 8601), когда версия была сэмплирована.

Copilot app Метричные поля

Объект totals_by_copilot_app содержит следующие вложенные поля при Copilot app наличии использования. Он отображается в отчетах на пользователях и в агрегированных корпоративных отчетах; Он опущен или null, когда пользователь или предприятие не Copilot app имели действий в тот день. totals_by_cli В отличие Copilot appот действия кодирования, также отражается в totals_by_featureзначении totals_by_model_featureфункции, totals_by_language_featureа totals_by_language_model``copilot_app также в действии кода верхнего уровня и в метриках кода верхнего уровня. Поле отсутствует last_known_app_version .

ПолеТипНуллибельныйDescription
totals_by_copilot_app.session_countintegerNoКоличество отдельных Copilot app сеансов, инициированных в этот день.
totals_by_copilot_app.request_countintegerNoОбщее количество запросов, сделанных Copilot через Copilot app этот день, включая запросы, инициированные пользователем, и автоматические последующие вызовы агентов.
totals_by_copilot_app.prompt_countintegerNoОбщее количество пользовательских подсказок, команд или запросов, выполненных в течение сессии.
totals_by_copilot_app.token_usage.output_tokens_sumintegerNoОбщий объем выходных маркеров, созданных во всех Copilot app запросах в этот день.
totals_by_copilot_app.token_usage.prompt_tokens_sumintegerNoОбщий объем маркеров запроса, отправленных по всем Copilot app запросам в этот день.
totals_by_copilot_app.token_usage.avg_tokens_per_requestnumberДаСреднее значение выходных и запрашиваемых маркеров для каждого Copilot app запроса, вычисляемое как (output_tokens_sum + prompt_tokens_sum) ÷ request_count. Нулевый, когда в тот день не было никаких просьб.

Agent apps Метричные поля

Массив totals_by_3rd_party_agent содержит одну запись для каждого распознанного в agent app течение отчетного периода. Записи группируются agent_idпо и интеграциям, которые сопоставляются с тем же агентом. Используйте agent_id в качестве стабильного ключа группировки и agent_name для отображения. Массив опущен, если распознаваемые agent app действия не доступны в течение отчетного периода.

Эти метрики берутся из действия задания на стороне сервера. Задание вложенного user_initiated_interaction_count подсчета agent app начинается и отличается от поля верхнего уровня с тем же именем, которое подсчитывает явные запросы от других поддерживаемых данных телеметрии.

ПолеТипНуллибельныйDescription
totals_by_3rd_party_agent[].agent_namestringNoОтображаемое имя agent appобъекта . Имя может измениться, поэтому используется agent_id для группировки.
totals_by_3rd_party_agent[].agent_idstringNoСтабильный agent appидентификатор для объекта .
totals_by_3rd_party_agent[].user_initiated_interaction_countintegerNoКоличество запущенных пользователем заданий в agent app течение отчетного периода. Каждое задание увеличивает число один раз.
totals_by_3rd_party_agent[].session_countintegerNoСумма отдельных, непустых сеансов для интеграции, сопоставленных с агентом в течение отчетного периода. Включен только в агрегированные отчеты предприятия и организации; опущено из отчетов для каждого пользователя.

Поля активности pull request

Внимание

Отчёты на уровне организации и предприятий могут показывать разные итоги из-за различий в дедупликации пользователя и времени атрибуции. Для получения рекомендаций по интерпретации метрик pull request-запросов в разных областях см. GitHub Copilot метрики использования.

Объект pull_requests отображается в агрегированных отчетах предприятия и организации, а также в отчетах уровня репозитория. Он записывает ежедневное создание запроса на вытягивание, проверку, слияние и действие предложения, включая действия, выполняемые Copilot cloud agent и Copilot code review.

ПолеТипНуллибельныйDescription
pull_requests.total_createdintegerNoОбщее количество pull request, созданных в этот конкретный день.

Творение — это единичное событие. Каждый pull request учитывается только в день его создания.
pull_requests.total_reviewedintegerNoОбщее количество pull request, рассмотренных в этот конкретный день.

Один и тот же pull request может засчитываться в несколько дней, если он получает отзывы в несколько дней. В течение одного дня каждый pull request засчитывается один раз, даже если происходит несколько действий по проверке.
pull_requests.total_mergedintegerNoОбщее количество пулл-заявок, объединённых в этот конкретный день.

Слияние — это одноразовое событие. Каждый pull request засчитывается только в день его слияния.
pull_requests.median_minutes_to_mergenumberДаМедиана времени, в минутах, между созданием pull request и слиянием для pull-запросов, объединённых в этот конкретный день.

Медиана используется для снижения воздействия выбросов от необычно долгих pull request. Null, когда в тот день не было объединено pull-запросы.
pull_requests.total_suggestionsintegerNoОбщее количество предложений по отзывам pull request, созданных в этот конкретный день, независимо от автора.
pull_requests.total_applied_suggestionsintegerNoОбщее количество предложений по отзывам pull request, которые были применены в этот конкретный день, независимо от автора.
pull_requests.total_created_by_copilotintegerNoКоличество pull-request, созданных Copilot cloud agent в этот конкретный день.
pull_requests.total_reviewed_by_copilotintegerNoКоличество просмотренных pull Copilot code review requests в этот конкретный день.

Pull request может рассчитываться несколько дней, если Copilot code review проверять его несколько дней.
pull_requests.total_merged_created_by_copilotintegerNoКоличество pull-request, созданных Copilot cloud agent ими, было объединено именно в этот день. Каждый pull request засчитывается только в день его слияния.
pull_requests.total_merged_reviewed_by_copilotintegerNoКоличество pull request, которые были объединены и рассмотрены Copilot code review в течение отчетного периода.
pull_requests.median_minutes_to_merge_copilot_authorednumberДаМедиана времени, в минутах, между созданием и слиянием pull request, созданных Copilot cloud agent и объединёнными в этот конкретный день. Null, когда в тот день не было объединено таких pull request.
pull_requests.median_minutes_to_merge_copilot_reviewednumberДаМедианное время, в минутах, между созданием и слиянием pull request, рассчитывается только для pull request, рассмотренных .Copilot code review Null, когда в тот день не было объединено таких pull request.
pull_requests.total_copilot_suggestionsintegerNoКоличество предложений по отзывам pull request, полученных Copilot code review в этот конкретный день.
pull_requests.total_copilot_applied_suggestionsintegerNoКоличество предложений по проверке pull request, Copilot code review которые были применены именно в этот день.
pull_requests.copilot_suggestions_by_comment_typearrayNoАгрегированные числа Copilot code review предложений, разбитые на назначенный тип комментариев (например, security или bug_risk). Каждая запись включает comment_type, total_copilot_suggestions, и total_copilot_applied_suggestions. Всегда присутствует, но может быть пустым.

Области фазы внедрения ИИ

Copilot группирует пользователей на этапы внедрения ИИ в зависимости от их активности. Информация о фазе появляется в двух местах: объекте для каждого пользователя ai_adoption_phase и агрегированном totals_by_ai_adoption_phase массиве. Для фазовых значений см. Значения размерности разбоя.

Логика классификации

Пользователь классифицируется на этапе на Copilot основе функций, с которыми они занимаются . Пользователь занимается функцией, когда они используют ее по крайней мере через два разных дня в течение 28-дневного окна. Взаимодействие оценивается из сигналов активности уровня функций в таблице ниже, а не непосредственно из полей одного дня used_*на пользователя или из code_acceptance_activity_count. Этапы оцениваются сверху вниз, и пользователю назначается самый высокий этап, для которого они подходят.

PhaseКритерии взаимодействия
Нет когорты (отображаются как "Пассивные пользователи" на панели мониторинга влияния)Пользователь не занимается какой-либо функцией, которая соответствует этапу. Это не означает, что пользователь неактивен. Пользователь в этой группе по-прежнему может использовать Copilot регулярно и потреблять запросы premium, но не использовал квалификацию по крайней мере два разных дня в течение 28-дневного окна. Наиболее распространенным случаем является разговорное использование Copilot Chat или режим агента, записанный как chat_panel_agent_mode, который никогда не создает code_completion или agent_edit действие. Копирование кода из ответа чата также не создает сигнал.
Этап 1. Первый кодУчаствует в выполнении встроенного кода (code_completionзначение измерения) или при редактировании агента непосредственно в файлы (agent_editзначение feature измерения).feature
Этап 2. Первый агентЗадействована ровно с одной GitHubповерхностью агента на основе: Copilot CLI (copilot_cliзначение feature измерения), Copilot cloud agent (used_copilot_cloud_agentили (used_copilot_code_review_active или Copilot code reviewused_copilot_code_review_passive). Активное и пассивное Copilot code review число вместе в виде одной поверхности.
Этап 3. Мультиагентный
Copilot app Занимаясь (copilot_appзначением feature измерения) или занимаясь двумя или более поверхностями агента, перечисленными на этапе 2.

Пользователю необходимо только взаимодействовать с собственными сигналами этапа, чтобы достичь этого этапа. Пользователь не должен независимо соответствовать критериям этапа 1, чтобы достичь этапа 2 или этапа 3, хотя на практике использование поверхности агента часто происходит совместно с завершениями или изменениями агента.

Примечание.

Так как классификация использует взаимодействие на уровне признаков, некоторые действия не влияют на этап пользователя самостоятельно. Использование чата интегрированной среды разработки (used_chat) или режима агента (used_agent) не соответствует пользователю для этапа 1, если он не создает code_completion или agent_edit не выполняет действие.

Например, задавая вопрос в режиме агента, не позволяя Copilot изменять действия записей chat_panel_agent_mode файлов, а не agent_edit. Пользователь, использование которого полностью беседует таким образом, остается в группе No Cohort, даже если они активно используются и по-прежнему могут повлечь за собой использование Copilot запросов класса Premium. Аналогичным образом включает code_acceptance_activity_count приемы на основе чата, такие как "применить к файлу" и кнопку "Копировать ", которые не являются встроенным code_completion действием, поэтому он не используется для классификации. Дополнительные сведения об измерении feature см. в разделе "Значения измерения разбивки".

Назначение этапов пересчитывается каждый день с помощью 28-дневного окна, поэтому этап пользователя может измениться с одного дня на следующий, как их действие в окне сдвигается. Это ожидаемое поведение и не указывает на ошибку данных.

Объект для каждого пользователя ai_adoption_phase содержит:

ПолеТипНуллибельныйDescription
ai_adoption_phase.phase_numberintegerNoЧисловой фазовый идентификатор (например, 0 для «No Cohort»).
ai_adoption_phase.phasestringNoФазовое имя, читаемое человеком.
ai_adoption_phase.versionstringNoВерсия модели фазы принятия (например, v1).

Каждая запись в агрегированном totals_by_ai_adoption_phase массиве содержит:

ПолеТипНуллибельныйDescription
phasestringNoФазовое имя, читаемое человеком.
phase_numberintegerNoЧисловой фазовый идентификатор.
total_engaged_usersintegerNoКоличество пользователей, сгруппированных в эту фазу за этот период.
avg_user_initiated_interactionsnumberNoСредний результат взаимодействий, инициированных пользователем на одного пользователя в этой фазе.
avg_code_generation_activitiesnumberNoСредняя активность по генерации кода на пользователя на этой фазе.
avg_code_acceptance_activitiesnumberNoСредняя активность по принятию кода на пользователя на этой фазе.
avg_loc_addednumberNoСредняя добавленная строка кода на пользователя в этом этапе.
avg_loc_deletednumberNoСреднее количество строк кода, удалённых на одного пользователя в этом этапе.
avg_pull_requests_reviewednumberNoСреднее количество просмотренных пулл-заявок на одного пользователя на этом этапе.
avg_pull_requests_creatednumberNoСреднее количество пулл-заявок, созданных на одного пользователя на этой фазе.
avg_pull_requests_mergednumberNoСреднее количество pull-запросов на пользователя в этом этапе.
total_pull_requests_mergedintegerNoОбщее количество запросов на вытягивание, объединенных пользователями на этом этапе. Применяется к объединенным отчетам дня организации и дня предприятия.
avg_pull_requests_median_minutes_to_mergenumberNoСреднее количество медианных минут на одного пользователя для слияния для пользователей в этом этапе.
avg_pull_requests_minutes_to_reviewnumberNoВремя медиана в минутах от создания запроса на вытягивание до первого просмотра, область действия для объединения запросов на вытягивание и атрибут день слияния запроса на вытягивание.
avg_pull_requests_review_cyclesnumberNoМедиана количество отправки проверки (циклы проверки) на запрос на вытягивание, область действия для объединения запросов на вытягивание и атрибут день слияния запроса на вытягивание.

Значения размерности разбоя

Объекты разбоя выше используют поля размерности, значения которых получены из фиксированных множеств. Это значения полей, а не отдельные поля. Например, agent_edit и значения chat_panel_*_mode — это значения поля feature , а не поля верхнего уровня.

Измерение определяет feature особенность или режим, к Copilot которому приписывается активность:

ValueDescription
code_completionВстроенные кодовые завершения.
chat_inlineОнлайн-чат в редакторе.
chat_panel_ask_modeВзаимодействие в чат-панели с выбранным режимом спроса.
chat_panel_edit_modeВзаимодействие в чате с выбранным режимом редактирования.
chat_panel_agent_modeВзаимодействие в чат-панели с выбранным режимом агента.
chat_panel_plan_modeВзаимодействие в чат-панели с выбранным режимом плана.
chat_panel_custom_modeВзаимодействие в чат-панели с выбранным пользовательским агентом.
chat_panel_unknown_modeВзаимодействие в чат-панели, где режим неизвестен.
agent_editСтроки добавляются и удаляются, когда Copilot (в режиме агента и редактирования) записывает изменения прямо в ваши файлы в IDE. Также учитывает правки от кастомных агентов.
agent_edit не включена в метрики на основе предложений и может не заполнять поля в стиле предложений, такие user_initiated_interaction_countкак .
copilot_cliАктивность, приписываемая Copilot CLI.
copilot_appДействие, приписываемое приложению Copilot .
othersЛюбая особенность, не покрывающаяся вышеуказанными значениями.

Измерение определяет IDE, в котором ide произошла активность. Это не исчерпывающий список, но примеры наблюдаемых значений включают vscode, visualstudio, , intellij, eclipse``xcode``neovim``vim``emacs``zedи .

Измерение определяет модель ИИ, model используемую для активности в чате. Значения включают конкретные идентификаторы модели (например gpt-5.4 , или claude-sonnet-4.6), auto, unknown, и others. Значение auto отражает активность, в которой auto model selection была использована и запрос не был приписан конкретной модели.

Измерение определяет фазу внедрения ИИ, в которую phase сгруппирован пользователь: No Cohort, Phase 1, Phase 2, или Phase 3.