> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/running-the-room/room-controls-reference.md).

# 房间控件参考

聊天体验房间顶部栏和侧边栏中控件的参考，以及每个控件对对话的作用。

聊天体验房间的控制项位于对话上方的顶部栏和左侧的侧边栏中。本页按它们在屏幕上的显示顺序列出这两处控件。线程下方的消息框也有自己的控件——回复芯片和回形针——其说明见于 [选择由谁回复](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/running-the-room/choose-who-replies.md) 和 [与房间共享文件](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/share-files-with-the-room.md).

### 顶部栏

顶部栏位于线程上方，并显示打开此房间所依据的体验名称。它从左到右包含以下内容：

| 部分         | 它的作用                                                                                                                                              |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| 返回箭头       | 返回到 **我的体验** 并结束对话                                                                                                                                |
| 体验名称       | 标示打开此房间所基于的聊天体验                                                                                                                                   |
| 铅笔         | 打开 **重命名体验**，可在那里更改名称。房间类型、用途和简介保持不变                                                                                                              |
| 房间类型标签     | 创建该体验时所使用的房间类型，例如 **焦点小组**                                                                                                                        |
| 房间 ID 标签   | 复制房间 ID。参见 [房间 ID](#the-room-id) 如下所示                                                                                                             |
| 角色头像       | 房间中每个角色对应一个头像，后面跟着数量： `1 个角色`，或 `4 个角色` 在四人房间中                                                                                                    |
| **仅文本** 标签 | 房间的模式。悬停时会显示 **房间模式**。角色以文字作答                                                                                                                     |
| **之前的会话**  | 列出此体验已记录的会话，按最新优先排序，并提供 **打开体验页面**。请参阅 [查看过往会话](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/sessions-and-transcripts/review-a-past-session.md) |
| 三点菜单       | 打开此房间的操作，如下所列                                                                                                                                     |

随着窗口变窄，栏位会舍弃放不下的内容。首先消失的是房间 ID 和角色数量，返回箭头旁会出现一个人物图标，用于在线程上方打开侧边栏。再窄一些时，房间类型标签、头像以及 **仅文本** 标签也会消失，而且 **之前的会话** 只会以图标显示。

### 三点菜单

三点菜单位于顶部栏右侧，包含以下操作：

| 物品          | 它的作用                                                                                                                                          |
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **重命名体验**   | 打开与铅笔相同的重命名对话框                                                                                                                                |
| **使用新说明复制** | 打开创建对话框，并预填充此体验中的内容，所有字段均可编辑。参见 [为什么简报无法更改](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/the-room-brief/why-the-brief-cannot-be-changed.md) |
| **导出记录稿**   | 将此房间中的对话下载为 Markdown 文件。参见 [导出记录稿](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/sessions-and-transcripts/export-a-transcript.md)            |
| **清空对话**    | 结束对话并清空房间：线程、角色以及 **在房间中共享** 列表                                                                                                               |

{% hint style="warning" %}
**清空对话** 一旦你选中它，就会结束对话。它不会要求确认，而且已结束的对话无法重新加入。房间会保持开启、清空并等待角色，因此你随后看到的房间是一个新房间。
{% endhint %}

### 房间 ID

房间 ID 是顶部栏中的短标识符，以 `rm_`开头。选择该标签会复制它，并以 **房间 ID 已复制**.

该 ID 属于聊天体验，因此从该体验打开的每个房间都会显示相同的 ID。它也会显示在……的列表视图中 **我的体验**，你可以从该行复制它。

该 ID 用于在你自己的账户内标识房间。聊天体验及其打开的房间只能由创建它们的账户访问，因此该 ID 不能让其他人进入房间。

由于该 ID 隶属于体验，因此无法区分不同会话。每个会话都有自己的标识符，导出的记录稿也以它命名。参见 [导出记录稿](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/sessions-and-transcripts/export-a-transcript.md).

### 侧边栏

侧边栏包含成员列表、你自己的行、简介以及目前共享的文件。在窄屏上，它会通过返回箭头旁的人物图标覆盖在线程上方打开，标题栏中的 X 可将其关闭。从上到下包含以下内容：

| 部分              | 它的作用                                                               |
| --------------- | ------------------------------------------------------------------ |
| **在此房间中**       | 标示该部分。一旦有角色就位，其后会显示角色数量                                            |
| 标题栏中的加号         | 打开角色选择器。房间中有角色后才会出现                                                |
| 角色行             | 显示角色名称、其角色以及来源：你的工作区，或对通过 ID 添加的角色显示“与你共享”                         |
| 角色行右侧的省略号       | 保留 **从房间中移除**                                                      |
| **添加角色**        | 打开角色选择器。位于角色列表下方，并在 **添加参与者** 卡片上（当房间为空时）                          |
| **主持人** 或 **你** | 包含你自己的行的部分。 **主持人** 在有两个或更多角色的房间中， **你** 在单角色房间中                   |
| 你的行             | 你的名字后带有 **（你）** ，后面描述为“你提问，他们回答”或“与 ⟨name⟩ 对话”，如果有可显示的内容，则再跟上你的工作区 |
| **房间简报**        | 创建体验时设置的房间类型和用途，在每个会话中都相同                                          |
| **创建时固定**       | 简介旁的锁。悬停时会解释为何简介无法更改，并提供 **使用新说明复制**                               |
| **在房间中共享**      | 本次对话中附加的文件。在附加文件之前显示“你附加的文件会在这里对每个角色显示。”                           |

无论房间大小如何，该面板都会显示相同的房间类型和用途。不过，在单角色房间中，分配给该角色的简介会以自己的措辞显示，而不是来自房间类型。参见 [房间说明是如何编写的](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/the-room-brief/how-the-room-brief-is-written.md).

加号、 **添加角色**，以及 **从房间中移除** 在回合进行中或房间正在打开时都会被禁用。原因会写在 **添加角色** 以及行菜单中，加号在悬停时也会显示该原因。参见 [在对话中途添加或移除角色](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/running-the-room/add-or-remove-characters.md).

空房间会用一个单独的 **添加参与者** 卡片替代成员列表和你自己的行，内容为“每个角色在加入的瞬间都会收到房间简介。”

### 相关页面

{% content-ref url="/pages/7005e68f9ae36198bb49889d444783908f91755a" %}
[在对话中途添加或移除角色](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/running-the-room/add-or-remove-characters.md)
{% endcontent-ref %}

{% content-ref url="/pages/74590cb5e120e705f258bba7fb72a88ca6dd0bff" %}
[选择谁来回复](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/running-the-room/choose-who-replies.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.convai.com/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/running-the-room/room-controls-reference.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.