> 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/the-room-brief.md).

# 房间简报

了解房间简报会告诉加入聊天体验的每个角色什么、它出现在哪里，以及哪个页面回答哪个问题。

一项聊天体验只有一份简报，房间中的每个角色一加入便会收到它。该简报由你在创建体验时设置的房间类型和目的写成，并在那一刻确定下来。这些页面将说明简报包含什么、其措辞是如何组成的，以及只有哪一个时刻由你来撰写这些措辞。

### 简报由什么组成

简报由房间类型、目的，以及由这两者写成的一段简报组成。

房间类型决定了对话运行的模式。在有两个或以上角色的房间里，它提供简报开头的那句话、结尾的规则，以及旁边显示的简短规则标签。只有一个角色的房间则改用单角色措辞来写简报：它有自己的开场句、自己的结尾规则，以及同样的三个规则标签，不论体验是按哪种类型创建的。共有六种类型，它们在由谁主导对话、以及是否有人主导对话方面各不相同。参见 [房间说明是如何编写的](/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/create-a-chat-experience.md)，它位于系统为你写好的简报中间。

简报是角色实际收到的那段文字。它由房间类型和目的为你写成，而“创建”对话框是你可以将那段措辞替换为自己的唯一位置。

### 每个角色加入时会收到什么

每个角色都会在其原有的人设之上收到简报。角色本身不会被编辑，而角色在接收简报前也不需要额外设置。参见 [使用聊天体验所需条件](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/prerequisites.md) 房间接受哪些角色。

在空房间中，侧边栏会这样说明：“每个角色在加入的那一刻都会收到房间简报。” 一旦角色进入，线程就会将每个角色所携带的人设与简报一并列出。

简报旁边的规则标签会以简短形式重述这些规则，供你阅读。简报段落就是角色被告知的内容。

### 简报在产品中的出现位置

从“创建”对话框到房间及其 **之前的会话** 页面，简报会在五个位置显示，而简报正文的措辞本身会在其中两个位置出现：

| 位置                                                                                                                    | 显示内容                                                                      |
| --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| 该 **创建聊天体验** 对话框                                                                                                      | **每个角色将被告知的内容**，以可编辑文本框形式承载简报                                             |
| 线程，在尚无角色的房间中                                                                                                          | 一个置顶的 **房间简报** 卡片：房间类型、目的以及规则标签                                           |
| 房间侧边栏                                                                                                                 | 一个 **房间简报** 成员列表下方的区域，显示房间类型和目的，适用于整个对话                                   |
| 线程，在角色加入后                                                                                                             | **每个角色加入时被告知的内容**，其中包含简报正文以及每个角色对应的一行人设。在单角色房间中，标题显示为 **⟨角色名称⟩加入时被告知的内容** |
| 该体验的 [**之前的会话**](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/sessions-and-transcripts/review-a-past-session.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/the-room-brief/how-the-room-brief-is-written.md">房间简报是如何编写的</a></td></tr><tr><td><strong>房间类型参考</strong><br>六种房间类型、每种类型设定的规则，以及它会为你填入的目的。</td><td><a href="/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/the-room-brief/room-types-reference.md">房间类型参考</a></td></tr><tr><td><strong>撰写你自己的简报</strong><br>用你自己的措辞替换系统为你写好的简报，并将系统写好的版本放回。</td><td><a href="/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/the-room-brief/write-your-own-briefing.md">编写你自己的简报</a></td></tr><tr><td><strong>为什么简报无法更改</strong><br>在创建时就已确定的内容，以及如何让相同的角色对应不同的措辞运行。</td><td><a href="/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/the-room-brief/why-the-brief-cannot-be-changed.md">为什么简报不能被修改</a></td></tr></tbody></table>

要首次设置简报，请从“创建”对话框开始。关于无法编辑的简报该如何处理，请参阅故障排除页面。

{% content-ref url="/pages/20c927f8c4b5a32b788bb0a212b0be01c0ff1591" %}
[创建聊天体验](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/create-a-chat-experience.md)
{% endcontent-ref %}

{% content-ref url="/pages/bd8ecd0a747fe5a0b24502f315519d2b336ad2d9" %}
[简报与文字记录](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/troubleshooting/briefs-and-transcripts.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/the-room-brief.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.