在云中使用 GitHub 中的Copilot

Introduction

您可以在 GitHub Copilot in the cloud 的多个位置发起 GitHub 会话。会话运行后，可以监视其进度，使用后续提示对其进行引导，并在不离开浏览器的情况下对生成的拉取请求进行迭代修改。

有关 Copilot in the cloud 的详细信息，请参阅 GitHub.com 和 GitHub Mobile 上的GitHub Copilot。

还可以使用 agent apps 通过这些相同的入口点启动合作伙伴构建的代理。有关详细信息，请参阅“使用代理应用”。

Copilot in the cloud启动会话

可以从多个不同的入口点启动会话。

你的位于 github.com/copilot 的 Copilot主页。
您的https://github.com[](https://github.com?ref_product=copilot&ref_type=engagement&ref_style=text)个人仪表板或主页，登录到后显示。
存储库中的“代理”选项卡或面板。

可以使用默认设置立即发送提示，或者在发送提示之前将会话配置为适合任务。

在提示框中，描述你希望 Copilot 执行的操作。包括所需的结果和任何约束。

提示

还可以在提示中使用斜杠命令执行特定操作，例如 /rubber-duck 获取第二个意见、/security-review 检查代码仓库中的漏洞，或 /usage 显示会话的使用信息。
（可选）单击**附加**，为请求提供Copilot参考资料。

选择 文件和文件夹、从计算机上传、存储库或空间，为您的请求提供上下文。

对于云沙盒会话，可以通过配置连接器和个人自定义 MCP 服务器来提供来自第三方源的其他上下文，请参阅 Copilot连接器和模型上下文协议（MCP）。
打开模式选取器以选择要如何协作 Copilot。
- 交互式：（默认值）与 Copilot 一步一步交互。
- Autopilot：将任务委托给 Copilot 进行端到端执行。
在同一菜单中，使用 工具权限 来控制工具请求的批准方式。
- 选择“辅助”（默认值），它使用安全检查来确定是批准请求还是询问你。
- 选择“始终询问”，以便每次请求都需要批准。
- 选择 “全部允许” 以自动批准所有工具、路径和 URL 请求。
打开模型选取器并选择“ 自动 ”或特定模型。模型按其优势进行分组，帮助你在速度和成本效益、多功能性和智能性或处理复杂任务的能力之间进行选择。如果所选模型支持可配置的推理，例如平衡，还可以使用下拉菜单选择推理级别。
在提示框下方，使用聊天会话上下文选取器选择会话范围（个人、组织或存储库）。
- 在搜索框中，键入存储库名称以搜索要添加的存储库。
- 在“跨存储库询问任何内容”下，选择“聊天”以跨存储库提问。默认作用域是个人仓库。单击右侧的映像以打开帐户菜单，并通过选择组织或按存储库所有者（用户或组织）搜索来更改范围。
- 在 在存储库中工作 下，选择一个最近使用的存储库进行操作。列出的存储库反映了所选作用域。
注意
- 通过“Attach”菜单（前面的步骤）添加存储库可提供提示的参考（上下文材料）。而在此处，在 “开始会话” 下选择它会使存储库成为会话的工作存储库（范围）。在会话开始时，云沙盒获取存储库的副本，并在现有约束中授予 Copilot 权限，以操作其中的内容。
- 如果未列出存储库，则该存储库可能因个人设置或组织或企业策略而从 Copilot 中排除。
（可选）如果选择了上面的存储库，还可以单击 main（或列出的默认分支名称），以选择 Copilot 用作工作上下文并在其中运行的分支。
打开环境以选择 Copilot 的运行位置。
- 云：（默认）在 GitHub托管的云沙盒中运行。
- 操作：在基于 GitHub Actions 的环境中运行。如果以前选择了聊天会话上下文，则无法为会话选择此环境。
- 环境：展开列表并选择列出的远程环境之一。
单击“ 发送消息 ”或按 Enter 发送提示并启动会话。

Copilot 将根据所选上下文和环境响应提示并启动会话。如果请求， Copilot 将生成已更改的文件列表、拉取请求、生成的项目（如研究计划）以及任何其他相关输出。

Copilot从文件、问题或拉取请求开始

从上下文页面打开与 Copilot 的聊天会话时，会话将从您当前打开的文件、议题或拉取请求的上下文开始。

不能从上下文面板本身内启动新的代理会话;需要从 Copilot 页面、主页或代理选项卡启动它。

使用 Copilot cloud agent 开始会话

从“代理”选项卡或面板启动会话

可以从“代理”选项卡和“代理”面板启动会话。唯一的区别是入口点-一旦看到“新建代理任务”窗体，步骤是相同的。

