Thanks to visit codestin.com
Credit goes to docs.github.com

Skip to main content

跟踪 GitHub Copilot 的会话

可以使用代理面板或页面、 Visual Studio CodeJetBrains IDE、Eclipse、 GitHub CLIRaycast 和会话日志跟踪 Copilot其进度并了解其方法。

谁可以使用此功能?

Copilot云代理可用于GitHub Copilot Pro、GitHub Copilot Pro+、GitHub Copilot业务和GitHub Copilot Enterprise计划。 代理在所有存储于GitHub的存储库中可用,除非这些存储库由托管用户帐户拥有或已被显式禁用。
Sign up for Copilot

介绍

在提供 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 --helpgh agent-task view --help

从 Raycast 跟踪代理会话

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

  1. Raycast 网站安装 Raycast。
  2.        GitHub Copilot单击**扩展页上的**“[安装扩展](https://www.raycast.com/github/github-copilot)”按钮,安装 Raycast 的扩展。
    
  3. 打开 Raycast,搜索“Copilot”,找到“查看任务”命令,然后按 Enter
  4. 单击 使用 GitHub 登录,然后完成身份验证流程。 Raycast 将重新打开。
  5. 你将看到一个任务列表。 选择任务,然后使用以下键盘快捷方式:
    • 若要实时观看会话日志,请按 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中查看由代理生成的当前和过去的拉取请求列表。

  1. 在主页上的 GitHub Mobile “代理”部分中,点击 “代理任务”。

    显示当前打开的拉取请求列表,即你要求 Copilot 生成的请求。

  2. 使用列表顶部的按钮筛选拉取请求列表。

    例如,若要仅显示合并的任务,请点击 “打开 ”,然后在下拉列表中点击“ 合并”。

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

将提交跟踪到会话日志

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

  • 每次提交都是由 Copilot创作的,启动任务的人被标记为共同作者。
  • 每个提交消息都包含一个指向该提交的会话日志的链接,因此你可以了解为什么 Copilot 在代码评审期间进行更改,或稍后跟踪更改以进行审核。
  • 来自 Copilot云代理 的提交都经过签名,并在 GitHub 上显示为“已验证”。

使用会话日志了解 Copilot其方法

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

在会话日志中,可以看到 Copilot内部独白及其用于了解存储库、进行更改和验证其工作的工具。

注意

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

          Copilot从“代理”选项卡引导会话

在它完成任务的同时,你可以操控 Copilot。 你可能希望引导会话的原因包括:

  •           Copilot 似乎走错了方向,你想让它更清晰。
    
  • 你在描述所需工作时犯了一个错误,你决定重新开始。

请按照以下步骤来操控 Copilot:

  1. 打开 “代理”选项卡
  2. “代理会话 ”列表中,选择要为其提供进一步输入的任务。
  3. 在提示框中,当它正在处理任务时提示 Copilot。

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

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

注意

每条引导消息会消耗一个高级请求额度。

停止 Copilot 会话

可以通过单击会话日志查看器中的Copilot”来停止**** 继续处理任务。

突出显示了“Stop session”按钮的日志查看器的屏幕截图。

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

  • 你在描述所需工作时犯了一个错误,你决定重新开始。
  • 你已经意识到你要求的更改不需要进行,所以你想阻止 Copilot 在这方面做更多的工作。

延伸阅读