Copilot使用情况指标的仪表板和 API 使用一组一致的字段来显示和导出数据。 此参考列出了所有可用的指标，并介绍了如何在仪表板视觉对象和 NDJSON 或 API 导出中解释其值。
- Copilot使用情况指标仪表板在企业和组织级别提供。
- Copilot使用情况指标 API 支持企业、组织和用户级记录。
- 团队级指标不是预先汇总的；您需要将用户-团队报表与按用户划分的使用指标报表进行关联，以构建这些指标。 请参阅“团队级Copilot使用情况指标”。
有关如何读取和解释这些指标的指导，请参阅 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 | 捕获在 Copilot（在代理和编辑模式下）将更改直接写入 IDE 中的文件时添加和删除的行。 |
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 的企业或组织省略。 |
daily_active_copilot_code_review_users | 在给定日期主动使用 Copilot 代码评审 的唯一用户数。 主动使用意味着手动请求评审或应用建议。 当用户在同一时间段内同时具有主动和被动信号时，它们仅算作主动信号。 |
daily_passive_copilot_code_review_users | 在给定日期，其拉取请求被自动分配了 Copilot 代码评审 审查，且本人无活跃参与的唯一用户数。 |
weekly_active_copilot_code_review_users | 在最近七天内主动使用 Copilot 代码评审 的唯一用户数量。 当用户在同一时间段内同时具有主动和被动信号时，它们仅算作主动信号。 |
weekly_passive_copilot_code_review_users | 在最近七天内，其拉取请求被自动分配了 Copilot 代码评审 审查，且本人无活跃参与的唯一用户数。 |
monthly_active_copilot_code_review_users | 在过去 28 天的时间段内活跃使用 Copilot 代码评审 的唯一用户数。 当用户在同一时间段内同时具有主动和被动信号时，它们仅算作主动信号。 |
monthly_passive_copilot_code_review_users | 在最近 28 天内，其拉取请求被自动分配了 Copilot 代码评审 审查，且本人无活跃参与的唯一用户数。 |
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.total_merged_reviewed_by_copilot | 报告期间由 Copilot 代码评审 合并且审查的拉取请求数。 |
pull_requests.median_minutes_to_merge_copilot_authored | 由 Copilot 创建且在此特定日期合并的拉取请求从创建到合并的中位时间（分钟）。 |
pull_requests.median_minutes_to_merge_copilot_reviewed | 从创建到合并的中位时间（分钟），仅统计由 Copilot 代码评审 审查的拉取请求。 |
pull_requests.total_copilot_suggestions | 由 Copilot 在此特定日期生成的拉取请求审查建议数。 |
pull_requests.total_copilot_applied_suggestions | 由 Copilot 生成且在此特定日期应用的拉取请求审查建议数。 |
pull_requests.copilot_suggestions_by_comment_type | 代码评审建议的聚合计数，按分配的 Copilot 注释类型 Copilot （例如， security 或 bug_risk） 细分。 每个条目包括 comment_type、 total_copilot_suggestions和 total_copilot_applied_suggestions。 在存储库级别不可用。 |
用户团队字段（仅限 API）
这些字段显示在每日用户团队报表（通过组织和企业范围的 REST API 提供）中，并用于通过加入每用户使用情况指标报告来构建团队级指标。 有关完整联接配方和终结点 URL，请参阅 团队级Copilot使用情况指标。
在给定日期，Copilot 席位用户数少于 5 人的团队不包含在用户-团队报告中。
| 字段 | Description |
|---|---|
user_id / user_login | 用户的唯一标识符和 GitHub 用户名。 |
day | 此记录表示的日历日。 |
organization_id （组织范围） | 团队所属的组织的唯一 ID。 |
enterprise_id（企业范围） | 团队所属企业的唯一 ID。 企业范围报表同时包括企业团队和业务团队。 |
team_id | 用户所属的团队的唯一 ID。 |
slug | URL 友好的团队标识符。 |