GitHub Copilot用量API新增PR评审耗时分析

Full translation

完整中文译文

企业级和组织级仓库维度的 Copilot 使用量指标报告，现在拆分出了 PR 在每个评审阶段所花费的时长。每个 repos-1-day 行新增了一个 pull_request_review_times 数组，其中包含从「ready for review」到「首次评审」、「首次评审」到「最终评审」、「最终评审」到「合并」三个阶段的中位数和第 90 百分位数。

pull_request_review_times 数组中的每个条目包含以下字段：

authored_by 和 reviewed_by：分别是提交该 PR 的人和评审该 PR 的人。本版本中两者都是人类。
total_merged：当天在该仓库合并的符合条件的 PR 数量。
median_minutes_ready_to_first_review 和 p90_minutes_ready_to_first_review：从 PR 进入 ready for review 状态到首次评审的时间。
median_minutes_first_to_final_review 和 p90_minutes_first_to_final_review：从首次评审到最终评审的时间。
median_minutes_final_review_to_merge 和 p90_minutes_final_review_to_merge：从最终评审到合并的时间。

时长以分钟为单位，归因到 PR 合并那天。已有的 pull_requests 字段保持不变。

团队目前已经能看到 PR 合并耗时很长，但无法得知时间消耗在哪里。将等待拆分为三个阶段后，就能看出 PR 是在等评审者查看、是在评审者之间来回沟通、还是已经批准但未被合并。每一个问题都指向不同的解决方向，而中位数旁边的第 90 百分位数可以揭示是否存在少量慢速 PR 在主导整体延迟。

适用版本：企业级和组织级的 repos-1-day 报告。

统计范围：统计由人员发起、且至少有另一人评审的 PR。只有人工评审计入计时，Copilot code review、其他机器人以及作者本人的评审均不计入。因此，即使一个 PR 同时被人员和 Copilot code review 评审过，仍然会被纳入统计。最终结果是，pull_request_review_times[].total_merged 通常低于 pull_requests.total_merged，因为后者也包含了没有任何评审就被合并的 PR。

不会补历史数据：数据从发布日期开始往前积累，所以早期天数的数据会很少。2026 年 9 月 21 日之前进入 ready for review 状态的 PR 不会出现在这个部分，但仍会计入 pull_requests.total_merged。

空数据日返回空数组而非零：仓库当天没有合并符合条件的 PR 时，该数组为 []。如果 PR 只经历了一次评审，则首次到最终评审阶段的时长为 0。

访问权限：企业所有者与计费管理员、组织所有者，以及拥有授予了「查看 Copilot 指标」权限的自定义组织或企业角色的用户，均可访问这些报告。同时必须启用 Copilot 使用量指标策略。

访问 Copilot 使用量指标 API 文档开始接入。