О метриках использования Copilot
Метрики использования Copilot помогают ключевым заинтересованным сторонам и лицам, принимающим решения, понять, как их команды внедряют и используют Copilot. Отслеживая модели использования по всему предприятию, вы можете измерять вовлечённость, выявлять возможности для увеличения ценности и оценивать, как рабочие процессы с помощью ИИ влияют на пропускную способность pull request и время слияния.
Метрики доступны через:
- Copilot API метрик использования, которые предоставляют подробные, экспортируемые данные на уровне предприятия, организации и пользователей.
- Панель метрик использования { variables.product.prodname_copilot_short %% данных } визуализирует 28-дневные тенденции использования в вашем предприятии и организациях.
- Дашборд генерации кода, который объясняет, как пользователи и агенты генерируют код в вашем предприятии и организациях.
- Экспорт Copilot метрики использования NDJSON, который предлагает необработанные данные для пользовательских инструментов бизнес-аналитики или долгосрочного хранения.
Какое использование включено?
Copilot метрики использования выводятся из телеметрии по нескольким Copilot поверхностям, включая активность IDE и Второй пилот CLI. Поскольку многие метрики поступают из IDE-телеметрии, конечные пользователи должны иметь включённую телеметрию в их IDE, чтобы быть включенной в эти метрики.
Данные не включают активность других Copilot поверхностей, таких как:
- Копилот Чат на GitHub.com
- GitHub Mobile
Данные об управлении лицензиями и рабочими местами не включаются в отчеты Copilot метрики использования. Для просмотра назначенных лицензий или управления ими используйте API управления пользователями Copilot, который является источником достоверной информации о лицензиях и рабочих местах. См . раздел AUTOTITLE.
Почему метрики использования Copilot могут различаться между ресурсами API
Следующие ресурсы API предоставляют Copilotсвязанные с } данными, но они не взаимозаменяемы и не должны сравниваться напрямую. Каждый ресурс API разработан для конкретного случая использования и модели данных, и ожидаются различия в сумме или покрытии. Используйте эту таблицу, чтобы понять, какой API ресурс лучше всего соответствует вашим потребностям в отчетности.
Примечание.
Мы настоятельно рекомендуем использовать API метрик использования Copilot для новых интеграций и анализов, так как он предоставляет наиболее полный и ориентированный на будущее обзор использования Copilot.
| Ресурс API | Scope | Ключевые возможности |
|---|
[AUTOTITLE](/rest/copilot/copilot-usage-metrics) | Продвинутая телеметрия событий на уровне предприятий, организаций и пользователей | Обеспечивает унифицированную телеметрию между режимами завершений, чата и агента. Включает метрики использования и строки кода во всех режимах, языках и моделях IDE. Поддерживает подробные разбивки по функциям, IDE, языку, модели и пользователю, и является основным ресурсом API, активно разрабатываемым и поддерживаемым. |
|
REST API конечные точки для управления пользователями Copilot | Лицензия и распределение мест | Списки, назначенные Copilot мест для организации или предприятия, включая состояние лицензии, ассоциацию пользователей и last_activity_at. Этот ресурс API является источником информации о лицензиях и местах. |
|
Конечные точки REST API для метрик Copilot | Метрики использования на уровне предприятия, организации и команды | Предоставляет агрегированные данные об использовании для Copilot функций на GitHub.com (например, резюме pull request) и некоторых завершений на основе IDE и чата. Не включает телеметрию в режиме агента или редактирования. Предлагает разбивку по всему предприятию и по функциям по IDE и языку. Не включает данные индивидуального уровня. |
Как приписывают метрики в разных организациях?
Примечание.
Вы можете предоставить только организационной видимости метрики использования Copilot без предоставления доступа на уровне предприятия.
Вы можете сделать это, создав пользовательскую роль организации, включающую разрешение «View organization Copilot метрики», и назначив эту роль пользователям, которым нужна видимость метрик для одной организации. См . раздел AUTOTITLE.
Метрики использования на уровне организации Copilot основаны на членстве организации, а не на том, где происходят отдельные действия. Чтобы отображаться в метриках предприятия, пользователь должен иметь активное место Copilot внутри этого предприятия (в любой организации, принадлежащей этому предприятию). В результате использование одного пользователя может отображаться в нескольких панелях управления организации, тогда как этот же пользователь учитывается только один раз в общем общем счете на уровне предприятия. Аналитика на уровне организации предназначена для видимости внедрения и использования внутри организации и не предназначена для прямого сравнения с корпоративными показателями.
Аналитика на уровне организации Copilot доступна с 12 декабря 2025 года. Это первая дата, когда предоставляются отчеты на уровне организации.
После того как пользователь получает место в компании, его использование приписывается каждой организации, к которой он принадлежит, независимо от того, где это место.
Это означает:
- Если лицензии присваиваются специализированной «оболочкой» организации для административных целей внутри предприятия, пользователи всё равно отображаются в метриках всех других организаций предприятия, к которым они принадлежат.
- Если у пользователя также есть место Copilot в отдельной организации вне предприятия, его активность всё равно включена в метрики на уровне организации, если у него есть хотя бы одно место внутри предприятия.
Короче говоря: пользователи должны быть лицензированы где-то в компании, чтобы они отображались в её метриках. Когда это происходит, метрики отражают место работы (членство в организации), а не то, какая организация предоставляет Copilot или откуда началась деятельность.
Поддерживаемые интегрированные среды разработки (IDE)
Чтобы быть включенным в метрики использования Copilot, конечные пользователи должны использовать одну из следующих версий IDE и Копилот Чат.
| Интегрированная среда разработки (IDE) | Минимальная версия IDE | Минимальная Копилот Чат версия расширения |
|---|---|---|
| Затмение | 4.31 | 0.9.3.202507240902 |
| JetBrains / IntelliJ | 2024.2.6 | 1.5.52-241 |
| Visual Studio | 17.14.13 | 18.0.471.29466 |
| VS Code | 1.101 | 0.28.0 |
| Xcode | 13.2.1 | 0.40.0 |
Свежесть данных
Данные на панели Copilot метриках использования и отчетах API регулярно обновляются.
Ожидайте, что данные будут доступны в течение двух полных дней. Это означает, что данные за определённый день обрабатываются и становятся доступны в течение двух полных дней UTC после окончания этого дня.
Что измеряют данные?
Copilot метрики использования можно сгруппировать в несколько основных категорий: внедрение, вовлечённость, уровень приёма, строки кода (LoC) и метрики жизненного цикла pull request.
**Внедрение** измеряет, сколько лицензированных разработчиков активно используют Copilot. Например, ежедневные активные пользователи (DAU) показывают, сколько уникальных пользователей взаимодействовали с Copilot в определенный день. В идеале во время развертывания вы должны наблюдать устойчивую тенденцию к росту этих показателей.
**Показатели вовлечения** описывают, насколько глубоко разработчики используют Copilot после их внедрения. Ключевые метрики вовлечения показывают не только частоту использования, но и широту охвата функций. Например, среднее количество запросов в чате на одного активного пользователя показывает, как часто пользователи открывают данные Копилот Чат и взаимодействуют с ними. Вы хотели бы видеть регулярное и растущее использование чата на разных языках и в интегрированных средах разработки.
**Коэффициент принятия** измеряет, как часто разработчики принимают предложения Copilot. Это поможет вам понять, актуальны ли предложения и заслуживают ли доверия. Например, высокий уровень принятия встроенных предложений указывает на то, что предложения актуальны и полезны.
**Метрики строк кода (LoC)** измеряют количество строк Copilot, предложенных, добавленных или удаленных в редакторе, обеспечивая направленное представление% данных variables.product.prodname_copilot_short %материальными результатами }. Например, "Добавлено строк" показывает, сколько кода было фактически принято и вставлено в редактор.
**Метрики жизненного цикла pull** request измеряют, как активность Copilot связана с результатами pull request и потоком доставки. Эти метрики включают создание и количество слияний по pull request, медианное время слияния и активность по просмотру предложений. Сравнивая общую активность pull request с pull-request, созданными Copilot, вы можете оценить, как рабочие процессы с помощью ИИ влияют на пропускную способность и время цикла на уровне организации или предприятия.
Интерпретация метрик жизненного цикла pull-запроса в разных областях
Метрики жизненного цикла pull запросов доступны как на уровне организации, так и на уровне предприятия. При сравнении отчётов имейте в виду следующее:
-
**Дедупликация**: Корпоративные отчёты дедупликационируют пользователей в разных организациях. Отчёты на уровне организаций — нет. -
**Данные только для pull request**: метрики жизненного цикла pull request могут появляться даже если метрики использования IDE отсутствуют, поскольку данные pull request производятся из активности репозитория. -
**Время атрибуции**: если репозиторий или организация передаётся между владельцами, события создания, просмотра и слияния могут быть приписаны разным организациям в зависимости от времени каждого события.
Как я могу использовать эти метрики?
Эти метрики можно использовать вместе, чтобы ответить на ключевые вопросы об использовании вашими командами Copilot.
| Question | Используйте эти метрики |
|---|---|
| Регулярно ли мои команды используют Copilot? | Ежедневные и еженедельные активные пользователи |
| Какие функции обеспечивают наибольшую ценность? | Количество запросов на режим чата, адаптация операторов |
| Доверяют ли разработчики Copilot? | Тенденции коэффициента принятия |
| Работают ли усилия по внедрению? | Рост внедрения и вовлеченности после обучения или коммуникационных кампаний |
| Влияет ли Copilot на скорость доставки или пропускную способность pull-запросов? | Количество слияний в pull request и медианное время слияния |
Ищите закономерности в этих сигналах, а не сосредотачивайтесь на каком-то одном числе. Например, стабильная DAU в сочетании с растущим коэффициентом принятия указывает на растущее доверие и ценность.
Дальнейшие шаги
Теперь, когда вы понимаете, что измеряет каждая метрика Copilot и как её использовать, вы можете изучить дашборды, чтобы увидеть эти метрики в действии.
- Чтобы увидеть тенденции внедрения и использования в вашем предприятии и организациях, смотрите раздел AUTOTITLE.
- Чтобы проанализировать, как пользователь и агенты генерируют код, см. АВТОЗАГОЛОВОК.
- Чтобы программно получить доступ к метрикам использования Copilot, см. Конечные точки REST API для метрик использования Copilot.