关于 Copilot 使用数据指标
Copilot 使用情况指标可帮助关键利益干系人和决策者了解其团队的采用和使用 Copilot方式。 通过跟踪企业中的使用模式，可以衡量参与度、识别增加价值的机会，以及评估 AI 辅助工作流如何影响拉取请求吞吐量和合并时间。
可通过以下方法获取指标：
- Copilot使用情况指标 API，这些 API 在企业、组织、存储库和用户级别提供详细的可导出数据。 请参阅“用于 Copilot 使用情况指标的REST API终结点”。
- Copilot使用情况指标仪表板，可直观显示企业和组织 28 天的使用情况趋势。 请参阅“查看 Copilot 使用情况指标仪表板”。
- 代码生成仪表板可细分企业和组织中的用户和代理如何生成代码。 请参阅“查看代码生成仪表板”。
- 影响 Copilot 仪表板，将用户分组到采用队列中，并将该采用连接到拉取请求输出。 请参阅“查看 Copilot 影响力仪表板”。
- Copilot 使用指标 NDJSON 导出，提供原始数据用于自定义商业智能工具或长期存储。
包括哪些用法？
Copilot 使用情况指标派生自多个 Copilot 图面（包括 IDE） Copilot CLI和活动 agent apps 之间的遥测数据。 大多数指标来自客户端 IDE 遥测， 最终用户需要在其 IDE 中启用遥测 ，以获取这些指标中最丰富的数据。
使用指标 API 和 NDJSON 导出中提供了单个 agent app 指标。 它们在使用情况指标仪表板中不可用。 活动已 agent apps 包含在每日、每周和每月活动用户总数中，通过服务器端遥测数据。 各个指标提供详细的细目，但不会更改这些总计。
此外， Copilot 使用情况指标还包含 服务器端遥测 数据，以识别客户端遥测可能错过的活动用户。 网络条件、代理配置和客户端设置可能会阻止客户端遥测数据到达 GitHub，因此服务器端信号可确保这些用户仍显示在报表中。
通过服务器端遥测显示的用户将完全计入活动用户总数（例如每日活跃用户）。 daily_active_users 如果可用，它们也可能出现在 totals_by_ide （包括每个用户报告中最近检测到的 IDE 和 Copilot 扩展版本）。 但是，其他维度细分（例如 totals_by_feature 代码行指标和代码行指标）保持为空，直到更丰富的遥测数据可供使用。 对于已通过客户端遥测采集到的用户，顶层汇总和细分数据保持不变。
数据不包括其他Copilot界面的活动，例如：
- Copilot Chat 上 GitHub.com
- GitHub Mobile
使用情况指标报表中不包括 Copilot 许可证和席位管理数据。 若要查看或管理许可证分配，请使用 Copilot 用户管理 API，这是许可证和席位信息的真相来源。 请参阅“用于Copilot用户管理的 REST API 终结点”。
排查缺少使用情况数据的问题
详细细分取决于 IDE 中的客户端遥测数据或 Copilot CLI. 此遥测数据提供有关功能、语言、模型、接受的建议和代码行的数据。 服务器端遥测可以显示用户处于活动状态，但它无法观察编辑器中发生的情况。
如果缺少客户端遥测数据，即使服务器端数据显示活动，报表也可能包含较少的数字或空细分。 常见原因包括：
| Cause | 对报表的影响 | 可检查的内容 |
|---|---|---|
遥测在 IDE 中处于关闭状态，例如在 IDE 中VS Code启用telemetry.telemetry此设置。 | IDE 不发送详细活动。 用户仍可以通过服务器端遥测数据视为活动状态，但功能、语言和代码细分行为空。 | 确认是否为开发人员启用了 IDE 遥测。 |
| 网络代理、防火墙或 VPN 会阻止 Copilot 遥测终结点。 | 与关闭遥测时相同。 | |
| Copilot允许客户端遥测终结点。 请参阅“Copilot 允许列表参考”。 | ||
| 客户端不是受支持的 IDE，也不会发送 Copilot 遥测数据。 | 用户可能通过服务器端遥测数据被计为活动，但客户端不会显示在或详细细分中 totals_by_ide 。 | 使用受支持的 IDE 获取完整的指标。 |
如果在检查上述原因后仍然存在差距，请联系 通过网站管理员GitHub支持门户 并包括受影响的用户、IDE、版本和日期。
为何 Copilot 使用指标可能因 API 资源而异
以下 API 资源公开 Copilot了相关的数据，但它们不可互换，不应直接进行比较。 每个 API 资源专为特定用例和数据模型设计，预计总计或覆盖范围的差异。 使用此表了解最适合你的报告需求的 API 资源。
注意
强烈建议使用 Copilot 使用情况指标 API 进行新的集成和分析，因为它提供了最完整和面向未来的使用情况视图 Copilot 。
| API 资源 | Scope | 关键功能 |
|---|---|---|
| 用于 Copilot 使用情况指标的REST API终结点 | 具有存储库和用户级报表的高级企业和组织范围的事件遥测 | 跨完成、聊天和代理模式提供统一的遥测。 包括所有 IDE 模式、语言和模型的使用情况和代码行指标。 支持按功能、IDE、语言、模型和用户以及存储库级拉取请求活动报告的详细细分，并且是正在积极开发和维护的主要 API 资源。 |
| 用于Copilot用户管理的 REST API 终结点 | 许可证和席位分配 | 列出组织或企业分配 Copilot 的席位，包括许可证状态、用户关联和 last_activity_at。 此 API 资源是许可证和席位信息的真相来源。 |
如何跨组织特性化指标？
注意
可以授予 仅限组织的可见性 至 Copilot 使用情况指标，而无需提供企业级访问权限。
为此，可以创建包含“查看组织 Copilot 指标”权限的组织自定义角色，并将该角色分配给需要了解单个组织的指标的用户。 请参阅“自定义组织角色的权限”。
组织级别的 Copilot 使用情况指标基于组织成员身份，而不是基于各个操作的发生位置。 要出现在企业的指标中，用户必须在该企业中分配一个活跃的 Copilot 席位（这可以是在属于该企业的任何组织中）。 因此，单个用户的使用情况可能会出现在多个组织仪表板中，而同一用户仅计算在企业级总计中的一次。 组织级别的分析旨在了解组织中的采用和使用情况，并且不会直接与企业级总计进行比较。
从 2025 年 12 月 12 日起，组织级 Copilot 分析可用。 这是提供组织级报告的第一个日期。
用户拥有企业中的席位后，其使用情况将归咎于 他们所属的每个组织，而不考虑分配席位的位置。
这意味着：
- 如果在专用的“shell”组织中分配许可证用于企业内部的管理目的，则用户仍显示在他们所属的企业中所有其他组织的指标中。
- 如果用户在Copilot也拥有一个席位，只要他们在企业中至少有一个**** 席位，他们的活动仍包含在企业的组织级别指标中。
简言之：用户必须在企业中的某个位置获得许可才能在其指标中显示。 一旦满足条件，这些指标就会反映员工的工作地点（他们所属的组织），而不是哪个组织提供Copilot席位或活动发起的位置。
支持的 IDE
若要将最终用户包括在 Copilot 使用指标中，必须使用以下 IDE 和 Copilot Chat 扩展版本之一。
旧版本可能不会发送使用指标依赖的所有事件，也可能将活动归因于错误的 IDE。 使 IDE 和 Copilot 扩展保持最新状态，并尽可能使用设备管理工具强制实施这些最低版本。
| IDE | 最低 IDE 版本 | 最低 Copilot Chat 扩展版本 |
|---|---|---|
| Eclipse | 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.107.1 | 0.35.3 |
| Xcode | 14.3.1 | 0.40.0 |
在每用户报表中，每个 totals_by_ide 条目包括 last_known_ide_version 和 last_known_plugin_version。 使用这些字段标识需要更新的开发人员。 请参阅“Copilot使用情况指标中提供的数据”。
基于 SDK 的代理活动的版本要求
某些 IDE 通过 Copilot SDK 运行Copilot代理会话。 这些 IDE 的某些版本在发送代理活动时不会自行标识，因此活动被排除在使用情况指标外。 这会导致代理交互和代理代码行被低估。 若要包含此活动，最终用户必须使用以下版本之一或更高版本：
| IDE | 基于 SDK 的代理活动的最低版本 | 受影响版本 |
|---|---|---|
| VS Code | 1.139.0 | 使用代理窗口时，1.134 到 1.138 |
| Copilot JetBrains IDE 插件 | 1.20.0 | 1.15.0 到 1.19.x |
| Visual Studio | 18.12 | 预览体验成员（预览版）在 18.12 之前生成 |
如果要规划 IDE 更新，请将开发人员直接移动到这些版本或更高版本。 正式版版本 Visual Studio 不受影响。
对于 JetBrains IDE，请避免 Copilot 插件版本 1.15.0 到 1.19.x。
Eclipse 和 Xcode 不会通过 Copilot SDK 运行代理会话，因此它们不会受到影响。
无法回填缺失的数据，因为受影响版本中的活动无法标识它来自哪个 IDE。
其中一些活动被计为 Copilot CLI 活动，这可能会增加 Copilot CLI 指标。 当开发人员更新受影响的 IDE 时，这可以清除，但无法更正早期 Copilot CLI 指标。 Copilot CLI 用户不需要更新。
此问题仅影响活动在使用情况指标中的属性。 计费不受影响。
数据新鲜度
仪表板和 API 报表中的数据会定期更新。
预计数据将在 两天内可用。 这意味着在给定日期的数据处理完毕后，能够在该日期结束后的完整两个UTC天内使用。
仍在处理的遥测数据可能会使最近几天看起来不完整。 等待处理窗口关闭，然后调查差距。
数据度量值是什么？
Copilot 使用情况指标可分为几个主要类别：采用、参与、接受率、代码行（LoC）和拉取请求生命周期指标。
使用情况 用于衡量有多少授权开发人员正在积极使用 Copilot。 例如，每日活动用户（DAU）告诉你给定一天与 Copilot 多少个唯一用户交互。 理想情况下，在推出期间，这些指标中会出现一致的上升趋势。 Copilot code review 的采用情况是单独跟踪的，具有独特的主动和被动用户计数。 活跃用户手动请求评审或应用建议，而被动用户则已自动分配来评审其拉取请求。 当用户在同一时间段内同时发出这两个信号时，它们仅算作活动状态。 为了更深入地了解采用深度，用户也会分组到采用队列中。 请参阅 了解采用队列。
参与度量值描述了开发人员在采用Copilot后如何深入使用该工具。 关键参与指标不仅显示使用频率，还显示了功能之间的广度。 例如，每个活动用户的平均聊天请求度量用户打开和交互 Copilot Chat的频率。 你希望看到在不同语言和 IDE 中聊天的使用保持定期性并不断增加。
接受率 衡量开发人员接受 Copilot建议的频率。 这有助于了解建议是否相关且受信任。 例如，高内联建议接受率表明这些建议具有相关性和实用性。
代码行（LoC）指标 用于度量编辑器中建议、添加或删除的代码行数，从而为Copilot 的有形产出提供方向性视图。 例如，“添加的行”显示实际接受并插入到编辑器中的代码量。
拉取请求生命周期指标 衡量活动与 Copilot 拉取请求结果和传递流的关系。 这些指标包括拉取请求创建和合并计数、合并的中位时间以及评审建议活动。 通过将总体拉取请求活动与创建的 Copilot拉取请求进行比较，可以评估 AI 辅助工作流如何影响组织或企业级的吞吐量和周期时间。
模型细分可以包括开发人员未直接选择的模型。 例如， Copilot 可以将其他模型用于自动模型选择或后台任务。
了解采用队列
与其将采用作为单个活动用户计数来衡量采用率， Copilot 不如根据用户参与的方式将用户分组到 采用队列 中，而不仅仅是他们是否参与 Copilot进来。 平面活动用户计数将处理偶尔接受代码完成的人与全天协调多个代理驱动工作流的人员相同。 队列将这两个用户分开，因此你可以看到组织的使用情况是否随时间推移而加深，而不是在初始试用版中保持稳定。
用户分为以下阶段：
| 阶段 | 它所代表的意义 |
|---|---|
| 被动用户 | 在此期间，用户未达到某个阶段的预订阈值。 被动用户可能仍在定期使用 Copilot ，例如，在不应用任何代码编辑的情况下提出问题 Copilot Chat 或代理模式。 在 API 中，此阶段标记为 No Cohort。 |
| 阶段 1：代码优先 | 参与代码完成和/或代理编辑的用户，其中 Copilot 直接将更改写入 IDE 中的文件。 使用 Copilot Chat 或代理模式而不生成代码完成或代理编辑活动本身不符合条件。 |
| 阶段 2：代理优先 | 用户与单个 GitHub代理图面（例如 Copilot cloud agent， Copilot code review或 Copilot CLI） 主动参与 Copilot code review 和自动分配它以查看拉取请求计数为同一图面。 |
| 阶段 3：多代理 | 与两个或更多 GitHub个基于代理图面的用户，或与 GitHub Copilot app. |
若要分组到阶段，用户必须使用与该阶段关联的图面，在尾随的 28 天时段外至少满足两个活动天数的参与阈值。 用户只需在较高阶段的图面上需要两个符合条件的天数才能进入该阶段。 单独使用代理可以限定用户，而无需单独的纯完成天数。
阶段分配每天从尾随的 28 天窗口重新计算，因此用户阶段可以在该窗口内的活动发生更改时从一天转移到下一天。 这是预期行为，而不是数据错误。
影响仪表板按当前阶段对在尾随的 28 天时段内处于活动状态的每个用户进行计数，并按其当前阶段对每个用户进行分组。 阶段分类规则相同，但仪表板填充范围比 totals_by_ai_adoption_phase.total_engaged_users API 和 NDJSON 报表中的字段更广，这将统计在特定日期处于活动状态的用户。
未满足任何阶段阈值的用户将分组到 被动用户中，该用户不是非活动度量值，而是表示用户参与尚未达到可靠地分类其采用深度所需的级别。 例如，在尾随的 28 天窗口中，只有不到两个活动天数的用户，或者仅轻量地使用像上Copilot Chat这样的GitHub.com图面的用户显示为被动用户。
由于阶段分配基于 用户参与的图面，而不仅仅是他们采取的操作数，具有高完成量但没有代理使用情况的用户保留在阶段 1 中，而跨代理图面使用较轻但更广泛的用户将进入阶段 2 或阶段 3。
有关基础架构字段，请参阅 AI 采用阶段字段。
影响仪表板的 采用乘数 将参与用户合并的拉取请求的平均量除以被动用户合并的拉取请求量（即阶段 1、2 或 3 中的拉取请求量）。
这显示了更深入采用的相对影响，与每个阶段的用户数量无关。 这是一个度量值，用于了解成为更参与的用户可以提供的潜在提升。
例如，如果参与队列中的用户平均 20 个拉取请求/用户/月和被动队列平均为 10，则公式为 20 / 10 = 2 倍乘数。
了解行业比较
影响仪表板的 “行业比较 ”小组件比较了企业或不是企业拥有的组织的两个度量值，以及参与同行的聚合结果：
- 代理采用：企业或组织中属于代理优先用户或多代理用户的活跃用户的百分比。
- 利用：代理用户的拉取请求合并率与非代理用户（每月每个用户）的比率。 例如，杠杆分数为 4.1x 意味着代理用户合并拉取请求的速率是报告期间非代理用户的速率的 4.1 倍。
每个比较涵盖小组件中显示的 28 天报告期。 在选择加入时，对等队列使用所选的公司规模和行业。 公司规模选项为 1-999、1,000–4,999 和 5,000 多名员工，有 10 个行业选择。 这些值是自报告且未验证的。 你可以与所选行业或所有行业的同行进行比较。
当有足够的符合条件的对等方可用时，每个卡片会显示：
- 分数在队列中排名的位置。
- 分数与对等中值之间的差异。
- 分数与最高分位之间的差异。
顶分位比较需要比中值比较更大的对等队列，因此当顶十分位数不是时，中值可用。 很少活跃用户的企业和组织可以查看比较，但不会计入任何对等队列。
该图表根据对等分数的分布绘制企业分数，并标记对等中位数和最高分位。 如果队列不包含足够的符合条件的对等方，则某些标记可能不可用。
对于所选行业内的比较，仪表板将按此顺序扩展对等队列，直到有足够的符合条件的对等方可用：
- 参与同一公司规模和行业的同行。
- 参与同一个公司规模的同行，在所有行业。
比较始终使用具有相同公司规模的对等方。 该小组件显示使用了哪个对等队列，因此你可以判断何时将比较扩展到所选行业之外。
对于 GitHub Enterprise Cloud 数据驻留，对等队列仅包括在同一数据驻留区域中托管的参与者。 仪表板在该区域内应用相同的队列扩展，并且不会跨区域合并数据。
仪表板不会仅基于行业使用队列。 跨所有行业的比较使用参与的对等方，而不是所有用户 GitHub 或企业。
参与由Copilot指标行业比较策略控制，默认情况下处于禁用状态。 企业和组织不属于企业，可以参与其中。 企业拥有的组织通过企业参与。 用于分配 Copilot Business 许可证的企业无法参与，因为无法为其计算杠杆。 启用策略会为对等队列提供聚合指标，并允许查看比较。 有关详细信息，请参阅 查看 Copilot 影响力仪表板。
排名仅在足够的企业和组织选择组成对等队列之后才会出现。 如果仪表板应用回退队列后没有足够的符合条件的对等方，则不会显示排名。 当无法计算自己的分数时，排名也不可用，例如，在报告期间没有活动用户或没有非代理用户提供用于利用的基线。
行业比较如何保护数据
- 仅选择加入。 在企业所有者或企业不拥有的组织所有者之前，不会造成任何贡献，因此支持Copilot指标行业比较策略。 企业仅用于分配 Copilot Business 许可证永远不会参与。
- 仅贡献两个摘要分数。 每个参与者贡献其代理采用，并在 28 天报告期间利用分数。 没有提供用户名、用户级活动、代码、存储库内容或拉取请求内容。
- 结果聚合。 分数与其他参与者的分数相结合，以计算队列统计信息，例如中位数和最高十分位数。 其他参与者看不到企业或组织名称、企业和组织参与的名称，或者队列中有多少参与者。
- 队列统计信息未链接到参与者。 计算队列统计信息时，参与者的分数合并为仅按日期、公司规模和行业存储的结果。 这些结果不包含企业、组织或用户标识符，因此无法将其链接回特定参与者。
- 排名在 GitHub服务器上的计算。 你自己的分数随其余使用情况指标一起 Copilot 存储。 若要显示排名， GitHub 请将分数与同一报告周期的队列统计信息进行比较。 其他参与者的分数永远不会单独查找或比较。
- 小队列被抑制。 仅当队列包含足够的参与者和用户时，才会显示队列的统计信息。 很少活跃用户的企业和组织不计入任何队列，因此少数开发人员无法塑造结果。
- 公司规模和行业保持私密性。 你选择的公司规模和行业仅用于将参与者分组到队列中。 它们不会向其他参与者显示，也不会由 GitHub其他参与者进行验证。
- 尊重数据驻留。 对于 GitHub Enterprise Cloud 数据驻留，数据永远不会跨数据驻留区域合并。
- 结果保留在仪表板中。 下载、NDJSON 导出或 Copilot 使用情况指标 API 中不包括行业比较。
- 聚合结果是生存期较短的。 队列统计信息每天重新计算，并在 30 天后删除。 如果选择退出，仪表板将立即停止显示比较，并且从下一次每日更新开始，数据将从队列中排除。 每个每日计算都使用当前的选择加入设置，因此，如果在选择退出后重新计算早期结果，则不会重新添加数据。
估计潜在投资回报
影响仪表板的 “潜在投资回报”部分提供了阶段 0-1 被动用户和代码优先用户与****阶段 2-3 代理第一用户之间的成本和拉取请求输出的比较。
对于每个阶段组，仪表板根据实际AI credits消耗显示每个开发人员的Copilot每月成本，并将该成本作为开发人员补偿的百分比显示。 它还显示每个开发人员每月的平均拉取请求。
可以选择补偿带来更新依赖于开发人员补偿的估计值。 这些数字是估计的，而不是确切的财务结果，因此请将其与采用乘数的代码交付和合并时间比较一起解释。 投资回报估计仅在仪表板中提供，并且不包括在使用情况指标 API 或 NDJSON 导出中 Copilot 。
跨范围解读拉取请求的生命周期度量
拉取请求生命周期指标在组织和企业级均可用。 比较报表时，请记住以下几点：
- 去重：企业级报表在多个组织之间去重用户。 组织级报告不。
- 仅拉取请求数据：即使缺少 IDE 使用情况指标，拉取请求生命周期指标也可能出现，因为拉取请求数据派生自存储库活动。
- 属性计时：如果存储库或组织在所有者之间传输，则拉取请求创建、评审和合并事件可能会归因于不同的实体，具体取决于每个事件发生的时间。
如何使用这些指标？
这些指标可以一起使用来回答有关团队使用 Copilot的关键问题。
| Question | 使用这些指标 |
|---|---|
| 我的团队是否经常使用 Copilot ？ | 每日和每周活动用户 |
| 哪些功能提供最大的价值？ | 每个聊天模式的请求数，代理采纳情况 |
| 开发人员是否信任 Copilot输出？ | 接受率趋势 |
| 启用举措是否奏效？ | 培训或沟通活动后采用和参与度的增长 |
| 是否 Copilot 影响传递速度或拉取请求吞吐量？ | 拉取请求合并计数和合并中值时间 |
| 正在如何被Copilot code review采用？ | 主动评审与被动评审代码用户数量 |
| 我的组织的采用是否随着时间推移而加深？ | 采用队列分布和参与趋势 |
| 如何从仪表板中处理见解？ | 请参阅“解释 GitHub Copilot 的使用情况和采用指标” |
查找这些信号中的模式，而不是专注于任何单个数字。 例如，与接受率上升配对的稳定 DAU 表明信任和价值不断增加。
更详细地分析指标
当你需要解释或验证你的发现时，请使用参考文章来帮助你了解所有可用的数据、它如何跨图面进行比较以及如何解释这些数据。 请参阅“GitHub Copilot 使用情况指标”。