Skip to main content

在 GitHub 上使用 Copilot 云代理

直接在 Copilot云代理 上启动 GitHub 会话,然后根据结果不断迭代,全程无需离开浏览器。

谁可以使用此功能?

Copilot云代理 适用于所有付费 Copilot 计划。

代理在所有存储于GitHub的存储库中可用,除非这些存储库由托管用户帐户拥有或已被显式禁用。
Sign up for Copilot

Introduction

您可以在 Copilot云代理 的多个位置发起 GitHub 会话。 会话运行后,可以监视其进度,使用后续提示对其进行引导,并循环访问生成的拉取请求,而无需离开浏览器。

有关 Copilot云代理 的详细信息,请参阅 关于 GitHub Copilot 云代理

从“代理”选项卡或面板启动会话

可以从“代理”选项卡和“代理”面板启动会话。 唯一的区别是入口点-一旦看到“新建代理任务”窗体,步骤是相同的。

  1. 打开代理面板或选项卡:

    • 在存储库中打开 Agents 选项卡。
    • 导航到智能体页面****:转到 github.com/copilot/agents。 你也可以通过打开智能体面板,然后单击“View all”进入此页面****。
    • 打开智能体面板****:单击 GitHub 右上角导航栏中的
  2. 使用提示字段中的下拉菜单,选择要使用的存储库 Copilot 。

  3. 键入描述请求的提示。 还可以通过粘贴、拖动或上传图像来添加视觉输入,例如屏幕截图或 UI 模型。 支持的文件:image/png、image/jpeg、image/gif、image/webp。

    例如: Implement a user friendly message for common errors.

    如果要 Copilot 打开拉取请求,可以在提示中提问,例如Open a pull request to implement a user friendly message for common errors.

  4. (可选)为 Copilot 的变更选择基分支。 Copilot 将基于此分支创建新分支。

  5. (可选)如果您想分配一个代理或一个具有专用行为和工具的,可以单击自定义智能体以打开代理下拉菜单。 可以从存储库、组织或企业中选择现有 自定义智能体。 还可以单击“创建代理”,在所选存储库和分支中创建新的代理资料代理。 有关详细信息,请参阅“为Copilot云代理创建自定义代理”。

    注意

    所有付费 Copilot 计划都提供第三方代理。

  6. (可选)可以使用下拉菜单来选择将使用的 Copilot 模型。 有关详细信息,请参阅“更改 GitHub Copilot 云代理的 AI 模型”。

  7. 单击 或按 Enter

Copilot 将启动一个新会话,该会话将显示在提示框下面的列表中。 Copilot 将处理任务并推送任何代码更改。

在会话日志中,只需单击一次即可追踪 Copilot的工作并打开拉取请求。 有关详细信息,请参阅“[AUTOTITLE](/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents)”。

从仪表板启动会话

你可以要求 Copilot 从仪表板中的提示框开始工作。 仪表板是你在登录时访问 GitHub 时看到的 https://github.com 上活动的个性化概述。

  1. 导航到 https://github.com 的仪表板。

  2. ** 单击“任务**”按钮。

  3. 使用提示字段中的下拉菜单,选择要使用的存储库 Copilot 。

  4. 键入描述请求的提示。

    例如: Implement a user friendly message for common errors.

    如果要 Copilot 打开拉取请求,可以在提示中提问,例如Open a pull request to implement a user friendly message for common errors.

  5. 可选地为 Copilot 的拉取请求选择一个基分支。 Copilot 将基于此分支创建新分支。

  6. (可选)如果您想分配一个代理或一个具有专用行为和工具的,可以单击自定义智能体以打开代理下拉菜单。 可以从存储库、组织或企业中选择现有 自定义智能体。 还可以单击“创建代理”,在所选存储库和分支中创建新的代理资料代理。 有关详细信息,请参阅“为Copilot云代理创建自定义代理”。

    注意

    所有付费 Copilot 计划都提供第三方代理。

  7. 单击“立即发送” 或按“返回”。

    你将被带到“代理”选项卡,并 Copilot 启动一个新会话,该会话将显示在提示框下方的“最近会话”列表中。 Copilot 将处理任务并推送任何代码更改。

    注意

    如果已启用功能预览版 中的“新建仪表板体验 ”,新会话将显示在仪表板的提示框下的“代理会话” 中。 有关详细信息,请参阅“个人仪表板”。

