Copilot 影响面板纳入聊天与代理用量，采用率统计口径怎样变化

这次变化的核心不是“把聊天和代理用户直接改算成更高的采用率”，而是把 Copilot Chat 与 VS Code Agents window 纳入 feature engagement 的观察范围。GitHub 同时把 “Passive users” 更名为 “Chat-first users”，但 adoption phases 的判定没有改变；如果团队把新增 feature 计数直接相加，反而会把同一用户重复计算。

官方地址：https://github.com/

相关说明可从 GitHub Changelog、影响面板文档 和 usage metrics API 文档核对。

一、先看清这次到底增加了什么

更新后的 Agent adoption chart 会展示九个 Copilot 体验，新增的是 Copilot Chat 和 VS Code Agents window。企业与组织的 28 天 usage metrics 报告也会在 copilot_feature_engagement.totals_by_feature 中增加 chat 与 vscode_agent 条目。

这意味着团队的“功能使用面”变宽了，但不代表原来的用户基数、采用阶段或业务产出自动变大。分析表最好把报告周期、feature 名称和指标层级一起保存，避免只保留一个总数后无法解释变化来源。

二、把 feature engagement 和 adoption phase 分成两条线

GitHub 的说明明确区分了两个概念：Chat 和 VS Code Agents window 会被报告为 feature engagement，但不会参与 adoption phases。也就是说，团队可以观察“哪些体验被使用”，却不能据此推断用户已经进入更高的 adoption phase。

“Passive users” 改名为 “Chat-first users” 也是命名调整。这个 cohort 仍然表示用户使用了 Copilot，但在 28 天内没有至少两天使用符合条件的 feature，因此不进入 adoption phase。API 中对应的 cohort 值仍是 No Cohort，cohort size 也不会因为更名而改变。

三、按 28 天和“至少两天”规则读取新增数据

这次报告仍然围绕完整的 28 天周期。与其他体验一样，当用户在这段周期内至少两天使用某个 feature，才会被视为该 feature 的 engaged user。这里的“至少两天”不是两次点击，也不是当天产生两条消息；它是按使用日期判断。

另一个容易被忽略的边界是：一个用户可以同时出现在多个 feature 下。比如同一用户在两天使用 Chat、在另外两天使用 VS Code Agents，那么他可能同时被两个 feature 计入。Chat 的口径还包含 usage metrics 捕获到的 agent mode，因此不能把 Chat 与 agent mode 简单相加。

四、历史对比时要先切开新旧报告

GitHub 说明，变更前的报告周期仍只包含原来的七个 feature。做月度趋势或同比分析时，不能直接把新周期的九项 feature 总数与旧周期的七项总数放到同一列相减。

更稳妥的做法是把指标拆成三层：

1. 保留原有七项 feature 的可比序列，观察旧口径下的变化。
2. 把 chat 与 vscode_agent 作为新增列，并标记它们从哪个报告周期开始出现。
3. 单独保存去重后的用户数、feature engagement 用户数与 adoption phase 用户数，明确每个数的分母。

尤其不要把九项 feature 的用户数求和后命名为“活跃用户”。这会把跨 feature 的重复用户放大；如果必须合并，应使用去重后的用户维度或直接沿用 GitHub 提供的汇总指标，并在字段说明中写清口径。

五、接入前补上权限、政策和报告范围记录

影响面板和 usage metrics 并不是所有账号默认都能读取。官方文档列出的访问角色包括企业所有者、企业计费管理员、组织所有者，以及被授予相应 Copilot Metrics 权限的自定义角色；同时，Copilot usage metrics policy 需要启用。

报告范围也有边界：这次新增体验只出现在企业和组织的 28 天报告中，较早于变更的报告周期不会回填这两项 feature。团队的同步任务应保存报告起止日期、权限主体、policy 状态和字段版本，出现空值时先区分“尚未覆盖”与“确实没有使用”。

如果要把这些数据送进内部看板，建议给数据字典加上变更说明：chat 覆盖 Chat 使用与 usage metrics 捕获到的 agent mode，vscode_agent 表示 VS Code Agents window，二者属于 feature engagement，不改变 adoption phase。这样后续换报表或更换查询方式时，统计资产仍然可追溯。

新增 Chat 后，adoption phase 会自动上升吗？

不会。Chat 与 VS Code Agents window 会进入 feature engagement，但官方说明 adoption phases 不变；Chat-first users 仍然是 No Cohort。

为什么各 feature 用户数相加会超过总用户数？

因为一个用户可以同时被多个 feature 计入。feature engagement 是分 feature 的观察，不等于已经去重的用户集合。

旧的 28 天报告会补上 Chat 和 VS Code Agents 吗？

不会。变更前的报告周期只包含原来的七个 feature，历史对比需要标记新字段开始出现的周期。

Chat 和 agent mode 是两个可以直接相加的数字吗？

不建议直接相加。GitHub 说明 Chat 的 usage metrics 包含 agent mode 捕获到的使用，直接相加可能重复计算同一行为或同一用户。