代码行 (LoC) 指标通过量化 Copilot 在补全、聊天和代理功能中建议、添加或删除的代码行数,为其输出提供方向性的衡量标准。
LoC 指标出现的位置
在以下情况下可能会遇到 LoC 指标:
- 代码生成仪表板(企业和组织级别) - 可视化基于 LoC 的用户和代理活动。 请参阅“查看代码生成仪表板”。
- 导出和 API(企业、组织和用户级别) - 公开 LoC 字段,例如
loc_suggested_to_add_sum,loc_added_sum和loc_deleted_sum。 请参阅“用于 Copilot 使用情况指标的REST API终结点”。 - “可以通过 Copilot 使用情况指标获取的数据”参考 — 列出了从 LoC 派生的所有仪表板和 API 字段。 请参阅“Copilot使用情况指标中提供的数据”。
本文介绍 LoC 的测量方式以及影响其准确性和覆盖范围的内容。 有关详细定义,请参阅上面的参考文章。
LoC 指标注意事项
LOC 指标可能因 IDE 和版本而异。 请谨记下列注意事项:
- 覆盖: 并非所有 IDE 和用户都会在升级到所需版本之前发出 LoC 遥测数据。 报表包括
last_known_ide_version和last_known_plugin_version字段,以便监控整个企业的覆盖范围。 - 稳定性: 随着 Copilot 的发展,遥测定义可能会更改。 随着准确性随时间改善,数据会发生小幅度变化。
版本要求
LoC 指标需要特定最低版本的 IDE 和 Copilot 插件才能正常运行。 较旧版本的用户不会提供 LoC 数据,这可能会导致在升级之前报告不足。
| IDE | 功能 / 特点 | 最低 IDE 版本 | 最低 副驾驶聊天 扩展版本 |
|---|---|---|---|
| Eclipse |
| 4.31 | 0.9.3.202507240902 |
`chat_panel` (询问、编辑、规划、代理)</li></ul> | 4.31 | 0.11.0.202508291001 |
| |
agent_edit
code_completion-
chat_panel(询问、编辑、规划、代理) chat_inlineagent_edit
code_completion-
chat_panel(询问、编辑、规划、代理)
chat_inlineagent_edit
code_completion
-
chat_panel(询问、编辑、规划、代理)
chat_inline
agent_edit
code_completion
-
chat_panel(询问、编辑、规划、代理)
agent_edit
代理模式如何影响 LoC 指标
与补全或聊天不同,Copilot 代理 不遵循“建议然后接受”流。 代理计划和执行多步骤任务,通常以迭代方式编辑多个文件,而无需用户明确接受。 因此,代理活动的 LoC 指标以不同的方式进行度量。
| 行为 | 其在 LoC 指标中的反映方法 |
|---|---|
| 代理代码建议 | 在可见代码块显示在聊天面板中时计为 loc_suggested_to_add_sum。 |
| 文件中的代理编辑 | 计为 loc_added_sum 功能存储桶下的 loc_deleted_sum 和 agent_edit。 这些编辑不包括在建议的指标中。 |
| 多文件操作 | 即使由一个提示触发,每个文件编辑也会导致添加和删除的总行数。 |
与代理相关的 LoC 活动的示例输出:
"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