在 GitHub Copilot 应用中使用代理会话

同时运行多个独立代理会话，每个会话都有其自己的分支，并使用不同的会话模式、模型和工具引导它们。

谁可以使用此功能？

所有 Copilot 计划均可使用 GitHub Copilot app。
下载 GitHub Copilot app

在本文中

可以从存储库启动会话以处理该存储库中的工作，或启动项目来为 Copilot 设定一个目标并让其协调工作。 项目可以跨一个或多个存储库，也可以专注于不需要存储库的任务。 请参阅“在 GitHub Copilot 应用中使用项目”。

启动会话

可以在单独的工作树中运行会话，以并行处理多个任务，或在现有检出副本中工作。

  1. 在边栏中的 “会话” 旁边，单击 。
  2. 在“在...中开始会话”下，选择已连接的存储库或文件夹。 若要先连接一个，请选择“添加 GitHub 存储库”、“克隆存储库”或“打开本地文件夹”。
  3. 在提示框下方，打开“环境”下拉菜单，然后选择 此计算机 或 云。 云会话在由 GitHub 托管的隔离沙盒中运行。 请参阅 使用云和本地沙盒。
  4. 在提示框下方，打开“工作区”下拉菜单，然后选择“ 新建工作树 ”以使用存储库的独立工作副本，或 当前签出 以在现有签出中工作。 还可以选择基准分支。
  5. 从提示字段下方的下拉列表中选择会话模式、模型和推理工作。 如果选择 Copilot Fusion 和工作量级别，Copilot 会分析每个任务并选择一个模型来完成它，并在需要时通过可用的执行模式协调多个模型。
  6. 在提示词字段中描述任务。 您可以使用 # 引用问题，使用 @ 添加文件，或使用 / 输入命令。

代理开始工作。 活动会话显示在按存储库分组的边栏中，单击任意会话以切换到该会话。

有关可在提示框中使用的命令列表，请参阅 GitHub Copilot 应用程序的斜杠命令。

选择会话模式

会话模式控制代理如何与你协作。 它独立于工具权限，而工具权限则控制代理在运行工具之前何时需要先询问。 可以从提示字段下方的下拉列表中设置模式，并随时更改它。

  • 交互式：你和代理协同工作。 代理建议更改并等待输入，然后再继续操作。
  • 计划：代理首先创建计划。 在代理执行该计划之前，请查看并批准该计划。
  • Autopilot：代理完全自主工作 - 编写代码、运行测试和迭代，而无需等待输入。

选择工具权限

在应用会话中， Copilot 使用工具完成任务，例如运行终端命令、读取和编辑文件、搜索代码库、提取 Web 内容以及将工作委派给专用代理。 某些工具可以修改你的系统或访问外部资源，因此工具权限会控制 Copilot 在使用这些工具前何时请求你的批准。

可以在三个选项之间进行选择，以确定你希望在批准 Copilot 使用的工具方面参与到什么程度。

  • 手动审批（每次询问）：在运行工具之前请求审批。 这为你提供了最大的掌控程度，但要求你响应最多的提示。
  • 辅助：使用模型来评估每个请求，自动批准它判断为安全的请求，并提示你批准潜在的不安全请求。 Assisted permissions 减少提示，同时保持对潜在风险操作的监督。
  • 无条件审批（全部批准）：无需请求批准即可运行工具。 这是最方便的选项，但您将无法监督单个操作。

有关使用 assisted permissions的详细信息，请参阅 允许安全命令在未经手动批准的情况下运行。

选择单个会话的权限级别：

  1. 在会话中，单击提示字段下方的模式。
  2. 将鼠标悬停在 工具权限上。
  3. 选择 “每次询问”、“辅助” 或 “全部批准”。

若要为将来的本地会话设置默认权限级别，

  1. 打开应用设置。
  2. 单击“ 会话”。
  3. 在 “工具权限” 下，选择 “每次都询问”、“辅助” 或 “全部允许”。

选择模型

可以从提示字段下方的下拉列表中选择模型和推理工作。 更高的推理工作量使代理有更多的时间来思考复杂的问题，但可能需要更长的时间。 可以在会话期间随时更改这两种设置。

如果在模型选取器中选择 Fusion，然后选择努力程度级别，则应用会自动为你的任务选择模型和执行模式。 在 Copilot Fusion 运行时，你可以跟踪每个步骤和所用模型的进度。 提供响应后，可以将鼠标悬停在响应下方的努力程度名称上，以查看所使用的模型列表。 有关详细信息，请参阅“关于 GitHub Copilot Fusion”。

如果在应用中配置了自己的模型提供程序，这些模型也会显示在选取器中。 有关设置步骤，请参阅 将 LLM 模型添加到 GitHub Copilot 应用。

将鼠标悬停在 模型选取器中的图标上以查看模型详细信息。

使用聊天功能

边栏中的 “聊天 ”部分将打开聊天模式，而无需创建专用分支或工作树。 在开始会话之前，使用它进行集思广益、提问或探索想法。 聊天历史记录按对话名称保存并列出。

若要存档聊天而不丢失其历史记录，请右键单击边栏中的聊天以打开其菜单，然后单击“ 存档聊天”。

管理会话和聊天

使用 “管理会话” 查看、搜索和筛选会话和聊天，包括存档聊天。 你可以选择要存档或删除的多个项目，以及还原以前存档的聊天。 该视图还显示工作文件和聊天历史记录使用的磁盘空间的单独可排序列。

  1. 打开应用设置，然后选择 “会话”。
  2. 单击“ 管理会话”。
  3. 搜索或筛选以查找要管理的会话或聊天。
  4. 选择一个或多个会话或聊天，然后存档或删除它们。 若要还原存档聊天，请找到聊天，然后还原它。

