介绍
在提供 Copilot 任务后,它会在后台自主工作以完成它。 请参阅“关于 GitHub Copilot 云代理”。
"代理"面板, 代理选项卡, GitHub CLI 和 Raycast 的 GitHub Copilot 扩展提供了跨存储库的代理会话概览。 可以使用它们启动新任务并跟踪 Copilot进度。
还可以从Copilot中跟踪Visual Studio Code特定存储库中的会话。
在代理会话期间或之后,您可以检查会话日志,以了解 Copilot 处理您问题的方法。
从“代理”选项卡跟踪代理会话
可以在代理面板中查看正在运行和过去的代理会话列表,该面板可在GitHub的每个页面上访问,或在专用的代理选项卡上访问。如果您启动了会话或提示Copilot处理其他用户的会话,则这些代理会话将显示在您的会话列表中。
若要打开 “代理”选项卡,请单击 任意页面上导航栏中的“代理”面板,然后单击“ 全部查看”。
每个会话显示其状态。 单击会话以打开会话日志和概述,可在其中监视代理的进度、令牌使用情况、会话计数和会话长度。
可以从选项卡中启动新的代理会话。请参阅 要求 GitHub Copilot 创建拉取请求。
从 GitHub CLI 跟踪代理会话
注意
`agent-task` 命令集仅在 GitHub CLI 的 v2.80.0 或更高版本中可用。 此命令集是一个 公共预览版 且可能会更改。
您可以从GitHub CLI使用gh agent-task list命令查看您正在运行和过去的代理会话的列表。 输出将显示近期会话列表。
要查看有关特定会话的详细信息,请使用 gh agent-task view 命令。 例如,要查看与 monalisa/bookstore 仓库中编号为 #123 的拉取请求相关联的会话信息,请运行 gh agent-task view --repo monalisa/bookstore 123 命令。
要查看会话日志,请添加 --log 选项。 也可使用 --follow 选项在智能体工作时流式传输实时日志。
要查看所有可用选项,请运行 gh agent-task list --help 或 gh agent-task view --help。
从 Raycast 跟踪代理会话
Raycast 是适用于 Windows 和 macOS 的可扩展启动器。 GitHub Copilot使用 Raycast 的扩展,您可以在您的计算机上随时随地启动和跟踪Copilot云代理任务,并实时观看会话日志。
- 从 Raycast 网站安装 Raycast。
-
GitHub Copilot单击**扩展页上的**“[安装扩展](https://www.raycast.com/github/github-copilot)”按钮,安装 Raycast 的扩展。 - 打开 Raycast,搜索“Copilot”,找到“查看任务”命令,然后按 Enter。
- 单击 使用 GitHub 登录,然后完成身份验证流程。 Raycast 将重新打开。
- 你将看到一个任务列表。 选择任务,然后使用以下键盘快捷方式:
- 若要实时观看会话日志,请按 Enter。 日志实时更新,因此可以在不离开 Raycast 的情况下监视 Copilot进度。
- 要在浏览器中打开会话日志,请按 Command+Enter(macOS)或 Ctrl+Enter(Windows)。
- 要打开链接的拉取请求,请按 Command+P (macOS)或 Ctrl+P (Windows)。
注意
如果在 Raycast 中看不到某些任务,则拥有存储库的组织可能已启用 OAuth app 访问限制。 若要了解如何请求批准“GitHub Copilot for Raycast” OAuth app,请参阅 请求组织批准 OAuth 应用。
还可以从 Raycast 启动新的代理会话。 请参阅“要求 GitHub Copilot 创建拉取请求”。
从 Visual Studio Code 跟踪会话
可以使用 Visual Studio Code 中的 GitHub 拉取请求扩展 查看特定存储库的当前和过去的代理会话列表。
安装扩展后,可以通过单击边栏中的Copilot按钮来查看GitHub“会话”。
对于列出的每个会话,可以一目了然地看到其状态,或者单击它以导航到 Visual Studio Code 中的拉取请求。
若要查看会话日志,请单击列表中的拉取请求,然后单击“View Session”****。
还可以从 Visual Studio Code中启动新的代理会话。 请参阅“要求 GitHub Copilot 创建拉取请求”。
若要直接在VS Code中打开代理会话,请单击“代理”选项卡上的在VS Code中打开选项。
注意
在 VS Code 中打开会话目前仅在 VS Code 预览体验成员中可用。
从 JetBrains IDE 跟踪会话
注意
JetBrains IDE 中的 Copilot云代理 在 公共预览版 中,并且可能会发生变化。
可以在 JetBrains IDEs 中使用 GitHub Copilot 聊天功能 扩展,查看项目的正在运行和过去的代理会话列表。 请参阅“在环境中安装 GitHub Copilot 扩展”。
你可以在将任务从GitHub Copilot 聊天功能委托给Copilot后,通过单击侧栏中的GitHub 云代理作业按钮或单击打开作业列表按钮,查看Copilot的所有会话。
对于列出的每个会话,你可以一目了然地查看其状态。 单击“ 在浏览器中打开 ”以在浏览器中打开拉取请求,或右键单击正在运行的作业,然后单击“ 取消作业 ”以取消。
Copilot 还会在代理任务启动和完成时通知你。
从 Eclipse 跟踪会话
注意
Copilot云代理 位于 Eclipse 中的 公共预览版,并且可能会更改。
在 Eclipse GitHub Copilot 聊天功能 中,您可以使用扩展查看与项目相关的正在运行和过去的代理会话列表。 请参阅“在环境中安装 GitHub Copilot 扩展”。
可以通过单击聊天窗口右上角的Copilot查看所有的会话,或在从**** 将任务委派给**** 后,单击Copilot按钮。
对于列出的每个会话,你可以一目了然地查看其状态。 单击“ 在浏览器中打开 ”以在浏览器中打开拉取请求,或右键单击正在运行的作业,然后单击“ 取消作业 ”以取消。
Copilot 还会在代理任务启动和完成时通知你。
从 GitHub Mobile 跟踪会话
可以在GitHub Mobile中查看由代理生成的当前和过去的拉取请求列表。
-
在主页上的 GitHub Mobile “代理”部分中,点击 “代理任务”。
显示当前打开的拉取请求列表,即你要求 Copilot 生成的请求。
-
使用列表顶部的按钮筛选拉取请求列表。
例如,若要仅显示合并的任务,请点击 “打开 ”,然后在下拉列表中点击“ 合并”。

将提交跟踪到会话日志
来自 Copilot云代理 的提交具有以下特征:
- 每次提交都是由 Copilot创作的,启动任务的人被标记为共同作者。
- 每个提交消息都包含一个指向该提交的会话日志的链接,因此你可以了解为什么 Copilot 在代码评审期间进行更改,或稍后跟踪更改以进行审核。
- 来自 Copilot云代理 的提交都经过签名,并在 GitHub 上显示为“已验证”。
使用会话日志了解 Copilot其方法
可以深入了解Copilot中的会话日志,在GitHub、Visual Studio Code或 Raycast 中了解它如何处理您的任务。
在会话日志中,可以看到 Copilot内部独白及其用于了解存储库、进行更改和验证其工作的工具。
注意
Copilot 拥有自己的开发环境,包括运行自动化测试和代码检查的能力,可在推送前验证更改。
Copilot从“代理”选项卡引导会话
在它完成任务的同时,你可以操控 Copilot。 你可能希望引导会话的原因包括:
-
Copilot 似乎走错了方向,你想让它更清晰。 - 你在描述所需工作时犯了一个错误,你决定重新开始。
请按照以下步骤来操控 Copilot:
- 打开 “代理”选项卡。
- 在 “代理会话 ”列表中,选择要为其提供进一步输入的任务。
- 在提示框中,当它正在处理任务时提示 Copilot。
例如: Use our existing ErrorHandler utility class instead of writing custom try-catch blocks for each endpoint.
Copilot 将在完成当前工具调用后开始实施您的输入。
注意
每条引导消息会消耗一个高级请求额度。
停止 Copilot 会话
可以通过单击会话日志查看器中的Copilot”来停止**** 继续处理任务。

你可能想要停止会话的原因包括:
- 你在描述所需工作时犯了一个错误,你决定重新开始。
- 你已经意识到你要求的更改不需要进行,所以你想阻止 Copilot 在这方面做更多的工作。