Copilot使用情况指标中提供的数据

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
参与趋势	在过去六个月中，组织的采用队列组合和拉取请求吞吐量（每月合并的拉取请求总数）是如何变化的。
采用同期群分布	在该期间内，按各采用阶段（被动用户、第 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和org-1-day）包含每个企业或组织的一个聚合记录，包括活动用户计数和pull_requests``totals_by_ai_adoption_phase。它们不包含user_id或user_login``used_*指示器。
28 天报告（enterprise-28-day 和 org-28-day）会在 day_totals 字段中封装一组按天聚合的记录，而报告时间范围位于顶层。
用户团队报表 （*-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。仅包含在组织范围报表中;从企业范围报表中省略。
`etl_id` / `day_partition`	`string`	否	用于维护的分区字段。包含在导出的 NDJSON 文件中，并由使用情况指标 API 返回。
`entity_id_partition`	`integer`	否	用于维护的实体分区。包含在导出的 NDJSON 文件中，并由使用情况指标 API 返回。

每位用户的报表字段

每用户报表包含报告期间每个用户的一条记录。每个用户的 28 天报表还包括 report_start_day 和 report_end_day 标记报告窗口。

字段	类型	可为 Null	Description
`user_id`	`integer`	否	用户的唯一标识符。
`user_login`	`string`	否
GitHub 用户的用户名。
`ai_credits_used`	`number`	否	报告期间用户消耗的 AI 信用额度总数。此字段仅包含在每用户报表中，并且不会按功能、模型或图面细分。此指标用于消耗分析，而不是开票总计。
`user_initiated_interaction_count`	`integer`	否	发送到 Copilot的显式提示数。仅对主动发送到模型的消息或提示进行计数。
不包括打开聊天面板、切换模式（例如询问、编辑、计划或代理）、使用键盘快捷键打开内嵌 UI 或进行配置更改。
`code_generation_activity_count`	`integer`	否	生成的不同 Copilot 输出事件数。
包括：所有生成的内容，包括注释和文档字符串。
多个块：单个用户提示中的每个不同代码块都计为单独的生成。
注意：此指标不直接可比 `user_initiated_interaction_count`，因为一个提示可以生成多代。
`code_acceptance_activity_count`	`integer`	否	用户接受的建议或代码块数。
计数内容：所有内置的接受操作，如“应用到文件”“插入到光标”“插入到终端”以及使用复制按钮。
不计数：操作系统的手动剪贴板操作（例如 `Ctrl`+`C`）。
粒度：无论初始提示生成多少个代码块，每个接受操作都会使计数递增一次。
`loc_suggested_to_add_sum`	`integer`	否	建议添加的代码行数 Copilot（补全、内联聊天、聊天面板等；不包括代理编辑）。
`loc_suggested_to_delete_sum`	`integer`	否
Copilot 建议删除的代码行（未来计划支持）。
`loc_added_sum`	`integer`	否	实际添加到编辑器中的代码行数（已接受的补全、已应用的代码块、Agent 模式和编辑模式）。
`loc_deleted_sum`	`integer`	否	从编辑器中删除的代码行（当前来自代理修改）。
`used_agent`	`boolean`	否	用户当天是否在 IDE 中使用代理模式。不包括 Copilot code review 活动，该活动在 `used_copilot_code_review_active` 和 `used_copilot_code_review_passive` 中单独捕获。
`used_chat`	`boolean`	否	用户当天是否使用 IDE 聊天。
`used_cli`	`boolean`	否	用户当天是否使用了 Copilot CLI 。
`used_copilot_app`	`boolean`	否	用户当天是否使用了 Copilot app。
`used_copilot_coding_agent`	`boolean`	否	用户当天是否使用了Copilot cloud agent（以前Copilot编码代理）。
`used_copilot_cloud_agent`	`boolean`	否	用户当天是否使用了 Copilot cloud agent 。其值与 `used_copilot_coding_agent` 相同；为保持向后兼容性，保留了这两个名称。
`used_copilot_code_review_active`	`boolean`	是	用户当天是否主动与 Copilot code review 进行过交互。如果用户手动请求 Copilot 评审或应用 Copilot 了评审建议，则被视为处于活动状态。如果该用户当天没有 Copilot code review 信号，则为 Null。
`used_copilot_code_review_passive`	`boolean`	是	用户当天是否在未主动参与评审的情况下，被自动分配Copilot去审查其拉取请求。如果该用户当天没有 Copilot code review 信号，则为 Null。
`ai_adoption_phase`	`object`	否	用户当日的 AI 采用阶段。始终存在;默认为“无队列”阶段。请参阅 AI 采用阶段字段。
`totals_by_cli`	`object`	是	用户的 CLI 专用指标。当用户当天未使用 Copilot CLI 时，则省略。查看 Copilot CLI 指标字段。
`totals_by_copilot_app`	`object`	是
Copilot app 面向用户的指标。当用户当天未使用 Copilot app 时，则省略。查看 Copilot app 指标字段。
`totals_by_3rd_party_agent`	`array`	是	已识别的 agent apps 的各代理使用指标。在报告期间用户没有识别 agent app 的活动时省略。查看 Agent apps 指标字段。
`totals_by_ide`	`array`	否	按 IDE 划分的用户活动明细。请参阅活动细分对象。
`totals_by_feature`	`array`	否	用户活动的按功能细分。请参阅活动细分对象。
`totals_by_language_feature`	`array`	否	结合语言和功能维度的细分方法。请参阅活动细分对象。
`totals_by_language_model`	`array`	否	按语言和模型维度组合划分的聊天活动细分情况。请参阅活动细分对象。
`totals_by_model_feature`	`array`	否	对聊天活动的模型和功能维度进行细分。请参阅活动细分对象。

