GitHub Copilot使用情况指标

关于 Copilot 使用情况指标

Copilot 使用情况指标可帮助关键利益干系人和决策者了解其团队如何采用和使用 Copilot。通过跟踪企业中的使用模式，可以衡量参与度、识别增加价值的机会，以及评估 AI 辅助工作流如何影响拉取请求吞吐量和合并时间。

可通过以下方法获取指标：

Copilot 使用情况指标 API，这些 API 在企业、组织和用户级别提供详细的可导出数据。
Copilot 使用情况指标仪表板，可视化企业和组织在 28 天内的使用趋势。
代码生成仪表板可细分企业和组织中的用户和代理如何生成代码。
Copilot 使用情况指标 NDJSON 导出，可为自定义 BI 工具或长期存储提供原始数据。

包括哪些用法？

Copilot 使用指标来自多个 Copilot 界面的遥测数据，包括 IDE 和 Copilot 命令行界面（CLI）活动。由于许多指标来自 IDE 遥测， 因此最终用户必须在其 IDE 中启用遥测才能包含在这些指标中。

数据不包括来自其他 Copilot 界面的活动，如：

GitHub.com 上的 Copilot对话
数据变量.product.prodname_mobile %}

许可证和座席管理数据不包括在 Copilot 使用指标报告中。要查看或管理许可证分配，请使用 Copilot 用户管理 API，此 API 是许可证和席位信息的权威来源。请参阅“用于Copilot用户管理的 REST API 终结点”。

为什么 Copilot 使用指标可能因 API 资源而异

以下 API 资源会公开与 Copilot 相关的数据，但这些资源不可互换，也不应直接进行比较。每个 API 资源专为特定用例和数据模型设计，预计总计或覆盖范围的差异。使用此表了解最适合你的报告需求的 API 资源。

注意

强烈建议使用 Copilot 使用情况指标 API 进行新的集成和分析，因为它提供了 Copilot 使用情况的最完整和面向未来的视图。

API 资源	Scope	关键功能

          [AUTOTITLE](/rest/copilot/copilot-usage-metrics) | 高级企业、组织和用户级事件遥测 | 在各种完成、聊天和智能体模式中提供统一的遥测。 包括所有 IDE 模式、语言和模型的使用情况和代码行指标。 支持按功能、IDE、语言、模型和用户的详细细分，并且是正在积极开发和维护的主要 API 资源。 |

| 用于Copilot用户管理的 REST API 终结点 | 许可证和席位分配 | 列出为组织或企业分配的 Copilot 席位，包括许可证状态、用户关联和 last_activity_at。此 API 资源是许可证和席位信息的真相来源。 | | Copilot指标的REST API终结点 | 企业、组织和团队级使用情况指标 | 提供 GitHub.com 上 Copilot 功能的聚合使用情况数据（例如拉取请求摘要），以及基于 IDE 的一些代码补全和聊天功能的聚合使用情况数据。不包括代理或编辑模式遥测。提供按企业范围和按功能细分的 IDE 和语言分析。不包括单个级数据。 |

如何跨组织归因指标？

注意

你可以只允许组织查看 Copilot 使用情况指标，而无需提供企业级访问权限。

为此，可以创建包含“查看组织 Copilot 指标”权限的组织自定义角色，并将该角色分配给需要查看单个组织的指标的用户。请参阅“自定义组织角色的权限”。

组织级别的 Copilot 使用情况指标基于组织成员身份，而非执行单个操作的位置。要显示在企业的指标中，用户必须在该企业内（属于企业的任何组织）分配有效的 Copilot 席位。因此，单个用户的使用情况可能会出现在多个组织仪表板中，而同一用户仅计算在企业级总计中的一次。组织级别的分析旨在了解组织中的采用和使用情况，并且不会直接与企业级总计进行比较。

从 2025 年 12 月 12 日开始，组织层级 Copilot 分析可用。这是提供组织级报告的第一个日期。

用户拥有企业中的席位后，其使用情况将归咎于 他们所属的每个组织，而不考虑分配席位的位置。

这意味着：

