跳至主要内容

跟踪 GitHub Copilot 会话

您可以使用代理面板或页面、Visual Studio Code、JetBrains IDE、Eclipse、GitHub CLI、Raycast 以及会话日志来跟踪 Copilot 的进度并了解其工作方式。

谁可以使用此功能?

Copilot 云代理在 GitHub Copilot Pro、GitHub Copilot Pro+、GitHub Copilot Business 和 GitHub Copilot Enterprise 计划中可用。该代理在 GitHub 上存储的所有仓库中均可用,受管用户账户拥有的仓库以及已明确禁用的仓库除外。
注册 Copilot

简介

在您向 Copilot 分配任务后,它会在后台自主工作以完成任务。请参阅 关于 GitHub Copilot 云代理

代理面板、代理选项卡、GitHub CLI 以及适用于 Raycast 的 GitHub Copilot 扩展可提供跨仓库的代理会话概览。您可以使用它们来启动新任务并跟踪 Copilot 的进度。

您亦可在 Visual Studio Code 中跟踪特定仓库的 Copilot 会话。

在代理会话期间或之后,您可以检查会话日志以了解 Copilot 对您问题的处理方式。

从代理选项卡跟踪代理会话

您可以在代理面板(在 GitHub 的每个页面均可访问)或专用的代理选项卡中看到正在运行和过去的代理会话列表。如果您启动了会话或提示 Copilot 在其他用户的会话上工作,代理会话将出现在您的会话列表中。

要打开 代理选项卡,请点击以在任意页面的导航栏中打开代理面板,然后点击 查看全部

每个会话都会显示其状态。点击会话可打开会话日志和概览,您可以在其中监控代理的进度、令牌使用情况、会话次数以及会话时长。

您可以在该选项卡中启动新的代理会话。请参阅 让 GitHub Copilot 创建拉取请求

从 GitHub CLI 跟踪代理会话

注意

agent-task 命令集仅在 GitHub CLI v2.80.0 或更高版本中可用。此命令集为公开预览,可能会更改。

您可以使用 gh agent-task list 命令在 GitHub CLI 中查看正在运行和过去的代理会话列表。输出将显示您最近的会话列表。

要查看特定会话的更多信息,请使用 gh agent-task view 命令。例如,要查看 monalisa/bookstore 仓库中与拉取请求 #123 关联的会话信息,请运行 gh agent-task view --repo monalisa/bookstore 123

要查看会话日志,请添加 --log 选项。可选地,使用 --follow 选项以在代理工作时实时流式传输日志。

要查看所有可用选项,请运行 gh agent-task list --helpgh agent-task view --help

从 Raycast 跟踪代理会话

Raycast 是适用于 Windows 和 macOS 的可扩展启动器。使用适用于 Raycast 的 GitHub Copilot 扩展,您可以启动并跟踪 Copilot 云代理任务,并在计算机任意位置实时查看会话日志。

  1. Raycast 网站安装 Raycast。
  2. 扩展页面上点击 Install Extension 按钮,即可为 Raycast 安装 GitHub Copilot 扩展。
  3. 打开 Raycast,搜索 “Copilot”,找到 View Tasks 命令,然后按 Enter
  4. 点击 Sign in with GitHub,然后完成身份验证流程。Raycast 将重新打开。
  5. 您将看到任务列表。选择一个任务后,使用以下键盘快捷键
    • 要实时观看会话日志,请按 Enter。日志会实时更新,您无需离开 Raycast 即可监控 Copilot 的进度。
    • 要在浏览器中打开会话日志,请按 Command+Enter(macOS)或 Ctrl+Enter(Windows)。
    • 要打开关联的拉取请求,请按 Command+P(macOS)或 Ctrl+P(Windows)。

注意

如果您在 Raycast 中看不到某些任务,可能是仓库所属的组织已启用了 OAuth 应用访问限制。要了解如何为 “GitHub Copilot for Raycast” OAuth 应用请求批准,请参阅 请求组织对 OAuth 应用的批准

您也可以在 Raycast 中启动新的代理会话。请参阅 让 GitHub Copilot 创建拉取请求

从 Visual Studio Code 跟踪会话

您可以在 Visual Studio Code 中使用 GitHub Pull Requests 扩展查看特定仓库的正在运行和过去的代理会话列表。

安装扩展后,您可以通过点击侧栏的 GitHub 按钮查看 Copilot 的会话。

对于列出的每个会话,您可以一目了然地看到其状态,或点击它在 Visual Studio Code 内导航至相应的拉取请求。

要查看会话日志,先点击列表中的拉取请求,然后点击 View Session