使用云端和本地沙盒

云和本地沙盒以不同的方式保护会话：

  • 云沙盒：在由 GitHub其托管的独立环境中运行整个会话。 如果要使会话远离计算机或并行运行多个资源密集型任务，请使用云沙盒。 启动会话时，从 “环境”下拉菜单中选择 “云”。 然后，可以从任何 Copilot 客户端跟进并引导会话。
  • 本地沙盒：在计算机上运行会话，但限制可用于代理运行工具的文件系统、网络和凭据访问。 当代理需要使用你的本地工具或开发服务，但你又希望限制其对整台机器其他部分的访问权限时，请使用本地沙盒。 在项目设置中为新的本地仓库和工作树会话配置默认值，或使用 /sandbox on 或 /sandbox off 更改当前活动的本地会话。

注意

云沙盒和本地沙盒是单独的技术。 云沙盒是一个由 GitHub 托管并运行整个会话的环境。 本地沙盒机制是你自己的计算机上的一组操作系统限制。 一方的设置、策略和命令不适用于另一方。

本地沙盒不适用于云沙盒会话，也不适用于在远程主机上运行的会话。 有关这两种类型的沙盒工作方式的详细信息，请参阅 关于 GitHub Copilot 的本地沙盒 和 关于 GitHub Copilot 的云沙盒。 若要启用本地沙盒，请参阅 使用本地沙盒机制。

在 WSL 中运行会话

在Windows，可以使用应用在 适用于 Linux 的 Windows 子系统 （WSL） 2 分发版中运行代理会话。 在开始之前，请使用帐户 GitHub 登录到应用，并确保已安装 WSL 2，且该发行版中有可用的存储库或文件夹。

  1. 在 WSL 分发中打开终端，然后运行 gh auth login 以通过 GitHub 进行身份验证。 WSL 中的身份验证与在 Windows 登录到应用分开。
  2. 打开应用设置，然后选择边栏中的 环境。 应用会自动发现已安装的 WSL 分发版。
  3. 单击连接以连接你的 WSL 发行版。
  4. 打开分发的详细信息。 在 “存储库和文件夹” 下，单击 “添加存储库或文件夹”。
  5. 选择或键入存储库或文件夹的 Linux 路径，然后单击“ 添加存储库 ”或 “添加文件夹”。
  6. 启动存储库或文件夹的会话。 在提示框下的“环境”下拉菜单中，选择 “环境”下的发行版。

如果 环境 不可见，请在应用设置中选择 实验，并确保已启用 WSL 主机 。

在应用会话中使用 /security-review

注意

/security-review斜杠命令当前处于公开预览状态，可能会更改。

可以在活动代理会话中运行 /security-review 斜杠命令，查看当前工作流更改是否存在高可信度漏洞。 该命令返回具有严重性和置信度分数的优先结果，以及可在同一会话中应用和验证的建议修复。

  1. 打开正在进行代码更改的活动会话。
  2. 在提示框中，键入 /security-review 并按 Enter。
  3. 查看审查结果，然后根据需要对代码进行修改。

这种轻量级、按需进行的评审，通过在你打开拉取请求之前对本地更改进行初步检查，对 GitHubcode scanning、Dependabot 和 secret scanning 形成补充。

若要与会话一起处理本地评审结果和现有 code scanning 警报，请安装 GitHub 安全扩展插件。 请参阅“在 GitHub Copilot 应用中查看和修复安全警报”。

使用橡皮鸭智能体

橡皮鸭智能体是一个内置智能体，它充当建设性批评者，审查您当前的计划、实施或测试，并返回具体的反馈。 该代理基于与驱动您当前会话的模型不同的另一模型运行。

启用“橡皮鸭”后，Copilot 在工作过程中可在关键节点自动向其咨询。 主会话智能体将任务传递给橡皮鸭智能体，接收评审意见，然后决定如何应用该反馈，再继续执行。

您也可以手动要求 Copilot 向橡皮鸭智能体寻求评审。

  1. 打开活动会话。
  2. 在提示框中，键入 /rubber-duck 并请求对当前计划、实施或测试进行批评。

有关橡皮鸭智能体的更多信息，请参阅 向橡皮鸭代理征求第二意见。

在应用会话中使用/chronicle

由于GitHub Copilot app基于GitHub Copilot CLI构建，因此你可以使用Copilot CLI会话历史记录功能（例如/chronicle），从你在该应用中以及其他Copilot CLI会话中完成的工作中获取洞察。

例如，可用于 /chronicle standup 汇总最近的工作。 有关详细信息，请参阅“使用 GitHub Copilot CLI 会话数据”。

使用语音听写功能

可以使用语音听写在会话中朗读提示，而不是键入提示。

在使用语音听写之前，需要在应用设置中对其进行配置。

  1. 打开应用设置，然后选择 “语音听写 ”选项卡。
  2. 选择键盘快捷方式。
  3. 允许在操作系统设置中访问麦克风。
  4. 下载本地转写模型。

设置后，使用快捷方式启动和停止语音听录。 应用将转录的文本插入到提示框中，以便你可以在发送之前查看或编辑它。

键盘快捷方式

支持 GitHub Copilot app 键盘快捷方式来帮助导航会话、在工作区之间切换和执行常见操作。 若要查看可用的快捷方式，请打开应用，转到 “帮助”，然后单击 键盘快捷方式。

还可以使用 markdown 文件、第三方工具或脚本中的深层链接直接在应用中启动会话。 有关详细信息，请参阅“使用深层链接打开 GitHub Copilot 应用”。