> 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.md).

# 运行房间

了解聊天体验房间由什么组成、侧边栏、线程和消息框各自的作用，以及房间控件位于何处。

一个 [聊天体验](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences.md) 房间由三个工作部分组成：左侧的侧边栏、中间的对话线程，以及底部的消息框。它们分别回答不同的问题——房间里有谁、已经说过什么，以及你发送的下一条消息会发生什么。这些页面介绍一次回合如何运行、如何选择由谁回复以及以哪种模式回复、如何在对话中途更改成员名单，以及房间里的每个控件都做什么。

### 房间由什么组成

房间占满整个页面。侧边栏沿左侧全高展开，线程和消息框上方有一条细窄的顶部栏：

| 部分   | 它的用途                                                                                                                                                |
| ---- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| 顶部栏  | 显示体验名称并承载房间的控件：房间类型、房间 ID、 **仅文本** 标签， [**之前的会话**](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/sessions-and-transcripts.md)，以及栏末尾的三点菜单，它会打开房间的操作 |
| 侧边栏  | 房间里有哪些人、你在其中是谁、房间简报，以及截至目前共享的文件                                                                                                                     |
| 对话线程 | 对话，以及房间对每一回合的报告                                                                                                                                     |
| 消息框  | 你在这里输入内容，并设置由谁回复                                                                                                                                    |

当你在上选择聊天体验时，房间会打开。 **我的体验**它打开时是空的，里面没有人，也没有任何发言。

### 侧边栏

侧边栏就是成员名单。其标题写着 **在此房间中**，一旦有人就座，后面就会跟上角色数量。

空房间会将成员名单和你自己的行替换为一个 **添加参与者** 卡片。房间里的每个角色都会占据自己的一行，显示其名称、角色以及它来自的工作区。

一旦有人在房间里，你自己的行会出现在名单下方。在有两个或更多角色的房间里，它标记为 **主持人** 并描述为“你提问，他们回答”；在只有一个角色的房间里，它标记为 **你** 并描述为“与⟨name⟩交谈”。如果有可显示的工作区，你的工作区会跟在描述后面。

面板末尾有两个部分。 **房间简报** 承载房间类型和整个对话的目的，旁边还有一个 **创建时固定** 标签。 [**在房间中共享**](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/share-files-with-the-room.md) 列出在对话中附加的文件，并写着“你附加的文件会在这里供每个角色查看。”，直到有一个为止。

顶部栏和面板中的每个控件，以及它们各自的作用，都列在 [房间控件参考](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/running-the-room/room-controls-reference.md).

### 对话线程

线程就是对话本身，也是房间报告每条消息发生了什么的地方。

它以房间开启的时间开始显示。只要房间里还没有人，一个置顶的 **房间简报** 卡片会显示目的和房间类型的规则，位于标题上方 **房间里还没有人**。角色加入时会生成一个分隔符，注明谁加入了并说明他们已收到简报，随后是一个装有简报内容的框——标题为 **每个角色加入时被告知的内容** 在有两个或更多角色的房间里，以及 **⟨name⟩加入时被告知了什么** 当房间里只有一个角色时。

只有一个角色的房间不会由其房间类型进行简报。该框中列出的规则始终写作 **另一人**, **保持角色设定**，以及 **在被叫到时回复**，而且围绕你的目的所写的措辞是针对单个角色而写，而不是取自该类型——除非你在创建对话框中自行改写了简报，在那种情况下，以你的措辞为准。

之后，线程承载对话。你自己的消息显示在右侧，每条下面都有说明，报告这一回合要求了什么以及返回了什么。回复显示在左侧，位于角色的名称和角色说明之下。其间，房间会添加简短注释：谁保持沉默、谁没有回答，以及谁离开了房间。

### 消息框

消息框是你输入内容的地方，也是你决定由谁回复的地方。

框中的提示邀请你向房间发言，或者输入 @ 来呼叫某人。文本下方是一排控件，先是用于附加文件的回形针，然后是 respond 标签，它显示下一条消息会要求什么——回复模式，或者当你标记了某人时显示姓名——并打开回复菜单。只有一个角色的房间会用一句话代替该标签，因为没有可在其间路由的人。

只要房间无法接收消息，消息框就会锁定——在房间里还没有任何角色之前、角色正在加入时、回合正在运行时，以及房间连接失败后——而且它总会说明原因。参见 [你无法发送消息](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/troubleshooting/composer-is-locked.md).

### 哪一页回答哪个问题

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>一次回合如何运作</strong><br>为什么房间一次只回复一条消息、回合说明会统计什么，以及为什么某个角色可能什么也不说。</td><td><a href="/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/running-the-room/how-a-turn-works.md">轮次如何运作</a></td></tr><tr><td><strong>选择由谁回复</strong><br>设置下一条消息由谁回复，并在你只想让特定角色回复时标记单个角色。</td><td><a href="/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/running-the-room/choose-who-replies.md">选择谁来回复</a></td></tr><tr><td><strong>回复模式参考</strong><br>全部五种回复模式、每种模式对角色的要求，以及之后线程会显示什么。</td><td><a href="/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/running-the-room/respond-modes-reference.md">回复模式参考</a></td></tr><tr><td><strong>在对话中途添加或移除角色</strong><br>在正在运行的房间中让一个角色入座、移除一个角色，并处理在回合期间会冻结的控件。</td><td><a href="/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/running-the-room/add-or-remove-characters.md">在对话中途添加或移除角色</a></td></tr><tr><td><strong>房间控件参考</strong><br>顶部栏和侧边栏中的每个控件，以及它们各自的作用。</td><td><a href="/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/running-the-room/room-controls-reference.md">房间控件参考</a></td></tr></tbody></table>

房间运行所依据的简报是在所有这些之前、在创建对话框中写好的。

{% content-ref url="/pages/60415f2943b1a54904f985393064fc8d9f4d1836" %}
[房间简报](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/the-room-brief.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.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.