如果在专用的“shell”组织中分配许可证用于企业内部的管理目的，则用户仍显示在他们所属的企业中所有其他组织的指标中。
如果用户在企业外部的单独组织中也拥有 Copilot 席位，只要他们在企业中至少有一个席位，其活动就仍包含在企业的组织级别指标中。

简言之：用户必须在企业中的某个位置获得许可才能在其指标中显示。一旦确定，指标将反映他们工作的地点（其组织成员身份），而不是提供 Copilot 席位的组织或活动发起的地点。

支持的 IDE

若要纳入 Copilot 使用情况指标中，最终用户必须使用以下某个 IDE 和 Copilot对话扩展版本。

IDE	最低 IDE 版本	最低 Copilot对话扩展版本
Eclipse	4.31	0.9.3.202507240902
JetBrains / IntelliJ	2024.2.6	1.5.52-241
数据变量.product.prodname_vs %}	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) 和拉取请求生命周期指标。

          **采用率**衡量有多少授权开发人员正在积极使用 Copilot。 例如，每日活跃用户数 (DAU) 显示某一天与 Copilot 进行了交互的唯一身份用户数。 理想情况下，在推出期间，这些指标中会出现一致的上升趋势。

          **参与度** 指标描述了开发人员在采用 Copilot 后如何深入使用它。 关键参与指标不仅显示使用频率，还显示了功能之间的广度。 例如，每个活跃用户的平均聊天请求次数用于测量用户打开和与Copilot对话交互的频率。 你希望看到在不同语言和 IDE 中聊天的使用保持定期性并不断增加。

          **接受率** 衡量开发人员接受 Copilot 建议的频率。 这有助于了解建议是否相关且受信任。 例如，高内联建议接受率表明这些建议具有相关性和实用性。

          **代码行数 (LoC) 指标**用于衡量在编辑器中建议、添加或删除的 Copilot 行数，从而提供 Copilot 有形输出的方向性视图。 例如，“添加的行”显示实际接受并插入到编辑器中的代码量。

          **拉取请求生命周期指标**衡量 Copilot 活动与拉取请求结果和交付流程的关系。 这些指标包括拉取请求创建和合并计数、合并中位时间以及审核建议活动。 通过比较总体拉取请求活动与 Copilot 创建的拉取请求，你可以评估 AI 辅助工作流在组织或企业级别如何影响吞吐量和周期时间。

跨范围解读拉取请求的生命周期度量

拉取请求生命周期指标在组织和企业级别均可用。比较报表时，请记住以下几点：

          **去重**：企业级报告在组织间对用户去重。 组织级报告不会去重。

仅拉取请求数据：即使缺少 IDE 使用情况指标，拉取请求生命周期指标也可能出现，因为拉取请求数据派生自存储库活动。

        **属性计时**：如果存储库或组织在所有者之间传输，则拉取请求创建、评审和合并事件可能会归因于不同的实体，具体取决于每个事件发生的时间。

如何使用这些指标？

这些指标可以结合使用，以回答有关团队的 Copilot 使用情况的关键问题。

问题	使用这些指标
我的团队是否定期使用 Copilot？	每日和每周活动用户
哪些功能提供最大的价值？	每个聊天模式的请求数，代理采纳情况
开发人员信任 Copilot 的输出吗？	接受率趋势
启用举措是否奏效？	培训或沟通活动后采用和参与度的增长
Copilot 是否在影响交付速度或拉取请求吞吐量？	拉取请求合并计数和合并中位时间

查找这些信号中的模式，而不是专注于任何单个数字。例如，与接受率上升配对的稳定 DAU 表明信任和价值不断增加。

后续步骤

了解每个 Copilot 指标衡量的内容及其使用方法后，你可以浏览仪表板以查看这些指标的实际应用。

若要查看企业和组织中的采用和使用情况趋势，请参阅查看 Copilot 使用情况指标仪表板。
若要分析用户和代理如何生成代码，请参阅查看代码生成仪表板。
要以编程方式访问 Copilot 使用情况指标，请参阅用于 Copilot 使用情况指标的REST API终结点。

在本文中