聚合的企业和组织报表字段

聚合报表包含每个企业或组织的一条记录，汇总当天的所有用户。活动用户计数包括通过客户端和服务器端遥测标识的用户。仅通过服务器端遥测发现的用户会计入活跃用户总数中，但可能不会出现在维度细分数组（totals_by_ide、totals_by_feature等）中。下表列出了活动用户计数，然后列出活动总数和细分。

活跃用户数量：

字段	类型	可为 Null	Description
`daily_active_users`	`integer`	否	在给定日期使用 Copilot 的唯一用户数。
`weekly_active_users`	`integer`	否	在过去七天窗口期内使用 Copilot 的独立用户数。
`monthly_active_users`	`integer`	否	在过去 28 天窗口期内使用 Copilot 的唯一用户数。
`monthly_active_chat_users`	`integer`	否	过去 28 天内使用聊天功能的唯一用户数。
`monthly_active_agent_users`	`integer`	否	过去 28 天窗口期内使用代理模式的独立用户数。
`daily_active_copilot_cloud_agent_users`	`integer`	否	在给定日期使用 Copilot cloud agent 的唯一用户数。
`weekly_active_copilot_cloud_agent_users`	`integer`	否	在过去七天窗口期内使用 Copilot cloud agent 的独立用户数。
`monthly_active_copilot_cloud_agent_users`	`integer`	否	在过去 28 天窗口期内使用 Copilot cloud agent 的唯一用户数。
`daily_active_copilot_code_review_users`	`integer`	否	在给定日期主动使用 Copilot code review 的唯一用户数。主动使用意味着手动请求评审或应用建议。当用户在同一时间段内同时具有主动和被动信号时，它们仅算作主动信号。
`weekly_active_copilot_code_review_users`	`integer`	否	在最近七天内主动使用 Copilot code review 的唯一用户数量。当用户在同一时间段内同时具有主动和被动信号时，它们仅算作主动信号。
`monthly_active_copilot_code_review_users`	`integer`	否	在过去 28 天的时间段内活跃使用 Copilot code review 的唯一用户数。当用户在同一时间段内同时具有主动和被动信号时，它们仅算作主动信号。
`daily_passive_copilot_code_review_users`	`integer`	否	在给定日期，其拉取请求被自动分配了 Copilot code review 审查，且本人无活跃参与的唯一用户数。
`weekly_passive_copilot_code_review_users`	`integer`	否	在最近七天内，其拉取请求被自动分配了 Copilot code review 审查，且本人无活跃参与的唯一用户数。
`monthly_passive_copilot_code_review_users`	`integer`	否	在最近 28 天内，其拉取请求被自动分配了 Copilot code review 审查，且本人无活跃参与的唯一用户数。
`daily_active_cli_users`	`integer`	是	在给定日期使用 Copilot CLI 的唯一用户数。此计数独立于 IDE 活动用户计数，并且不包括在基于 IDE 的活动用户定义中。当天未使用 CLI 的企业或组织省略。
`daily_active_copilot_app_users`	`integer`	是	在给定日期使用 Copilot app 的唯一用户数。当企业或组织在当天没有 Copilot app 活动时，为“Null”。

