关于 Agent Merge
Agent Merge 是 Copilot in the cloud的一部分。 它会监视包含你所选阻塞项的拉取请求,并在发现阻塞项时自动开始处理。 可以允许 Copilot 修复失败的 GitHub Actions 工作流、解决合并冲突,或同时执行这两项。
Agent Merge 帮助使拉取请求做好合并准备,并使其保持该状态。 它不能代替你对更改的审查,也不能代替对存储库合并要求的审查。
先决条件和限制
若要使用Agent Merge,必须有权通过付费Copilot in the cloud计划访问Copilot。 如果你的组织或企业提供你对 Copilot 的访问权限,则其策略必须允许你使用 Copilot in the cloud。
还必须启用存储库的 “启用自动化Copilot ”策略。
Agent Merge 不支持堆叠式拉取请求或从复刻仓库创建的拉取请求。
为拉取请求启用 Agent Merge
-
在 GitHub 上,打开要 Copilot 监视的拉取请求。
-
在拉取请求的合并框中,单击“监视并修复”。
-
选择要Copilot执行的操作:
- 修复失败的 Actions 工作流:允许 Copilot 调查并修复失败的 GitHub Actions 工作流。
- 解决合并冲突:允许 Copilot 解决拉取请求的分支与其基分支之间的冲突。
当您选择的某个阻塞问题出现时,Copilot 会开始在云开发环境中处理并修复该问题。
继 Agent Merge 的工作之后
当 Copilot 监视你的拉取请求时,你将在合并框的 Agent Merge 部分中看到更新。
当 Copilot 开始工作时,更新会显示为拉取请求时间线事件。 更新解释了开始的原因,例如失败的工作流或合并冲突。
在合并之前查看 Copilot 所做的更改并检查工作流结果。 Agent Merge 并不能免除人工审核的需要。
Agent Merge自动启用
默认情况下,可以为你创建的拉取请求启用 Agent Merge 。
- 在 GitHub 任意页面的右上角,单击你的个人资料照片,然后单击“ Settings”****。
- 在边栏中,单击位于Copilot 下的“云”。
- 选择为我创建的拉取请求自动启用Agent Merge。
- 使用 修复失败的 Actions 工作流 和 解决合并冲突 开关,选择当 Agent Merge 为你的拉取请求自动启用时,Copilot 可以执行哪些操作。 可以启用任一操作或同时启用这两种操作。
在拉取请求中禁用 Agent Merge
如果是你启用了 Agent Merge,或者对存储库具有写入访问权限,则可以为拉取请求禁用 Agent Merge。
- 在 GitHub 上,打开拉取请求。
- 在拉取请求底部的合并框中,单击“取消指派Copilot”。
使用 Agent Merge 进行自动合并
Agent Merge 修复阻塞问题,而自动合并会在所有必需的评审和状态检查通过后合并拉取请求。 启用 Agent Merge 不会启用自动合并。
可以将两者结合起来,让 Copilot 使拉取请求准备就绪并保持其就绪状态,同时 GitHub 在满足所有要求后立即将其合并。 有关设置指南,请参阅 自动合并拉取请求。
自定义 Agent Merge 的环境
虽然 Agent Merge 是 Copilot in the cloud 的一部分,但它的修复是在基于 GitHub Actions 的开发环境中运行的,而不是云沙盒。 它使用与在GitHub Actions上运行的其他Copilot任务相同的存储库自定义项,包括:
- 在
.github/workflows/copilot-setup-steps.yml中的设置步骤 请参阅“在 GitHub Actions 上为代理配置开发环境”。 - 存储库自定义说明。 请参阅“为GitHub Copilot添加存储库自定义说明”。
- 仓库代理技能 请参阅“为 GitHub Copilot 添加代理技能”。
使用情况和计费
Agent Merge使用的AI credits记在为该拉取请求启用它的用户名下,不一定是拉取请求的作者。 有关使用情况和配额的详细信息,请参阅 GitHub Copilot计费和使用情况。