Copilot使用情况指标的仪表板和 API 使用一组一致的字段来显示和导出数据。 此参考列出了所有可用的指标，并介绍了如何在仪表板视觉对象和 NDJSON 或 API 导出中解释其值。
- Copilot使用情况指标仪表板在企业和组织级别提供。
- Copilot使用情况指标 API 支持企业、组织和用户级记录。
有关如何读取和解释这些指标的指导，请参阅 GitHub Copilot使用情况指标。
Copilot 仪表板使用情况指标
这些指标直接出现在 Copilot 使用情况仪表板中。 这些图表不包括Copilot 命令行界面（CLI）使用情况。
| 指标 | Description |
|---|---|
| 代理采用 | 当前日历月中尝试代理的Copilot授权活跃用户的百分比。 |
| 每个活动用户的平均聊天请求数 | 每个活动用户的平均聊天请求数。 |
| 代码自动完成功能（建议/已接受） | 显示和接受的内联代码建议的总数。 |
| 代码完成验收率 | 用户接受的建议百分比。 |
| 每日活动用户 | 在给定日期使用 Copilot 的唯一用户数。 |
| 每周活动用户 | 在七天窗口中使用 Copilot 的唯一用户数。 |
| 活动用户总数 | 在当前日历月中处于活动状态的许可用户。 |
| 语言的使用 | 与 Copilot 一起使用的编程语言分布。 |
| 每天的语言使用情况 | 所用语言的每日使用情况细分。 |
| 模型使用 | 用于聊天的 AI 模型的分布。 |
| 每天的模型使用情况 | 聊天模型使用情况的每日细分。 |
| 每个聊天模式的模型使用情况 | 按 Copilot 功能（提问、编辑、计划、代理）使用模型。 |
| 每个语言的模型用法 | 按模型细分的语言分布。 |
| 最常用的聊天模型 | 过去 28 天内最常用的聊天模型。 |
| 每个聊天模式的请求数 | 按模式（询问、编辑、计划、代理）的聊天请求数。 |
代码生成仪表板指标
这些指标显示在代码生成仪表板中，并提供如何跨用户发起的活动和代理发起的活动生成代码的细分。 所有值都派生自 IDE 中添加或删除的代码行（LoC）。
| 指标 | Description |
|---|---|
| 使用 AI 修改代码行 | 在过去 28 天内在所有模式下添加和删除的代码行总数。 |
| 代理贡献 | 在过去 28 天内，代理添加和删除的代码行（包括编辑、代理和自定义模式）的百分比。 |
| 代理删除的平均行数 | 代理系统在当前日历月内代表活跃用户自动删除的平均行数。 |
| 每天添加和删除行的总数 | 每天在所有模式下添加到代码库和从代码库中删除的行总数。 |
| 用户启动的代码更改 | 用户通过代码补全和聊天面板操作（插入、复制或应用）建议或手动添加的行。 |
| 代理启动的代码更改 | 代理代表用户在编辑、代理和自定义模式下自动添加或从代码库中删除的代码行。 |
| 用户每个模型发起的代码更改 | 用户自主创建的代码行，按 IDE 中使用的模型分组。 |
| 由代理发起的每个模型的代码更改 | 由代理发起的代码行，根据执行代理操作的模型进行分组。 |
| 每种语言的用户发起的代码更改 | 用户启动的代码行，按编程语言分组。 |
| 代理启动的代码更改（每种语言） | 代理启动的代码行，按编程语言分组。 |
API 和导出字段
这些字段显示在导出的 NDJSON 报表和 Copilot 使用情况指标 API 中。 它们根据指标在企业、组织或用户范围内提供每日记录。
有关 API 返回的数据的示例架构，请参阅 Copilot使用情况指标的示例架构。
| 字段 | Description |
|---|---|
agent_edit | 捕获在（在代理和编辑模式下）将更改直接写入 IDE 中的文件时添加和删除 Copilot 的行。 |
`agent_edit`不包含在基于建议的指标中，并且可能不会填充建议样式字段（例如）。 `user_initiated_interaction_count` 也会统计来自自定义代理的编辑操作。 |
| report_start_day / report_end_day | 28 天报告周期的开始日期和结束日期。 |
| day | 此记录表示的日历日。 |
| enterprise_id | 企业的唯一 ID。 |
| organization_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 输出事件数。
包括： 所有生成的内容，包括注释和文档字符串。
多个块： 单个用户提示中的每个不同代码块都计为单独的生成。
注意： 此指标不直接可比 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 和 副驾驶聊天 扩展版本。 |
| daily_active_cli_users | 在给定日期通过 CLI 使用 Copilot 的企业或组织中的唯一用户数。 此字段 独立于 IDE 活动用户计数， 并且不包括 在基于 IDE 的活动用户定义中。 当天未使用 CLI 的企业或组织省略。 |
| totals_by_cli | 给定日期内关于企业、组织或用户的 CLI 特定指标的细分。 与 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 代码评审。 如果用户手动请求 Copilot 评审或应用 Copilot 了评审建议，则被视为处于活动状态。 |
| used_copilot_code_review_passive | 记录用户 Copilot 当天是否自动分配到审查其拉取请求，在无主动参与评审的情况下。 |
Copilot 命令行界面（CLI） 指标字段（仅限 API）
当存在 CLI 使用情况时，该 totals_by_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 请求的平均输出和提示令牌数（计算为 (output_tokens_sum + prompt_tokens_sum) ÷ request_count）。 |
totals_by_cli.prompt_count | 在会话中执行的用户提示、命令或查询总数。 |
totals_by_cli.last_known_cli_version | 当天检测到用户的最新版本 Copilot 命令行界面（CLI） 。 |
拉取请求活动字段（API 专用）
重要
由于用户重复数据删除和归因时间差异，组织和企业级报告可能会显示不同的总计。 有关跨范围拉取请求指标解释指南，请参阅 GitHub Copilot使用情况指标。
这些字段记录企业或组织范围内的每日拉取请求创建、审查、合并以及建议活动，包括由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生成并在此特定日期应用的拉取请求评审建议数量。 |