活动总计和细分：

字段	类型	可为 Null	Description
`user_initiated_interaction_count`	`integer`	否	当天所有用户发送给 Copilot 的显式提示总数。
`code_generation_activity_count`	`integer`	否	一天中所有用户生成的非重复 Copilot 输出事件总数。
`code_acceptance_activity_count`	`integer`	否	一天中所有用户接受的建议或代码块总数。
`loc_suggested_to_add_sum`	`integer`	否	当天建议添加的汇总代码行数。定义与按用户划分的字段相同。
`loc_suggested_to_delete_sum`	`integer`	否	当日建议删除的代码行总数。定义与按用户划分的字段相同。
`loc_added_sum`	`integer`	否	当天新增代码行总数定义与按用户划分的字段相同。
`loc_deleted_sum`	`integer`	否	当天累计删除的代码行数定义与按用户划分的字段相同。
`totals_by_ide`	`array`	否	按 IDE 汇总的活动明细。请参阅活动细分对象。
`totals_by_feature`	`array`	否	按功能汇总的活动明细。请参阅活动细分对象。
`totals_by_language_feature`	`array`	否	按语言和功能划分的汇总活动明细。请参阅活动细分对象。
`totals_by_language_model`	`array`	否	按语言和模型汇总的活动细分统计。请参阅活动细分对象。
`totals_by_model_feature`	`array`	否	聚合的模型和特征活动细分。请参阅活动细分对象。
`totals_by_cli`	`object`	是	当天汇总的 Copilot CLI 指标。当天没有 CLI 使用时则省略。与按用户划分的表单不同，它不包含 `last_known_cli_version`。查看 Copilot CLI 指标字段。
`totals_by_copilot_app`	`object`	是	当天汇总的 Copilot app 指标。当企业或组织在当天没有 Copilot app 活动时，为“Null”。查看 Copilot app 指标字段。
`totals_by_3rd_party_agent`	`array`	是	针对已识别的 agent apps 的按代理聚合使用指标。当企业或组织当天没有已识别的 agent app 活动时，则省略。查看 Agent apps 指标字段。
`totals_by_ai_adoption_phase`	`array`	是	按阶段汇总的用户数及其平均活跃度在没有可用的采用阶段数据时省略。请参阅 AI 采用阶段字段。
`pull_requests`	`object`	否	企业或组织的每日拉取请求情况。请参阅拉取请求活动字段。

28天报表字段

28 天报表（enterprise-28-day 和 org-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）。
`day_totals`	`array`	否	按日聚合记录的数组。每个条目都具有与聚合的 1 天报表相同的字段。请参阅聚合企业和组织报表字段。

用户团队字段

