# 管理智能体会话

实时监视代理的进度，使用后续提示对其进行引导，并停止或存档会话。

使用代理 GitHub 面板监视和管理存储库中的代理会话。

## 监视代理活动

从智能体面板（可从 GitHub 的任何页面访问）或从[智能体页面](https://github.com/copilot/agents?ref_product=copilot\&ref_type=engagement\&ref_style=text)跟踪会话。 由您启动的会话，或由其他用户提示 Copilot 处理的会话，将显示在您的会话列表中。

单击会话以打开会话日志和概述，可在其中监视代理的进度、令牌使用情况和会话长度。

## 查看会话日志

会话日志显示了 Copilot内部推理及其用于了解存储库、进行更改和验证其工作的工具。
Copilot 有自己的临时开发环境，因此可以运行自动化测试和代码检查程序，以在推送之前验证更改。

## 跟踪会话日志的提交

来自 Copilot cloud agent 的提交由 Copilot 创作，启动任务的人列为共同作者。 每个提交消息都包含会话日志的链接，以便跟踪在代码评审或审核期间发生更改的原因。 提交已签名，并在GitHub上显示为“已验证”。

## 控制代理会话

如果 Copilot 正朝着错误的方向前进，或者你意识到原始提示需要调整，则可以在不停止会话的情况下重定向它。

1. 打开 [代理页](https://github.com/copilot/agents?ref_product=copilot\&ref_type=engagement\&ref_style=text) 并选择会话。

2. 在会话日志下面的提示框中，键入后续操作。 例如：

   ```text
   Use our existing ErrorHandler utility class instead of writing custom try-catch blocks for each endpoint.
   ```

3. 按 <kbd>Enter</kbd>。
   Copilot 在完成当前工具调用后将实现你的输入。

每个转向消息占用 AI credits。 控制不适用于第三方编码代理。

## 停止会话

如果任务不再需要完成，或者想要通过新的提示重新开始，请单击会话日志查看器中的 **“停止会话** ”。 停止会话将结束 GitHub Actions 运行并保留任何已推送的提交。

## 存档会话

存档已停止的会话以将其从会话列表中删除。

1. 打开已停止的会话。
2. 单击 **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="More actions" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>**，然后单击“ **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-inbox" aria-label="inbox" role="img"><path d="M2.8 2.06A1.75 1.75 0 0 1 4.41 1h7.18c.7 0 1.333.417 1.61 1.06l2.74 6.395c.04.093.06.194.06.295v4.5A1.75 1.75 0 0 1 14.25 15H1.75A1.75 1.75 0 0 1 0 13.25v-4.5c0-.101.02-.202.06-.295Zm1.61.44a.25.25 0 0 0-.23.152L1.887 8H4.75a.75.75 0 0 1 .6.3L6.625 10h2.75l1.275-1.7a.75.75 0 0 1 .6-.3h2.863L11.82 2.652a.25.25 0 0 0-.23-.152Zm10.09 7h-2.875l-1.275 1.7a.75.75 0 0 1-.6.3h-3.5a.75.75 0 0 1-.6-.3L4.375 9.5H1.5v3.75c0 .138.112.25.25.25h12.5a.25.25 0 0 0 .25-.25Z"></path></svg> 存档会话**”。
3. 在对话框中，单击“ **是”，存档**。

Copilot cloud agent 会话可以存档，但不能删除。 只能删除来自 GitHub Copilot CLI、VS Code、JetBrains 或 GitHub Copilot app 的本地会话。 有关删除会话的详细信息，请参阅 [关于 GitHub Copilot CLI 会话数据](/zh/copilot/concepts/agents/copilot-cli/chronicle#managing-your-session-data)。

## 共享会话

Copilot cloud agent 会话默认 **共享** 。 它们显示在存储库的“代理”选项卡上的“所有会话”视图中，对有权访问存储库的任何人可见。

默认情况下，本地会话（来自 GitHub Copilot CLI、 VS CodeJetBrains 或 GitHub Copilot app） **未共享** 。 可以选择从存储库的“代理”选项卡共享本地会话，以便仅查看存储库协作者的访问权限。 若要共享或取消共享本地会话，请使用会话菜单中的共享控件。

收件人可以查看会话的提示、响应和文件更改，但无法引导或修改会话。 共享本地会话显示在“所有会话”视图中，但不会为其他用户的会话查询编制索引（它们不会显示在其他用户 `/chronicle` 的结果中）。

有关会话同步的详细信息，请参阅 [关于 GitHub Copilot CLI 会话数据](/zh/copilot/concepts/agents/copilot-cli/chronicle#session-syncing)。

## 查询过去的会话

您可以通过在 Copilot Chat、VS Code、JetBrains、GitHub Copilot app 或 GitHub.com 中用自然语言提问来搜索您的会话历史记录。
Copilot会搜索你来自Copilot CLI、Copilot cloud agent和Copilot code review的已同步会话，以提供答案。

您只能查询由您启动的会话。 默认情况下，会话数据是专用的，但可以选择共享单个会话进行仅查看访问。 请参阅本文前面的 [“共享会话](#share-a-session) ”。

### Prerequisites

您的会话必须与您的 GitHub 账户同步。 默认情况下，会话数据会自动同步。 如果已选择退出同步（通过 CLI 设置 JSON 中的设置 `"remoteExport": false` ），或者组织尚未启用“在云中存储本地会话”策略，则会话查询不可用。 有关详细信息，请参阅“[关于 GitHub Copilot CLI 会话数据](/zh/copilot/concepts/agents/copilot-cli/chronicle#session-syncing)”。

### 示例查询

```text
What agent tasks did I run last week?
```

```text
Find the session where I refactored authentication.
```

```text
Have I worked on anything related to the payments API?
```

```text
Show me sessions where the agent struggled or I had to correct it multiple times.
```

Copilot 可以在同步会话中搜索提示、响应、文件更改和其他上下文。

有关特定于 CLI 的会话查询和 `/chronicle` 命令，请参阅 [使用 GitHub Copilot CLI 会话数据](/zh/copilot/how-tos/copilot-cli/use-copilot-cli/chronicle)。 有关如何存储和同步会话数据的概念性信息，请参阅 [关于 GitHub Copilot CLI 会话数据](/zh/copilot/concepts/agents/copilot-cli/chronicle)。

## 在 GitHub Copilot Chat 中继续会话工作

你可以在 Copilot Chat 上的 Copilot cloud agent 与你的 GitHub 会话之间传递上下文。

当你从 Copilot Chat 启动会话时，它会纳入你的对话上下文；在会话运行期间，Copilot Chat 会显示其状态，这样你就可以提出后续问题。

当会话完成后，或者在查看已创建的拉取请求 Copilot 时，你可以询问变更了什么、验证了什么以及原因，Copilot 将依据会话日志作出回答。 您还可以直接从 Copilot Chat 启动另一个会话。

有关详细信息，请参阅 [关于 GitHub Copilot 聊天功能](/zh/copilot/concepts/chat) 和 [使用 GitHub Copilot 浏览拉取请求](/zh/copilot/tutorials/explore-pull-requests)。

## 延伸阅读

* [使用GitHub Copilot处理任务的最佳做法](/zh/copilot/tutorials/cloud-agent/get-the-best-results)