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 |
|---|---|---|---|
day | string | No | Календарный день, который представляет эта запись, в YYYY-MM-DD формате. В 28-дневных отчетах она day появляется внутри каждой day_totals записи, а не на верхнем уровне. |
enterprise_id | string | No | Уникальный идентификатор предприятия. Включено как в отчеты по корпоративному, так и в организационном масштабе. |
organization_id | string | Да | Уникальный идентификатор организации. Включено только в отчёты по организационному масштабу; Опущено в отчётах масштаба предприятия. |
etl_id / day_partition | string | No | Разделочные поля, используемые для уборки. Включено в экспортированные файлы NDJSON и возвращаемое API метрик использования. |
entity_id_partition | integer | No | Раздел сущности, используемый для уборки. Включено в экспортированные файлы NDJSON и возвращаемое API метрик использования. |
Поля отчёта для каждого пользователя
Отчёты на пользователя содержат одну запись на каждого пользователя за отчетный период. 28-дневный отчет на пользователя также включает report_start_day и report_end_day отмечает окно отчётности.
| Поле | Тип | Нуллибельный | Description |
|---|---|---|---|
user_id | integer | No | Уникальный идентификатор пользователя. |
user_login | string | No | |
| GitHub Имя пользователя. | |||
ai_credits_used | number | No | Общее количество кредитов ИИ, потраченных пользователем за отчетный период. Это поле включено только в отчёты для каждого пользователя и не разбивается по функциям, модели или поверхности. Эта метрика предназначена для анализа потребления, а не для выставления сумм. |
user_initiated_ | integer | No | Количество явных подсказок, отправленных на Copilot. Подсчитываются только сообщения или приглашения, активно отправленные в модель. |
| Не включает открытие панели чата, переключение режимов (например, запрос, редактирование, планирование или агент), использование клавиатурных ярлыков для открытия встроенного интерфейса или внесение изменений в конфигурацию. | |||
code_generation_ | integer | No | Количество генерируемых отдельных Copilot выходных событий. |
| Включает: Весь сгенерированный контент, включая комментарии и строки документации. | |||
| Несколько блоков: Каждый отдельный блок кода из приглашения одного пользователя считается отдельным поколением. | |||
Заметка: Эту метрику нельзя напрямую сравнивать с user_initiated_, так как один запрос может привести к нескольким поколениям. | |||
code_acceptance_ | integer | No | Количество предложений или блоков кода, принятых пользователями. |
| Рассчитывает: Все встроенные действия принятия, такие как «применить к файлу», «вставить при курсоре», «вставить в терминал» и использование кнопки «Копировать ». | |||
| Не считается: Ручные действия с буфером обмена ОС (например, Ctrl+C). | |||
| Зернистость: При каждом действии принятия счетчик увеличивается один раз, независимо от того, сколько блоков кода было создано первоначальным запросом. | |||
loc_suggested_ | integer | No | Предложенные строки кода Copilot (завершения, встроенный чат, чат-панель и так далее; исключает правки агента). |
loc_suggested_ | integer | No | Предложено удалить строки Copilot кода (планируется поддержка в будущем). |
loc_added_sum | integer | No | Строки кода, фактически добавляемые в редактор (принимаемые завершения, применяемые блоки кода, режим агента и редактирования). |
loc_deleted_sum | integer | No | Строки кода удаляются из редактора (в настоящее время из правок агентов). |
used_agent | boolean | No | Использовал ли пользователь режим агента в IDE в тот день. Не включает Copilot code review активность, которая фиксируется отдельно в used_copilot_ и used_copilot_. |
used_chat | boolean | No | Пользовался ли пользователь в IDE Chat в тот день. |
used_cli | boolean | No | Пользовался Copilot CLI ли пользователь в тот день. |
used_copilot_app | boolean | No | Используется ли пользователь в Copilot app тот день. |
used_copilot_ | boolean | No | Пользовался ли Copilot cloud agent пользователь (ранее кодинговым агентом Copilot) в тот день. |
used_copilot_ | boolean | No | Пользовался Copilot cloud agent ли пользователь в тот день. Имеет то же значение, что used_copilot_и ; оба имена сохраняются для обратной совместимости. |
used_copilot_ | boolean | Да | Активно ли пользователь участвовал в Copilot code review этом дне. Пользователь считается активным, если он вручную запросил Copilot отзыв или применил Copilot предложение по отзыву. Null, если у пользователя в этот день нет Copilot code review сигнала. |
used_copilot_ | boolean | Да | Был ли пользователь Copilot автоматически назначен для просмотра своего pull-запроса в тот день, не участвуя в этом обзоре. Null, если у пользователя в этот день нет Copilot code review сигнала. |
ai_adoption_phase | object | No | Фаза внедрения ИИ пользователем на сегодня. Всегда рядом; по умолчанию переходит на фазу «Нет когорты». См. поля фазы внедрения ИИ. |
totals_by_cli | object | Да | Метрики, специфичные для CLI, для пользователя. Опущено, когда пользователь не Copilot CLI пользовался этим в тот день. См. Copilot CLI поля метрик. |
totals_by_copilot_ | object | Да | |
| Copilot app Метрики для пользователя. Опущено, когда пользователь не Copilot app пользовался этим в тот день. См. Copilot app поля метрик. | |||
totals_by_3rd_ | array | Да | Метрики использования для распознанных agent appsданных для каждого агента. Опущен, когда пользователь не agent app распознал действия в течение отчетного периода. См. Agent apps поля метрик. |
totals_by_ide | array | No | Per-IDE разбивку активности пользователя. См. Объекты разбивки активности. |
totals_by_feature | array | No | Разбивка активности пользователя по функциям. См. Объекты разбивки активности. |
totals_by_language_ | array | No | Разбивка, объединяющая язык и размерность функции. См. Объекты разбивки активности. |
totals_by_language_ | array | No | Разбор с сочетанием языковых и модельных измерений для активности в чате. См. Объекты разбивки активности. |
totals_by_model_ | array | No | Разбор комбинирующих размеров модели и функций для активности чата. См. Объекты разбивки активности. |
Агрегированные поля отчётов о предприятиях и организациях
Агрегированные отчёты содержат одну запись на каждое предприятие или организацию, суммируя всех пользователей за день. Количество активных пользователей включает пользователей, идентифицированных как с помощью клиентской, так и серверной телеметрии. Пользователи, выявленные только с помощью телеметрии на стороне сервера, учитываются в общем числе активных пользователей, но могут не появляться в массивах разбивания размеров (totals_by_ide, totals_by_feature, и аналогично). В следующих таблицах приведены подсчёты активных пользователей, затем итоги активности и разбивки.
Количество активных пользователей:
| Поле | Тип | Нуллибельный | Description |
|---|---|---|---|
daily_active_ | integer | No | Число уникальных пользователей, которые использовались Copilot в данный день, включая пользователей, активных только в этом Copilot appслучае. |
weekly_active_ | integer | No | Число уникальных пользователей, которые использовались Copilot в течение следующего семидневного окна, включая пользователей, активных только в этом режиме Copilot app. |
monthly_active_ | integer | No | Число уникальных пользователей, которые использовались Copilot во время 28-дневного окна, включая пользователей, активных только в этом режиме Copilot app. |
monthly_active_ | integer | No | Количество уникальных пользователей, которые использовали чат в течение оставшихся 28 дней. |
monthly_active_ | integer | No | Количество уникальных пользователей, использовавших режим агента в течение оставшегося 28-дневного окна. |
daily_active_ | integer | No | Количество уникальных пользователей, которые использовали Copilot cloud agent в определённый день. |
weekly_active_ | integer | No | Количество уникальных пользователей, использовавших Copilot cloud agent их в течение семидневного окна. |
monthly_active_ | integer | No | Количество уникальных пользователей, использовавших Copilot cloud agent их в течение оставшегося 28-дневного окна. |
daily_active_ | integer | No | Количество уникальных пользователей, которые активно использовали Copilot code review их в определённый день. Активное использование означает ручной запрос на проверку или применение предложения. Если у пользователя есть как активные, так и пассивные сигналы в одном периоде, они считаются активными только так. |
weekly_active_ | integer | No | Количество уникальных пользователей, которые активно использовали Copilot code review это в течение семидневного окна. Если у пользователя есть как активные, так и пассивные сигналы в одном периоде, они считаются активными только так. |
monthly_active_ | integer | No | Количество уникальных пользователей, которые активно использовали Copilot code review в течение оставшихся 28-дневного окна. Если у пользователя есть как активные, так и пассивные сигналы в одном периоде, они считаются активными только так. |
daily_passive_ | integer | No | Количество уникальных пользователей, которые автоматически Copilot code review назначили просмотр своего pull-запроса в определённый день без активного взаимодействия. |
weekly_passive_ | integer | No | Количество уникальных пользователей, которые автоматически были Copilot code review назначены для просмотра их pull-запроса в течение оставшихся семи дней без активного взаимодействия. |
monthly_passive_ | integer | No | Количество уникальных пользователей, которые автоматически были Copilot code review назначены для просмотра своего pull-запроса в течение оставшихся 28 дней без активного взаимодействия. |
daily_active_ | integer | Да | Количество уникальных пользователей, которые использовали Copilot CLI в определённый день. Этот счёт независим от подсчёта активных пользователей IDE и не входит в определения активных пользователей на основе IDE. Опущено для предприятий или организаций без использования CLI в этот день. |
daily_active_ | integer | Да | Число уникальных пользователей, которые использовали Copilot app этот день. Значение NULL, если предприятие или организация не Copilot app имеет действий в этот день. |
Итоги активности и разбивки:
| Поле | Тип | Нуллибельный | Description |
|---|---|---|---|
user_initiated_ | integer | No | Общее количество явных запросов, отправленных Copilot всем пользователям за день. |
code_generation_ | integer | No | Общее количество отдельных Copilot выходных событий, генерируемых всеми пользователями за день. |
code_acceptance_ | integer | No | Общее количество предложений или блоков кода, принятых всеми пользователями за день. |
loc_suggested_ | integer | No | Собранные строки кода, предложенные для добавления на день. То же определение, что и поле для каждого пользователя. |
loc_suggested_ | integer | No | Агрегированные строки кода предложили удалить на день. То же определение, что и поле для каждого пользователя. |
loc_added_sum | integer | No | Добавлены агрегированные строки кода за день. То же определение, что и поле для каждого пользователя. |
loc_deleted_sum | integer | No | Агрегированные строки кода удалены за день. То же определение, что и поле для каждого пользователя. |
totals_by_ide | array | No | Агрегированный разбивка активности по IDE. См. Объекты разбивки активности. |
totals_by_feature | array | No | Агрегированный разбивка активности по объектам. См. Объекты разбивки активности. |
totals_by_language_ | array | No | Агрегированный разбор языковой и функциональной активности. См. Объекты разбивки активности. |
totals_by_language_ | array | No | Агрегированная разбивка языковой и модельной активности. См. Объекты разбивки активности. |
totals_by_model_ | array | No | Агрегированная разбивка активности по моделям и характеристикам. См. Объекты разбивки активности. |
totals_by_cli | object | Да | Агрегированные Copilot CLI метрики за день. Опускается, если в тот день нет использования CLI. В отличие от формы для каждого пользователя, она не включает last_known_cli_. См. Copilot CLI поля метрик. |
totals_by_copilot_ | object | Да | Агрегированные Copilot app метрики за день. Значение NULL, если предприятие или организация не Copilot app имеет действий в этот день. См. Copilot app поля метрик. |
totals_by_3rd_ | array | Да | Агрегированные метрики использования для распознанных agent appsданных для каждого агента. Опущен, когда предприятие или организация не признали agent app активность в тот день. См. Agent apps поля метрик. |
totals_by_ai_ | array | Да | Агрегаты пользователей по фазам и их средняя активность. Опускается, когда отсутствуют данные фазы внедрения. См. поля фазы внедрения ИИ. |
pull_requests | object | No | Ежедневная активность pull request для компании или организации. См. поля активности Pull request. |
28-дневные поля отчёта
28-дневные отчёты (enterprise-28-day и org-28-day) — это обёртки: они содержат окно отчётности на верхнем уровне и массив ежедневных агрегированных записей.
| Поле | Тип | Нуллибельный | Description |
|---|---|---|---|
report_start_day | string | No | Первый календарный день 28-дневного окна отчетности, в YYYY-MM-DD формате. |
report_end_day | string | No | Последний календарный день 28-дневного окна отчетности, в YYYY-MM-DD формате. |
created_at | string | No | Временная метка (ISO 8601) при формировании отчёта. |
day_totals | array | No | Массив ежедневных агрегированных записей. Каждая запись содержит те же поля, что и агрегированный однодневный отчет. См. поля отчётов по агрегированному предпринимательству и организации. |
Поля пользовательских команд
Эти поля появляются в ежедневном отчете пользовательских команд (доступном через REST API на уровне организации и предприятия) и используются для построения метрик на уровне команды путём объединения с отчётом по показателям использования на каждого пользователя. Полный рецепт join и URL конечных точек см. Показатели использования Copilot на уровне команд.
Команды с менее чем 5 сидящими Copilot пользователями в определённый день исключены из отчета user-teams.
| Поле | Тип | Нуллибельный | Description |
|---|---|---|---|
user_id | integer | No | Уникальный идентификатор пользователя. |
user_login | string | No | |
| GitHub Имя пользователя. | |||
day | string | No | Календарный день, который представляет эта запись. |
organization_id | string | No | Уникальный идентификатор организации, к которой принадлежит команда. Только по сфере деятельности. |
enterprise_id | string | No | Уникальный идентификатор предприятия, к которому принадлежит команда. Только для корпоративного масштаба. Отчет с корпоративным охватом включает как корпоративные команды, так и бизнес-команды. |
team_id | integer | No | Уникальный идентификатор команды, к которой принадлежит пользователь. |
slug | string | No | Идентификатор, удобный для команды. |
Поля уровня репозитория (только API)
Отчеты уровня репозитория показывают ежедневное создание запроса на вытягивание, проверку, слияние и действие предложений для репозиториев в организации или предприятии, включая запросы на вытягивание, созданные Copilot cloud agent и проверенные Copilot code review. Каждая строка представляет один репозиторий, который имел действие запроса на вытягивание в течение запрошенного дня; репозитории без действия опущены. Эти отчеты сосредоточены на действии жизненного цикла запроса на вытягивание и могут содержать данные, даже если метрики использования интегрированной среды разработки отсутствуют.
Эти поля возвращаются ежедневным отчетом уровня репозитория (repos-1-day), доступным через REST API в организациях и корпоративных областях. URL-адреса конечных точек, конверт ответа, разрешения и рабочий процесс скачивания см. в разделе Конечные точки REST API для метрик использования Copilot. Примеры строк см. в разделе Пример схемы для метрик использования Copilot.
| Поле | Тип | Нуллибельный | Description |
|---|---|---|---|
day | string | No | Календарный день, который представляет эта запись, в YYYY-MM-DD формате. |
enterprise_id | string | No | Уникальный идентификатор предприятия. Заполнены в отчетах с областью предприятия и в отчетах с областью действия организации для организаций, принадлежащих предприятиям. Пусто для организаций, не принадлежащих предприятиям. |
organization_id | string | No | Уникальный идентификатор организации, владеющей репозиторием. Включен как в отчеты, так и в области организации. |
repo_id | integer | No | Уникальный идентификатор репозитория. |
repo_owner_name | string | No | Вход владельца репозитория. |
repo_name | string | No | Имя репозитория. |
repo_visibility | string | No | Видимость репозитория. Возможные значения: PRIVATE, INTERNALи PUBLIC. |
pull_requests | object | No | Ежедневное действие запроса на вытягивание для репозитория. См. поля активности Pull request. |
Объекты разбивки активности
Поля totals_by_* представляют собой массивы объектов поломки. Массив всегда присутствует, но может быть пустым. Внутри каждого объекта метрические поля (*_count и loc_*_sum) следуют тем же определениям, что и поля верхнего уровня для каждого пользователя, а поля размерности содержат значения, задокументированные в значениях размерности разбивки.
| Объект | Размерные поля | Description |
|---|---|---|
totals_by_ide[] | ide | Разбор по IDE. В отчётах для каждого пользователя каждая запись также включает last_known_ide_ и last_known_plugin_. |
totals_by_feature[] | feature | Разбивка по Copilot функциям (например, встроенный чат или панель чата). |
totals_by_language_ | ||
language, feature | Разбор, сочетая язык и особенности. Не включает user_initiated_. | |
totals_by_language_ | ||
language, model | Разбор комбинирования языка и модели, для активности чата (не завершения). | |
totals_by_model_ | ||
model, feature | Комбинирование модели и функций разбивки для активности чата (не завершения). |
В отчётах totals_by_ide[] для каждого пользователя каждая запись также содержит самые недавно обнаруженные версии IDE и Copilot Chat расширений для пользователя.
| Поле | Тип | Нуллибельный | Description |
|---|---|---|---|
last_known_ide_ | object | Да | Самая последняя версия IDE, обнаруженная для пользователя, как { ide_version, sampled_at }. Опущено для агрегированных строк разбивки, таких как ограниченный bucket IDE «другие». |
last_known_ide_ | string | No | Строка версии IDE. Присутствует, когда last_known_ide_ присутствует. |
last_known_ide_ | string | Да | Временная метка (ISO 8601), когда версия была сэмплирована. |
last_known_plugin_ | object | Да | Самое последнее Copilot расширение, обнаруженное для пользователя, как { plugin, plugin_version, sampled_at }. Опущено для агрегированных строк разбивки. |
last_known_plugin_ | string | No | Имя расширения (например copilot , или copilot-chat). Присутствует, когда last_known_plugin_ присутствует. |
last_known_plugin_ | string | No | Строка версии расширения. Присутствует, когда last_known_plugin_ присутствует. |
last_known_plugin_ | string | Да | Временная метка (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_ | integer | No | В этот день инициировано несколько отдельных сессий CLI. |
totals_by_cli.request_ | integer | No | Общее количество запросов, сделанных Copilot через CLI в этот день, включая как пользовательские подсказки, так и автоматические агентские последующие звонки. |
totals_by_cli.prompt_ | integer | No | Общее количество пользовательских подсказок, команд или запросов, выполненных в течение сессии. |
totals_by_cli.token_ | integer | No | Общее количество выводных токенов, сгенерированных по всем запросам CLI в этот день. |
totals_by_cli.token_ | integer | No | Общее количество токенов prompt, отправленных по всем запросам CLI в этот день. |
totals_by_cli.token_ | number | Да | Среднее количество токенов вывода и запросов на запрос CLI, вычисленное как (output_tokens_. Нулевый, когда в тот день не было никаких просьб. |
totals_by_cli.last_ | object | No | Самая последняя Copilot CLI версия, обнаруженная для пользователя в тот день, как { cli_version, sampled_at }. Только отчёты по пользователю. |
totals_by_cli.last_ | string | No | |
Copilot CLI Строка версии. По умолчанию unknown — если версия не обнаружена. | |||
totals_by_cli.last_ | string | Да | Временная метка (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_ | integer | No | Количество отдельных Copilot app сеансов, инициированных в этот день. |
totals_by_copilot_ | integer | No | Общее количество запросов, сделанных Copilot через Copilot app этот день, включая запросы, инициированные пользователем, и автоматические последующие вызовы агентов. |
totals_by_copilot_ | integer | No | Общее количество пользовательских подсказок, команд или запросов, выполненных в течение сессии. |
totals_by_copilot_ | integer | No | Общий объем выходных маркеров, созданных во всех Copilot app запросах в этот день. |
totals_by_copilot_ | integer | No | Общий объем маркеров запроса, отправленных по всем Copilot app запросам в этот день. |
totals_by_copilot_ | number | Да | Среднее значение выходных и запрашиваемых маркеров для каждого Copilot app запроса, вычисляемое как (output_tokens_. Нулевый, когда в тот день не было никаких просьб. |
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_ | string | No | Отображаемое имя agent appобъекта . Имя может измениться, поэтому используется agent_id для группировки. |
totals_by_3rd_ | string | No | Стабильный agent appидентификатор для объекта . |
totals_by_3rd_ | integer | No | Количество запущенных пользователем заданий в agent app течение отчетного периода. Каждое задание увеличивает число один раз. |
totals_by_3rd_ | integer | No | Сумма отдельных, непустых сеансов для интеграции, сопоставленных с агентом в течение отчетного периода. Включен только в агрегированные отчеты предприятия и организации; опущено из отчетов для каждого пользователя. |
Поля активности pull request
Внимание
Отчёты на уровне организации и предприятий могут показывать разные итоги из-за различий в дедупликации пользователя и времени атрибуции. Для получения рекомендаций по интерпретации метрик pull request-запросов в разных областях см. GitHub Copilot метрики использования.
Объект pull_requests отображается в агрегированных отчетах предприятия и организации, а также в отчетах уровня репозитория. Он записывает ежедневное создание запроса на вытягивание, проверку, слияние и действие предложения, включая действия, выполняемые Copilot cloud agent и Copilot code review.
| Поле | Тип | Нуллибельный | Description |
|---|---|---|---|
pull_requests.total_ | integer | No | Общее количество pull request, созданных в этот конкретный день. Творение — это единичное событие. Каждый pull request учитывается только в день его создания. |
pull_requests.total_ | integer | No | Общее количество pull request, рассмотренных в этот конкретный день. Один и тот же pull request может засчитываться в несколько дней, если он получает отзывы в несколько дней. В течение одного дня каждый pull request засчитывается один раз, даже если происходит несколько действий по проверке. |
pull_requests.total_ | integer | No | Общее количество пулл-заявок, объединённых в этот конкретный день. Слияние — это одноразовое событие. Каждый pull request засчитывается только в день его слияния. |
pull_requests.median_ | number | Да | Медиана времени, в минутах, между созданием pull request и слиянием для pull-запросов, объединённых в этот конкретный день. Медиана используется для снижения воздействия выбросов от необычно долгих pull request. Null, когда в тот день не было объединено pull-запросы. |
pull_requests.total_ | integer | No | Общее количество предложений по отзывам pull request, созданных в этот конкретный день, независимо от автора. |
pull_requests.total_ | integer | No | Общее количество предложений по отзывам pull request, которые были применены в этот конкретный день, независимо от автора. |
pull_requests.total_ | integer | No | Количество pull-request, созданных Copilot cloud agent в этот конкретный день. |
pull_requests.total_ | integer | No | Количество просмотренных pull Copilot code review requests в этот конкретный день. Pull request может рассчитываться несколько дней, если Copilot code review проверять его несколько дней. |
pull_requests.total_ | integer | No | Количество pull-request, созданных Copilot cloud agent ими, было объединено именно в этот день. Каждый pull request засчитывается только в день его слияния. |
pull_requests.total_ | integer | No | Количество pull request, которые были объединены и рассмотрены Copilot code review в течение отчетного периода. |
pull_requests.median_ | number | Да | Медиана времени, в минутах, между созданием и слиянием pull request, созданных Copilot cloud agent и объединёнными в этот конкретный день. Null, когда в тот день не было объединено таких pull request. |
pull_requests.median_ | number | Да | Медианное время, в минутах, между созданием и слиянием pull request, рассчитывается только для pull request, рассмотренных .Copilot code review Null, когда в тот день не было объединено таких pull request. |
pull_requests.total_ | integer | No | Количество предложений по отзывам pull request, полученных Copilot code review в этот конкретный день. |
pull_requests.total_ | integer | No | Количество предложений по проверке pull request, Copilot code review которые были применены именно в этот день. |
pull_requests.copilot_ | array | No | Агрегированные числа Copilot code review предложений, разбитые на назначенный тип комментариев (например, security или bug_risk). Каждая запись включает comment_type, total_copilot_, и total_copilot_. Всегда присутствует, но может быть пустым. |
Области фазы внедрения ИИ
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_, который никогда не создает code_completion или agent_edit действие. Копирование кода из ответа чата также не создает сигнал. |
| Этап 1. Первый код | Участвует в выполнении встроенного кода (code_completionзначение измерения) или при редактировании агента непосредственно в файлы (agent_editзначение feature измерения).feature |
| Этап 2. Первый агент | Задействована ровно с одной GitHubповерхностью агента на основе: Copilot CLI (copilot_cliзначение feature измерения), Copilot cloud agent (used_copilot_или (used_copilot_ или Copilot code reviewused_copilot_). Активное и пассивное 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_ | integer | No | Числовой фазовый идентификатор (например, 0 для «No Cohort»). |
ai_adoption_phase.phase | string | No | Фазовое имя, читаемое человеком. |
ai_adoption_phase.version | string | No | Версия модели фазы принятия (например, v1). |
Каждая запись в агрегированном totals_by_ai_adoption_phase массиве содержит:
| Поле | Тип | Нуллибельный | Description |
|---|---|---|---|
phase | string | No | Фазовое имя, читаемое человеком. |
phase_number | integer | No | Числовой фазовый идентификатор. |
total_engaged_ | integer | No | Количество пользователей, сгруппированных в эту фазу за этот период. |
avg_user_initiated_ | number | No | Средний результат взаимодействий, инициированных пользователем на одного пользователя в этой фазе. |
avg_code_generation_ | number | No | Средняя активность по генерации кода на пользователя на этой фазе. |
avg_code_acceptance_ | number | No | Средняя активность по принятию кода на пользователя на этой фазе. |
avg_loc_added | number | No | Средняя добавленная строка кода на пользователя в этом этапе. |
avg_loc_deleted | number | No | Среднее количество строк кода, удалённых на одного пользователя в этом этапе. |
avg_pull_requests_ | number | No | Среднее количество просмотренных пулл-заявок на одного пользователя на этом этапе. |
avg_pull_requests_ | number | No | Среднее количество пулл-заявок, созданных на одного пользователя на этой фазе. |
avg_pull_requests_ | number | No | Среднее количество pull-запросов на пользователя в этом этапе. |
total_pull_requests_ | integer | No | Общее количество запросов на вытягивание, объединенных пользователями на этом этапе. Применяется к объединенным отчетам дня организации и дня предприятия. |
avg_pull_requests_ | number | No | Среднее количество медианных минут на одного пользователя для слияния для пользователей в этом этапе. |
avg_pull_requests_ | number | No | Время медиана в минутах от создания запроса на вытягивание до первого просмотра, область действия для объединения запросов на вытягивание и атрибут день слияния запроса на вытягивание. |
avg_pull_requests_ | number | No | Медиана количество отправки проверки (циклы проверки) на запрос на вытягивание, область действия для объединения запросов на вытягивание и атрибут день слияния запроса на вытягивание. |
Значения размерности разбоя
Объекты разбоя выше используют поля размерности, значения которых получены из фиксированных множеств. Это значения полей, а не отдельные поля. Например, agent_edit и значения chat_panel_*_mode — это значения поля feature , а не поля верхнего уровня.
Измерение определяет feature особенность или режим, к Copilot которому приписывается активность:
| Value | Description |
|---|---|
code_completion | Встроенные кодовые завершения. |
chat_inline | Онлайн-чат в редакторе. |
chat_panel_ask_ | Взаимодействие в чат-панели с выбранным режимом спроса. |
chat_panel_edit_ | Взаимодействие в чате с выбранным режимом редактирования. |
chat_panel_agent_ | Взаимодействие в чат-панели с выбранным режимом агента. |
chat_panel_plan_ | Взаимодействие в чат-панели с выбранным режимом плана. |
chat_panel_custom_ | Взаимодействие в чат-панели с выбранным пользовательским агентом. |
chat_panel_unknown_ | Взаимодействие в чат-панели, где режим неизвестен. |
agent_edit | Строки добавляются и удаляются, когда Copilot (в режиме агента и редактирования) записывает изменения прямо в ваши файлы в IDE. Также учитывает правки от кастомных агентов. |
agent_edit не включена в метрики на основе предложений и может не заполнять поля в стиле предложений, такие user_initiated_как . | |
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.