这些字段显示在每日用户团队报表（通过组织和企业范围的 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`	否	存储库的每日拉取请求活动。请参阅拉取请求活动字段。

活动细分对象

这些 totals_by_* 字段是细分对象的数组。数组始终存在，但可以为空。在每个对象中，指标字段（*_count 和 loc_*_sum）遵循与顶级每个用户字段相同的定义，维度字段携带 “细分”维度值中记录的值。

对象	维度字段	Description
`totals_by_ide[]`	`ide`	按 IDE 细分。在按用户划分的报表中，每个条目还包括 `last_known_ide_version` 和 `last_known_plugin_version`。
`totals_by_feature[]`	`feature`	按 Copilot 功能细分（例如内联聊天或聊天面板）。
`totals_by_language_feature[]`
`language`、`feature`	按语言和功能组合进行细分。不包括 `user_initiated_interaction_count`。
`totals_by_language_model[]`
`language`、`model`	按语言和模型组合的聊天活动细分（不包括补全）
`totals_by_model_feature[]`
`model`、`feature`	针对聊天活动（而非补全）按模型和功能组合进行细分。

在每用户报表中，每个 totals_by_ide[] 条目还会报告用户最近检测到的 IDE 和 Copilot Chat 扩展版本。

字段	类型	可为 Null	Description
`last_known_ide_version`	`object`	是	为用户检测到的最新 IDE 版本，如下所示 `{ ide_version, sampled_at }`。对于聚合细分行（例如有上限的“其他”IDE 分组），将省略。
`last_known_ide_version.ide_version`	`string`	否	IDE 版本字符串。在存在 `last_known_ide_version` 时显示。
`last_known_ide_version.sampled_at`	`string`	是	对该版本进行采样时的时间戳（ISO 8601）。
`last_known_plugin_version`	`object`	是	为用户检测到的最新 Copilot 扩展，如 `{ plugin, plugin_version, sampled_at }`. 对于聚合明细行，省略。
`last_known_plugin_version.plugin`	`string`	否	扩展名称（例如， `copilot` 或 `copilot-chat`）。在存在 `last_known_plugin_version` 时显示。
`last_known_plugin_version.plugin_version`	`string`	否	扩展程序版本字符串。在存在 `last_known_plugin_version` 时显示。
`last_known_plugin_version.sampled_at`	`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_count`	`integer`	否	当天启动的不同 CLI 会话数。
`totals_by_cli.request_count`	`integer`	否	这一天通过 CLI 发出的 Copilot 请求总数，包括用户发起的提示和自动代理后续调用。
`totals_by_cli.prompt_count`	`integer`	否	在会话中执行的用户提示、命令或查询总数。
`totals_by_cli.token_usage.output_tokens_sum`	`integer`	否	这一天在所有 CLI 请求中生成的输出令牌总数。
`totals_by_cli.token_usage.prompt_tokens_sum`	`integer`	否	这一天在所有 CLI 请求中发送的提示令牌总数。
`totals_by_cli.token_usage.avg_tokens_per_request`	`number`	是	每个 CLI 请求的平均输出和提示令牌数（计算为 `(output_tokens_sum + prompt_tokens_sum) ÷ request_count`）。当天没有请求时，则为 Null。
`totals_by_cli.last_known_cli_version`	`object`	否	当天为用户检测到的最新版本 Copilot CLI ，如下所示 `{ cli_version, sampled_at }`。仅限按用户报告。
`totals_by_cli.last_known_cli_version.cli_version`	`string`	否
Copilot CLI 版本字符串。如果未检测到任何版本，则默认为 `unknown`。
`totals_by_cli.last_known_cli_version.sampled_at`	`string`	是	对该版本进行采样时的时间戳（ISO 8601）。

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_app.session_count`	`integer`	否	在这一天启动的不同 Copilot app 会话数。
`totals_by_copilot_app.request_count`	`integer`	否	在这一天，通过Copilot向Copilot app发出的请求总数，包括用户发起的提示和智能体自动发起的后续调用。
`totals_by_copilot_app.prompt_count`	`integer`	否	在会话中执行的用户提示、命令或查询总数。
`totals_by_copilot_app.token_usage.output_tokens_sum`	`integer`	否	当天所有 Copilot app 请求生成的输出令牌总数。
`totals_by_copilot_app.token_usage.prompt_tokens_sum`	`integer`	否	当日所有Copilot app请求中发送的提示词令牌总数。
`totals_by_copilot_app.token_usage.avg_tokens_per_request`	`number`	是	每个 Copilot app 请求的输出和提示令牌的平均值，计算为 `(output_tokens_sum + prompt_tokens_sum) ÷ request_count`。当天没有请求时，则为 Null。

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_party_agent[].agent_name`	`string`	否
agent app 的显示名称。名称可能会更改，因此请使用 `agent_id` 进行分组。
`totals_by_3rd_party_agent[].agent_id`	`string`	否
agent app的稳定标识符。
`totals_by_3rd_party_agent[].user_initiated_interaction_count`	`integer`	否	报告期间为 agent app 启动的用户发起的作业数量。每次作业启动时，计数都会增加一次。
`totals_by_3rd_party_agent[].session_count`	`integer`	否	报告期间映射到代理的集成的非空会话计数之和。仅包含在聚合的企业和组织报表中;从每用户报表中省略。

拉取请求活动字段

重要

由于用户重复数据删除和归因时间差异，组织和企业级报告可能会显示不同的总计。有关跨范围拉取请求指标解释指南，请参阅 GitHub Copilot使用情况指标。

该 pull_requests 对象显示在聚合的企业和组织报表以及存储库级报表中。它会记录每日与拉取请求创建、评审、合并和建议相关的活动，包括由 Copilot cloud agent 和 Copilot code review 执行的活动。

字段	类型	可为 Null	Description
`pull_requests.total_created`	`integer`	否	在此特定日期创建的拉取请求总数。创建是一次性事件。每一条拉取请求仅在其创建当日才会被计入统计。
`pull_requests.total_reviewed`	`integer`	否	在此特定日期查看的拉取请求总数。如果同一个拉取请求在多天内收到评审，那么它可能会被计入多个日期的统计中。在一天内，即使发生多个评审操作，每个拉取请求也仅计数一次。
`pull_requests.total_merged`	`integer`	否	在此特定日期合并的拉取请求总数。合并是一次性事件。每个拉取请求仅在合并当天计数。
`pull_requests.median_minutes_to_merge`	`number`	是	特定日期合并的拉取请求从创建到合并的中位时间（以分钟为单位）。使用中位数是为了减少异常长时间运行的拉取请求的异常值影响。当天未合并拉取请求时为 Null。
`pull_requests.total_suggestions`	`integer`	否	特定日期生成的拉取请求审查建议总数，与作者无关。
`pull_requests.total_applied_suggestions`	`integer`	否	特定日期应用的拉取请求审查建议总数，与作者无关。
`pull_requests.total_created_by_copilot`	`integer`	否
Copilot cloud agent 在此特定日期创建的拉取请求数。
`pull_requests.total_reviewed_by_copilot`	`integer`	否
Copilot code review 在此特定日期审查的拉取请求数。如果 Copilot code review 在多个日期审查了同一拉取请求，则该请求可能会被重复计入多个日期。
`pull_requests.total_merged_created_by_copilot`	`integer`	否	由 Copilot cloud agent 创建且在此特定日期合并的拉取请求数。每个拉取请求仅在合并当天计数。
`pull_requests.total_merged_reviewed_by_copilot`	`integer`	否	报告期间由 Copilot code review 合并且审查的拉取请求数。
`pull_requests.median_minutes_to_merge_copilot_authored`	`number`	是	由 Copilot cloud agent 创建且在此特定日期合并的拉取请求从创建到合并的中位时间（分钟）。当天未合并此类拉取请求时为 Null。
`pull_requests.median_minutes_to_merge_copilot_reviewed`	`number`	是	从创建到合并的中位时间（分钟），仅统计由 Copilot code review 审查的拉取请求。当天未合并此类拉取请求时为 Null。
`pull_requests.total_copilot_suggestions`	`integer`	否	由 Copilot code review 在此特定日期生成的拉取请求审查建议数。
`pull_requests.total_copilot_applied_suggestions`	`integer`	否	由 Copilot code review 生成且在此特定日期应用的拉取请求审查建议数。
`pull_requests.copilot_suggestions_by_comment_type`	`array`	否	按所分配的批注类型（例如 Copilot code review 或 `security`）细分的 `bug_risk` 建议的汇总计数。每个条目包括 `comment_type`、 `total_copilot_suggestions`和 `total_copilot_applied_suggestions`。始终存在，但可以为空。

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_mode`，永远不会产生 `code_completion` 或 `agent_edit` 活动。将代码从聊天响应中复制也不会产生任何信号。
阶段 1：代码优先	通过内联代码补全功能进行交互（即 `feature` 维度的 `code_completion` 值），或通过代理直接写入文件的编辑进行交互（即 `feature` 维度的 `agent_edit` 值）。
阶段 2：代理优先	仅与恰好一个基于 GitHub 的代理界面发生交互：Copilot CLI（`feature` 维度的 `copilot_cli` 值）、Copilot cloud agent（`used_copilot_cloud_agent`），或 `used_copilot_code_review_active`（Copilot code review 或 `used_copilot_code_review_passive`）。主动和被动 Copilot code review 合并计为一个表面。
阶段 3：多代理	与 `feature` 维度的 `copilot_app` 值（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，并且仍可能产生高级请求用量，也仍会留在“无 Cohort”组中。同样，code_acceptance_activity_count 包括聊天中的接受操作，例如“应用到文件”和复制按钮，这些都不属于内联 code_completion 活动，因此不用于分类。有关feature维度的更多信息，请参阅细分维度值。