从Copilot 对话助手开始

  1. 在 GitHub Copilot 聊天功能 上打开 GitHub.com。

  2. 键入 /task 以请求 Copilot 创建拉取请求,并提供有关要 Copilot 更改的内容的详细信息。

    例如: /task Create a pull request to put backticks around file names and variables in output.

  3. 可选地为 Copilot 的拉取请求选择一个基分支。 Copilot 将基于此分支创建新分支,然后将更改推送到面向该分支的拉取请求。

  4. (可选)如果您想分配一个代理或一个具有专用行为和工具的,可以单击自定义智能体以打开代理下拉菜单。 可以从存储库、组织或企业中选择现有 自定义智能体。 还可以单击“创建代理”,在所选存储库和分支中创建新的代理资料代理。 有关详细信息,请参阅“为Copilot云代理创建自定义代理”。

    注意

    所有付费 Copilot 计划都提供第三方代理。

  5. 单击 或按 Enter

Copilot 将启动一个新会话,该会话将显示在提示框下面的列表中。 Copilot 将处理任务并将更改推送到其拉取请求中,任务完成后,它会将你添加为审阅者,并触发通知。

将问题分配给 Copilot

可以请求 Copilot 将问题分配给 Copilot 来开始处理问题。 Copilot 将开始处理这项任务,发起拉取请求,并在完成后向你请求评审。

注意

此功能目前处于公开预览,可能会发生更改。

  1. 在 GitHub 上,导航到存储库的主页面。

  2. 在仓库名称下,单击 “Issues”****。

    存储库的主页的屏幕截图。 在水平导航栏中,标记有“问题”的选项卡以深橙色标出。

  3. 打开要分配给 Copilot 的问题。

  4. 在右侧菜单中,单击“代理人”****。

    问题右侧边栏的屏幕截图。 标记为“被分派人”的标题以深橙色突出显示。

  5. 从被分配者列表中单击Copilot

    议题的“Assignees”窗口的屏幕截图。 列表中可用Copilot。

    此时,将显示其他选项。

    “分配到 Copilot” 对话框的屏幕截图,其中显示了目标存储库、起始分支、自定义智能体和附加说明。

  6. “可选提示 ”字段中,可以添加特定 Copilot指南。 添加有助于理解和完成任务的任何上下文、约束或特定要求 Copilot 。

    例如,可以包含有关要使用的特定编码模式或框架、测试要求、代码样式偏好设置、应修改或不应修改的文件或目录的说明。

    除了在此处提供的详细信息之外, Copilot 还将使用为目标存储库配置的任何自定义说明。 请参阅“为GitHub Copilot添加存储库自定义说明”。

  7. 可以使用对话框中的下拉菜单更改 Copilot 将要工作的存储库,以及它将从中派生的分支。

    所有您拥有至少读取权限的存储库都会显示在存储库下拉菜单中。 但是,只有在您对该存储库具有写入访问权限并且Copilot云代理已为该存储库启用时,您才能选择该存储库。

    如果在与问题源组织不同的组织中选择存储库,或者在问题位于专用存储库中时选择公共存储库,则会显示警告。

    如果未指定存储库, Copilot 则会在与问题相同的存储库中工作。 如果未指定分支, Copilot 则从所选存储库的默认分支工作。

    提示

    当将问题分配给 Copilot 时,它会收到问题标题、描述、当前存在的任何注释以及你提供的任何其他说明。 分配问题后, Copilot 将不知道,因此不会对添加到问题的任何进一步注释做出反应。 如果您掌握了更多信息,或对原始要求进行了更改,请将这些内容作为注释添加到 Copilot 提出的拉取请求中。

  8. (可选)如果您想分配一个代理或一个具有专用行为和工具的,可以单击自定义智能体以打开代理下拉菜单。 可以从存储库、组织或企业中选择现有 自定义智能体。 还可以单击“创建代理”,在所选存储库和分支中创建新的代理资料代理。 有关详细信息,请参阅“为Copilot云代理创建自定义代理”。

    注意

    所有付费 Copilot 计划都提供第三方代理。

  9. (可选)可以使用下拉菜单来选择将使用的 Copilot 模型。 有关详细信息,请参阅“更改 GitHub Copilot 云代理的 AI 模型”。

还可以从Copilot上的其他位置将问题分配给GitHub.com。

  • 从存储库 的“问题 ”页上的问题列表中。
  • 查看问题 GitHub项目时。

为新存储库设定种子

