关于 Copilot 拉取请求摘要
Copilot 拉取请求摘要是一项 AI 驱动的功能,可帮助您创建对拉取请求中所做更改的摘要、受影响的文件以及审阅者在进行审查时应关注的要点。
当用户请求摘要时,Copilot 会扫描整个拉取请求,以散文形式提供更改概览,并给出带有受影响文件的要点列表。
您可以在以下位置生成摘要
- 在您创建的新拉取请求的描述中
- 在已有拉取请求的描述中,通过编辑首条评论
- 在拉取请求主时间线的评论中
Copilot 拉取请求摘要目前仅支持英文。
Copilot 拉取请求摘要采用基于 Copilot API 的简易提示流,无需额外训练模型。它使用通用的大型语言模型。
响应生成
当前流程使用大型语言模型启动自动完成过程并生成拉取请求摘要。
流水线方法
当用户请求摘要时,会触发工作流。工作流使用代码差异构建提示调用,请求 Copilot 生成拉取请求的摘要。该摘要请求启动一个流水线过程,将可汇总文件的原始差异放入提示中,并请求 Copilot 为整个拉取请求生成总体摘要。
输出格式化
您可以在创建拉取请求时、创建后编辑拉取请求描述,或在拉取请求讨论线程中发表评论时启动此功能。启动后,Copilot 将生成两部分摘要
- 一段以散文撰写的文字,概述拉取请求中的更改。
- 一个要点列表,列出关键更改并链接到相应代码行。
较大的拉取请求可能需要几分钟才能生成摘要。根据您的企业设置,您可以在摘要生成后直接在 UI 中提供反馈,以帮助我们持续改进此功能。
拉取请求摘要的使用场景
Copilot 拉取请求摘要的目标是帮助作者在请求人工审查时快速提供上下文,从而优化其提供变更信息的能力。这可以通过减少打开拉取请求所需的时间来提升开发者生产力。
对许多用户而言,它能够提供比通常可获得的更有帮助的变更上下文。
提升拉取请求摘要的性能
将 Copilot 拉取请求摘要作为工具,而非替代品
该功能旨在补充而非取代人工添加上下文的工作,我们鼓励您继续添加有用的上下文信息,让 Copilot 负责解析代码并链接到具体文件。审阅并评估您创建的拉取请求中信息的准确性仍是您的责任。
提供反馈
注意
向 GitHub 提供关于 Copilot 拉取请求摘要的反馈取决于企业设置。详情请参阅 企业中管理 GitHub Copilot 的策略和功能。
如果您在使用 Copilot 拉取请求摘要时遇到任何问题或限制,可以通过点击“糟糕的摘要”按钮(向下的大拇指图标)提供反馈。该按钮会在生成摘要后、您点击 Create pull request(创建拉取请求)或 Update comment(更新评论)之前显示在文本框下方。

在您将摘要评为好或坏后,可以通过点击显示的链接提供书面反馈。
拉取请求摘要的局限性
目前,我们团队已了解到此功能存在一些局限性。许多局限性源于使用我们的 Copilot API;但也有一些特定于 Copilot 拉取请求摘要的限制,包括范围受限、处理时间较长以及响应不准确。我们也注意到,用户在 PR 中使用的术语会出现在 AI 生成的摘要中。该功能已接受 RAI 红队审查,我们将持续监控其有效性和安全性。详情请参阅 Microsoft AI Red Team 建设更安全 AI 的未来(Microsoft 安全博客)。
更改行数限制
单个文件的新增和删除累计超过 400 行的文件将被排除在摘要之外。
范围有限
由于容量限制,我们知道引用 30 个或以上文件的大型拉取请求需要更长时间才能彻底处理。我们目前没有精确阈值,但观察到前 30 个文件会被计入摘要,之后的文件则被省略。我们正在努力解决此范围限制。
处理时间
一般情况下,我们期望在用户发起操作后 40 秒以内返回摘要。但我们听说这可能需要最长 1 分钟,某些情况下甚至需要几分钟。我们正致力于缩短处理时间,并且了解用户可能不想在此期间等待而去处理拉取请求的其他部分。
不准确的响应
Copilot 能够学习的输入和上下文越多,输出质量就会越好。然而,由于该功能尚新,达到摘要的精确度仍需时间。期间,可能会出现生成的摘要不够准确,需要用户在保存并发布带有该描述的拉取请求前进行修改的情况。此外,还存在“幻觉”风险,即 Copilot 生成不准确的陈述。因此,审阅是必需的,我们强烈建议对输出进行细致审查。
重新生成摘要
拉取请求摘要仅在用户手动请求时创建。用户对拉取请求进行更新或更改时,摘要不会自动更新。如有需要,用户可以让 Copilot 生成新的摘要。强烈建议手动审查更新后的 Copilot 摘要。更新后的摘要同原始摘要一样,存在不准确的风险。
复制拉取请求内容
由于摘要是对拉取请求所做更改的概括,如果拉取请求内容中包含有害或冒犯性词语,摘要中也可能出现这些词语。
延伸阅读
- GitHub Copilot 信任中心
- 使用 GitHub Copilot 创建拉取请求摘要(在 GitHub Enterprise Cloud 文档中)。