> 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/convai-playground/character-customization/narrative-design.md).

# 叙事设计 | Playground

## 简介

叙事设计让你在保持对话灵活性的同时，通过高层级目标引导角色。你无需硬编码一棵台词树，而是定义目标和决策点，然后让角色动态响应。这种方法适用于许多领域，例如游戏、学习与培训模拟、旅游、零售助手以及客户支持终端。你可以在这里了解更多关于叙事设计背后的考量 [这里。](https://convai.com/blog/convai-narrative-design)

<figure><img src="/files/04b815639f894d5b107a90681d4af719efedd00a" alt=""><figcaption></figcaption></figure>

***

## 视频

观看这组视频，了解如何在 Convai Playground 中创建叙事设计图。\
该演示采用导游场景，逐步展示如何设计、连接并实现你自己的叙事设计流程。

{% embed url="<https://youtube.com/playlist?feature=shared&list=PLn_7tCx0Chip2mfSbOkqJLevEbm3jDuNV>" %}

***

## 访问叙事设计

在 Convai Playground 中打开你的角色，并选择 '**叙事设计**' 从左侧边栏。你会看到一个图表编辑器，可以使用节点连接流程。

***

## 叙事图

叙事图由四个构建块组成：

## 章节

一个章节包含：

* **目标** – 角色在叙事这一部分中要达成的目标。\
  \&#xNAN;*例如：* 虚拟导游的目标可以是欢迎用户，并询问他们是否想开始参观。
* **决策** – 基于用户交互的选择，用于引导角色进入不同章节。\
  \&#xNAN;*例如：* 如果用户对参观说“是”，下一章节可能会开始参观路线；如果说“否”，角色可能会提供替代信息。

{% hint style="warning" %}
确保决策清晰且明确；否则，预期的章节可能不会被触发。
{% endhint %}

每个章节都有一个 **唯一 ID**.

<figure><img src="/files/ed10c4dec636dfdc62279bed9caf30f6c9145e4f" alt=""><figcaption></figcaption></figure>

***

## 触发器

触发器是来自应用程序的一个简单信号，用于指示某个条件已满足。触发后，触发器会将图推进到下一个相连的章节。

每个触发器都有一个 **唯一 ID**.

**示例**

* **基于位置（空间）：** 你的应用检测到用户进入了某个区域，并触发与该章节相关联的触发器。
* **基于时间：** 你应用中的计时器到期并触发该触发器。
* **基于事件：** 发生了一个应用内事件，例如“安全演示已完成”，于是你触发该触发器。

<figure><img src="/files/f985ef4668cdc93703d6833dc3127d6339a21c6c" alt=""><figcaption></figcaption></figure>

***

## 示例场景

为了更好地理解叙事设计在实践中的运作方式，下面有两个示例角色，你可以直接在 Convai Playground 中探索。\
打开每个链接，前往 **叙事设计** 选项卡，并查看图表如何通过章节和触发器组织。

### 工厂参观导游 – [查看角色](https://convai.com/pipeline/dashboard/character?id=8cd9fa0c-384b-11ef-a852-42010a7be00e)

这是一个设定在制造设施中的培训模拟场景。\
该角色使用基于位置的触发器（例如，进入传送带区域或装配线时）来引导用户穿过工作空间、讲解安全规程，并推进参观流程。\
非常适合 **工业培训** 是位于 **入职培训模拟**.

<figure><img src="/files/04b815639f894d5b107a90681d4af719efedd00a" alt=""><figcaption></figcaption></figure>

### 房地产看房导览 – [查看角色](https://convai.com/pipeline/dashboard/character?id=4d31ce84-8c6a-11ef-bc7a-42010a7be011)

这是一个房地产模拟场景，角色引导潜在买家参观房产中的不同房间。\
与工厂示例类似，它使用 **基于位置的触发器** ——例如，当用户进入某个特定房间（如厨房、浴室、卧室）时，叙事图中相应的章节就会被触发。\
这使角色能够根据用户在房产中的移动动态调整对话内容。\
适用于 **虚拟房产导览**, **销售演示**，以及 **客户入职**.

<figure><img src="/files/b3e0b1ca05ee3520fd3cee5373e353fae66934a0" alt=""><figcaption></figcaption></figure>

***

## 语法说明

这些特殊字符可以添加到你的叙事设计图中的节点，以控制特定结果和行为。

| 特殊字符     | 示例                              | 使用                              |
| -------- | ------------------------------- | ------------------------------- |
| \<speak> | \<speak> 我会说这句完全一样的话！ \</speak> | 强制角色仅以标签内的短语作出回应，不进行释义或添加额外上下文。 |
| \*       |                                 | 强制立即过渡到下一个节点，跳过后续决策检查。          |


---

# 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:

```
GET https://docs.convai.com/api-docs/zh/convai-playground/character-customization/narrative-design.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.