创建新存储库时,可以通过输入提示来请求 Copilot 为新存储库设定种子。

  1. 在任何页面的右上角,选择 ,然后单击“新建存储库”。

    GitHub 下拉菜单的屏幕截图,其中显示了用于创建新项的选项。 菜单项“新建存储库”用深橙色框标出。

  2. 使用“所有者”下拉菜单选择你想要拥有存储库的帐户。

    新 GitHub 存储库的所有者菜单的屏幕截图。 菜单显示两个选项:“octocat”和“github”。

  3. “提示” 字段中,输入描述您希望 Copilot 构建的内容的提示。

    例如, Create a Rust CLI for converting CSV spreadsheets to Markdown1. 单击“创建存储库”。

Copilot 将立即打开草稿拉取请求。 Copilot 将处理任务并将更改推送到其拉取请求中,任务完成后,它会将你添加为审阅者,并触发通知。

修复失败的 GitHub Actions 工作流运行

注意

此功能仅适用于 Copilot业务 用户和 Copilot Enterprise 用户。

当 GitHub Actions 工作流在拉取请求分支上运行失败时,可以请求 Copilot 调查并修复失败。

  1. 打开 GitHub,导航到失败的工作流运行作业页。

  2. ** 单击“修复”按钮Copilot**。

Copilot 将启动一个新会话,调查失败的原因,并将修补程序推送到分支。

继续处理拉取请求

可以在任何拉取请求的评论中提及 @copilot ,要求 Copilot 进行更改。 此功能适用于由 Copilot 创建的拉取请求,以及由你或其他人创建的拉取请求。

默认情况下, Copilot 将提交直接推送到拉取请求分支。 若要改为创建单独的拉取请求,请在批注中描述该请求。 您还可以检出分支并自己推送更改。

批量审阅批注,而不是单独提交批注。 通过 GitHub Web 界面提交拉取请求注释(而不是审阅或审阅批注)时,请使用模型选取器选择模型。 Copilot 默认情况下,使用原始拉取请求中的模型。

Copilot 仅响应对存储库具有写入权限的人的评论。

当 Copilot 启动新会话以响应你的批注时,批注上会显示一个眼睛表情符号(👀)。 拉取请求时间线中会显示“Copilot已开始工作”事件。

拉取请求时间轴的屏幕截图,其中包含带有眼睛表情符号的审查评论和“Copilot 开始工作”时间轴事件。

Copilot 记住以前针对同一拉取请求的会话的上下文,因此后续请求更快、更可靠。 如果拉取请求是由自定义智能体创建的,那么提到@copilot将继续使用相同的代理。

解决合并冲突

可以通过两种方式请求 Copilot 解决拉取请求中的合并冲突:

  • 使用“修复 Copilot”按钮:如果拉取请求有合并冲突,请单击合并框中出现的“修复Copilot”按钮。
  • @copilot使用提及:在对拉取请求的注释中提及@copilot并要求其修复冲突,例如,“@copilot解决此 PR 上的合并冲突”。

Copilot 分析冲突的更改,解决这些问题,并验证生成、测试和 linter 是否仍通过。 然后,它会请求你的评审,以便你可以在合并之前确认解决方案。

管理 GitHub Actions 工作流运行

默认情况下,当 GitHub Actions 向拉取请求推送更改时,Copilot 工作流不会自动运行。

GitHub Actions 工作流可以具有特权,并且有权访问敏感机密。 检查拉取请求中的拟议更改,确保您在拉取请求分支上自由运行您的工作流程。 应特别注意 .github/workflows/ 目录中影响工作流文件的任何拟议更改。

若要允许 GitHub Actions 工作流运行,请单击拉取请求合并框中的 “批准并运行工作流 ”按钮。

来自 Copilot 的拉取请求的合并框的屏幕截图,其中包含“Approve and run workflows”按钮。

(可选)你可以配置为 Copilot云代理 允许 GitHub Actions 工作流在没有人工干预的情况下运行。 有关详细信息,请参阅 配置 GitHub Copilot 云代理的设置

提供有关Copilot的工作反馈

使用Copilot的拉取请求和评论上的反馈按钮对输出进行评分。 你的反馈有助于提高 Copilot质量。

  1. 在Copilot的拉取请求或评论中,单击大拇指向上(+1)或向下(-1)按钮。
  2. 如果单击拇指向下按钮,可以选择原因并留下批注,然后单击 “提交反馈”。

延伸阅读