打开代理面板或选项卡：
- 在存储库中打开代理选项卡。
- 导航到 GitHub Copilot “所有会话”页：转到 github.com/copilot。还可以通过打开顶部导航栏中的 GitHub Copilot 菜单，然后单击 查看所有会话，进入此页面。
- 打开代理面板：在存储库中的“代码”选项卡中，单击“转到文件”搜索栏右侧的。
使用提示字段中的下拉菜单，选择要使用的存储库 Copilot 。
打开环境以选择 Copilot 的运行位置。
- 云：（默认）在 GitHub托管的云沙盒中运行。
- 操作：在基于 GitHub Actions 的环境中运行。如果以前选择了聊天会话上下文，则无法为会话选择此环境。
- 环境：展开列表并选择列出的远程环境之一。
键入描述请求的提示。还可以通过粘贴、拖动或上传图像来添加视觉输入，例如屏幕截图或 UI 模型。支持的文件：image/png、image/jpeg、image/gif、image/webp。

例如： Implement a user friendly message for common errors.

如果要 Copilot 打开拉取请求，可以在提示中提问，例如Open a pull request to implement a user friendly message for common errors.
（可选）为 Copilot 的变更选择基分支。 Copilot 将基于此分支创建新分支。
（可选）如果您想分配一个代理或一个具有专用行为和工具的，可以单击custom agent以打开代理下拉菜单。可以从存储库、组织或企业中选择现有 custom agent。还可以单击“创建代理”，在所选存储库和分支中创建新的agent profile代理。有关详细信息，请参阅“为Copilot cloud agent创建自定义代理”。

注意

Third-party coding agents are available for all paid Copilot plans.
（可选）可以使用下拉菜单来选择将使用的 Copilot 模型。如果所选模型支持可配置推理，还可以使用下拉菜单选择推理级别。有关详细信息，请参阅“更改 GitHub Copilot 云代理的 AI 模型”。
单击或按 Enter。

Copilot 将启动一个新会话，该会话将显示在提示框下面的列表中。 Copilot 将处理任务并推送任何代码更改。

在会话日志中，只需单击一次即可追踪 Copilot的工作并打开拉取请求。 有关详细信息，请参阅“[AUTOTITLE](/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents)”。

从仪表板启动会话

你可以要求 Copilot 从仪表板中的提示框开始工作。仪表板是你在登录时访问 GitHub 时看到的 https://github.com 上活动的个性化概述。

导航到 https://github.com 的仪表板。
** 单击“任务**”按钮。
使用提示字段中的下拉菜单，选择要使用的存储库 Copilot 。
键入描述请求的提示。

例如： Implement a user friendly message for common errors.

如果要 Copilot 打开拉取请求，可以在提示中提问，例如Open a pull request to implement a user friendly message for common errors.
可选地为 Copilot 的拉取请求选择一个基分支。 Copilot 将基于此分支创建新分支。
（可选）如果您想分配一个代理或一个具有专用行为和工具的，可以单击custom agent以打开代理下拉菜单。可以从存储库、组织或企业中选择现有 custom agent。还可以单击“创建代理”，在所选存储库和分支中创建新的agent profile代理。有关详细信息，请参阅“为Copilot cloud agent创建自定义代理”。

注意

Third-party coding agents are available for all paid Copilot plans.
单击“立即发送” 或按“返回”。

你将被带到“代理”选项卡，并 Copilot 启动一个新会话，该会话将显示在提示框下方的“最近会话”列表中。 Copilot 将处理任务并推送任何代码更改。

注意

如果已启用功能预览版 中的“新建仪表板体验 ”，新会话将显示在仪表板的提示框下的“代理会话” 中。有关详细信息，请参阅“个人仪表板”。

从Copilot Chat开始

当你从 Copilot Chat 启动任务时，新的 Copilot cloud agent 会话会纳入当前聊天对话的上下文。这意味着，你无需在你的 Copilot 提示中重复说明已经向 /task 提供过的细节。

在 GitHub Copilot Chat 上打开 GitHub.com。
键入 /task 以请求 Copilot 创建拉取请求，并提供有关要 Copilot 更改的内容的详细信息。

例如： /task Create a pull request to put backticks around file names and variables in output.
可选地为 Copilot 的拉取请求选择一个基分支。 Copilot 将基于此分支创建新分支，然后将更改推送到面向该分支的拉取请求。
（可选）如果您想分配一个代理或一个具有专用行为和工具的，可以单击custom agent以打开代理下拉菜单。可以从存储库、组织或企业中选择现有 custom agent。还可以单击“创建代理”，在所选存储库和分支中创建新的agent profile代理。有关详细信息，请参阅“为Copilot cloud agent创建自定义代理”。

注意

Third-party coding agents are available for all paid Copilot plans.
单击或按 Enter。

Copilot 将启动一个新会话，该会话将显示在提示框下面的列表中。 Copilot 将处理任务并将更改推送到其拉取请求中，任务完成后，它会将你添加为审阅者，并触发通知。

将问题分配给 Copilot

可以请求 Copilot 将问题分配给 Copilot 来开始处理问题。 Copilot 将开始处理任务，发起拉取请求，然后在完成时请求您进行评审。

注意

此功能目前处于公开预览，可能会发生更改。

