Copilot App 使用数据进入标准报表：能衡量采用，不能直接证明 ROI

GitHub 在 2026 年 7 月 28 日扩展 Copilot usage metrics API，把 Copilot App 活动纳入更多企业、组织与用户级报表。GitHub 官方公告说明，管理员不再只能看到 App 的企业或组织汇总值，而可以识别哪些用户在使用 App，并把相关代码活动按功能、模型和语言与其他 Copilot 表面一起分析。

这补上的是“使用可见性”，不是业务价值证明。报表能回答谁在用、用了多少、在哪些模型和语言中发生，但不能仅凭会话、Token 或代码行数断言团队更高效、交付质量更好或已经获得投资回报。

用户级报表开始标记谁在使用 Copilot App

更新后，企业用户和组织用户的 1 天、28 天报表会出现 used_copilot_app，表示某个用户当天是否在 Copilot App 中活跃。totals_by_copilot_app 进一步包含会话数、请求数、提示数，以及输出 Token、提示 Token 和每请求平均 Token 等拆分。

这些字段在用户没有 App 活动时会被省略，而不是固定返回零值。GitHub 指标字段文档还说明，Copilot App 没有 last_known_app_version 字段，因此管理员可以看到活动，却不能用同一报表直接判断用户运行的 App 版本。

App 活动进入功能、模型、语言与代码汇总

copilot_app 现在可以作为 feature 值出现在 totals_by_feature、totals_by_model_feature、totals_by_language_feature 和 totals_by_language_model 中。顶层代码生成、代码接受、增加行数与删除行数也会计入 App 活动，daily_active_users 会包含只在 Copilot App 中活跃的用户。

这让企业能够用相同字段比较 App、IDE、Chat、code review 与 cloud agent 等表面，但不同维度不能机械相加。一次用户提示可能产生多个代码生成事件，Agent 也可能在没有逐次“接受”动作的情况下直接编辑多个文件；请求数、生成事件数、接受数与代码行数代表不同粒度。

哪些角色可以看，哪些报表会出现

这些指标要求企业启用 Copilot usage metrics policy。GitHub 公告列出的访问者包括企业所有者、billing manager、组织所有者，以及被自定义组织或企业角色授予 View Copilot Metrics 权限的人。

GitHub REST API 文档提供企业和组织的 1 天、28 天汇总，以及用户级报表下载端点。报告以有限时效的签名 URL 提供下载；不同报表形状包含的字段不同：用户级记录包含用户身份与 used_* 指标，汇总记录包含活跃用户与整体拆分，不能假设一次 API 调用返回所有粒度。

更合理的看法是“采用漏斗”，不是单一排行榜

团队可以把这些字段组织成三层：

1. 覆盖：有多少获许可用户出现 used_copilot_app，1 天与 28 天活跃是否稳定。
2. 使用：每位用户的 session、request、prompt、模型与语言分布如何，是否只集中在少数人。
3. 交付：App 活动发生后，Pull Request 周期、缺陷、返工和人工评审结果是否变化。

前两层主要来自 GitHub 使用度量，第三层需要结合仓库、Issue、CI、质量和团队上下文。只用使用次数给个人排名，会把任务复杂度、角色差异和数据覆盖问题混进结论，也容易把度量工具变成行为压力。

相关不等于因果，代码行数只是方向信号

GitHub 的指标解读文档明确提醒，比较深度采用者与被动用户时，两组人在团队构成、项目复杂度和资历上可能本来就不同；相关差异不能单独归因于 Copilot。即使官方 adoption multiplier 显示合并数量或时间差异，也应结合团队级和 PR 生命周期数据交叉检查。

代码行数同样不是生产力、质量或价值的直接替代。更多新增与删除可能来自大规模重构，也可能意味着返工；GitHub 指标字段文档还说明，仅由服务器侧遥测识别的用户可能计入活跃总数，却不一定出现在功能、模型或语言等维度拆分中。因此这次更新最可靠的用途是让企业看清 Copilot App 的采用范围和使用结构，再设计后续验证，而不是直接把报表写成 ROI。

向后兼容减少了接入成本，仍要记录口径变化

GitHub 表示本次字段扩展向后兼容：没有 App 活动的用户和实体不会产生相关对象或拆分，既有字段形状保持不变。对于已经消费 usage metrics API 的团队，这降低了 schema 破坏风险。

但“字段兼容”不等于长期口径永远固定。团队仍应保存报表窗口、字段版本、遥测覆盖和分析脚本版本，并在首次纳入 Copilot App 后重新建立基线。只有这样，新增数据才会成为可解释的采用证据，而不是一组看似精确、实际口径漂移的数字。