GitHub 在 Copilot 用量报告中新增了按开发工具统计的模型请求和令牌用量。对于通过代码编辑器之外的工具使用 Copilot 模型的情况,管理员也能了解其使用情况,并评估工具支持与运营政策。
1. 统计范围覆盖代码编辑器之外的用量
GitHub 在 2026年10月23日的更新日志中公布了按工具汇总的 totals_by_client 数组。该数组适用于企业、组织整体及各用户的 1日报告和 28日报告。在 28日报告中,该数组位于按日期划分的 day_totals 条目内。
此前,代码编辑器之外的工具往往不发送编辑器使用记录,因此未被纳入现有的按编辑器统计。这次变更通过在服务器端统计模型请求来填补这一空白。管理员可对比各工具的请求量和令牌用量,了解哪些工具推动了 Copilot 的使用。
新数组是现有报告的新增项。原有字段保持不变,没有可报告的用量时,新数组为空。
2. 请求数、令牌与模型选择方式
每个条目包含发出请求的工具、成功的模型请求数、不同会话数,以及提示词令牌、输出令牌和每次请求的平均令牌数。OpenCode、Claude Code 等工具均在统计范围内,无法识别的工具归入 other。
请求数和令牌用量也按模型细分。在模型选择方式中,用户直接指定的情况标为 user_selected,自动选择的情况标为 auto。
Copilot Code Review 和 Copilot Cloud Agent 由产品选择模型,因此选择方式报告为 product_selected。其中,代码审查功能的模型名称显示为 unknown。
现有活动指标统计代理应用在 GitHub 上发起的任务数,而新统计关注的是与模型之间的请求和令牌。管理员除了了解任务层面的活动,还能查看各工具的模型使用规模。
3. 具备权限的用户通过 API 查询
查询前,必须将企业的 Copilot 用量指标策略设为全部启用。根据更新日志,企业所有者、账单管理员、组织所有者,以及通过自定义企业或组织角色获得 Copilot 指标查看权限的用户均可使用。
文档中的企业 1日报告请求示例如下。日期通过 day 指定,API 版本请求头保持文档示例原样。
curl -L \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
-H "X-GitHub-Api-Version: 2026-03-10" \
"https://api.github.com/enterprises/ENTERPRISE/copilot/metrics/reports/enterprise-1-day?day=DAY"响应包含 NDJSON 格式报告的下载链接,该格式每行包含一个 JSON 对象。
根据文档,企业 1日报告提供自 2025年10月10日起的数据,历史数据最多可查询至当前日期之前的 1年。
4. 扩大支持政策依据与报告处理负担
按工具统计为管理员根据实际使用情况评估支持工具和运营政策提供了更多依据。若要用于定期分析,需要从 API 响应中获取链接,再下载并处理报告文件。链接是有到期时间的签名 URL,即仅在规定时间内允许访问的链接,因此下载流程也需纳入运营。
解读时需注意,request_count 是模型调用次数,一个提示词可能触发多次调用,因此不能直接与提示词或交互次数比较。此外,工具分类依据请求携带的集成标识符,即用于区分工具的字符串,只是近似分类,并非精确确认,也不是 GitHub 验证工具身份的结果。
此次变更的核心是将偏重编辑器的 Copilot 用量统计扩展到按工具呈现的模型使用情况,从而加强支持政策的依据。
