Copilot 使用情况指标 API 新增 AI 采用阶段分类

GitHub 于近日宣布对其 Copilot 使用情况指标 API 进行重要更新，引入了一项名为“AI 采用阶段”（ai_adoption_phase）的新分类功能。该功能旨在帮助管理员更深入地了解开发者如何实际使用 Copilot，而不仅仅是追踪活跃用户数量。通过将每个活跃用户根据其在过去 28 天内使用 Copilot 功能的情况划分为四个阶段，管理员可以清晰地看到用户从基础代码补全到高级多代理工作流的演进路径。

新的 ai_adoption_phase 字段现已加入用户级报告，同时在企业和组织级报告中新增了 totals_by_ai_adoption_phase 数组，按阶段展示聚合指标。每个活跃用户根据过去 28 天内至少两天使用不同 Copilot 功能的记录被分配到以下四个阶段之一：

• 阶段 0（无队列）：用户未达到任何阶段的参与标准。
• 阶段 1（代码优先）：用户主要使用代码补全和/或 IDE 代理模式。
• 阶段 2（代理优先）：用户使用了单一的基于 GitHub 的代理功能，例如 Copilot 云代理、Copilot 代码审查或 Copilot CLI。
• 阶段 3（多代理）：用户使用了两个或更多基于 GitHub 的代理功能，或者使用了新的 GitHub Copilot 应用。

每个 ai_adoption_phase 值都包含一个版本字段（起始为 v1），这使得分类逻辑可以随着 Copilot 产品功能的增长而演进，而不会破坏历史数据的上下一致性。

在企业级和组织级报告中，新的 totals_by_ai_adoption_phase 数组按阶段提供了多项关键指标的平均值，包括：总活跃用户数（基于 28 天内至少 2 天的参与窗口）、用户发起交互的平均次数、代码生成与接受活动的平均值、代码行数增加和删除的平均值、拉取请求创建、合并和审查的平均值，以及中位合并时间的平均值。需要注意的是，这些聚合指标报告的是每个阶段内每位用户的平均值，而非总和。

为什么这很重要？首先，它帮助管理员讲述用户成熟度的故事，超越简单的活跃用户统计，展示开发者实际采用的 Copilot 能力。其次，可以追踪用户的阶段进展，观察用户如何从代码优先逐步过渡到代理优先和多代理工作流。最后，能够更有针对性地进行赋能，将培训、文档和推广计划聚焦于最具潜力的阶段。

重要提示：这些指标目前面向拥有 Copilot 使用情况指标访问权限的企业管理员和组织所有者开放，可通过 REST API 获取。此外，管理员可以将此功能与团队过滤器结合使用，以获得更精细的粒度。GitHub 鼓励用户在社区中分享反馈，共同探讨如何更好地利用这些数据推动 AI 工具在企业中的深度采用。