代码行指标

注意

GitHub Copilot 使用情况指标目前处于使用数据保护的公共预览版阶段，可能会发生更改。

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

LoC 指标出现的位置

在以下情况下可能会遇到 LoC 指标：

        **代码生成仪表板 （企业级）** - 可视化基于 LoC 的用户和代理活动。 请参阅“[AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/view-code-generation)”。

        **导出和 API（企业、组织和用户级别）** - 公开 LoC 字段，例如 `loc_suggested_to_add_sum`， `loc_added_sum`和 `loc_deleted_sum`。 请参阅“[AUTOTITLE](/rest/copilot/copilot-usage-metrics)”。

          **“可以通过 Copilot 使用情况指标获取的数据”参考** — 列出了从 LoC 派生的所有仪表板和 API 字段。 请参阅“[AUTOTITLE](/copilot/reference/copilot-usage-metrics/copilot-usage-metrics)”。

本文介绍 LoC 的测量方式以及影响其准确性和覆盖范围的内容。有关详细定义，请参阅上面的参考文章。

LoC 指标注意事项

LOC 指标可能因 IDE 和版本而异。请谨记下列注意事项：

        **覆盖：** 并非所有 IDE 和用户都会在升级到所需版本之前发出 LoC 遥测数据。 报表包括 `last_known_ide_version` 和 `last_known_plugin_version` 字段，以便监控整个企业的覆盖范围。

        **稳定性：** 随着 Copilot 的发展，遥测定义可能会更改。 随着准确性随时间改善，数据会发生小幅度变化。

版本要求

LoC 指标需要特定最低版本的 IDE 和 Copilot 插件才能正常运行。较旧版本的用户不会提供 LoC 数据，这可能会导致在升级之前报告不足。

IDE	功能 / 特点	最低 IDE 版本	最低 Copilot 对话助手扩展版本
Eclipse	`code_completion`	4.31	0.9.3.202507240902

          `chat_panel` （询问、编辑、代理）</li></ul> | 4.31 | 0.11.0.202508291001 |

| |

agent_edit

| 4.31 | 0.10.0.202508110512 | | IntelliJ/JetBrains |

code_completion
chat_panel （询问、编辑、代理）
chat_inline
agent_edit

| 2024.2.6 | 1.5.52-241 | | Visual Studio |

code_completion
chat_panel （询问、编辑、代理）

| 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 （询问、编辑、代理）

| 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 （询问、编辑、代理）

| 15.0 | 0.43.0 | | |

agent_edit

| 15.2 | 0.41.0 |

代理模式如何影响 LoC 指标

与补全或聊天不同，Copilot 代理不遵循“建议然后接受”流。代理计划和执行多步骤任务，通常以迭代方式编辑多个文件，而无需用户明确接受。因此，代理活动的 LoC 指标以不同的方式进行度量。

行为	其在 LoC 指标中的反映方法
代理代码建议	在可见代码块显示在聊天面板中时计为 `loc_suggested_to_add_sum`。
文件中的代理编辑	计为 `agent_edit` 功能存储桶下的 `loc_added_sum` 和 `loc_deleted_sum`。这些编辑不包括在建议的指标中。
多文件操作	即使由一个提示触发，每个文件编辑也会导致添加和删除的总行数。

与代理相关的 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

谁可以使用此功能？

本文内容

LoC 指标出现的位置

LoC 指标注意事项

版本要求

代理模式如何影响 LoC 指标