이미지: 깃허브 코파일럿
摘要
- GitHub Copilot 使用量指标 API 新增功能，可将第三方代理应用活动按代理分类进行统计。
- 新字段 `totals_by_3rd_party_agent` 包含代理名称、稳定标识符、用户发起的交互次数及会话数。
- 此次更新保持向后兼容，若某时间段内没有可识别的代理活动，该字段将从报告中省略。
代理活动，不再是"一锅粥"
GitHub Copilot 使用量指标 API 于2026年8月7日推出新功能，可将第三方代理应用活动按代理分别报告。此前，Claude、Codex 等合作伙伴代理的活动被合并统计在单一类别下，无法区分具体是哪个代理产生了多少使用量。随着团队开始同时引入两个以上代理，这一局限逐渐成为实际问题，使得比较采用率或做出授权决策变得困难。
此次更新适用于企业、组织、企业用户、组织用户各层级的日报和28天报告。由于可以独立追踪各代理的活动，现在可以用实际数据比较新引入代理与现有代理的采用率。
新字段的结构与使用方法
响应中新增的可选数组 totals_by_3rd_party_agent 为每个被识别的代理应用包含一个条目。每个条目包含 agent_name（显示名称）、agent_id（稳定标识符）、user_initiated_interaction_count（用户发起的代理应用作业执行次数）以及 session_count（代理应用会话数）。
GitHub 明确指出，由于显示名称可能发生变化，在跨报告周期关联数据时应使用 agent_id 而非 agent_name 作为主键。session_count 仅包含在汇总的企业·组织报告中，用户级条目中不包含此字段。
需注意的数值混淆问题
有一点需要特别注意。此次新增的嵌套字段 user_initiated_interaction_count 统计的是代理应用作业的启动次数，与现有顶层字段中同名字段所代表的值完全不同。现有顶层字段统计的是来自其他遥测数据源的显式提示词数量。切勿将这两个值相加或视为相同含义。
此外，属于同一代理的多个应用会被合并为一个条目，而无法识别的代理活动则不会出现在报告中。此指标仅向企业所有者、账单管理员、组织所有者，以及被授予"查看 Copilot 指标"权限的自定义角色持有者提供。使用此功能需事先启用 Copilot 使用量指标策略。
向后兼容性与当前局限
此次更新保持向后兼容。现有字段的结构保持不变，若该时间段内没有可识别的代理应用活动，totals_by_3rd_party_agent 字段本身将从报告中省略。现有集成代码无需修改即可正常运行。
不过，由于无法识别的代理活动会被排除在统计之外，无法保证所有代理使用量都被完整捕捉。关于哪些代理会被纳入识别范围的详细标准，消息来源中并未公开。
