Copilot 使用量 API 新增 Agent 应用活动追踪

自 Agent 应用登陆 GitHub 以来，团队已经可以直接在 GitHub 工作流中运行来自 Claude、Codex 等合作伙伴的 Agent。Copilot 使用量指标 API 现已支持上报相关活动，并按单个 Agent 进行拆分。该 API 在企业级、组织级、企业-用户级和组织-用户级的 1 天及 28 天报表中均提供此项能力。

新增一个可选的 totals_by_3rd_party_agent 数组，每条已识别的 Agent 应用对应一条记录。每条记录包含以下字段：

• agent_name：Agent 的展示名称。展示名称可能会变化，因此请按 agent_id 而非此字段进行分组。

• agent_id：Agent 的稳定标识符，是在不同报表期间进行关联的正确键名。

• user_initiated_interaction_count：由用户发起的 Agent 应用任务启动次数。

• session_count：Agent 应用会话数。仅在汇总的企业级和組織级报表中包含此字段。按用户维度的条目不包含此字段。

在此之前，Agent 活动在使用量指标中实际上是一个单一的"大桶"，因此无法将 Copilot coding agent 的工作与其他 Agent 的工作区分开来。随着团队采用越来越多的 Agent，一些基础问题变得难以回答：究竟哪些 Agent 被实际使用了、有多少人在用、新部署的 Agent 的推广情况与其所补充的原有 Agent 相比如何。

按 Agent 拆分活动后，可以精确追踪每个 Agent 应用的使用情况，在不同 Agent 之间比较推广程度，并根据真实使用数据而非假设来制定推广和授权决策。

嵌套的 user_initiated_interaction_count 统计的是 Agent 应用的任务启动次数。它与同名的顶层字段不同，顶层字段统计的是其他支持遥测功能的显式提示。不要将二者相加或视为可互换。

活动按 Agent 聚合，因此属于同一 Agent 的多个应用会合并为一条记录。无法识别的 Agent 的活动会被省略。

这些指标对企业所有者和计费管理员、组织所有者，以及拥有自定义组织或企业角色（该角色被授予了查看 Copilot 指标权限）的所有用户均可见。Copilot 使用量指标策略必须已启用。

此次变更向后兼容。现有字段保持原有结构，当报表周期内没有已识别的 Agent 应用活动时，报表会完全省略 totals_by_3rd_party_agent 字段。

访问 Copilot 使用量指标 API 文档开始使用，或查看 Agent apps metrics fields 获取完整的字段定义。