> 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 %}

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

网格会先显示最近编辑的八个角色，下面有一行会统计列表中的角色并说明当前显示了多少个。当还有更多时，网格下方的按钮会将其展开为完整列表，并在标签中显示该数量，例如 **显示全部 24 个**.

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

{% step %}

#### 选择它们

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

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

{% step %}

#### 确认

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

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

### 通过 ID 添加角色

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

{% stepper %}
{% step %}

#### 粘贴 ID

在……下 **角色 ID**，每行粘贴一个角色 ID。该字段可一次接受多个，下面的说明会写明 ID 需要满足的条件：任何其拥有者已与你共享的角色都可以加入，即使它来自你的工作区之外。
{% endstep %}

{% step %}

#### 查找它们

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

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

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

{% step %}

#### 添加并确认

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

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

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

每个角色都会立即出现在侧边栏中，并带有 **正在加入房间……** 位于其名称下方，并在加入后变成普通行。在房间连接期间，消息框会锁定并显示 **等待角色加入……**.

线程会标记简报送达的时刻。一个分隔符会列出角色名称，并说明它们已加入并收到简报。一个标题为 **“每个角色加入时被告知的内容”** 的框中包含简报本身，并为每个角色附上一行，说明它也带有自己的角色设定。在只有一个角色的房间中，该框则改为以该角色的名字命名。简报包含什么，以及房间类型和用途如何生成它，在 [房间简报](/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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.convai.com/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/add-characters-to-the-room.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.