使用 GitHub 的代理功能时,您可以在已启用 Copilot 云代理的仓库的 Agents 选项卡中启动、监控和管理代理会话,而无需离开工作流。您也可以使用 代理页面 查看和启动代理会话。要了解如何启用 Copilot 云代理,请参阅 管理对 GitHub Copilot 云代理的访问。
1. 选择仓库并选择您的代理
-
启动一个新的代理任务。
- 打开仓库中的 Agents 选项卡
- 打开 代理页面
- 使用 Task 按钮或在 Copilot Chat 中输入
/task命令 - 点击打开代理面板位于 GitHub 任意页面顶部
-
使用下拉菜单选择您希望云代理工作的仓库。
-
(可选)选择 Copilot 拉取请求的基准分支。
-
(可选)您可以点击以打开代理下拉菜单,分配特定的代理或具备专门行为和工具的自定义代理。您可以从仓库、组织或企业中选择已有的自定义代理。您也可以点击 创建代理,在所选仓库和分支中创建新的代理配置文件。更多信息请参阅 为 Copilot 云代理创建自定义代理。
注意
第三方编码代理在 GitHub Copilot Pro+ 和 Copilot Enterprise 计划中可用。
-
(可选)选择 CURRENT-MODEL下拉菜单,然后点击您想使用的 AI 模型。
-
输入描述您请求的提示。例如
Implement a user-friendly message for common errors. -
点击 或按 Enter。
Copilot 将开始执行该任务,并将更改推送到新的拉取请求中,会自动将您添加为审阅者。
欲了解启动新代理任务的更多方式,请参阅 让 GitHub Copilot 创建拉取请求。
2. 监控代理活动
代理开始工作后,它会持续在会话日志和概览中更新进度和思考过程。
每个会话都会显示其状态。点击会话即可打开会话日志,您可以在其中监控代理的进度、查看其使用的工具以及会话运行的时长。
Copilot 云代理会话还可以通过 GitHub CLI、GitHub Mobile、Visual Studio Code、Raycast 和 JetBrains IDE 进行追踪。更多信息请参阅 追踪 GitHub Copilot 会话。
3. 根据需要重新指派代理
您可以介入并向 Copilot 提供 引导输入,而无需停止运行。每条引导消息会消耗 一次高级请求。
注意
对 第三方编码代理,当前尚不支持会话引导。
您可能想要引导会话的原因包括:
- Copilot 似乎走错方向,您希望为其提供更明确的指示。
- 您在工作描述中出现错误,决定重新开始。
在代理会话日志下方的提示框中,向正在执行任务的 Copilot 发送提示。例如
Use our existing ErrorHandler utility class instead of writing custom try-catch blocks for each endpoint.
Copilot 将在完成当前工具调用后开始实现您的输入。
4. 在本地开发环境中打开代理会话
您可以在本地开发环境中指导代理进行进一步更改,或对需要人工专业知识的部分进行编辑。
VS Code
在代理会话视图底部,点击 在 VS Code 中打开 按钮,以在 VS Code 中直接启动会话。
注意
在 VS Code 中打开会话需要使用最新版的 VS Code、GitHub Copilot 扩展以及 GitHub Pull Requests 扩展。
GitHub Copilot CLI
- 在代理会话视图底部,点击位于 在 VS Code 中打开 旁边的下拉列表。
- 点击 在 GitHub Copilot CLI 中继续,将
copilot --resume=SESSION-ID命令复制到剪贴板。
- 在终端中粘贴并运行该命令,以恢复代理会话。
5. 审核并合并代理代码
代理完成会话后,您可以前往相应的拉取请求进行代码审查。在拉取请求页面,您可以查看差异、请求进一步改进,或批准并合并更改。参见 审查 GitHub Copilot 创建的拉取请求。
6. 归档代理会话
已停止的会话可以归档,以将其从会话列表中移除。
- 打开您想要归档的代理会话。
- 在右上角,点击 ,随后点击 归档会话。
- 在弹出的对话框中,点击 是,归档。