# AI 聊天客服
> 为全景作品开启 AI 问答助手，访客可在场景中与 AI 对话，回答基于作者录入的知识库内容生成。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：进入编辑器后，在「基础设置」中打开「AI 聊天客服」。开启「启用AI问答」，设置助手主标题、副标题与欢迎语，并在「知识库配置」中录入场景相关信息。点击「保存配置」，配置会构建作品知识库并上传，保存成功后开放给访客使用。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 开启或关闭访客可见的 AI 问答入口
- 自定义助手主标题、副标题与欢迎语
- 录入知识库内容，AI 基于这些信息回答访客问题
- 提供知识库编写建议与示例内容一键填入
- 内置功能介绍与常见问题说明

## 3. 业务说明

### 配置区域

面板由三个区域组成：基础配置（启用AI问答、助手主标题、助手副标题、AI助手欢迎语）、知识库配置（知识库内容、示例内容与使用示例）、功能介绍 & 常见问题（可展开的说明列表）。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 启用AI问答 | 开启后访客将在场景中看到 AI 问答入口 | 开关 | 默认关闭 |
| 助手主标题 | AI 助手的主标题 | 输入框，最多 8 个字符 | 非必填，回退为默认标题 |
| 助手副标题 | AI 助手的副标题 | 输入框，最多 16 个字符 | 非必填，回退为默认副标题 |
| AI助手欢迎语 | 打开对话时展示的欢迎语 | 多行输入框，最多 255 个字符 | 非必填，回退为默认欢迎语 |
| 知识库内容 | AI 回答访客问题所依据的场景信息 | 多行输入框，最多 9999 个字符 | 开启问答时必填 |
| 使用示例 | 一键填入示例知识库内容 | 按钮，会覆盖当前内容并需确认 | 非必填 |

### 保存与生效

点击底部「保存配置」。开启问答时会先把知识库内容构建为作品知识库并保存，保存成功提示「知识库文件保存成功」。知识库内容过少时会给出提醒；关闭问答会先提示确认。更新知识库后 AI 会基于新内容回答，无需额外配置。

## 4. 使用说明

1. 在编辑器左侧点击「基础设置」，打开「AI 聊天客服」
2. 开启「启用AI问答」，填写助手主标题、副标题与欢迎语
3. 在「知识库配置」录入场景介绍、常见问答、术语解释、价格规格位置等信息
4. 需要参考时点击「使用示例」填入示例内容，再按实际情况修改
5. 点击「保存配置」，等待知识库构建与上传完成

## 5. 规则与限制

- 开启问答时知识库内容不能为空且不建议过少，否则会影响回答质量
- 助手主标题最多 8 个字符，副标题最多 16 个字符
- 使用示例会覆盖当前知识库内容
- 关闭问答时访客将无法使用 AI 问答
- AI 回答的质量和范围主要取决于知识库内容的丰富程度

## 6. 状态与异常

- 表单有未保存更改时离开会提示确认
- 保存过程中按钮显示「保存中…」
- 未开启问答时使用示例会先提示是否立即开启
- 知识库内容过少：提示「知识库内容过少，建议添加更详细的描述以提高AI回答质量」
- 知识库文件上传失败：提示「知识库文件上传失败，请重试」
- 创建知识库文件失败：提示「创建知识库文件失败，请重试」

## 7. 相关文档

- [芊云编辑器配置项总览](https://9kvr.cn/site/tour/editor/config.md)
- [基础设置（一级菜单）](https://9kvr.cn/site/tour/editor/config/basic.md)
- [通知公告配置](https://9kvr.cn/site/tour/editor/config/basic/announcement.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

- 事实来源：芊云编辑器公开版本配置与真实界面
- 文档构建时间：2026-10-20 19:04:23
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验