本文是使用人工智能生成的关于技术说明和实现的示例。虽然发布的代码和步骤是基于一手资料构建的，但未经作者在实际设备上进行操作验证。根据环境和版本的不同，运行表现可能会有所差异。
GitHub 官方变更日志（Changelog）宣布，Copilot impact dashboard 已新增显示各项功能使用情况（feature engagement）的功能。本文将整理一手资料中所述的更改内容、API 规范、权限要求以及统计定义。
通过阅读本文，企业（Enterprise）和组织（Organization）的管理员可以了解如何掌握 Copilot 的部署效果，并能安全、实用理解从报告 API 或 CLI 获取的数据结构。
1. 更改的背景与目的
随着 GitHub Copilot 的不断普及，管理员需要了解“哪些功能真正融入了开发者的日常工作流”。根据一手资料，以往的仪表板和报告虽然能掌握整体使用趋势，但很难详细追踪各个功能的参与度，或者 AI adoption phase 的明细仅限于每日活跃用户数。
通过此次更新，企业管理员可以快速判断哪些体验被广泛接受，以及在哪些地方需要提供额外的支持或培训。
2. Copilot impact dashboard 的主要新功能
在 Copilot impact dashboard 中，针对主要的 Copilot 功能，将显示在 28 天统计周期内至少使用 2 天的活跃用户数。
这使得可视化持续使用的用户群体成为可能，而不仅仅是“偶然接触过一次的用户”。此外，不仅是仪表板上的数值，面向企业和组织的 28 天汇总报告 API 也可以获取相同的数据。
3. 报告 API 中数据结构的扩展
一手资料详细说明了添加至 API 和汇总报告中的具体对象与字段。
copilot_feature_engagement：在 28 天汇总报告（企业和组织级别）中，添加仪表板的活跃用户总数以及各功能的参与度数量。
totals_by_feature：将功能分类为以下类别，并显示参与度的明细。
code completion
agent edit
passive Copilot code review
active Copilot code review
Copilot 云端代理
Copilot 命令行界面
Copilot 应用
users_in_phase_28d：报告每个报告日最近 28 天滚动周期内各 AI 采用阶段的总人数（population）。现有的
total_engaged_users字段将继续仅报告当天在该阶段处于活跃状态的用户。
4. 关于功能和代码审查定义的注意事项
第一手资料中提到了有关聚合功能的定义和限制的一些重要注意事项。
报告级别：功能参与度可在企业版和组织版的 28 天汇总报告中查看，不会添加到用户级别的报告中。
重复计数：如果单个用户使用多个功能，则会在每个功能中分别计数，因此多个功能的总和可能包含重复项。
代码审查的区分:
Active Copilot code review：用户手动请求 Copilot 审查，或者应用了 Copilot 审查建议的情况。
Passive Copilot code review：在用户没有主动参与的情况下，Copilot 被自动分配用于拉取请求审查的情况。
匿名性和缺失值:
users_in_phase_28d和total_engaged_users是汇总值，并不用于识别具体用户。如果未进行测量，则显示users_in_phase_28d被省略，若进行了测量但没有用户，则会返回0。此外，如果无法计算，copilot_feature_engagement对象可能会缺失或变为null。
5. 使用所需的权限和策略
要访问此数据，您必须满足适当的权限和组织策略设置。
目标角色: Enterprise 的所有者和账单管理员（billing managers）、Organization 的所有者，以及拥有
View Copilot Metrics权限的自定义 Organization/Enterprise 角色的用户。前提策略: 必须启用 Copilot usage metrics policy（Copilot 使用指标策略）。
6. 总结
本文基于官方 Changelog，整理了 Copilot impact dashboard 以及 API 中功能参与度（feature engagement）的增加情况。
执行和验证前需确认的要点与限制
本文是对一手信息的解说，实际环境中的 API 调用和屏幕显示结果处于【实机验证前】的状态。
获取数据需要适当的角色（Enterprise 所有者、账单管理员、Organization 所有者，或
View Copilot Metrics权限）。请提前确认已启用 Copilot 使用指标策略。
请注意，用户级报告不包含功能参与度。
参考信息
本文更新历史
本文的内容已通过利用生成式 AI 的自动审查和更新流程进行了审查，并反映了必要的修改。
2026年9月26日
- 更改修正了总结部分开头不自然的句子。
