Copilot 使用指标仪表板和 API 使用一致的字段集显示和导出数据。 此参考列出了所有可用的指标，并介绍了如何在仪表板视觉对象和 NDJSON 或 API 导出中解释其值。
- Copilot 使用情况指标仪表板在企业和组织级别可用。
- Copilot 使用情况指标 API 支持企业、组织和用户级记录。
有关如何读取和解释这些指标的指导，请参阅 AUTOTITLE。
Copilot 使用情况仪表板指标
这些指标直接显示在 Copilot 使用仪表板中。 这些图表 不包括 Copilot CLI 使用情况。
| 指标 | Description |
|---|---|
| 代理采用 | Copilot 在当前日历月尝试使用代理的活跃授权用户的百分比。 |
| 每个活动用户的平均聊天请求数 | 每个活动用户的平均聊天请求数。 |
| 代码自动完成功能（建议/已接受） | 显示和接受的内联代码建议的总数。 |
| 代码完成验收率 | 用户接受的建议百分比。 |
| 每日活动用户 | 在特定日期使用 Copilot 的唯一用户数量。 |
| 每周活动用户 | 在七天时间段内使用 Copilot 的唯一用户数。 |
| 活动用户总数 | 在当前日历月中处于活动状态的许可用户。 |
| 语言的使用 | 使用 Copilot 的编程语言分布情况。 |
| 每天的语言使用情况 | 所用语言的每日使用情况细分。 |
| 模型使用 | 用于聊天的 AI 模型的分布。 |
| 每天的模型使用情况 | 聊天模型使用情况的每日细分。 |
| 每个聊天模式的模型使用情况 | Copilot 功能（询问、编辑、计划、代理）的模型使用情况。 |
| 每个语言的模型用法 | 按模型细分的语言分布。 |
| 最常用的聊天模型 | 过去 28 天内最常用的聊天模型。 |
| 每个聊天模式的请求数 | 按模式（询问、编辑、计划、代理）的聊天请求数。 |
代码生成仪表板指标
这些指标显示在代码生成仪表板中，并提供如何跨用户发起的活动和代理发起的活动生成代码的细分。 所有值都派生自 IDE 中添加或删除的代码行（LoC）。
| 指标 | Description |
|---|---|
| 使用 AI 修改代码行 | 在过去 28 天内在所有模式下添加和删除的代码行总数。 |
| 代理贡献 | 在过去 28 天内，代理添加和删除的代码行（包括编辑、代理和自定义模式）的百分比。 |
| 代理删除的平均行数 | 代理系统在当前日历月内代表活跃用户自动删除的平均行数。 |
| 每天添加和删除行的总数 | 每天在所有模式下添加到代码库和从代码库中删除的行总数。 |
| 用户启动的代码更改 | 用户通过代码补全和聊天面板操作（插入、复制或应用）建议或手动添加的行。 |
| 代理启动的代码更改 | 代理代表用户在编辑、代理和自定义模式下自动添加或从代码库中删除的代码行。 |
| 用户每个模型发起的代码更改 | 用户自主创建的代码行，按 IDE 中使用的模型分组。 |
| 由代理发起的每个模型的代码更改 | 由代理发起的代码行，根据执行代理操作的模型进行分组。 |
| 每种语言的用户发起的代码更改 | 用户启动的代码行，按编程语言分组。 |
| 代理启动的代码更改（每种语言） | 代理启动的代码行，按编程语言分组。 |
API 和导出字段
这些字段会出现在导出的 NDJSON 报告中以及 Copilot 使用指标 API 中。 它们根据指标在企业、组织或用户范围内提供每日记录。
| 字段 | Description |
|---|---|
agent_edit | 捕获 Copilot（在代理和编辑模式下）直接在 IDE 的文件中写入更改时添加和删除的代码行。 不包含在基于建议的指标中，并且可能不会填充建议样式字段（例如）。 也会统计来自自定义代理的编辑操作。 |
report_start_day / report_end_day | 28 天报告周期的开始日期和结束日期。 |
day | 此记录表示的日历日。 |
enterprise_id | 企业的唯一 ID。 |
| （仅限 API） | 组织的唯一 ID。 |
user_id / user_login | 用户的唯一标识符和 GitHub 用户名。 |
user_initiated_interaction_count | 发送给 Copilot 的显式提示次数。 仅对主动发送到模型的消息或提示进行计数。 不包括打开聊天面板、切换模式（例如询问、编辑、计划或代理）、使用键盘快捷键打开内嵌 UI 或进行配置更改。 |
chat_panel_agent_mode | 捕获在聊天面板中选择代理模式时用户发起的交互。 |
chat_panel_ask_mode | 在选择“询问”模式时，捕获用户在聊天面板中发起的交互。 |
chat_panel_custom_mode | 捕获在聊天面板中选择自定义代理时用户发起的交互。 |
chat_panel_edit_mode | 捕获在聊天面板中选择编辑模式时用户发起的交互。 |
chat_panel_unknown_mode | 捕获聊天面板中模式未知时用户发起的交互。 |
code_generation_activity_count | 生成的不同 Copilot 输出事件的数量。 包括： 所有生成的内容，包括注释和文档字符串。 多个块： 单个用户提示中的每个不同代码块都计为单独的生成。 注意： 此指标不直接可比 ，因为一个提示可以生成多代。 |
code_acceptance_activity_count | 用户接受的建议或代码块数。 计数内容：所有内置的接受操作，如“应用到文件”“插入到光标”“插入到终端”以及使用复制按钮。 不计数： 操作系统的手动剪贴板操作（例如 CtrlC）。 粒度： 无论初始提示生成多少个代码块，每个接受操作都会使计数递增一次。 |
loc_suggested_to_add_sum | Copilot 建议添加的代码行数（完成、内联聊天、聊天面板等；不包括代理编辑）。 |
loc_suggested_to_delete_sum | Copilot 建议删除的代码行（未来支持）。 |
loc_added_sum | 实际添加到编辑器的代码行（已接受的补全、应用的代码块、智能体/编辑模式）。 |
loc_deleted_sum | 从编辑器中删除的代码行（当前来自代理修改）。 |
totals_by_ide | IDE使用的指标分解。 |
totals_by_feature | 按 Copilot 功能（如内联聊天、聊天面板）划分的指标细分。 |
totals_by_language_feature | 结合语言和功能维度的细分方法。 |
totals_by_model_feature / totals_by_language_model | 聊天活动的模型特定细分（不包括补全）。 |
last_known_ide_version / last_known_plugin_version | 检测到的每个用户最近使用的 IDE 和 Copilot对话 扩展版本。 |
daily_active_cli_users | 企业中在给定日期通过 CLI 使用 Copilot 的唯一用户的数量。 此字段 独立于 IDE 活动用户计数， 并且不包括 在基于 IDE 的活动用户定义中。 对于当天未使用 CLI 的企业，省略该作。 |
totals_by_cli | 给定日期中企业的命令行界面 (CLI) 特定指标的细分。 与 IDE 指标无关 - CLI 使用不会在其他字段（如 或 ）中体现。 对于当天未使用 CLI 的企业，省略该作。 请参阅下面的 Copilot CLI metrics 字段 。 |
used_cli | 捕获用户当天是否使用 Copilot CLI。 |
used_agent | 捕获用户当天是否使用了 IDE 代理模式。 |
used_chat | 捕获用户当天是否使用了 IDE 聊天。 |
Copilot CLI 指标字段（仅限 API）
当存在 CLI 使用情况时，该 对象包含以下嵌套字段。 这些指标目前仅在企业级和用户级报表中可用。
| 字段 | Description |
|---|---|
totals_by_cli.session_count | 当天启动的不同 CLI 会话数。 |
totals_by_cli.request_count | 当天通过 CLI 向 Copilot 发出的请求总数，包括用户启动的提示和自动代理后续调用。 |
totals_by_cli.token_usage.output_tokens_sum | 这一天在所有 CLI 请求中生成的输出令牌总数。 |
totals_by_cli.token_usage.prompt_tokens_sum | 这一天在所有 CLI 请求中发送的提示令牌总数。 |
totals_by_cli.token_usage.avg_tokens_per_request | 每个 CLI 请求的平均输出和提示令牌数（计算为 ）。 |
totals_by_cli.prompt_count | 在会话中执行的用户提示、命令或查询总数。 |
totals_by_cli.last_known_cli_version | 当天检测到的用户最近 Copilot CLI 版本。 |
拉取请求活动字段（API 专用）
重要
由于用户重复数据删除和归因时间差异，组织和企业级报告可能会显示不同的总计。 有关跨范围拉取请求指标解释指南，请参阅 AUTOTITLE。
这些字段捕获企业或组织范围内的每日拉取请求创建、审查、合并和建议活动，包括 Copilot 执行的活动。
| 字段 | Description |
|---|---|
pull_requests.total_created | 在此特定日期创建的拉取请求总数。 创建是一次性事件。 每一条拉取请求仅在其创建当日才会被计入统计。 |
pull_requests.total_reviewed | 在此特定日期查看的拉取请求总数。 如果同一个拉取请求在多天内收到评审，那么它可能会被计入多个日期的统计中。 在一天内，即使发生多个评审操作，每个拉取请求也仅计数一次。 |
pull_requests.total_merged | 在此特定日期合并的拉取请求总数。 合并是一次性事件。 每个拉取请求仅在合并当天计数。 |
pull_requests.median_minutes_to_merge | 特定日期合并的拉取请求从创建到合并的中位时间（以分钟为单位）。 使用中位数是为了减少异常长时间运行的拉取请求的异常值影响。 |
pull_requests.total_suggestions | 特定日期生成的拉取请求审查建议总数，与作者无关。 |
pull_requests.total_applied_suggestions | 特定日期应用的拉取请求审查建议总数，与作者无关。 |
pull_requests.total_created_by_copilot | 特定日期由 Copilot 创建的拉取请求数。 |
pull_requests.total_reviewed_by_copilot | Copilot 在此特定日期审阅的拉取请求数。 如果 Copilot 在多天内对拉取请求进行评审，则拉取请求可能会被计算在多天之内。 |
pull_requests.total_merged_created_by_copilot | 特定日期由 Copilot 创建且已合并的拉取请求数。 每个拉取请求仅在合并当天计数。 |
pull_requests.median_minutes_to_merge_copilot_authored | 特定日期由 Copilot 创建且已合并的拉取请求从创建到合并的中位时间（以分钟为单位）。 |
pull_requests.total_copilot_suggestions | 特定日期由 Copilot 生成的拉取请求审查建议数。 |
pull_requests.total_copilot_applied_suggestions | 特定日期由 Copilot 生成且已应用的拉取请求审查建议数。 |