> 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/send-your-first-message.md).

# 发送第一条消息

在聊天体验房间中编写并发送消息，指定某个角色让其回应，并在回复到达时阅读它们。

你是聊天体验的主持人，角色会回答你，而不是彼此交谈。使用此页面可在房间中发送第一条消息、点名某个角色让它回复，以及在回合结束后查看对话串所报告的内容。

### 前提条件

* 一个聊天体验房间，里面已经至少有一个角色。参见 [向房间添加角色](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/add-characters-to-the-room.md).

### 发送消息

{% stepper %}
{% step %}

#### 编写消息

选择房间底部的消息框并输入。

框中的提示会告诉你正在写给谁。在有多个角色的房间里，它显示 **询问群组…** 在对话开始前，以及 **询问群组，或 @ 标记某人…** 之后。在只有一个角色的房间里，它显示 **消息** 后跟该角色的名字。
{% endstep %}

{% step %}

#### 发送它

按 `Enter`，或选择发送按钮——即消息框右下角的向上箭头。 `Shift`+`Enter` 会换行，而不是发送。

你的消息会出现在对话串中，并且消息框会锁定，直到该回合结束。
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
一条没有明确指向任何人的消息可能根本不会得到回复。角色只有在被点名时才会回答，否则会保持沉默，所以当你想要特定回答时，请点名某个角色或对其进行标记。
{% endhint %}

### 点名某个角色，让它回答

一个房间运行在 **自动** 模式下，除非你更改它；在自动模式下，简报决定谁来回答——角色在被点名时会回复，否则保持沉默。你正在输入内容下方的芯片会显示下一条消息将使用的模式，并显示 **自动 · 房间简介决定** ，直到你更改它。

在一个包含两个或更多角色的房间中发送第一条消息之前，对话串会说明你所依据的规则：“回复模式设为自动：简报决定谁来回答。对任何消息都可以使用 @ 标记或芯片来覆盖。” 每种房间类型对角色的要求见于 [房间简报是如何写成的](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/the-room-brief/how-the-room-brief-is-written.md).

点名某个角色就是直接写出它的名字。写“Maya，你怎么看这个价格？”就是在点名 Maya；写“你怎么看这个价格？”则没有点名房间中的任何人。

标记是更明确的方式，也是房间强制要求的唯一方式。在消息框中输入 `@` ，然后从弹出的列表中选择你想要的角色。

被标记的角色必须回复，房间会要求它这样做，而不是把决定权留给角色。在有两个或更多角色的房间里，芯片会变更以显示消息发给谁，而你没有标记的每个角色都会跳过该回合。

有关标记列表的其余内容，以及如何设置芯片以便它在一条消息到下一条消息之间保持不变，请参见 [选择谁来回复](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/running-the-room/choose-who-replies.md).

### 发送后对话串显示的内容

房间中的每个角色都会在对话串中显示其名字，并在回合进行时显示动画输入指示器，无论它最终是否会回答。回复到达时会替换该角色的指示器，而回合结束时仍然亮着的指示器会一起清空。

在你的消息下方，标题会报告该回合要求了什么以及返回了什么。在一个运行于自动模式的、包含两个或更多角色的房间中，标题显示 **自动 · 房间简介决定**，后跟一个由最多三个计数构成的结果：

| 计数             | 含义                                                          |
| -------------- | ----------------------------------------------------------- |
| `4 个中有 2 个已回复` | 你发送消息时，房间里有多少角色已经回复，占当时房间内总数的多少                             |
| `1 个正在等待`      | 有多少角色尚未回复，也尚未被报告为未回答。在回合进行时，这些是仍需回答的角色；一旦回合结束，它们就是保持沉默的那些角色 |
| `1 个未回答`       | 房间报告为未回答的角色数量                                               |

在一个只有一个角色的房间中，标题会改为注明该角色——**发送给** 后跟该名字——并添加 `已回复` ，当回复到达后；或者 `等待中` ，当回合仍在进行时。如果该角色保持沉默，标题则不会带任何结果。

在回合进行时，消息框会用等待状态代替通常的提示： **正在等待 4 个中的 2 个…**，其中第一个数字表示仍有多少回复尚未到来，而不是已经到来的数量。它显示为 **正在完成回合…** ，当回合收尾时，并在回合结束后解锁。

有关其他回复模式下这些计数的含义，请参见 [回合如何运作](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/running-the-room/how-a-turn-works.md).

### 当某个角色保持沉默时

一个本来无需回答的角色会在回复下方的注释中被点名，注释会告诉你如何获得它的那一面。

在自动模式下，注释会点名这些角色，并写道“按照简报要求保持沉默。如果你想听听它们的说法，请标记它们。” 当有多个角色保持沉默时，最后一句会改为“如果你想听听其中某个的说法，请标记它。” 一个所有角色都保持沉默的房间会产生这条注释，而不会有任何回复。

该注释中点名的角色会在标题中计入 `正在等待` ，而不是计入 `未回答`。这两种结果不同：保持沉默的角色是选择什么也不说。

要从该注释中点名的角色那里得到回答，请再发送一条标记它的消息。

### 下一步

一旦你运行过一次对话，该体验就属于 **我的体验**上的若干体验之一，而再次找到它、重命名它，或使用新的简报对其进行复制，都是不同的任务。

{% content-ref url="/pages/6e1ca09b18a432f83ac60ca4073562afe124a6c2" %}
[管理你的聊天体验](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/manage-your-chat-experiences.md)
{% endcontent-ref %}

要决定由谁回答，而不是交给简报，请阅读每种回复模式对角色的要求。

{% content-ref url="/pages/7eeb66a9ac5bb80ce7d065a4b723f69d026f387e" %}
[回复模式参考](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/running-the-room/respond-modes-reference.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/send-your-first-message.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.