Copilot 使用度量仪表盘和 API 使用一致的字段集来显示和导出数据。本参考列出所有可用指标，并说明如何在仪表盘可视化以及 NDJSON 或 API 导出中解释其数值。
- Copilot 使用度量仪表盘在企业和组织级别提供。
- Copilot 使用度量 API 支持企业、组织和用户级别的记录。
有关阅读和解释这些指标的指南，请参阅GitHub Copilot 使用度量指标。
Copilot 使用仪表盘指标
这些指标直接显示在 Copilot 使用仪表盘中。这些图表不包括 Copilot CLI 的使用情况。
| 指标 | 描述 |
|---|---|
| Agent 采纳 | 本日历月内尝试代理的 Copilot 授权活跃用户的百分比。 |
| 每位活跃用户的平均聊天请求数 | 每位活跃用户的平均聊天请求数。 |
| 代码补全（已建议/已接受） | 显示并被接受的内联代码建议的总数。 |
| 代码补全接受率 | 用户接受的建议的百分比。 |
| 日活跃用户 | 在特定日期使用 Copilot 的唯一用户数量。 |
| 周活跃用户 | 在七天窗口内使用 Copilot 的唯一用户数量。 |
| 总活跃用户 | 本日历月内活跃的授权用户。 |
| 语言使用 | 使用 Copilot 的编程语言分布。 |
| 每日语言使用情况 | 每日的语言使用细分。 |
| 模型使用情况 | 聊天使用的 AI 模型分布。 |
| 每日模型使用情况 | 聊天模型每日使用情况细分。 |
| 各聊天模式的模型使用情况 | Copilot 功能（ask、edit、plan、agent）对应的模型使用情况。 |
| 按语言的模型使用情况 | 按模型划分的语言分布。 |
| 使用最频繁的聊天模型 | 过去 28 天内使用最频繁的聊天模型。 |
| 各聊天模式的请求数 | 按模式（ask、edit、plan、agent）的聊天请求数量。 |
代码生成仪表盘指标
这些指标出现在代码生成仪表盘中，提供用户发起和代理发起活动的代码生成细分。所有数值均基于 IDE 中添加或删除的代码行（LoC）。
| 指标 | 描述 |
|---|---|
| AI 变动的代码行数 | 过去 28 天内所有模式下添加和删除的代码行总数。 |
| 代理贡献度 | 过去 28 天内由代理（包括 edit、agent、custom 模式）添加和删除的代码行占比。 |
| 代理平均删除的代码行数 | 本日历月内代理代表活跃用户自动删除的平均代码行数。 |
| 每日新增与删除的代码行总计 | 每日所有模式下代码库中新增和删除的代码行总数。 |
| 用户发起的代码更改 | 用户通过代码补全和聊天面板操作（插入、复制或应用）建议或手动添加的代码行。 |
| 代理发起的代码更改 | 代理代表用户在 edit、agent、custom 模式下自动添加或删除的代码行。 |
| 按模型划分的用户发起代码更改 | 按 IDE 中使用的模型分组的用户发起代码行。 |
| 按模型划分的代理发起代码更改 | 按执行代理操作的模型分组的代理发起代码行。 |
| 按语言划分的用户发起代码更改 | 按编程语言分组的用户发起代码行。 |
| 按语言划分的代理发起代码更改 | 按编程语言分组的代理发起代码行。 |
API 与导出字段
这些字段出现在导出的 NDJSON 报告以及 Copilot 使用度量 API 中。它们提供企业、组织或用户范围的每日记录，具体取决于指标。
有关 API 返回数据示例模式，请参阅Copilot 使用度量示例模式。
| 字段 | 描述 |
|---|---|
agent_edit | 捕获 Copilot（在代理和编辑模式）直接写入 IDE 文件时添加和删除的行数。agent_edit不包含在基于建议的指标中，可能不会填充建议类字段（例如 user_initiated_interaction_count）。同时统计自定义代理的编辑。 |
report_start_day / report_end_day | 28 天报告期的起始和结束日期。 |
day | 此记录对应的日历日。 |
enterprise_id | 企业的唯一标识。 |
organization_id（仅 API） | 组织的唯一标识。 |
user_id / user_login | 用户的唯一标识符和 GitHub 登录名。 |
user_initiated_interaction_count | 发送给 Copilot 的显式提示数量。 仅统计实际发送给模型的消息或提示。不包括打开聊天面板、切换模式（例如 ask、edit、plan、agent）、使用快捷键打开内联 UI，或进行配置更改。 |
chat_panel_agent_mode | 捕获在聊天面板中选择代理模式时用户发起的交互。 |
chat_panel_ask_mode | 捕获在聊天面板中选择 ask 模式时用户发起的交互。 |
chat_panel_custom_mode | 捕获在聊天面板中选择自定义代理时用户发起的交互。 |
chat_panel_edit_mode | 捕获在聊天面板中选择编辑模式时用户发起的交互。 |
chat_panel_unknown_mode | 捕获在聊天面板中模式未知时用户发起的交互。 |
code_generation_activity_count | 生成的不同 Copilot 输出事件数量。 包含：所有生成的内容，包括注释和文档字符串。 多个块：单个用户提示产生的每个不同代码块均计为一次生成。 注意：此指标不能直接与 user_initiated_interaction_count 对比，因为一次提示可能产生多个生成。 |
code_acceptance_activity_count | 用户接受的建议或代码块数量。 计入：所有内建的接受操作，如“应用到文件”“在光标处插入”“插入到终端”以及使用复制按钮。 不计入：手动的操作系统剪贴板操作（例如 Ctrl+C）。 粒度：每一次接受操作均计一次，无论最初提示生成了多少代码块。 |
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 | 聊天活动（非补全）的模型特定汇总。当启用自动模型选择时，活动归属到实际使用的模型，而非显示为 Auto。 |
last_known_ide_version / last_known_plugin_version | 检测到的每位用户最近的 IDE 与 Copilot Chat 插件版本。 |
daily_active_cli_users | 在特定日期使用 Copilot CLI 的企业或组织内唯一用户数。此字段独立于IDE 活跃用户计数，且不计入基于 IDE 的活跃用户定义。若当日无 CLI 使用，则省略。 |
totals_by_cli | 在特定日期对企业、组织或用户的 CLI‑specific 指标进行的细分。独立于 IDE 指标——CLI 使用不会体现在 totals_by_ide 或 totals_by_feature 等字段中。若当日无 CLI 使用，则省略。参见下文Copilot CLI 指标字段。 |
used_cli | 捕获用户当日是否使用过 Copilot CLI。 |
used_agent | 捕获用户当日是否在 IDE 中使用过代理模式。不包括 Copilot 代码审查活动，后者分别记录在 used_copilot_code_review_active 与 used_copilot_code_review_passive 中。 |
used_chat | 捕获用户当日是否使用过 IDE 聊天。 |
used_copilot_code_review_active | 捕获用户当日是否主动参与 Copilot 代码审查。若用户手动请求审查或应用了审查建议，则视为主动。 |
used_copilot_code_review_passive | 捕获用户当日是否有 Copilot 自动被指派审查其 Pull Request，而用户未主动参与审查。 |
Copilot CLI 指标字段（仅 API）
当存在 CLI 使用时，totals_by_cli 对象包含以下嵌套字段。
| 字段 | 描述 |
|---|---|
totals_by_cli.session_count | 当日启动的不同 CLI 会话数量。 |
totals_by_cli.request_count | 当日通过 CLI 向 Copilot 发出的请求总数，包含用户发起的提示和自动化的代理后续调用。 |
totals_by_cli.token_usage.output_tokens_sum | 当日所有 CLI 请求产生的输出 token 总数。 |
totals_by_cli.token_usage.prompt_tokens_sum | 当日所有 CLI 请求发送的提示 token 总数。 |
totals_by_cli.token_usage.avg_tokens_per_request | 每个 CLI 请求的平均 输出 与 提示 token 数，计算方式为 (output_tokens_sum + prompt_tokens_sum) ÷ request_count。 |
totals_by_cli.prompt_count | 会话内执行的用户提示、命令或查询的总数。 |
totals_by_cli.last_known_cli_version | 当日检测到的用户最近的 Copilot CLI 版本。 |
Pull request 活动字段（仅 API）
重要提示
组织和企业层级的报告可能因用户去重方式和归属时间的差异而出现不同的总计。有关跨范围解释 Pull Request 指标的指南，请参阅GitHub Copilot 使用度量指标。
这些字段捕获企业或组织范围内每日的 Pull Request 创建、审查、合并以及建议活动，包括 Copilot 的参与。
| 字段 | 描述 |
|---|---|
pull_requests.total_created | 特定日期创建的 Pull Request 总数。 创建是一次性事件。每个 Pull Request 仅在创建当天计数。 |
pull_requests.total_reviewed | 特定日期审查的 Pull Request 总数。 同一个 Pull Request 若在多天内收到审查，则会在多个日期计数。单日内，每个 Pull Request 计一次，即使有多次审查操作。 |
pull_requests.total_merged | 特定日期合并的 Pull Request 总数。 合并是一次性事件。每个 Pull Request 仅在合并当天计数。 |
pull_requests.median_minutes_to_merge | 在该日合并的 Pull Request，从创建到合并的中位时间（分钟）。 使用中位数可降低异常长时间 Pull Request 对整体的影响。 |
pull_requests.total_suggestions | 特定日期生成的 Pull Request 审查建议总数（不区分作者）。 |
pull_requests.total_applied_suggestions | 特定日期被应用的 Pull Request 审查建议总数（不区分作者）。 |
pull_requests.total_created_by_copilot | 该日由 Copilot 创建的 Pull Request 数量。 |
pull_requests.total_reviewed_by_copilot | 该日由 Copilot 审查的 Pull Request 数量。 同一个 Pull Request 若被 Copilot 在多天审查，则会在多个日期计数。 |
pull_requests.total_merged_created_by_copilot | 该日由 Copilot 创建且在同一天合并的 Pull Request 数量。每个 Pull Request 仅在合并当天计数。 |
pull_requests.median_minutes_to_merge_copilot_authored | 在该日合并的、由 Copilot 创建的 Pull Request，从创建到合并的中位时间（分钟）。 |
pull_requests.total_copilot_suggestions | 该日由 Copilot 生成的 Pull Request 审查建议数量。 |
pull_requests.total_copilot_applied_suggestions | 该日由 Copilot 生成且被应用的 Pull Request 审查建议数量。 |