# 在 Raycast 中使用 Copilot 云代理

从 Raycast 启动器启动和跟踪 Copilot cloud agent 会话。

[Raycast](https://www.raycast.com/) 是适用于 Windows 和 macOS 的可扩展启动器。
GitHub Copilot使用 Raycast 的扩展，您可以在您的计算机上随时随地启动和跟踪Copilot cloud agent任务，并实时观看会话日志。

## 先决条件

1. 从 [Raycast 网站](https://www.raycast.com)安装 Raycast。
2. GitHub Copilot单击**扩展页上的**“[安装扩展](https://www.raycast.com/github/github-copilot)”按钮，安装 Raycast 的扩展。

## 启动会话

1. 打开 Raycast，搜索“Copilot”，找到“**创建任务**”命令，然后按<kbd>Enter</kbd>。

2. 单击 **使用 GitHub** 登录，然后完成身份验证流程。 Raycast 将重新打开。

3. 输入提示，描述您希望 Copilot 执行的操作。

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

4. 选择要在其中工作的存储库 Copilot 。

5. 可选地为 Copilot 的拉取请求选择一个基分支。
   Copilot 将基于此分支创建新分支，然后将更改推送到面向该分支的拉取请求。

6. （可选）从下拉菜单中选择具有专用行为和工具的 custom agent。 有关详细信息，请参阅“[为Copilot cloud agent创建自定义代理](/zh/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents)”。

7. （可选）可以使用下拉菜单来选择将使用的 Copilot 模型。 如果所选模型支持可配置推理，还可以使用下拉菜单选择推理级别。 有关详细信息，请参阅“[更改 GitHub Copilot 云代理的 AI 模型](/zh/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model)”。

8. 按 <kbd>Command</kbd>+<kbd>Enter</kbd> （macOS） 或 <kbd>Ctrl</kbd>+<kbd>Enter</kbd> （Windows） 启动任务。

Copilot 将启动新会话。
Copilot 将处理任务并将更改推送到其拉取请求中，任务完成后，它会将你添加为审阅者，并触发通知。

> \[!NOTE]
>
> 如果在启动任务时无法选择特定存储库，则拥有该存储库的组织可能已启用 OAuth app 访问限制。 要了解如何请求批准“GitHub Copilot for Raycast” OAuth app，请参阅 [请求组织批准 OAuth 应用](/zh/account-and-profile/how-tos/organization-membership/requesting-organization-approval-for-oauth-apps)。

## 通过 Raycast 分配问题

1. 打开 Raycast，搜索“Copilot”，找到命令**分配问题给Copilot**，然后按<kbd>Enter</kbd>。

2. 单击 **使用 GitHub** 登录，然后完成身份验证流程。 Raycast 将重新打开。

3. 选择要在其中工作的存储库 Copilot 。

4. 选择要分配给 Copilot 的问题。

5. 可选地为 Copilot 的拉取请求选择一个基分支。
   Copilot 将基于此分支创建新分支，然后将更改推送到面向该分支的拉取请求。

6. （可选）从下拉菜单中选择具有专用行为和工具的 custom agent。 有关详细信息，请参阅“[为Copilot cloud agent创建自定义代理](/zh/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents)”。

7. （可选）可以使用下拉菜单来选择将使用的 Copilot 模型。 如果所选模型支持可配置推理，还可以使用下拉菜单选择推理级别。 有关详细信息，请参阅“[更改 GitHub Copilot 云代理的 AI 模型](/zh/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model)”。

8. （可选）提供其他说明。 这些内容将与你的问题内容一起传递给 Copilot。

9. 按<kbd>Command</kbd>+<kbd>Enter</kbd>（macOS）或<kbd>Ctrl</kbd>+<kbd>Enter</kbd>（Windows）指派任务。

Copilot 将启动新会话。
Copilot 将处理任务并将更改推送到其拉取请求中，任务完成后，它会将你添加为审阅者，并触发通知。

> \[!NOTE]
>
> 如果在启动任务时无法选择特定存储库，则拥有该存储库的组织可能已启用 OAuth app 访问限制。 要了解如何请求批准“GitHub Copilot for Raycast” OAuth app，请参阅 [请求组织批准 OAuth 应用](/zh/account-and-profile/how-tos/organization-membership/requesting-organization-approval-for-oauth-apps)。

## 会话跟踪

1. 打开 Raycast，搜索“Copilot”，找到“**查看任务**”命令，然后按 <kbd>Enter</kbd>。
2. 单击 **使用 GitHub** 登录，然后完成身份验证流程。 Raycast 将重新打开。
3. 你将看到一个任务列表。 选择任务，然后使用以下键盘快捷方式：
   * 若要实时观看会话日志，请按 <kbd>Enter</kbd>。 日志实时更新，因此可以在不离开 Raycast 的情况下监视 Copilot进度。
   * 要在浏览器中打开会话日志，请按 <kbd>Command</kbd>+<kbd>Enter</kbd>（macOS）或 <kbd>Ctrl</kbd>+<kbd>Enter</kbd>（Windows）。
   * 要打开链接的拉取请求，请按 <kbd>Command</kbd>+<kbd>P</kbd> （macOS）或 <kbd>Ctrl</kbd>+<kbd>P</kbd> （Windows）。

> \[!NOTE]
> 如果在 Raycast 中看不到某些任务，则拥有存储库的组织可能已启用 OAuth app 访问限制。 若要了解如何请求批准“GitHub Copilot for Raycast” OAuth app，请参阅 [请求组织批准 OAuth 应用](/zh/account-and-profile/how-tos/organization-membership/requesting-organization-approval-for-oauth-apps)。

## 延伸阅读

* [管理智能体会话](/zh/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents)
* [使用GitHub Copilot处理任务的最佳做法](/zh/copilot/tutorials/cloud-agent/get-the-best-results)