> 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/convai-sim-experiences/tour-guide.md).

# 导游

使用 Convai Sim 内置的导览规划工具，将你的 AI 头像变成交互式导游

## **简介**

在本指南中，你将学习如何通过将 AI 头像变为沉浸式 3D 环境中的动态导览员，让它们“活”起来。

我们将带你了解如何：

* 设置导览模拟
* 定义交互行为
* 添加导览点
* 管理导览流程
* 预览并发布体验

## 分步指南

### **1. 设置导览员模式**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfZz05ySedk4Lajg9JYaQUgBQ2qy2tFQ83JsZ_BqPyhU4Z7YXMv8Me9YaZAPbpkGFpWK0RmpFRLa2wetYHvDJcvNlYKupDkpRn0vDrE1oVeGSIQMabaXZYmRxzB3FsxnCGzVBHUjw?key=oE6QAXhDPkZ0WZirjFau9Q" alt=""><figcaption></figcaption></figure>

1. 选择你的头像以打开 **编辑与发布** 菜单中。
2. 找到 **导览规划器设置** 部分。
3. 设置你的 **导览提示词** ——这决定了头像在导览开始和结束时会说什么。

**提示词示例：**

* **欢迎提示词：**\
  “嗨！准备好探索消防站了吗？”\
  → 向用户问好，介绍自己，并邀请他们开始导览。
* **结束提示词：**\
  “导览到这里就结束了。希望你玩得开心！”\
  → 询问用户是否有任何问题，回答后再道别。

### **2. 定义行为**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcBz2c8r7PObfXZj8jF4cq06K52dgnxZTL9tJXZaE42HckGNu3ki6iEs46-1FxJt6okkfsZ7sq6SeapiYAPjIDwE_Ec-IWnML9f3NMnZ4XBY2r2FFY6o2h5uQyhw6mX2nQPJp3u?key=oE6QAXhDPkZ0WZirjFau9Q" alt=""><figcaption></figcaption></figure>

选择你的头像如何发起导览：

* **等待玩家：**\
  头像保持静止，直到用户靠近。
* **视觉接近：**\
  头像通过视觉检测到用户并发起对话。
* **Max（定时互动）：**\
  头像会在用户一段时间无操作后开始互动。

### **3. 添加导览点**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXevR5D8O-lo8NFR7mcrsGgtBpPleeW7gPblo5wZEb66TZwT6l0tTkw4ZdIUESzOyBJpnLqiwcFdOmfwePyw9OtYrDpGeTz8jT05Mr6d_h4jqzhALdAv367eDoxTRuEasVSAyaBRGQ?key=oE6QAXhDPkZ0WZirjFau9Q" alt=""><figcaption></figcaption></figure>

1. 点击 **“添加导览点”** ——场景中会出现一个绿色操控器。
2. 使用 **XYZ 轴** 或点击 **旗帜图标** 来定位导览标记。
3. 输入一个 **导览点名称** （例如“消防车”）。
4. 添加一个 **目标** 用于描述头像在此处将解释或执行的内容（例如：“描述消防车及其在紧急情况下的作用。”）。
5. 重复此过程即可构建完整的导览路径。

### **4. 管理导览**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeOlI3VqyrWMFFXq_U3i58HBkmfH_BkxbWHPuBqxMch0VKszsudh7AM_58GyMtZR_Bw8QEFGkvBp0beMSc0X9L7CWj553ExD6YqkWiDxIFJv8R4bvenIpOtAChAkptyvtZpZ60y?key=oE6QAXhDPkZ0WZirjFau9Q" alt=""><figcaption></figcaption></figure>

* 要删除一个导览点，点击操控器并按下 **X 图标**.
* 在 **用户元素**，点击 **“设置用户起始点”** 来定义玩家的起始位置。
* 点击 **“保存叙事图”** 来保存你的导览配置。
* 使用 **预览** 来测试体验。
* 点击 **发布** 当你准备好分享导览时。

## **总结**

Convai Sim 的 **导览模式** 会将你的 AI 头像变成一个交互式、叙事驱动的主持人——非常适合：

* 教育与虚拟实地考察
* 员工入职培训
* 训练模拟
* 博物馆或产品讲解

一旦你的导览完成，只需点击一次，就能将其发布到网页、自助终端以及其他平台。


---

# 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/convai-sim-experiences/tour-guide.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.
