GitHub Copilot 修复用量统计中 Agent 活动丢失问题

如果你的 Copilot 使用量指标显示 agent activity 或 agent lines of code 在下降，但 Copilot 总体使用量却在增长——我们找到了原因，修复方案正在向各 IDE 推送。近期多个 IDE 将 Copilot agent 会话迁移到了 Copilot SDK，这些会话没有标识自己来自哪个 IDE，导致使用量指标无法正确归因。大部分活动未被计入报表，部分被误算成了 Copilot CLI 活动。只有使用 Copilot SDK agent 模式的 IDE 版本受影响，早期版本的开发者仍被正常统计。

修复现已随 Visual Studio Code 推出。其他 IDE 将在后续版本中陆续收到，预计于 2026 年 11 月前完成推送。开发者更新后，其 agent 活动将重新纳入 Copilot 使用量指标仪表板和 API 统计。

开发者升级到这些版本后，agent 活动即恢复统计。如果你的开发者使用的是受影响版本，请在修复版本可用时尽快更新，因为这些活动数据无法事后恢复。如果你集中管理 IDE 版本并依赖 agent 指标，可以规划直接向这些版本推送，以便开发者尽快迁移。

各版本发布后，我们会将其加入文档中的支持 IDE 列表。

报表中的预期情况

不影响计费。此问题仅改变了 agent 活动在使用量指标中的归因方式，不影响实际扣费。

受影响的 IDE 版本上的开发者在更新前会持续存在数据缺口。在此之前，其 agent 交互和 agent 代码行数（例如 agent_edit 的 loc_added_sum 和 loc_deleted_sum）会被少计。企业、组织和个人报表均受影响，1 天报表和 28 天报表均如此。

无法补填缺失数据。受影响 IDE 版本的活动未标识来自哪个 IDE，因此无法事后归因。数据恢复将是渐进式的（随开发者迁移到新版本），而非一次性跳升。

Copilot CLI 指标可能偏高，因为部分来自其他 SDK 客户端的活动被计入了 Copilot CLI 活动。随着这些客户端更新，这一情况会逐步消除，但此前的 Copilot CLI 指标无法修正，因为那些活动无法从真实的 Copilot CLI 使用中分离出来。Copilot CLI 用户无需更新。

为什么客户端指标与其他 Copilot 数据不一致

大多数详细使用量指标（如功能、语言、模型和代码行数分布）来自各 IDE 发送的遥测数据。GitHub 还会在 Copilot 处理请求时记录服务端数据。该数据能可靠地显示哪些用户处于活跃状态，但无法看到编辑器内发生的事。当你的报表与其他 Copilot 数据不一致时，差异通常出在客户端：

• IDE 中关闭了遥测，导致没有详细活动数据发送。
• 网络代理或防火墙阻止了 Copilot 遥测端点。
• IDE 或 Copilot 扩展版本过旧，未发送指标依赖的事件。
• 客户端改变了遥测发送方式，如上文的 Copilot SDK 变更。
• 客户端不发送 Copilot 遥测，例如不支持的编辑器或第三方编辑器。

我们正在逐步减少报表对客户端遥测的依赖。使用量指标现在使用服务端数据来统计客户端遥测遗漏的活跃用户，并为其识别 IDE，我们还在持续扩展服务端数据可以填补的范围。部分细节（如代码行数和接受的建议数）只能来自编辑器，因此客户端缺口不会完全消失。保持指标完整最可靠的方式是管理好开发者的环境：

• 保持 IDE 和 Copilot 扩展为最新版本。利用设备管理工具在可行的情况下强制执行最低版本要求。
• 保持 IDE 遥测开启，并允许 Copilot 遥测端点通过代理和防火墙。
• 在报表中排查过时的客户端。在按用户划分的报表中，totals_by_ide 包含每个用户的 last_known_ide_version 和 last_known_plugin_version。

如需了解使用量指标如何结合客户端和服务端遥测，请参阅 Copilot 使用量指标文档中的「哪些使用量被纳入其中？」。