# 从 GitHub CLI 使用 Copilot 云代理

从Copilot云代理启动并跟踪GitHub CLI会话。

> \[!NOTE]
> `agent-task` 命令集仅在 GitHub CLI 的 v2.80.0 或更高版本中可用。 此命令集是一个 公开预览 且可能会更改。

## 启动会话

您可以使用 `gh agent-task create` 命令启动新的 Copilot云代理 会话。

在没有任何参数的情况下运行命令时，系统会要求输入提示。
Copilot云代理 对提示进行操作，并在当前存储库中打开拉取请求。

可使用命令行选项执行以下操作：

* 提供提示 (`gh agent-task create "Example prompt"`)
* 选择一个基础分支，而不是使用该仓库的默认分支 (`--base`)
* 选择一个仓库，而非以当前仓库 (`--repo`) 为目标
* 实时跟踪会话日志 (`--follow`)

要查看所有可用选项，请运行 `gh agent-task create --help`。

## 会话跟踪

您可以使用 `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 --help` 或 `gh agent-task view --help`。

## 延伸阅读

* [管理智能体会话](/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)