跳到主要内容

关于副驾驶拉动请求摘要

使用Copilot pull请求摘要,您可以为pull请求创建AI生成的描述。

谁可以使用此功能?

订阅了的企业成员GitHub Copilot企业

注:您当前正在查看Free、Pro和Team计划的文档。GitHub Copilot Enterprise仅适用于GitHup Enterprise Cloud计划中的客户。有关Copilot Enterprise的完整文档,请参阅“GitHub Copilot企业”。

关于副驾驶拉动请求摘要

Copilot pull请求摘要是一个AI功能,它允许您创建一个关于在pull请求中所做更改的摘要,这些更改影响哪些文件,以及审阅者在进行审阅时应该关注的内容。

当用户请求摘要时,Copilot会扫描pull请求,并提供以散文形式所做更改的概述,以及带有项目符号的更改列表及其影响的文件。

Copilot pull请求摘要唯一支持的语言是英语。

Copilot pull请求摘要使用了一个利用CopilotAPI的简单提示流,没有其他经过训练的模型。这利用了通用的大型语言模型。

响应生成

当前进程使用大型语言模型来启动自动完成进程并生成拉请求摘要。

管道方法

当用户请求摘要时,将触发工作流。工作流使用代码差异构建提示调用,该调用请求Copilot生成拉请求的摘要。摘要请求启动一个管道进程,该进程在提示符中包含来自可摘要文件的原始差异,并请求Copilot为pull请求生成总体摘要。

输出格式

您可以在创建拉请求时启动此功能,方法是在创建后编辑拉请求描述,或在拉请求线程中的注释中。启动后,Copilot将生成一个由两部分组成的摘要:

  • 以散文形式写的一段,概述了拉取请求中的更改。
  • 关键更改的项目符号列表,链接到发生这些更改的相应代码行。

Copilot生成较大的拉请求可能需要几分钟时间。根据您的企业设置,您可以在生成摘要后直接从UI共享您对摘要的反馈,以帮助我们继续改进该功能。

拉取请求摘要的用例

Copilot拉取请求摘要的目的是帮助优化作者在请求需要共享所做更改的上下文的人工审查时快速提供上下文的能力。它可以通过减少打开拉取请求所花费的时间来帮助提高开发人员的生产力。

对于许多用户来说,它可以为拉请求中的更改提供比通常可用的更有用的上下文。

提高拉取请求摘要的性能

将Copilot pull请求摘要用作工具,而不是替代工具

该功能旨在补充而不是取代人类添加上下文的工作,我们鼓励您继续添加有用的上下文,让Copilot完成解析代码和链接特定文件的繁忙工作。您仍有责任审查和评估您创建的拉取请求中信息的准确性。

提供反馈

注:向GitHub提供有关Copilot pull请求摘要的反馈的能力取决于企业设置。有关详细信息,请参阅“启用GitHub Copilot Enterprise功能."

如果您在Copilot pull请求摘要中遇到任何问题或限制,您可以通过单击“Bad summary”(错误摘要)按钮(拇指向下图标)提供反馈,该按钮在生成摘要后和单击之前显示在文本框下方创建拉取请求更新注释.

拉请求注释底部的屏幕截图。反馈图标(大拇指向上和向下)以深橙色轮廓突出显示。

在对摘要进行评价后,您可以通过单击显示的链接提供书面反馈。

拉取请求摘要的限制

目前,我们的团队意识到此功能存在局限性。他们中的许多人有望利用我们的Copilot API;然而,有一些特定于Copilot pull请求摘要,涉及范围有限、处理时间较长和响应不准确。我们还注意到,用户应该期望其PR中使用的术语出现在AI生成的摘要中。此功能已受到RAI Red Teaming的限制,我们将随着时间的推移继续监控此功能的有效性和安全性。有关更多信息,请参阅微软AI红色团队打造更安全AI的未来在Microsoft安全博客上。

范围有限

由于容量的原因,我们知道引用30个或更多文件的较大请求将需要更多的时间来彻底处理。我们目前没有一个确切的阈值,但已经观察到前30个文件被占,然后任何其他文件被从摘要中删除。我们正在努力解决当前的范围限制。

处理时间

通常,我们希望在用户启动操作后40秒或更短时间内返回摘要。然而,我们听说这可能需要一分钟,有时需要几分钟。我们正在努力减少处理时间,并且我们知道用户可能不希望在转到pull请求的其他部分之前等待此操作完成。

回答不准确

Copilot可以学习的输入和上下文越多,输出就越好。然而,由于该功能相当新,因此生成的摘要要达到精确的精度需要时间。同时,在某些情况下,生成的摘要可能不太准确,需要用户在保存和发布带有此描述的拉取请求之前进行修改。此外,还存在“幻觉”的风险,Copilot会生成不准确的陈述。由于这些原因,审查是一项要求,我们的团队强烈建议对输出进行仔细审查。

重新生成摘要

拉取请求摘要仅在用户手动请求时创建。当用户提交对其拉取请求的更新或更改时,摘要不会自动更新。如果需要,用户可以要求Copilot生成一个新的摘要。强烈建议手动审查更新后的副驾驶摘要。更新后的摘要与原始摘要具有相同的不准确风险。

拉取请求内容的复制

由于摘要是对拉取请求中所做更改的概述,如果拉取请求的内容中包含有害或冒犯性术语,那么摘要也可能包含这些术语。

进一步阅读