系统会基于过去 28 天的滚动窗口每天重新计算阶段划分，因此，随着用户在该窗口内的活动发生变化，其阶段可能会从一天到下一天发生变化。这是预期行为，并不指示数据错误。

每个用户的 ai_adoption_phase 对象包含：

字段	类型	可为 Null	Description
`ai_adoption_phase.phase_number`	`integer`	否	数字阶段标识符（例如， `0` “无队列”）。
`ai_adoption_phase.phase`	`string`	否	人类可读的阶段名称。
`ai_adoption_phase.version`	`string`	否	使用的采用阶段模型的版本（例如 `v1`）。

聚合 totals_by_ai_adoption_phase 数组中的每个条目都包含：

字段	类型	可为 Null	Description
`phase`	`string`	否	人类可读的阶段名称。
`phase_number`	`integer`	否	数字阶段标识符。
`total_engaged_users`	`integer`	否	在该时间段内归入此阶段的用户数。
`avg_user_initiated_interactions`	`number`	否	此阶段每个用户平均发起的交互数。
`avg_code_generation_activities`	`number`	否	此阶段每个用户的平均代码生成活动。
`avg_code_acceptance_activities`	`number`	否	此阶段每个用户的平均代码接受活动。
`avg_loc_added`	`number`	否	此阶段中平均每位用户新增的代码行数。
`avg_loc_deleted`	`number`	否	此阶段每个用户平均删除的代码行数
`avg_pull_requests_reviewed`	`number`	否	在此阶段中查看每个用户的平均拉取请求数。
`avg_pull_requests_created`	`number`	否	此阶段每位用户创建的平均拉取请求数。
`avg_pull_requests_merged`	`number`	否	此阶段每个用户合并的平均拉取请求数。
`total_pull_requests_merged`	`integer`	否	此阶段用户合并的拉取请求总数。适用于组织日和企业日聚合报表。
`avg_pull_requests_median_minutes_to_merge`	`number`	否	此阶段用户的每位用户合并耗时中位数（分钟）的平均值。
`avg_pull_requests_minutes_to_review`	`number`	否	从拉取请求创建到第一次评审的中值时间（以分钟为单位）范围限定为合并拉取请求，并归因于拉取请求的合并日。
`avg_pull_requests_review_cycles`	`number`	否	每个拉取请求的评审提交次数（评审周期）中位数，仅针对已合并的拉取请求，并按拉取请求的合并日期归属。

细分维度值

上面的细分对象使用其值来自固定集的维度字段。这些是字段值，而不是单独的字段。例如，agent_edit 和 chat_panel_*_mode 的值是 feature 字段的值，而不是顶层字段。

维度 feature 标识 Copilot 活动所归因于的功能或模式：

价值	Description
`code_completion`	内联代码补全。
`chat_inline`	编辑器内的内联对话。
`chat_panel_ask_mode`	聊天面板在选择“提问”模式时的交互。
`chat_panel_edit_mode`	聊天面板与所选编辑模式交互。
`chat_panel_agent_mode`	已选择代理模式的聊天面板交互。
`chat_panel_plan_mode`	已选择“计划”模式时的聊天面板交互。
`chat_panel_custom_mode`	已选择自定义代理时的聊天面板交互
`chat_panel_unknown_mode`	模式未知时的聊天面板交互。
`agent_edit`	当 Copilot（在代理和编辑模式下）直接将更改写入 IDE 中的文件时新增和删除的行。也会统计来自自定义代理的编辑操作。
`agent_edit` 不包含在基于建议的指标中，并且可能不会填充建议样式字段，例如 `user_initiated_interaction_count`。
`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。