您也可以在 Visual Studio Code 中启动新的代理会话。请参阅 让 GitHub Copilot 创建拉取请求

要直接在 VS Code 中打开代理会话,请在代理选项卡上点击 Open in VS Code 选项。

注意

在 VS Code 中打开会话目前仅在 VS Code Insiders 可用。

从 JetBrains IDE 跟踪会话

注意

JetBrains IDE 中的 Copilot 云代理处于公开预览阶段,可能会更改。

您可以在 JetBrains IDE 中使用 GitHub Copilot Chat 扩展查看项目的正在运行和过去的代理会话列表。请参阅 在您的环境中安装 GitHub Copilot 扩展

您可以通过点击侧栏的 GitHub Cloud Agent Jobs 按钮,或在通过 GitHub Copilot Chat 将任务委派给 Copilot 后点击 Open Job List 按钮,查看 Copilot 的所有会话。

对于列出的每个会话,您可以一目了然地看到其状态。点击 Open in Browser 在浏览器中打开拉取请求,或右键单击正在运行的作业,然后点击 Cancel Job 进行取消。

当代理作业启动和完成时,Copilot 也会通知您。

从 Eclipse 跟踪会话

注意

Eclipse 中的 Copilot 云代理处于公开预览阶段,可能会更改。

您可以在 Eclipse 中使用 GitHub Copilot Chat 扩展查看项目的正在运行和过去的代理会话列表。请参阅 在您的环境中安装 GitHub Copilot 扩展

您可以通过点击位于聊天窗口右上角的 ,或在通过 GitHub Copilot Chat 将任务委派给 Copilot 后点击 Open Job List 按钮,查看 Copilot 的所有会话。

对于列出的每个会话,您可以一目了然地看到其状态。点击 Open in Browser 在浏览器中打开拉取请求,或右键单击正在运行的作业,然后点击 Cancel Job 进行取消。

当代理作业启动和完成时,Copilot 也会通知您。

从 GitHub Mobile 跟踪会话

您可以在 GitHub Mobile 中看到由代理生成的正在运行和过去的拉取请求列表。

  1. 在 GitHub Mobile 主页的 “Agents” 区域,点击 Agent Tasks

    将显示当前打开的拉取请求列表,这些是您让 Copilot 生成的。

  2. 使用列表顶部的按钮来过滤拉取请求列表。

    例如,要仅显示已合并的任务,点击 Open,然后在下拉菜单中点击 Merged

    Screenshot of the status dropdown list with a check mark against 'Open'.

追踪提交至会话日志

Copilot 云代理的提交具有以下特征

  • 每个提交的作者都是 Copilot,启动任务的人会被标记为共同作者。
  • 每条提交信息都包含指向该提交会话日志的链接,您可以了解 Copilot 在代码审查期间为何进行更改,或在以后审计时进行追溯。
  • Copilot 云代理的提交已签名,在 GitHub 上显示为 “Verified”。

使用会话日志了解 Copilot 的工作方式

您可以在 GitHub、Visual Studio Code 或 Raycast 中深入查看 Copilot 的会话日志,以了解其如何处理您的任务。

在会话日志中,您可以看到 Copilot 的内部独白以及它用来了解仓库、进行更改和验证工作所使用的工具。

注意

Copilot 拥有自己的开发环境,包括运行自动化测试和代码检查工具,以在推送前验证其更改。

从代理选项卡引导 Copilot 会话

在 Copilot 完成任务的过程中,您可以对其进行引导。您可能想要引导会话的原因包括

  • Copilot 似乎走错方向,您想为其提供更明确的指示。
  • 您在描述所需工作时出现错误,并决定重新开始。

按照以下步骤对 Copilot 进行引导

  1. 打开 代理选项卡
  2. Agent sessions 列表中,选择您想提供进一步输入的任务。
  3. 在提示框中,对正在执行任务的 Copilot 进行提示。

例如,Use our existing ErrorHandler utility class instead of writing custom try-catch blocks for each endpoint.

Copilot 在完成当前工具调用后,将开始实现您的输入。

注意

引导每条消息会消耗 一次高级请求

停止 Copilot 会话

您可以通过在会话日志查看器中点击 Stop session,阻止 Copilot 继续执行任务。

Screenshot of the log viewer with the 'Stop session' button highlighted.

您可能想要停止会话的原因包括

  • 您在描述所需工作时出现错误,并决定重新开始。
  • 您意识到所请求的更改并非必要,因此想阻止 Copilot 继续对此进行任何工作。

延伸阅读

© . This site is unofficial and not affiliated with GitHub, Inc.