在 GitHub 上，导航到存储库的主页面。
在仓库名称下，单击 “Issues”****。
打开要分配给 Copilot 的问题。
在右侧菜单中，单击“代理人”****。
从被分配者列表中单击Copilot。

此时，将显示其他选项。
在 “可选提示 ”字段中，可以添加特定 Copilot指南。添加有助于理解和完成任务的任何上下文、约束或特定要求 Copilot 。

例如，可以包含有关要使用的特定编码模式或框架、测试要求、代码样式偏好设置、应修改或不应修改的文件或目录的说明。

除了在此处提供的详细信息之外， Copilot 还将使用为目标存储库配置的任何自定义说明。请参阅“为GitHub Copilot添加存储库自定义说明”。
可以使用对话框中的下拉菜单更改 Copilot 将要工作的存储库，以及它将从中派生的分支。

所有您拥有至少读取权限的存储库都会显示在存储库下拉菜单中。但是，只有在您对该存储库具有写入访问权限并且Copilot cloud agent已为该存储库启用时，您才能选择该存储库。

如果在与问题源组织不同的组织中选择存储库，或者在问题位于专用存储库中时选择公共存储库，则会显示警告。

如果未指定存储库， Copilot 则会在与问题相同的存储库中工作。如果未指定分支， Copilot 则从所选存储库的默认分支工作。

提示

当将问题分配给 Copilot 时，它会收到问题标题、描述、当前存在的任何注释以及你提供的任何其他说明。分配问题后， Copilot 将不知道，因此不会对添加到问题的任何进一步注释做出反应。如果您掌握了更多信息，或对原始要求进行了更改，请将这些内容作为注释添加到 Copilot 提出的拉取请求中。
（可选）如果您想分配一个代理或一个具有专用行为和工具的，可以单击custom agent以打开代理下拉菜单。可以从存储库、组织或企业中选择现有 custom agent。还可以单击“创建代理”，在所选存储库和分支中创建新的agent profile代理。有关详细信息，请参阅“为Copilot cloud agent创建自定义代理”。

注意

Third-party coding agents are available for all paid Copilot plans.
（可选）可以使用下拉菜单来选择将使用的 Copilot 模型。如果所选模型支持可配置推理，还可以使用下拉菜单选择推理级别。有关详细信息，请参阅“更改 GitHub Copilot 云代理的 AI 模型”。

还可以从Copilot上的其他位置将问题分配给GitHub.com。

从存储库的**问题**页上的问题列表中。
查看问题 GitHub项目时。

为新存储库设定种子

创建新存储库时，可以通过输入提示来请求 Copilot 为新存储库设定种子。

在任何页面的右上角，选择，然后单击“新建存储库”。
使用“所有者”下拉菜单选择你想要拥有存储库的帐户。
在 “提示” 字段中，输入描述您希望 Copilot 构建的内容的提示。

例如， Create a Rust CLI for converting CSV spreadsheets to Markdown1. 单击“创建存储库”。

Copilot 将立即打开草稿拉取请求。 Copilot 将处理任务并将更改推送到其拉取请求中，任务完成后，它会将你添加为审阅者，并触发通知。

修复失败的 GitHub Actions 工作流运行

当 GitHub Actions 工作流在拉取请求分支上运行失败时，可以请求 Copilot 调查并修复失败。

打开 GitHub，导航到失败的工作流运行作业页。
** 单击“修复”按钮Copilot**。

Copilot 将启动一个新会话，调查失败的原因，并将修补程序推送到分支。

继续处理拉取请求

可以要求 Copilot 对现有拉取请求进行更改或处理评审意见。然后，可以跟踪生成的会话并提供后续说明。

Copilot要求进行更改

可以在任何拉取请求的评论中提及 @copilot ，要求 Copilot 进行更改。此功能适用于由 Copilot 创建的拉取请求，以及由你或其他人创建的拉取请求。

默认情况下，Copilot 将提交直接推送到拉取请求分支。若要改为创建单独的拉取请求，请在批注中描述该请求。还可以检出分支并自己推送更改。

通过 GitHub Web 界面提交拉取请求评论（而非审阅或审阅评论）时，使用模型选择器选择一个模型。 Copilot 默认情况下，使用原始拉取请求中的模型。

分派审阅评论

你可以将评审意见分派给 Copilot，让其落实人工审阅者的反馈和 GitHub Copilot code review。

在拉取请求中，打开 “文件已更改” 选项卡。
导航到你希望 Copilot 实现的第一条审阅评论。
- 若要分派一条批注，请单击使用Copilot修复。
- 若要分派多个评论，请单击“添加到批处理”。继续添加要 Copilot 处理的注释。
在 管理批处理 面板中，添加任何其他说明，并可选择使用模型选择器选择模型。
选择您希望 Copilot 如何应用更改：
- 若要直接将更改提交到分支，请单击 “修复并提交”。
- 若要让 Copilot 使用这些更改创建新的拉取请求，请从下拉菜单中单击 修复并打开拉取请求。