> 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/add-characters-to-the-room.md).

# 向房间添加角色

从当前所在工作区或通过粘贴角色 ID，将角色添加到聊天体验房间，并查看每个角色加入并接收简报。

聊天体验会以一个空房间的形式打开，而你安排在其中的角色就是回答你的人。你可以在每次会话中添加角色：再次打开该体验时，会在一个没有人的新房间中开始。使用此页面可从你的工作区或通过角色 ID 添加角色，并确认每个角色何时已加入并收到简报。

### 前提条件

* 你创建的聊天体验。请参见 [创建聊天体验](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/create-a-chat-experience.md).
* 至少有一个你可以访问的角色，无论是在你正在使用的工作区中，还是通过他人与你共享的角色 ID。请参见 [使用聊天体验所需条件](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/prerequisites.md).

### 打开角色选择器

选择 **添加角色**。在空房间中，该按钮会出现在两个位置：在 **添加参与者** 卡片上，在侧边栏中，以及在 **房间里还没有人** 线程中。一旦房间里有了角色，相同的按钮就会位于侧边栏列表下方。面板标题中的加号控件也可执行相同操作。

**添加角色** 在房间连接中以及角色正在回复消息时不可用。侧边栏会在按钮下方显示原因，轮次结束后按钮会重新可用。

该 **向房间添加角色** 对话框会在两个选项卡中打开： **来自我的工作区** 和 **按角色 ID**。两个选项卡共用同一个选择，因此在它们之间切换会保留你已选的内容。

### 从你的工作区添加角色

**来自我的工作区** 列出你正在使用的工作区中的角色，按最近编辑的优先排序。

{% stepper %}
{% step %}

#### 找到你想要的角色

网格初始显示最近编辑的 8 个角色，下方有一行会统计列表中的角色数量，并说明其中有多少正在显示。若还有更多，网格下方的按钮会将其展开为完整列表，并在标签中带上该数量，例如 **显示全部 24 个**.

要缩小网格范围，请在搜索字段中输入。它会同时匹配角色名称和角色描述。没有结果的搜索会显示“没有匹配的角色。”
{% endstep %}

{% step %}

#### 选择它们

选择一个角色卡片即可将其加入选择，再次选择即可取消。每个已选卡片的角落都会显示一个勾选标记。

页脚会统计所选内容，并列出其中前四个角色的名称。
{% endstep %}

{% step %}

#### 确认

选择确认按钮。其标签会统计所选内容，因此选择了三个角色时，它会显示 **向房间添加 3 个**，并且在你至少选择一个之前一直不可用。

对话框关闭，角色开始加入。
{% endstep %}
{% endstepper %}

### 按 ID 添加角色

**按角色 ID** 可根据 ID 查找角色。用于他人从你自己的工作区之外与你共享的角色。

{% stepper %}
{% step %}

#### 粘贴 ID

在 **角色 ID**下方，每行粘贴一个角色 ID。该字段可一次接受多个 ID，下面的说明会指出 ID 必须满足的条件：任何其所有者已与你共享的角色都可以加入，即使不在你的工作区中。
{% endstep %}

{% step %}

#### 查找它们

选择查找按钮。其标签会统计你输入的 ID 数量，因此粘贴了三个 ID 时，它会显示 **查找 3 个**.

每个 ID 都会成为下方的一行 **结果**。成功解析出的角色会显示其名称、描述以及一个 **添加** 按钮。未解析成功的 ID 会变成一行，显示该 ID 的缩写形式，并说明三种情况中的哪一种发生了：

* 该角色存在，但未与你共享。
* 没有可供你使用的、具有该 ID 的角色。
* 查找本身未完成。
  {% endstep %}

{% step %}

#### 添加并确认

选择 **添加** 在你想要的每一行上。该按钮会变为 **已添加**，页脚中按 ID 添加的角色计数会增加。

选择 **完成** 以关闭对话框。
{% endstep %}
{% endstepper %}

### 观察角色加入并接收简报

每个角色都会立刻出现在侧边栏中，并带有 **正在加入房间…** 作为名称下方的状态，待其加入后会变成普通条目。在房间连接期间，消息框会被锁定，并显示 **等待角色加入…**.

线程会标记简报送达的时刻。分隔线会列出角色名称，并说明他们已加入并接收了简报。一个标题为 **每个角色加入时被告知的内容** 的框中包含简报内容本身，每个角色各一行，注明它也包含自己的 persona。在单角色房间中，该框会改为以该角色的名称命名。简报包含什么，以及房间类型和用途如何生成它，会在 [房间简报](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/the-room-brief.md).

中说明。在有两个或更多角色的房间中，该框下方的说明会表示响应模式设为自动，并且由简报决定谁来回复。

侧边栏会随着房间规模变化。只有一个角色时，它会将你自己的行标记为 **你** 并将其描述为与该角色交谈；有两个或更多时，它会将该行标记为 **主持人** 并将其描述为“你提问，他们回答”。

### 这些角色仅属于本次会话

你添加的角色仅会在本次会话中就座。再次打开该体验会开启新会话，而打开的房间是空的。

简报会从一个会话沿用到下一个会话。角色和消息不会沿用，因此每次打开该体验时都需要添加你想要的角色。

{% hint style="warning" %}
在房间打开时重新加载页面会结束该会话，并将你返回到一个空房间。继续前请再次添加角色。
{% endhint %}

### 下一步

房间中至少有一个角色时，消息框会解锁，你就可以向房间发言了。

{% content-ref url="/pages/073aa8578a1ebb6453fd44b8427e5737de1aba18" %}
[发送第一条消息](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/send-your-first-message.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/add-characters-to-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.