Copilot 用量终于单列 VS Code Agents 窗口

GitHub 在 2026 年 9 月 11 日的 changelog 宣布：Copilot usage metrics 报告正式提供独立 VS Code Agents 窗口的用量字段。覆盖企业与组织范围的 1 天、28 天报告，既有聚合也有按用户。changelog 写明：这些指标只统计专用 Agents 窗口，和编辑器窗口里的 Agent Mode、以及通用用量汇总分开。官方文档的 REST 端点没有为此新增路径，字段写进现有报告文件。

VS Code Agents 窗口新增用量字段与易混淆旧字段对照 — 编辑绘制：新字段 daily_active_vscode_agent_users、totals_by_vscode_agent、used_vscode_agent，以及不得与 used_agent、cloud agent、CLI 字段混用。依据 GitHub changelog 2026-09-11。

平台团队原先的摩擦是：席位开了、聊天有量，却说不清有多少人在用 VS Code 里那扇独立 Agents 窗口。编辑器 Agent Mode、云端 Coding Agent、Copilot CLI 早就各有字段，窗口本身是盲区。有人把 used_agent 当成「Agents 窗口活跃」，治理会上就会把两种完全不同的入口算成一件事。本文要回答：新字段叫什么、从哪下载、缺数据时脚本会不会炸，以及人必须把哪些旧字段排除在外。

AI Coding 交流群

如果你也在用 AI 写代码，或者正在研究 Cursor、Claude Code 这些工具，欢迎加入以下交流群。群里平时会聊一些 AI 编程的实际用法、开发工作流，还有各种新工具和新玩法。

发生了什么

聚合的企业/组织报告新增两个可选字段。daily_active_vscode_agent_users：每天在 VS Code Agents 窗口活跃的独立用户数。totals_by_vscode_agent：可选的 session_count 与 total_user_messages 汇总。企业用户报告和组织用户报告则新增 used_vscode_agent（该用户是否用过该窗口），以及同一套按用户的 totals_by_vscode_agent。1 天和 28 天窗口都有。

访问范围写在 changelog：企业所有者、账单管理员、组织所有者，以及被授予 View Copilot Metrics 的自定义角色。前提是 Copilot usage metrics 策略已启用。没有 Agents 窗口数据时，这些可选字段会缺席或为 null，旧解析脚本只要能容忍未知字段和空值，就不该因此失败。

REST 仍是原路径，没有为窗口指标单开新资源。企业侧包括 enterprise-1-day、enterprise-28-day/latest、users-1-day、users-28-day/latest，以及 repos-1-day 与 user-teams-1-day；组织侧在 /orgs/{org}/copilot/metrics/reports/ 下有对应的 organization 与 users 报告。按天的接口要传 day=YYYY-MM-DD，28 天 latest 不传 day。响应体是带过期时间的 download_links 签名 URL，外加 report_day 或起止日期，不是内联整表。文档示例请求头使用 Accept: application/vnd.github+json 和 X-GitHub-Api-Version: 2026-03-10。企业令牌需要 manage_billing:copilot 或 read:enterprise，组织令牌需要 read:org；细粒度权限对应查看企业或组织 Copilot Metrics。策略必须「Enabled everywhere」。历史从 2025 年 10 月 10 日起，保留一年。发稿时 docs.github.com 的字段表尚未列出 vscode_agent 字段名，对接以 9 月 11 日 changelog 为准。

一次完整工作场景

输入是「这个月到底有多少人在用 VS Code 独立 Agents 窗口」。操作分三步。先确认 Copilot usage metrics 策略在企业内启用，否则接口会拒。再用具备 View Copilot Metrics 的令牌拉取 1 天或 28 天报告，拿到 download_links 后下载报告文件。最后在聚合行读 daily_active_vscode_agent_users 和 totals_by_vscode_agent，在用户行读 used_vscode_agent。

