代码行数指标

代码行（LoC）指标通过量化 Copilot 在补全、聊天和代理功能中建议、添加或删除的代码行数，为 Copilot 的输出提供了一个方向性的衡量。

代码行指标出现位置

您可能会在以下位置看到代码行指标

• 代码生成仪表板（企业和组织层级） — 可视化基于代码行的用户和代理活动。参见 查看代码生成仪表板。
• 导出和 API（企业、组织和用户层级） — 提供诸如 loc_suggested_to_add_sum、loc_added_sum 与 loc_deleted_sum 等代码行字段。参见 Copilot 使用指标的 REST API 端点。
• “Copilot 使用指标中可用的数据”参考 — 列出所有来源于代码行的仪表板和 API 字段。参见 Copilot 使用指标中可用的数据。

本文介绍了代码行的衡量方式以及哪些因素会影响其准确性和覆盖范围。欲了解详细定义，请参阅上述参考文章。

代码行指标的注意事项

代码行指标在不同 IDE 和版本之间可能存在差异。请留意以下事项

• 覆盖率：并非所有 IDE 与用户都会在升级到所需版本后发送代码行遥测。报告中包含 last_known_ide_version 与 last_known_plugin_version 字段，帮助您监控企业内部的覆盖情况。
• 稳定性：随着 Copilot 的演进，遥测定义可能会更改。请预期数据会出现轻微波动，随着时间推移准确性会提升。

版本要求

代码行指标需要特定的最低 IDE 与 Copilot 插件版本才能生效。使用旧版本的用户不会贡献代码行数据，可能导致统计低报，直至其升级为止。

IDE	功能	最低 IDE 版本	最低 Copilot Chat 扩展版本
Eclipse	code_completion	4.31	0.9.3.202507240902
	chat_panel (Ask, Edit, Plan, Agent)	4.31	0.11.0.202508291001
	agent_edit	4.31	0.10.0.202508110512
IntelliJ/JetBrains	code_completion chat_panel (Ask, Edit, Plan, Agent) chat_inline agent_edit	2024.2.6	1.5.52-241
Visual Studio	code_completion chat_panel (Ask, Edit, Plan, Agent)	17.14.13	18.0.471.29466
	chat_inline agent_edit	17.14.14	18.0.471.29466
VS Code	code_completion	1.104.0	0.31.0
	chat_panel (Ask, Edit, Plan, Agent)	1.102.0	0.29.0
	chat_inline	1.103.2	0.30.3
	agent_edit	1.103.0	0.30.0
XCode	code_completion	14.3.1	0.40.0
	chat_panel (Ask, Edit, Plan, Agent)	15.0	0.43.0
	agent_edit	15.2	0.41.0

代理模式如何影响代码行指标

与补全或聊天不同，Copilot 代理并不遵循“建议后接受”的流程。代理会规划并执行多步骤任务，通常会在多个文件中迭代编辑，而无需用户明确接受。因此，代理活动的代码行指标采用了不同的计量方式。

行为	在代码行指标中的体现方式
代理代码建议	当可见代码块在聊天面板中显示时，计入 loc_suggested_to_add_sum。
文件中的代理编辑	计入 loc_added_sum 与 loc_deleted_sum，归属到 agent_edit 功能桶中。这些编辑不计入建议指标。
多文件操作	每个文件的编辑都会贡献到总的添加和删除行数，即使它们是由一次提示触发的。

代理相关代码行活动的示例输出

"totals_by_language_feature": [
  {
    "language": "unknown",
    "feature": "chat_panel_agent_mode",
    "code_generation_activity_count": 12,
    "code_acceptance_activity_count": 0,
    "loc_suggested_to_add_sum": 86, // code block suggestions in chat panel in agent mode
    "loc_suggested_to_delete_sum": 0,
    "loc_added_sum": 5, // only includes code block copy or apply in chat panel, not agent edits
    "loc_deleted_sum": 0
  },
  {
    "language": "unknown",
    "feature": "agent_edit",
    "code_generation_activity_count": 345,
    "code_acceptance_activity_count": 0,
    "loc_suggested_to_add_sum": 0,
    "loc_suggested_to_delete_sum": 0,
    "loc_added_sum": 2342, // agent and edit mode edits in files
    "loc_deleted_sum": 947
  }
]

对于单次代理编辑，您可能会看到如下指标：

"user_initiated_interaction_count": 0,
"code_generation_activity_count": 1,
"code_acceptance_activity_count": 0