Copilot使用情况指标的仪表板和 API 使用一组一致的字段来显示和导出数据。 此参考列出了所有可用的指标,并介绍了如何在仪表板视觉对象和 NDJSON 或 API 导出中解释其值。
- Copilot使用情况指标仪表板在企业和组织级别提供。
- 使用情况指标 API 返回Copilot企业或组织范围内的报表,其中包含聚合、存储库级别和单个用户级报表粒度。 形状因范围和粒度而异。
- 团队级指标不是预先汇总的;您需要将用户-团队报表与按用户划分的使用指标报表进行关联,以构建这些指标。 请参阅“团队级Copilot使用情况指标”。
- 在存储库级别的报告中,每个在指定日期内有拉取请求活动的存储库都各有一条记录。 请参阅本文后面的 存储库级字段(仅 API )。
有关如何读取和解释这些指标的指导,请参阅 GitHub Copilot使用情况指标。
Copilot 仪表板使用情况指标
这些指标直接出现在 Copilot 使用情况仪表板中。 这些图表不包括Copilot CLI使用情况。
| 指标 | Description |
|---|---|
| 代理采用 | 当前日历月中尝试代理的 Copilot 授权活动用户的百分比。 |
| 每个活动用户的平均聊天请求数 | 每个活动用户的平均聊天请求数。 |
| 代码自动完成功能(建议/已接受) | 显示和接受的内联代码建议的总数。 |
| 代码完成验收率 | 用户接受的建议百分比。 |
| 每日活动用户 | 在给定日期使用 Copilot 的唯一用户数。 |
| 每周活动用户 | 在七天窗口中使用 Copilot 的唯一用户数。 |
| 活动用户总数 | 在当前日历月中处于活动状态的许可用户。 |
| 语言的使用 | 与 Copilot 一起使用的编程语言分布。 |
| 每天的语言使用情况 | 所用语言的每日使用情况细分。 |
| 模型使用 | 用于聊天的 AI 模型的分布。 |
| 每天的模型使用情况 | 聊天模型使用情况的每日细分。 |
| 每个聊天模式的模型使用情况 | 按 Copilot 功能(提问、编辑、计划、代理)使用模型。 |
| 每个语言的模型用法 | 按模型细分的语言分布。 |
| 最常用的聊天模型 | 过去 28 天内最常用的聊天模型。 |
| 每个聊天模式的请求数 | 按模式(询问、编辑、计划、代理)的聊天请求数。 |
影响力仪表板指标
这些指标显示在影响力仪表板中,该仪表板会按采用情况将用户划分为不同分组,并将采用情况与拉取请求产出关联起来。 有关如何解读采用队列的指导,请参阅 GitHub Copilot使用情况指标。
| 指标 | Description |
|---|---|
| 参与趋势 | 在过去六个月中,组织的采用队列组合和拉取请求吞吐量(每月合并的拉取请求总数)是如何变化的。 |
| 功能参与度 | 在包含首尾两天的 28 天窗口期内,至少在两个不同日期使用过每个所包含Copilot功能的活跃用户数量。 |
| 采用队列分布 | 在该期间内,按各采用阶段(被动用户、第 1 阶段、第 2 阶段、第 3 阶段)分组的已获许可用户占比。 被动用户对应于 No Cohort API 中的值。 |
| 采纳倍数 | 将参与用户(阶段 1、2 或 3)与被动用户在代码交付量(每位用户每月合并的拉取请求数)以及拉取请求合并时间方面进行比较,以显示更深入采用 Copilot 的相对影响。 |
| Recommendations | 建议的操作(例如,根据组织的当前队列分布配置 Copilot cloud agent 或启用 Copilot code review)。 |
代码生成仪表板指标
这些指标显示在代码生成仪表板中,并提供如何跨用户发起的活动和代理发起的活动生成代码的细分。 所有值都派生自 IDE 中添加或删除的代码行(LoC)。
| 指标 | Description |
|---|---|
| 使用 AI 修改代码行 | 在过去 28 天内在所有模式下添加和删除的代码行总数。 |
| 代理贡献 | 在过去 28 天内,代理添加和删除的代码行(包括编辑、代理和自定义模式)的百分比。 |
| 代理删除的平均行数 | 代理系统在当前日历月内代表活跃用户自动删除的平均行数。 |
| 每天添加和删除行的总数 | 每天在所有模式下添加到代码库和从代码库中删除的行总数。 |
| 用户启动的代码更改 | 用户通过代码补全和聊天面板操作(插入、复制或应用)建议或手动添加的行。 |
| 代理启动的代码更改 | 代理代表用户在编辑、代理和自定义模式下自动添加或从代码库中删除的代码行。 |
| 用户每个模型发起的代码更改 | 用户自主创建的代码行,按 IDE 中使用的模型分组。 |
| 由代理发起的每个模型的代码更改 | 由代理发起的代码行,根据执行代理操作的模型进行分组。 |
| 每种语言的用户发起的代码更改 | 用户启动的代码行,按编程语言分组。 |
| 代理启动的代码更改(每种语言) | 代理启动的代码行,按编程语言分组。 |
API 和导出字段
这些字段显示在导出的 NDJSON 报表和 Copilot 使用情况指标 API 中。 下表列出了字段名称、其 JSON 类型、值是否可以为 null 以及说明。
报表采用不同的形状,具体取决于其范围和粒度,因此记录中可用的字段取决于它来自哪些报表:
- 每个用户的报告(
*-users-1-day和*-users-28-day)包含每个用户的一条记录,其中包括user_id、user_login、ai_credits_used、used_*指标以及ai_adoption_phase。 它们不包含活跃用户数、pull_requests或totals_by_ai_adoption_phase。 - 聚合报表(
enterprise-1-day和organization-1-day)包含每个企业或组织的一个聚合记录,包括活动用户计数和pull_requests``totals_by_ai_adoption_phase。 它们不包含user_id或user_login``used_*指示器。 - 28 天聚合报告(
enterprise-28-day和organization-28-day)将每日聚合记录组成的数组封装在day_totals字段中,并将报告时间范围以及可选的copilot_feature_engagement对象置于顶层。 该对象未包含在按用户划分的报表中。 - 用户团队报表 (
*-user-teams-1-day) 将用户映射到他们所属的团队,以便可以构建团队级指标。 - 存储库级别报告(
*-repos-1-day)对当天有拉取请求活动的每个存储库包含一条记录,包括由 Copilot cloud agent 创建和由 Copilot code review 审核的拉取请求。
组织范围报告也包括organization_id以及enterprise_id。 有关 API 返回的数据的示例架构,请参阅 Copilot使用情况指标的示例架构。
类型列使用 JSON 架构类型:string、、integer``number、boolean、和array``object。
Nullable 列指示字段值是否可以为 null,或者在原本应包含该字段的记录中是否可以缺失。 活动细分数组始终存在,但可以为空([])。 可选数组被标记为可空,并且可以缺失。
报表标识字段
这些字段标识每个记录的范围和日期。 具体有哪些集合取决于报告形态。
| 字段 | 类型 | 可为 Null | Description |
|---|---|---|---|
day | string | 否 | 此记录的日历日以 YYYY-MM-DD 格式表示。 在 28 天报表中,day 显示在每个 day_totals 条目内,而不是在顶层显示。 |
enterprise_id | string | 否 | 企业的唯一 ID。 包含在企业和组织范围报表中。 |
organization_id | string | 是 | 组织的唯一 ID。 仅包含在组织范围报表中;从企业范围报表中省略。 |
每位用户的报表字段
每用户报表包含报告期间每个用户的一条记录。 每个用户的 28 天报表还包括 report_start_day 和 report_end_day 标记报告窗口。
| 字段 | 类型 | 可为 Null | Description |
|---|---|---|---|
user_id | integer | 否 | 用户的唯一标识符。 |
user_login | string | 否 | |
| GitHub 用户的用户名。 | |||
ai_credits_used | number | 否 | 报告期间用户消耗的 AI 信用额度总数。 此字段仅包含在每用户报表中,并且不会按功能、模型或图面细分。 此指标用于消耗分析,而不是开票总计。 |
user_initiated_ | integer | 否 | 发送到 Copilot的显式提示数。 仅对主动发送到模型的消息或提示进行计数。 |
| 不包括打开聊天面板、切换模式(例如询问、编辑、计划或代理)、使用键盘快捷键打开内嵌 UI 或进行配置更改。 | |||
code_generation_ | integer | 否 | 生成的不同 Copilot 输出事件数。 |
| 包括: 所有生成的内容,包括注释和文档字符串。 | |||
| 多个块: 单个用户提示中的每个不同代码块都计为单独的生成。 | |||
注意: 此指标不直接可比 user_initiated_,因为一个提示可以生成多代。 | |||
code_acceptance_ | integer | 否 | 用户接受的建议或代码块数。 |
| 计数内容: 所有内置的接受操作,如“应用到文件”“插入到光标”“插入到终端”以及使用复制按钮。 | |||
| 不计数: 操作系统的手动剪贴板操作(例如 Ctrl+C)。 | |||
| 粒度: 无论初始提示生成多少个代码块,每个接受操作都会使计数递增一次。 | |||
loc_suggested_ | integer | 否 | |
| Copilot 建议添加的代码行(补全、内联聊天、聊天面板等等;不含智能体编辑)。 | |||
loc_suggested_ | integer | 否 | |
| Copilot 建议删除的代码行(未来计划支持)。 | |||
loc_added_sum | integer | 否 | 实际添加到编辑器的代码行(已接受的补全、应用的代码块、智能体和编辑模式)。 |
loc_deleted_sum | integer | 否 | 从编辑器中删除的代码行(当前来自代理修改)。 |
used_agent | boolean | 否 | 用户当天是否在 IDE 中使用代理模式。 不包括 Copilot code review 活动,该活动在 used_copilot_ 和 used_copilot_ 中单独捕获。 |
used_chat | boolean | 否 | 用户当天是否使用 IDE 聊天。 |
used_cli | boolean | 否 | 用户当天是否使用了 Copilot CLI 。 |
used_copilot_app | boolean | 否 | 用户当天是否使用了 Copilot app。 |
used_copilot_ | boolean | 否 | 用户当天是否使用了Copilot cloud agent(以前Copilot编码代理)。 |
used_copilot_ | boolean | 否 | 用户当天是否使用了 Copilot cloud agent 。 其值与 used_copilot_ 相同;为保持向后兼容性,保留了这两个名称。 |
used_copilot_ | boolean | 是 | 用户当天是否主动与 Copilot code review 进行过交互。 如果用户手动请求 Copilot 评审或应用 Copilot 了评审建议,则被视为处于活动状态。 如果该用户当天没有 Copilot code review 信号,则为 Null。 |
used_copilot_ | boolean | 是 | 用户当天是否被自动分配了 Copilot 来评审其拉取请求,而未主动参与该评审。 如果该用户当天没有 Copilot code review 信号,则为 Null。 |
used_vscode_agent | boolean | 是 | 用户在报告期间是否使用了专用 VS Code 代理窗口。 当用户没有可用的专用代理窗口数据时省略。 |
ai_adoption_phase | object | 否 | 用户当日的 AI 采用阶段。 始终存在;默认为“无队列”阶段。 请参阅 AI 采用阶段字段。 |
distinct_skill_ | integer | 是 | 用户记录活动的不同技能标识符数。 请参阅 Copilot CLI 自定义字段。 |
distinct_custom_ | integer | 是 | 为该用户记录到活动的不同自定义代理标识符数量。 请参阅 Copilot CLI 自定义字段。 |
distinct_mcp_ | integer | 是 | 该用户连接过且有记录的不同模型上下文协议 (MCP) 服务器的标识符数量。 请参阅 Copilot CLI 自定义字段。 |
distinct_slash_ | integer | 是 | 用户记录活动的不同斜杠命令标识符数。 请参阅 Copilot CLI 自定义字段。 |
distinct_plugin_ | integer | 是 | 用户记录活动的不同插件标识符数。 请参阅 Copilot CLI 自定义字段。 |
totals_by_skill | array | 是 | |
| Copilot CLI 中最常用的技能,按交互次数排序。 请参阅 Copilot CLI 自定义字段。 | |||
totals_by_custom_ | array | 是 | |
| Copilot CLI 中最常用的自定义代理,按交互次数排序。 请参阅 Copilot CLI 自定义字段。 | |||
totals_by_mcp | array | 是 | |
| Copilot CLI中连接和重新连接尝试次数最多的 MCP 服务器,按交互次数排序。 请参阅 Copilot CLI 自定义字段。 | |||
totals_by_slash_ | array | 是 | 按交互次数排序的在 Copilot CLI 中使用的最常用斜杠命令。 请参阅 Copilot CLI 自定义字段。 |
totals_by_plugin | array | 是 | |
| Copilot CLI 中使用的热门插件,按交互次数排序。 请参阅 Copilot CLI 自定义字段。 | |||
totals_by_cli | object | 是 | 用户的 CLI 专用指标。 当用户当天未使用 Copilot CLI 时,则省略。 查看 Copilot CLI 指标字段。 |
totals_by_copilot_ | object | 是 | |
| Copilot app 面向用户的指标。 当用户当天未使用 Copilot app 时,则省略。 查看 Copilot app 指标字段。 | |||
totals_by_3rd_ | array | 是 | 已识别的 agent apps 的每智能体使用情况指标。 在报告期间用户没有识别 agent app 的活动时省略。 查看 Agent apps 指标字段。 |
totals_by_vscode_ | object | 是 | 为用户提供专用的 VS Code 代理窗口指标。 当两个必需计数都不可用时省略。 请参阅 VS Code “代理”窗口指标字段。 |
totals_by_ide | array | 否 | 按 IDE 划分的用户活动明细。 请参阅 活动细分对象。 |
totals_by_feature | array | 否 | 用户活动的按功能细分。 请参阅 活动细分对象。 |
totals_by_language_ | array | 否 | 结合语言和功能维度的细分方法。 请参阅 活动细分对象。 |
totals_by_language_ | array | 否 | 按语言和模型维度组合划分的聊天活动细分情况。 请参阅 活动细分对象。 |
totals_by_model_ | array | 否 | 对聊天活动的模型和功能维度进行细分。 请参阅 活动细分对象。 |
聚合的企业和组织报表字段
聚合报表包含每个企业或组织的一条记录,汇总当天的所有用户。 活动用户计数包括通过客户端和服务器端遥测标识的用户。 仅通过服务器端遥测发现的用户会计入活跃用户总数中,但可能不会出现在维度细分数组(totals_by_ide、totals_by_feature等)中。 下表列出了活动用户计数,然后列出活动总数和细分。
活跃用户数量:
| 字段 | 类型 | 可为 Null | Description |
|---|---|---|---|
daily_active_ | integer | 否 | 在给定日期使用 Copilot 的唯一用户数。 |
weekly_active_ | integer | 否 | 在过去七天窗口期内使用 Copilot 的独立用户数。 |
weekly_active_ | integer | 是 | 从星期日至报表日(含当日)期间使用专用 VS Code Agents 窗口的唯一用户数。 此按日历截至当前日期的计数并非过去七天的滚动窗口。 |
monthly_active_ | integer | 否 | 在过去 28 天窗口期内使用 Copilot 的唯一用户数。 |
monthly_active_ | integer | 是 | 从日历月的第一天到报表日(包括报表日)使用专用 VS Code 代理窗口的唯一用户数。 此计数是按日历累计的,不是过去 28 天的滚动窗口。 |
monthly_active_ | integer | 否 | 过去 28 天内使用聊天功能的唯一用户数。 |
monthly_active_ | integer | 否 | 过去 28 天窗口期内使用代理模式的独立用户数。 |
daily_active_ | integer | 否 | 在给定日期使用 Copilot cloud agent 的唯一用户数。 |
weekly_active_ | integer | 否 | 在过去七天窗口期内使用 Copilot cloud agent 的独立用户数。 |
monthly_active_ | integer | 否 | 在过去 28 天窗口期内使用 Copilot cloud agent 的唯一用户数。 |
daily_active_ | integer | 否 | 在给定日期主动使用 Copilot code review 的唯一用户数。 主动使用意味着手动请求评审或应用建议。 当用户在同一时间段内同时具有主动和被动信号时,它们仅算作主动信号。 |
weekly_active_ | integer | 否 | 在最近七天内主动使用 Copilot code review 的唯一用户数量。 当用户在同一时间段内同时具有主动和被动信号时,它们仅算作主动信号。 |
monthly_active_ | integer | 否 | 在过去 28 天的时间段内活跃使用 Copilot code review 的唯一用户数。 当用户在同一时间段内同时具有主动和被动信号时,它们仅算作主动信号。 |
daily_passive_ | integer | 否 | 在给定日期,其拉取请求被自动分配了 Copilot code review 审查,且本人无活跃参与的唯一用户数。 |
weekly_passive_ | integer | 否 | 在最近七天内,其拉取请求被自动分配了 Copilot code review 审查,且本人无活跃参与的唯一用户数。 |
monthly_passive_ | integer | 否 | 在最近 28 天内,其拉取请求被自动分配了 Copilot code review 审查,且本人无活跃参与的唯一用户数。 |
daily_active_ | integer | 是 | 在给定日期使用 Copilot CLI 的唯一用户数。 此计数 独立于 IDE 活动用户计数, 并且不包括 在基于 IDE 的活动用户定义中。 当天未使用 CLI 的企业或组织省略。 |
daily_active_ | integer | 是 | 在给定日期使用 Copilot app 的唯一用户数。 当企业或组织在当天没有 Copilot app 活动时,为“Null”。 |
daily_active_ | integer | 是 | 在给定日期使用专用 VS Code 代理窗口的唯一用户数。 当企业或组织没有可用的专用代理窗口数据时省略。 |
活动总计和细分:
| 字段 | 类型 | 可为 Null | Description |
|---|---|---|---|
user_initiated_ | integer | 否 | 当天所有用户发送给 Copilot 的显式提示总数。 |
code_generation_ | integer | 否 | 一天中所有用户生成的非重复 Copilot 输出事件总数。 |
code_acceptance_ | integer | 否 | 一天中所有用户接受的建议或代码块总数。 |
loc_suggested_ | integer | 否 | 当天建议添加的聚合代码行数。 定义与按用户划分的字段相同。 |
loc_suggested_ | integer | 否 | 当日建议删除的代码行总数。 定义与按用户划分的字段相同。 |
loc_added_sum | integer | 否 | 当天添加的聚合代码行数。 定义与按用户划分的字段相同。 |
loc_deleted_sum | integer | 否 | 当天累计删除的代码行数 定义与按用户划分的字段相同。 |
distinct_skill_ | integer | 是 | 整个企业或组织内已有活动记录的不同技能标识符数量。 请参阅 Copilot CLI 自定义字段。 |
distinct_custom_ | integer | 是 | 跨企业或组织记录活动的不同自定义代理标识符的数量。 请参阅 Copilot CLI 自定义字段。 |
distinct_mcp_ | integer | 是 | 在整个企业或组织范围内,有已记录连接活动的不同 MCP 服务器标识符数量。 请参阅 Copilot CLI 自定义字段。 |
distinct_slash_ | integer | 是 | 整个企业或组织范围内有已记录活动的不同斜杠命令标识符数量。 请参阅 Copilot CLI 自定义字段。 |
distinct_plugin_ | integer | 是 | 在整个企业或组织范围内有活动记录的不同插件标识符数量。 请参阅 Copilot CLI 自定义字段。 |
totals_by_skill | array | 是 | 整个企业或组织中在 Copilot CLI 使用的主要技能。 请参阅 Copilot CLI 自定义字段。 |
totals_by_custom_ | array | 是 | 整个企业或组织中在 Copilot CLI 内使用的热门自定义代理。 请参阅 Copilot CLI 自定义字段。 |
totals_by_mcp | array | 是 | 在整个企业或组织内的 Copilot CLI 中,连接和重连尝试次数最多的 MCP 服务器。 请参阅 Copilot CLI 自定义字段。 |
totals_by_slash_ | array | 是 | 整个企业或组织中在 Copilot CLI 内使用最多的斜杠命令。 请参阅 Copilot CLI 自定义字段。 |
totals_by_plugin | array | 是 | 企业或组织中使用的 Copilot CLI 顶级插件。 请参阅 Copilot CLI 自定义字段。 |
totals_by_ide | array | 否 | 按 IDE 汇总的活动明细。 请参阅 活动细分对象。 |
totals_by_feature | array | 否 | 按功能汇总的活动明细。 请参阅 活动细分对象。 |
totals_by_language_ | array | 否 | 按语言和功能划分的汇总活动明细。 请参阅 活动细分对象。 |
totals_by_language_ | array | 否 | 按语言和模型汇总的活动细分统计。 请参阅 活动细分对象。 |
totals_by_model_ | array | 否 | 聚合的模型和特征活动细分。 请参阅 活动细分对象。 |
totals_by_cli | object | 是 | 当天汇总的 Copilot CLI 指标。 当天没有 CLI 使用时则省略。 与按用户划分的表单不同,它不包含 last_known_cli_。 查看 Copilot CLI 指标字段。 |
totals_by_copilot_ | object | 是 | 当天汇总的 Copilot app 指标。 当企业或组织在当天没有 Copilot app 活动时,为“Null”。 查看 Copilot app 指标字段。 |
totals_by_3rd_ | array | 是 | 已识别的 agent apps 的每智能体聚合使用情况指标。 当企业或组织当天没有已识别的 agent app 活动时,则省略。 查看 Agent apps 指标字段。 |
totals_by_vscode_ | object | 是 | 当日汇总的专用 VS Code Agents 窗口指标。 当两个必需计数都不可用时省略。 请参阅 VS Code “代理”窗口指标字段。 |
totals_by_ai_ | array | 是 | 按阶段汇总的用户数及其平均活跃度 在没有可用的采用阶段数据时省略。 请参阅 AI 采用阶段字段。 |
pull_requests | object | 否 | 企业或组织的每日拉取请求活动。 请参阅拉取请求活动字段。 |
28天报表字段
28 天聚合报表(enterprise-28-day 和 organization-28-day)是封装结构:它们在顶层包含报告时间窗口,以及按日聚合记录的数组。
| 字段 | 类型 | 可为 Null | Description |
|---|---|---|---|
report_start_day | string | 否 | 28 天报告窗口的第一个日历日,采用 YYYY-MM-DD 格式。 |
report_end_day | string | 否 | 28 天报告窗口的最后一个日历日,采用 YYYY-MM-DD 格式。 |
created_at | string | 否 | 生成报表时的时间戳(ISO 8601)。 |
copilot_feature_ | object | 是 | 28 天窗口内的滚动功能参与度。 仅包含在企业和组织聚合报表中。 当可选计算不可用,或报告生成时间早于此字段时,该值为 Null 或缺失。 请参阅 Copilot 功能互动字段。 |
day_totals | array | 否 | 按日聚合记录的数组。 每个条目都具有与聚合的 1 天报表相同的字段。 请参阅 聚合企业和组织报表字段。 |
Copilot 功能使用情况字段
可选的 copilot_feature_engagement 对象汇总了该报告中的滚动活跃用户规模以及与七项功能的互动情况。 对于其 report_end_day 与 day 匹配的 day_totals 条目,copilot_feature_engagement.active_user_count 等于互斥的 totals_by_ai_adoption_phase[].users_in_phase_28d 值之和。
单个功能的计数重叠,因为用户可以参与多个功能。 不要将 engaged_user_count 值一起添加。 初始功能集将主动和被动 Copilot code review 作为两个单独的功能分别报告。 它不包括 Copilot Chat 或 VS Code 代理。
Copilot Chat 计划在后续版本中发布,届时已连续收集 28 天的数据,并且报告使用者支持该新增条目。
| 字段 | 类型 | 可为 Null | Description |
|---|---|---|---|
copilot_feature_ | integer | 否 | 含首尾的 28 天报告窗口中的非重复活动用户的非负数量。 有效的零用户报表将此字段设置为 0。 |
copilot_feature_ | array | 否 | 功能使用次数。 对于以下每个值,初始数组中都恰好包含一个条目:code_completion、code_review_passive、agent_edit、code_review_active、cloud_agent、copilot_cli 和 github_app。 有效的零用户报告包含七个条目,且所有条目中的 均设置为 。 |
copilot_feature_ | string | 否 | 功能标识符。 在此对象中,github_app 表示 Copilot app。 这不同于 copilot_app 活动细分数组中使用的值,例如 totals_by_feature。 |
copilot_feature_ | integer | 否 | 在包含首尾两天在内的 28 天报告窗口内,至少在两个不同日期使用过该功能的独立活跃用户数,且该数量为非负数。 |
用户团队字段
这些字段显示在每日用户团队报表(通过组织和企业范围的 REST API 提供)中,并用于通过加入每用户使用情况指标报告来构建团队级指标。 有关完整联接配方和终结点 URL,请参阅 团队级Copilot使用情况指标。
在给定日期,Copilot 席位用户数少于 5 人的团队不包含在用户-团队报告中。
| 字段 | 类型 | 可为 Null | Description |
|---|---|---|---|
user_id | integer | 否 | 用户的唯一标识符。 |
user_login | string | 否 | |
| GitHub 用户的用户名。 | |||
day | string | 否 | 此记录表示的日历日。 |
organization_id | string | 否 | 团队所属的组织的唯一 ID。 仅限组织范围。 |
enterprise_id | string | 否 | 团队所属企业的唯一 ID。 仅限企业范围。 企业范围报表同时包括企业团队和业务团队。 |
team_id | integer | 否 | 用户所属的团队的唯一 ID。 |
slug | string | 否 | URL 友好的团队标识符。 |
存储库级字段(仅限 API)
存储库级别报告显示组织或企业中的存储库的每日拉取请求创建、审查、合并和提出建议活动,以及拉取请求审查各阶段的持续时间,包括由 Copilot cloud agent 创建并由 Copilot code review 审查的拉取请求。 每行表示一个存储库,该存储库在请求的一天具有拉取请求活动;省略没有活动的存储库。 这些报表侧重于拉取请求生命周期活动,即使缺少 IDE 使用情况指标,也可以包含数据。
这些字段由每日仓库级报告(repos-1-day)返回,并可通过组织和企业范围的 REST API 获取。 有关终结点 URL、响应信封、权限和下载工作流,请参阅 用于 Copilot 使用情况指标的REST API终结点。 有关示例行,请参阅 Copilot使用情况指标的示例架构。
| 字段 | 类型 | 可为 Null | Description |
|---|---|---|---|
day | string | 否 | 此记录的日历日以 YYYY-MM-DD 格式表示。 |
enterprise_id | string | 否 | 企业的唯一 ID。 会在企业范围的报告中填充,也会在属于某企业的组织的组织范围报告中填充。 对于不属于企业所有的组织,此项为空。 |
organization_id | string | 否 | 拥有存储库的组织的唯一 ID。 包含在企业和组织范围内的报表中。 |
repo_id | integer | 否 | 存储库的唯一 ID。 |
repo_owner_name | string | 否 | 存储库所有者的登录名。 |
repo_name | string | 否 | 存储库名称。 |
repo_visibility | string | 否 | 存储库可见性。 可能的值为 PRIVATE、INTERNAL 和 PUBLIC。 |
pull_requests | object | 否 | 存储库的每日拉取请求活动。 请参阅拉取请求活动字段。 |
pull_request_ | array | 否 | 查看当天在仓库中合并的符合条件的拉取请求的各阶段持续时长,每位作者和每种审阅者类型各对应一条记录。 当没有符合条件的拉取请求被合并时,此项为空。 请参阅 拉取请求审查时间字段。 |
活动细分对象
这些 totals_by_* 字段是细分对象的数组。 数组始终存在,但可以为空。 在每个对象中,指标字段(*_count 和 loc_*_sum)遵循与顶级每个用户字段相同的定义,维度字段携带 “细分”维度值中记录的值。
| 对象 | 维度字段 | Description |
|---|---|---|
totals_by_ide[] | ide | 按 IDE 细分。 在按用户划分的报表中,每个条目还包括 last_known_ide_ 和 last_known_plugin_。 |
totals_by_feature[] | feature | 按 Copilot 功能细分(例如内联聊天或聊天面板)。 |
totals_by_language_ | ||
language、feature | 按语言和功能组合进行细分。 不包括 user_initiated_。 | |
totals_by_language_ | ||
language、model | 聊天活动的语言与模型组合细分(不包括补全)。 | |
totals_by_model_ | ||
model、feature | 聊天活动的模型与功能组合细分(不包括补全)。 |
在每用户报表中,每个 totals_by_ide[] 条目还会报告用户最近检测到的 IDE 和 Copilot Chat 扩展版本。
| 字段 | 类型 | 可为 Null | Description |
|---|---|---|---|
last_known_ide_ | object | 是 | 为用户检测到的最新 IDE 版本,如下所示 { ide_version, sampled_at }。 对于聚合后的细分行(例如设有上限的“其他”IDE 桶),该字段会被省略。 |
last_known_ide_ | string | 否 | IDE 版本字符串。 在存在 last_known_ide_ 时显示。 |
last_known_ide_ | string | 是 | 对该版本进行采样时的时间戳(ISO 8601)。 |
last_known_plugin_ | object | 是 | 针对该用户检测到的最新 Copilot 扩展,表示为 { plugin, plugin_version, sampled_at }。 对于聚合明细行,省略。 |
last_known_plugin_ | string | 否 | 扩展名称(例如, copilot 或 copilot-chat)。 在存在 last_known_plugin_ 时显示。 |
last_known_plugin_ | string | 否 | 扩展程序版本字符串。 在存在 last_known_plugin_ 时显示。 |
last_known_plugin_ | string | 是 | 对该版本进行采样时的时间戳(ISO 8601)。 |
Copilot CLI 指标字段
当存在 totals_by_cli 用法时,Copilot CLI 对象包含以下嵌套字段;如果没有 CLI 用法,则会省略该对象。 CLI 的使用情况独立于 IDE 指标;它不会反映在诸如 totals_by_ide 或 totals_by_feature 等字段中。 该 last_known_cli_version 对象仅显示在每用户报表中。
| 字段 | 类型 | 可为 Null | Description |
|---|---|---|---|
totals_by_cli.session_ | integer | 否 | 当天启动的不同 CLI 会话数。 |
totals_by_cli.request_ | integer | 否 | 这一天通过 CLI 发出的 Copilot 请求总数,包括用户发起的提示和自动代理后续调用。 |
totals_by_cli.prompt_ | integer | 否 | 在会话中执行的用户提示、命令或查询总数。 |
totals_by_cli.token_ | integer | 否 | 这一天在所有 CLI 请求中生成的输出令牌总数。 |
totals_by_cli.token_ | integer | 否 | 这一天在所有 CLI 请求中发送的提示令牌总数。 |
totals_by_cli.token_ | number | 是 | 每个 CLI 请求的平均输出和提示令牌数(计算为 (output_tokens_)。 当天没有请求时,则为 Null。 |
totals_by_cli.last_ | object | 否 | 当天针对该用户检测到的最新 Copilot CLI 版本,表示为 { cli_version, sampled_at }。 仅限每用户报告。 |
totals_by_cli.last_ | string | 否 | |
Copilot CLI 版本字符串。 如果未检测到任何版本,则默认为 unknown。 | |||
totals_by_cli.last_ | string | 是 | 对该版本进行采样时的时间戳(ISO 8601)。 |
Copilot CLI 自定义字段(仅限 API)
这些指标使企业和组织管理员能够了解开发人员使用哪些 Copilot CLI 自动化。 使用它们来了解采纳情况、识别赋能方面的缺口,并确定开发者认为有价值的技能、模型上下文协议(MCP)服务器、自定义代理、斜杠命令和插件的优先级。
若要访问报告, Copilot 必须启用使用情况指标策略。 有关策略配置说明,请参阅:
这些字段显示在以下企业和组织报告中:
- 每用户 1 天和 28 天报表
- 聚合的 1 天报表
- 28 天汇总报告中的每条
day_totals记录
每个 totals_by_* 数组最多包含五个条目,这些条目是其记录中活动记录数最多的条目,并按从高到低的顺序排列 interaction_count。 这些值是事件计数,而不是用户计数。 数组中缺少条目并不意味着它没有使用。 不要使用这些数组来计算确切的采用率。
当可用时,可显示已识别的第一方名称。 不公开客户定义的标识符。 技能、自定义代理、MCP 服务器以及仅通过客户特定哈希值识别的插件,在数组中归类到 other 项下。
Copilot CLI 遥测将客户定义的斜杠命令报告为 custom,因此斜杠命令数组会保留该值。
每个数组项都包含表中列出的名称字段和整数 interaction_count 字段。
| Array | 名称字段 |
interaction_count 衡量的内容 | 非重复计数字段 |
|:--|:--|:--|:--|
| totals_by_skill[] | skill | 技能调用。 | distinct_skill_use_count |
| totals_by_custom_agent[] | custom_agent | 自定义代理启动。 | distinct_custom_agent_use_count |
| totals_by_mcp[] | mcp | 成功或失败的 MCP 服务器连接和重新连接尝试。 通过已连接的服务器进行的工具调用不会增加此计数。 | distinct_mcp_use_count |
| totals_by_slash_cmd[] | slash_cmd | 斜杠命令调用。 | distinct_slash_cmd_use_count |
| totals_by_plugin[] | plugin | 与插件关联的技能调用。 插件交互是技能交互的子集。 | distinct_plugin_use_count |
每个插件交互都已包含在 totals_by_skill内,而未与插件关联的技能交互仅显示在技能总数中。 不要将插件交互次数和技能交互次数相加。
去重计数字段统计的是有活动的不同项目标识符,而不是用户或使用次数。 在每用户记录中,用户使用的每个不同标识符计数一次。 在汇总后的企业或组织记录中,在该范围内任何人使用的每种不同标识符均仅计一次,无论有多少用户使用过它。 聚合的非重复计数不是每用户非重复计数的总和。
去重计数会保留标识符的完整基数,包括前五项数组之外的项目。 当客户定义的工件归入 other 下时,每个隐藏标识符仍会分别计入对应的去重计数。
当这些字段存在时,空数组和非重复的 0 计数表示没有记录到匹配的活动。 在发布期间,如果 Copilot CLI 自定义数据不可用,这些字段可能为 null 或缺失。
Copilot app 指标字段
当存在Copilot app用法时,totals_by_copilot_app对象包含以下嵌套字段。 它会显示在单个用户报告和企业汇总报告中;如果用户或企业在当天没有 Copilot app 活动,则该项会被省略或为空值。 与 totals_by_cli 不同,Copilot app 编码活动也反映在 copilot_app 功能值下的 totals_by_feature、totals_by_model_feature、totals_by_language_feature 和 totals_by_language_model 中,以及顶层代码活动和代码行数指标中。 没有 last_known_app_version 字段。
| 字段 | 类型 | 可为 Null | Description |
|---|---|---|---|
totals_by_copilot_ | integer | 否 | 当天发起的 Copilot app 会话的非重复数量。 |
totals_by_copilot_ | integer | 否 | 当天通过 Copilot 向 Copilot app 发出的请求总数,包括用户发起的提示和智能体自动发起的后续调用。 |
totals_by_copilot_ | integer | 否 | 在会话中执行的用户提示、命令或查询总数。 |
totals_by_copilot_ | integer | 否 | 当天所有 Copilot app 请求生成的输出令牌总数。 |
totals_by_copilot_ | integer | 否 | 当天所有 Copilot app 请求中发送的提示令牌总数。 |
totals_by_copilot_ | number | 是 | 每个 Copilot app 请求的输出令牌与提示令牌的平均值,按 (output_tokens_ 计算。 当天没有请求时,则为 Null。 |
VS Code 代理窗口指标字段
专用 VS Code 代理窗口字段显示在企业、组织、企业用户和组织用户 1 天和 28 天报表中。 在聚合的 28 天报表中,它们会显示于每个适用的 day_totals 条目下,并且每周和每月计数是相对于每个条目的 day 计算的。 在按用户划分的 28 天报告中,它们出现在每个用户记录的顶层。
这些字段不同于编辑器窗口代理模式,包括used_agent``monthly_active_agent_users和chat_panel_agent_mode``agent_edit特征值。 专用代理窗口活动不包括在泛型顶级活动总数或维度细分中,例如 totals_by_feature, totals_by_model_feature或 totals_by_ai_adoption_phase。
如果没有可用的专用代理窗口数据,则可以省略每日计数和每用户字段。 当任一时间段内没有符合条件的活动时,将省略每周字段和每月字段。 如果一个时间段具有限定活动,另一个时间段没有,则非活动时段的 0值为 。 仅当两个嵌套计数都可用时,才会显示该 totals_by_vscode_agent 对象,包括当两个计数均为零时。
| 字段 | 类型 | 可为 Null | Description |
|---|---|---|---|
daily_active_ | integer | 是 | 当天使用专用 VS Code 代理窗口的唯一用户数。 仅限企业和组织的汇总报表。 |
weekly_active_ | integer | 是 | 从周日至报表日(含当日)期间使用专用坐席窗口的唯一用户数。 仅限企业和组织的汇总报表。 |
monthly_active_ | integer | 是 | 自日历月第一天起至报表日(含当日)使用 Agents 专用窗口的唯一用户数。 仅限企业和组织的汇总报表。 |
used_vscode_agent | boolean | 是 | 用户在报告期间是否使用了专用 VS Code 代理窗口。 仅限企业用户和组织用户报告。 |
totals_by_vscode_ | object | 是 | 专用 VS Code 代理窗口的会话和用户消息总计。 |
totals_by_vscode_ | integer | 否 | 记录中表示的不同代理窗口会话数。 当存在 totals_by_vscode_ 时,为必需项。 |
totals_by_vscode_ | integer | 否 | 记录中显示的 Agents 窗口中发送的用户消息数量。 当存在 totals_by_vscode_ 时,为必需项。 |
Agent apps 指标字段
注意
Agent apps are currently in 公开预览 and subject to change.
totals_by_3rd_party_agent 数组会为报告期内使用过的每个已识别 agent app 各记录一个条目。 条目按 agent_id 分组,映射到同一代理的集成项会合并显示。 使用 agent_id 作为稳定的分组键,使用 agent_name 进行显示。 在报告期间没有可用的识别 agent app 活动时,将省略该数组。
这些指标来自服务器端作业活动。 嵌套的 user_initiated_interaction_count 用于统计 agent app 作业启动次数,它不同于同名的顶层字段;后者统计的是来自其他受支持遥测数据的显式提示。
| 字段 | 类型 | 可为 Null | Description |
|---|---|---|---|
totals_by_3rd_ | string | 否 | |
agent app 的显示名称。 名称可能会更改,因此请使用 agent_id 进行分组。 | |||
totals_by_3rd_ | string | 否 | |
| agent app的稳定标识符。 | |||
totals_by_3rd_ | integer | 否 | 报告期内为 agent app 启动的用户发起的作业数量。 每次作业启动时,计数都会增加一次。 |
totals_by_3rd_ | integer | 否 | 报告期内,映射到该智能体的集成的非空会话的非重复数量合计。 仅包含在聚合的企业和组织报表中;从每用户报表中省略。 |
拉取请求活动字段
重要
由于用户重复数据删除和归因时间差异,组织和企业级报告可能会显示不同的总计。 有关跨范围拉取请求指标解释指南,请参阅 GitHub Copilot使用情况指标。
该 pull_requests 对象显示在聚合的企业和组织报表以及存储库级报表中。 它会记录每日与拉取请求创建、评审、合并和建议相关的活动,包括由 Copilot cloud agent 和 Copilot code review 执行的活动。
| 字段 | 类型 | 可为 Null | Description |
|---|---|---|---|
pull_requests.total_ | integer | 否 | 在此特定日期创建的拉取请求总数。 创建是一次性事件。 每一条拉取请求仅在其创建当日才会被计入统计。 |
pull_requests.total_ | integer | 否 | 在此特定日期查看的拉取请求总数。 如果同一个拉取请求在多天内收到评审,那么它可能会被计入多个日期的统计中。 在一天内,即使发生多个评审操作,每个拉取请求也仅计数一次。 |
pull_requests.total_ | integer | 否 | 在此特定日期合并的拉取请求总数。 合并是一次性事件。 每个拉取请求仅在合并当天计数。 |
pull_requests.median_ | number | 是 | 特定日期合并的拉取请求从创建到合并的中位时间(以分钟为单位)。 使用中位数是为了减少异常长时间运行的拉取请求的异常值影响。 当天未合并拉取请求时为 Null。 |
pull_requests.total_ | integer | 否 | 特定日期生成的拉取请求审查建议总数,与作者无关。 |
pull_requests.total_ | integer | 否 | 特定日期应用的拉取请求审查建议总数,与作者无关。 |
pull_requests.total_ | integer | 否 | |
| Copilot cloud agent 在此特定日期创建的拉取请求数。 | |||
pull_requests.total_ | integer | 否 | |
| Copilot code review 在此特定日期审查的拉取请求数。 如果 Copilot code review 在多个日期审查了同一拉取请求,则该请求可能会被重复计入多个日期。 | |||
pull_requests.total_ | integer | 否 | 由 Copilot cloud agent 创建且在此特定日期合并的拉取请求数。 每个拉取请求仅在合并当天计数。 |
pull_requests.total_ | integer | 否 | 报告期间由 Copilot code review 合并且审查的拉取请求数。 |
pull_requests.median_ | number | 是 | 由 Copilot cloud agent 创建且在此特定日期合并的拉取请求从创建到合并的中位时间(分钟)。 当天未合并此类拉取请求时为 Null。 |
pull_requests.median_ | number | 是 | 从创建到合并的中位时间(分钟),仅统计由 Copilot code review 审查的拉取请求。 当天未合并此类拉取请求时为 Null。 |
pull_requests.total_ | integer | 否 | 由 Copilot code review 在此特定日期生成的拉取请求审查建议数。 |
pull_requests.total_ | integer | 否 | 由 Copilot code review 生成且在此特定日期应用的拉取请求审查建议数。 |
pull_requests.copilot_ | array | 否 | 按所分配的批注类型(例如 Copilot code review 或 security)细分的 bug_risk 建议的汇总计数。 每个条目包括 comment_type、 total_copilot_和 total_copilot_。 始终存在,但可以为空。 |
拉取请求评审时间字段
该 pull_request_review_times 数组仅显示在存储库级报表中。 它将已合并的拉取请求在审查三个阶段分别花费的时间细分展示出来,以便你了解拉取请求是在等待首次评审、等待评审者之间反复沟通,还是在最终评审后等待合并。
每个条目都涵盖在此特定日期合并到存储库中的拉取请求。 所有持续时间都归于合并当日,即使审核发生在更早的日期也是如此。
哪些拉取请求会被计入
一个拉取请求会在满足以下条件时被计入:有人创建了该拉取请求、它进入了可供审查状态,并且至少有另一人审查了它。 只有人工审核会被计时。 来自 Copilot code review、其他机器人以及拉取请求作者的评审将被忽略,因此,如果某个拉取请求同时经过人工和 Copilot code review 的评审,它仍会被纳入统计,其各阶段的计时以人工评审为准。 在第一次审查之前在草稿中花费的时间不计为计数。
当以下任一条件为真时,已合并的拉取请求将从 pull_request_review_times 中排除:
- 它是由一个机器人程序创建的,其中包括 Copilot cloud agent。
- 它从未收到合格的人工评审,包括未经任何评审合并的拉取请求。
- 其何时准备好供审核尚不清楚。
- 其时间戳无序。 例如,其最终评审是在合并后才记录的。
对于单个拉取请求,不报告排除项。 由于 pull_requests.total_merged 会统计当天合并的每个拉取请求,因此 pull_request_review_times[].total_merged 通常会更低。 比较这两个值,查看这些时长涵盖了多少个已合并的拉取请求。
数据可用性
- 数据自这些字段发布起开始生成,且不会回填。
- 在 2026 年 9 月 21 日之前变为可供审查的拉取请求不包含在此数组中,但仍计入
pull_requests.total_merged。 - 在仓库未合并任何符合条件的拉取请求的日子里,该数组为空(
[])。 空数组表示当天没有数据,而不是零分钟。
| 字段 | 类型 | 可为 Null | Description |
|---|---|---|---|
pull_request_ | string | 否 | 谁打开了此条目中的拉取请求。 当前始终为 human。 |
pull_request_ | string | 否 | 谁查看了此条目中的拉取请求。 当前始终为 human。 |
pull_request_ | integer | 否 | 该存储库在此特定日期合并的符合条件的拉取请求数量。 这仅统计上述拉取请求,不包括所有已合并的拉取请求。 |
pull_request_ | number | 否 | 从拉取请求开始审查到其第一次合格评审的中值时间(以分钟为单位)。 |
pull_request_ | number | 否 | 从拉取请求变为可供评审到其首次符合条件的评审之间的第 90 百分位用时(以分钟为单位)。 |
pull_request_ | number | 否 | 从第一次资格评审到最终资格审查的中位数时间(以分钟为单位)。 只有一次合格评审的拉取请求贡献的时长为 0,因为其首次评审和最终评审是同一个事件。 |
pull_request_ | number | 否 | 第90百分位时间,以分钟为单位,从第一次资格审查到最终资格审查。 只有一条合格评审的拉取请求,其持续时间为 0,因为其首次评审和最终评审是同一事件。 |
pull_request_ | number | 否 | 从最终资格评审到合并的中值时间(以分钟为单位)。 |
pull_request_ | number | 否 | 从最终合格评审到合并所需时间的第 90 百分位值(单位:分钟)。 |
中位数和第 90 百分位数是通过线性插值计算得出的精确值,并保留两位小数。
AI 采用阶段字段
Copilot 根据用户的活动将用户分组到 AI 采用阶段。 阶段信息出现在两个位置:每个用户的 ai_adoption_phase 对象,以及聚合的 totals_by_ai_adoption_phase 数组。 有关阶段值,请参阅细分维度值。
分类逻辑
用户根据他们 参与 的 Copilot 功能被归类到某个阶段。 如果用户在过去 28 天窗口内至少在两个不同的日期使用过该功能,则视为该用户对该功能处于活跃状态。 参与度是根据下表中的功能级别活动信号评估的,而不是直接根据单日 used_*每用户字段或 code_acceptance_activity_count 进行评估。 阶段是从上到下评估的,用户被分配到他们有资格的最高阶段。
| 阶段 | 参与标准 |
|---|---|
| 无群组(在影响仪表板中显示为“被动用户”) | 用户未参与任何符合阶段条件的功能。 这并不意味着用户处于非活动状态。 该组中的用户仍可能经常使用 Copilot 并消耗高级请求,但在过去 28 天的统计窗口内,未曾在至少两个不同的日期使用过符合条件的功能。 最常见的情况是对话使用 Copilot Chat 或代理模式,记录为 chat_panel_agent_,永远不会产生 code_completion 或 agent_edit 活动。 将代码从聊天响应中复制也不会产生任何信号。 |
| 阶段 1:代码优先 | 使用过内联代码补全(即 feature 维度的 code_completion 值),或使用过直接写入文件的智能体编辑(即 feature 维度的 agent_edit 值)。 |
| 阶段 2:代理优先 | 仅使用了某一个基于 GitHub 的智能体界面:Copilot CLI(feature 维度的 copilot_cli 值)、Copilot cloud agent (used_copilot_),或 Copilot code review(used_copilot_ 或 used_copilot_)。 主动和被动 Copilot code review 合并计为一个表面。 |
| 阶段 3:多代理 | 使用过 Copilot app(即 feature 维度中的 copilot_app 值),或使用过为第 2 阶段列出的两个或更多智能体界面。 |
用户只需与某个阶段自身的信号发生交互,即可进入该阶段。 用户无需单独满足第 1 阶段的标准即可进入第 2 阶段或第 3 阶段,尽管在实际情况下,智能体界面的使用通常会与补全或智能体编辑同时出现。
在代理图面中,只有表中列出的第一方图面会影响用户的 AI 采用阶段。 来自合作伙伴构建的 agent apps 的活动不会影响该阶段。 相同的分类逻辑适用于企业和组织报表,包括 1 天报表和 28 天报表。
注意
由于分类使用功能级参与,因此某些活动本身不会影响用户的阶段。 除非用户生成code_completion或agent_edit活动,否则使用 IDE 聊天(used_chat)或代理模式(used_agent)不符合第 1 阶段的条件。
例如,在代理模式下提出问题而不让 Copilot 编辑你的文件,记录的是 chat_panel_agent_mode 活动,而不是 agent_edit。 如果某个用户的用法完全是这种对话式用法,即使该用户正在积极使用 Copilot,并且仍可能产生高级请求使用量,也仍会留在“无队列”组中。 同样,code_acceptance_activity_count 包括基于聊天的接受操作,例如“应用到文件”以及复制按钮,这些不属于内联 code_completion 活动,因此不用于分类。 有关feature维度的更多信息,请参阅细分维度值。
系统会基于过去 28 天的滚动窗口每天重新计算阶段划分,因此,随着用户在该窗口内的活动发生变化,其阶段可能会从一天到下一天发生变化。 这是预期行为,并不指示数据错误。
每个用户的 ai_adoption_phase 对象包含:
| 字段 | 类型 | 可为 Null | Description |
|---|---|---|---|
ai_adoption_phase.phase_ | integer | 否 | 数字阶段标识符(例如, 0 “无队列”)。 |
ai_adoption_phase.phase | string | 否 | 人类可读的阶段名称。 |
ai_adoption_phase.version | string | 否 | 使用的采用阶段模型的版本(例如 v1)。 |
聚合 totals_by_ai_adoption_phase 数组中的每个条目都包含两个单独的用户计数:
total_engaged_users是指被归类到该阶段且在该具体日期活跃的用户数量。users_in_phase_28d是使用滚动的 28 天窗口(截至当天)划分为阶段的完整总体。
将 users_in_phase_28d 用作滚动阶段级计算的总体基数。 例如,要计算每个用户在 28 天内合并的拉取请求数:
- 添加每日
total_pull_requests_merged值。 - 添加相应的每日
users_in_phase_28d值。 - 将第一个总计除以第二个,然后将结果乘以 28。
请勿将 total_engaged_users 用作分母,因为其中仅包含在某一天活跃的用户。
该字段不会更改现有 avg_* 字段或其计算、阶段分类规则或用户分配的阶段。 两个用户计数字段都无法标识个人。
当滚动快照中存在某个阶段但该阶段在当天没有任何活动时,报表可以包含一个合成条目,其中 0 设置为 users_in_phase_28d,total_engaged_users 为正值,并且所有活动指标均设置为零。
| 字段 | 类型 | 可为 Null | Description |
|---|---|---|---|
phase | string | 否 | 人类可读的阶段名称。 |
phase_number | integer | 否 | 数字阶段标识符。 |
total_engaged_ | integer | 否 | 被归类到此阶段且在当天活跃的用户数。 |
users_in_phase_ | integer | 是 | 截至当日,被归类到该阶段的滚动 28 天总人数。 正值是测量的阶段总体, 0 表示已测量该阶段且没有用户。 当日期早于此字段,或者企业或组织未出现在阶段快照中时,该字段会被省略。 |
avg_user_initiated_ | number | 否 | 此阶段每个用户平均发起的交互数。 |
avg_code_generation_ | number | 否 | 此阶段每个用户的平均代码生成活动。 |
avg_code_acceptance_ | number | 否 | 此阶段每个用户的平均代码接受活动。 |
avg_loc_added | number | 否 | 此阶段中平均每位用户新增的代码行数。 |
avg_loc_deleted | number | 否 | 此阶段每个用户平均删除的代码行数 |
avg_pull_requests_ | number | 否 | 在此阶段,每用户平均评审的拉取请求数。 |
avg_pull_requests_ | number | 否 | 此阶段每位用户创建的平均拉取请求数。 |
avg_pull_requests_ | number | 否 | 在此阶段,每用户平均合并的拉取请求数。 |
total_pull_requests_ | integer | 否 | 此阶段用户合并的拉取请求总数。 适用于组织日和企业日聚合报告。 |
avg_pull_requests_ | number | 否 | 在此阶段,用户的“每用户合并时间中位数(分钟)”的平均值。 |
avg_pull_requests_ | number | 否 | 从拉取请求创建到首次评审的中位时间(分钟),范围限定为已合并的拉取请求,并归属于该拉取请求的合并日期。 |
avg_pull_requests_ | number | 否 | 每个拉取请求的评审提交次数(评审周期)的中位数,范围限定为已合并的拉取请求,并归属到该拉取请求的合并日期。 |
细分维度值
上面的细分对象使用其值来自固定集的维度字段。 这些是字段 值,而不是单独的字段。 例如,agent_edit 和 chat_panel_*_mode 的值是 feature 字段的值,而不是顶层字段。
维度 feature 标识 Copilot 活动所归因于的功能或模式:
| 价值 | Description |
|---|---|
code_completion | 内联代码补全。 |
chat_inline | 编辑器内的内联对话。 |
chat_panel_ask_ | 聊天面板在选择“提问”模式时的交互。 |
chat_panel_edit_ | 聊天面板与所选编辑模式交互。 |
chat_panel_agent_ | 选择智能体模式时的聊天面板交互。 |
chat_panel_plan_ | 选择计划模式时的聊天面板交互。 |
chat_panel_custom_ | 已选择自定义代理时的聊天面板交互 |
chat_panel_unknown_ | 模式未知时的聊天面板交互。 |
agent_edit | 在 Copilot(智能体和编辑模式下)将更改直接写入 IDE 中的文件时添加和删除的行。 也会统计来自自定义代理的编辑操作。 |
agent_edit 不包含在基于建议的指标中,并且可能不会填充建议样式字段,例如 user_initiated_。 | |
copilot_cli | 归因于 Copilot CLI 的活动 |
copilot_app | 归因于 Copilot 应用的活动。 |
others | 上述值未涵盖的任何功能。 |
ide 维度用于标识活动发生所在的 IDE。 这不是详尽的列表,但观察到的值的示例包括vscode:、visualstudio、intellij``eclipse``xcode``neovim、 vim``emacs和。zed
维度 model 标识用于聊天活动的 AI 模型。 值包括特定的模型标识符(例如,gpt-5.4或claude-sonnet-4.6),auto``unknown和others。
auto 值表示使用了 auto model selection 的活动,且该请求未归属于特定模型。
phase维度标识用户被归入的 AI 采用阶段:No Cohort、Phase 1、Phase 2 或 Phase 3。