交付是一张与 Agent Mode 脱钩的采用表：日活窗口用户、会话数、用户消息数，以及哪些人还没用过窗口。反馈回路是拿这张表去对培训和默认布局，而不是对总聊天次数。若字段为 null，changelog 的解释是「对应窗口数据尚不可用」，不能写成「活跃为零」——零和缺失不是一回事。下载链接过期后要重新打 GET，不要把旧 URL 写进缓存当长期数据源。仓库报告里的 Copilot Coding Agent 和 Code Review 只覆盖有活动的仓库，也不能拿来填窗口日活的空。

读取 Copilot usage metrics 的权限、端点、时间窗口与文档滞后说明 — 编辑绘制：仍走原 Copilot usage metrics 报告；新字段可选；docs 字段表滞后于 changelog。依据 GitHub changelog 与 Copilot usage metrics REST 文档。

为什么这会改变治理工作流

没有这组字段时，平台只能用编辑器 Agent Mode 的 used_agent / monthly_active_agent_users 去近似「团队在用 agent」。VS Code 1.137（2026 年 9 月 9 日）已经把 Automations、Voice Mode、工单与 PR 上下文放进独立 Agents 窗口：Automations 要开 chat.automations.enabled，Voice Mode 要开 agents.voice.enabled，工单面板还要 GitHub Pull Requests 扩展和实验开关。入口和编辑器聊天不是同一条路径。继续用旧字段，会把「在编辑器里开过 Agent Mode」和「在 Agents 窗口里跑会话」算成同一采用率。窗口指标本身不要求这些预览开关打开，changelog 只统计窗口活动。

因果很直接：窗口级日活和会话数一旦可查询，默认布局、培训对象和许可证叙事就必须改口径。有人只在编辑器里用 agent，窗口日活可以很低；有人把重复任务丢进窗口，会话数会上去。changelog 还写了这些指标与云端 agent 的 used_copilot_cloud_agent、第三方 totals_by_3rd_party_agent、CLI 的 totals_by_cli、Copilot 应用的 totals_by_copilot_app 都要分开。治理会上先问「你统计的是哪一扇窗户」，再谈采用率。

限制与人必须接管的点

范围被写死：只覆盖专用 VS Code Agents 窗口，不含编辑器 Agent Mode。字段可选，缺失时不要当成零。权限不够或策略未全企业启用，接口会 403。报告是签名下载链接，有过期时间，流水线要在有效期内取文件。docs 字段表尚未同步，自动化解析应忽略未识别字段，并按 changelog 的名字读 vscode_agent。用户团队报告是用来做团队汇总的关联表，不能替代窗口字段。1 天报告和 28 天 latest 要分开存，避免把不同时间窗的日活直接比大小。

人必须接管的是口径，不是画图。若问题是「有多少工程师把工作放到独立 Agents 窗口」，读新字段。若问题是「有多少人在编辑器里用过 Agent Mode」，继续用 used_agent。把两套数字加总，会重复计算跨入口的同一人。仓库级报告里的 Copilot Coding Agent 与 Code Review 是另一组 PR 活动，也不能拿来代替窗口日活。云端 agent 请继续看 used_copilot_cloud_agent 和对应日活，不要塞进窗口表。

如何试用

用企业或组织所有者身份打开 Copilot usage metrics 策略，按 REST 文档拉取 1 天报告，确认下载文件里是否出现 daily_active_vscode_agent_users 或 used_vscode_agent。没有字段时先查策略是否全企业启用、令牌是否具备查看指标权限，再查该日是否确有人打开过 Agents 窗口。接口可能返回 200、403、404、500，部分组织或仓库路径还会 204。不要把 Voice Mode、Automations 的预览开关当成这组指标的前置条件——changelog 只把指标绑到窗口活动本身。管理员若关闭组织的 Copilot 预览功能，Voice Mode 会被禁，但那是功能开关，不是用量字段开关。