> 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/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/the-room-brief/write-your-own-briefing.md).

一个 **焦点小组** 将体验保留为其预填目的，会生成以下三部分：

| 部分   | 来源    | 措辞                                                                                       |
| ---- | ----- | ---------------------------------------------------------------------------------------- |
| 开场句  | 房间类型  | "你正在加入一个由主持人主持的焦点小组。你是多名参与者中的一员。"                                                        |
| 目的   | 你写的内容 | "新款辣味鸡肉三明治试吃后的反馈总结。五位普通顾客分享对口味、价格和包装的真实感受。"                                              |
| 结尾规则 | 房间类型  | "主持人会提出问题。只有在被问到时才回答，并且只在你所知道的内容相关时才回答。当主持人邀请讨论时，再与其他参与者交流。否则就倾听。保持角色，不要脱离设定，并结合你自己的背景。" |

这三部分会合成一段文字，而不是三段。每种房间类型都提供不同的开场句和不同的一组结尾规则，因此相同的目的在不同类型下会生成不同的简报。参见 [房间类型参考](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/the-room-brief/room-types-reference.md) 了解每种类型设置了什么。

**Custom** 与五种预设类型相比有两点不同。它的开场句“你正在加入一个由创建者设定目的的房间：”以冒号结尾，因此你的目的会被视为这句话的延续。它也是唯一一个以空白开头的类型 **用途** 字段。

如果目的没有以句号、问号或感叹号结尾，系统会自动补上一个，因此它在段落中间会作为一句完整的话出现。无论你选择哪种房间类型都会这样，单角色房间也是如此。

### 单角色房间会收到什么

单角色房间的简报会被写成两个人之间的对话，而不是群体对话：

| 部分   | 单角色房间中的措辞                            |
| ---- | ------------------------------------ |
| 开场句  | "你正在加入一个由创建者设定目的的聊天体验："              |
| 目的   | 你写下的目的，作为一句话                         |
| 结尾规则 | "房间里还有另外一个人。保持角色，结合你自己的背景，并在被提及时回应。" |

房间类型仍然决定你最初使用的目的，以及房间中显示的房间类型标签，但上面的开场句和结尾规则会取代房间类型自带的内容。两个或更多角色的房间则改用房间类型自己的措辞。

该 **创建聊天体验** 对话框会预览两个或更多角色房间的简报。角色实际收到其中哪一种，会在房间打开时根据当时在场的角色数量决定。

### 房间如何标注这份简报

房间会根据其中有多少角色，以不同方式标注同一份简报。在消息串中，简报框标题为 **⟨name⟩ 加入时被告知的内容** 在单角色房间中，以及 **每个角色加入时被告知的内容** 在两个或更多角色的房间中。侧边栏也会随之变化：包含你自己那一行的部分名称不同，你名字下方的那一行名称也不同。参见 [房间控制参考](/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/the-room-brief/room-types-reference.md) 查看每种类型显示的标签。

在单角色房间中，这些标签显示为 **另一人**, **保持角色**，以及 **被提及时回应**，无论该体验是在哪种房间类型下创建的。

### 当简报过长时

简报上限为 4,000 个字符，只有目的部分会被缩短以适应该上限。

开场句和结尾规则会完整保留。目的会在段落即将超过上限的位置截断，并以省略号结尾。

你自己撰写的简报也遵循相同的上限。 **每个角色将被告知的内容** 框中的 **创建聊天体验** 对话框在 4,000 个字符处停止接受文本，因此你在框中看到的措辞就是角色收到的措辞。同一个框在为你撰写简报时也会显示已完成的内容，因此在创建体验之前，你可以阅读整段文字，包括省略号在内的全部内容。

### 相关页面

位于简报中间的目的只会在创建对话框中写一次。那里也是可以用你自己的措辞替换简报的地方，而在那之后，简报的任何内容都无法再更改。

{% 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/d7f01a946536f2d04de02930a02801e454f2a82e" %}
[编写你自己的简报](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/the-room-brief/write-your-own-briefing.md)
{% endcontent-ref %}

{% content-ref url="/pages/049346515088c6b87be9938af7c005b0930eb41a" %}
[为什么简报不能被修改](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/the-room-brief/why-the-brief-cannot-be-changed.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/how-the-room-brief-is-written.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.