Bot 功能用户手册
更新 ：2026-08-03
Bot 功能用户手册
1. 快速开始第一步：启用功能进入 设置 → 功能/扩展，找到
第四步：开始使用创建完成后，你可以在 Bot 列表页看到你的 Bot。点击 Bot 卡片进入详情页，查看数据统计和访客信息。
2. Bot 管理2.1 Bot 列表Bot 列表以卡片网格形式展示所有已创建的 Bot。每张卡片显示：
3. 人设配置人设定义了 Bot 的对话风格、身份定位和知识范围。3.1 使用 AI 生成人设在创建或编辑 Bot 时，找到人设区域：在输入框中描述你想要的 Bot 人设，例如： 点击 生成人设 按钮 AI 会自动生成详细的人设描述，你可以在编辑器中查看和修改 点击 重新生成 可以更换生成结果 3.2 手动编辑人设生成后的人设可以在富文本编辑器中手动修改。你可以调整：
4. 知识库绑定Bot 的知识来源于 Wiki 功能中提取的文档树。4.1 绑定文档树在创建或编辑 Bot 时，绑定文档树为必填项。你可以选择一个或多个文档树，Bot 只能从这些文档树中检索信息来回答问题。4.2 搜索机制当访客提问时，Bot 会：将问题发送到 Wiki 服务的向量搜索引擎 Wiki 服务通过语义相似度匹配最相关的条目 返回的条目作为上下文注入到 AI 对话中 4.3 知识边界Bot 严格限制在绑定的文档树范围内回答：
5. 测试对话5.1 在管理后台测试在 Bot 列表页，点击 Bot 卡片进入详情页。在数据统计标签页右侧可以看到 Bot 的实时预览。你也可以点击 Bot 卡片上的 测试对话 按钮（如有），在弹出的对话框中与 Bot 对话。5.2 测试要点测试对话时建议验证：
6. 嵌入网站6.1 获取嵌入代码在 Bot 列表页，点击 Bot 卡片上的 嵌入代码 按钮，或在 Bot 详情页查看。代码格式如下：<script src="http://your-domain.com/api/bot/{botId}/widget.js"></script>6.2 嵌入到网页将上述代码复制到目标网页的
7. 对话记录7.1 查看访客列表在 Bot 详情页的 访客 标签中，可以看到所有与 Bot 对话过的访客列表。每个访客显示：
8. 访客画像Bot 会在每次对话后自动分析访客，提取用户特征，构建结构化画像。8.1 画像维度LLM 自动从对话中提取以下维度的信息（仅提取访客明确表述的内容）：
8.2 访客评分除了基础画像，Bot 还会给每个访客打分（0-10 分）。评分标准可以在 Bot 编辑中自定义，例如：
9. 数据统计在 Bot 详情页的 数据统计 标签中，可以查看 Bot 的运营数据：
点击统计卡片可以快速跳转到对应的详细列表。
10. 最佳实践10.1 选择合适的文档树Wiki 功能已启用 已使用 Wiki 功能提取了结构化的知识条目 Bot 绑定了正确的文档树 知识条目内容准确、完整
11. 未来计划
版本：1.1 | 最后更新：2026-08-01 Bot 功能是一个基于 Wiki 知识库的智能客服机器人系统。你可以创建多个 Bot，每个 Bot 绑定不同的文档树，嵌入到外部网站中，让访客通过与 Bot 对话获取知识库中的信息。Bot 会自动对访客画像评分，帮助你了解受众质量，筛选高价值线索。
1. 快速开始第一步：启用功能进入 设置 → 功能/扩展，找到
@dave/bot，点击启用。第二步：创建你的第一个 Bot在左侧导航菜单中点击 智能客服，进入 Bot 列表页。点击右上角 创建 Bot 按钮。第三步：配置 Bot填写 Bot 的基本信息：2. Bot 管理2.1 Bot 列表Bot 列表以卡片网格形式展示所有已创建的 Bot。每张卡片显示：
- 头像和名称 — Bot 的基本标识
- 启用/停用开关 — 右上角的开关可以直接控制 Bot 是否对外服务。停用的 Bot 不会响应访客消息
- 嵌入代码 — 一键复制网站的嵌入代码
- 编辑 — 修改 Bot 配置
- 删除 — 删除 Bot 及其所有对话数据
- Bot 嵌入代码失效，外部网站不再显示聊天图标
- 对话记录和访客画像保留，不会丢失
- 重新启用后立即恢复服务
3. 人设配置人设定义了 Bot 的对话风格、身份定位和知识范围。3.1 使用 AI 生成人设在创建或编辑 Bot 时，找到人设区域：
专业的医疗客服，耐心细致，善于安抚患者情绪- 身份定位 — Bot 是谁
- 沟通风格 — 语气、称呼、语速等
- 知识领域 — Bot 擅长的专业知识范围
- 回答风格 — 回答的结构、长度、主动性
- 客服 Bot 更专业、更有温度
- 销售 Bot 更懂得引导和转化
- 售后 Bot 更懂得安抚和解决问题
4. 知识库绑定Bot 的知识来源于 Wiki 功能中提取的文档树。4.1 绑定文档树在创建或编辑 Bot 时，绑定文档树为必填项。你可以选择一个或多个文档树，Bot 只能从这些文档树中检索信息来回答问题。4.2 搜索机制当访客提问时，Bot 会：
- 知识库中有相关信息 → 基于知识库回答
- 知识库中没有 → 回复你设置的"超出范围回复"（默认："抱歉，我目前无法回答这个问题。"）
- 不会编造信息，不会使用训练数据中的通用知识
5. 测试对话5.1 在管理后台测试在 Bot 列表页，点击 Bot 卡片进入详情页。在数据统计标签页右侧可以看到 Bot 的实时预览。你也可以点击 Bot 卡片上的 测试对话 按钮（如有），在弹出的对话框中与 Bot 对话。5.2 测试要点测试对话时建议验证：
- Bot 是否正确理解问题并基于知识库回答
- 超出知识库范围的问题是否正确回复了"超出范围回复"
- Bot 的人设风格是否符合预期
- 多轮对话的上下文是否连贯
6. 嵌入网站6.1 获取嵌入代码在 Bot 列表页，点击 Bot 卡片上的 嵌入代码 按钮，或在 Bot 详情页查看。代码格式如下：<script src="http://your-domain.com/api/bot/{botId}/widget.js"></script>6.2 嵌入到网页将上述代码复制到目标网页的
</body> 标签之前。Bot 会以右下角浮动气泡的形式出现在网页上，访客点击即可开始对话。6.3 多语言支持嵌入代码支持 data-lang 属性切换语言：<!-- 英文版 -->
<script src="..." data-lang="en"></script>6.4 访客识别访客的浏览器会通过 localStorage 自动保存一个唯一标识。关闭网页后再次访问，Bot 能识别出是同一个访客，加载之前的对话历史并继续完善访客画像。7. 对话记录7.1 查看访客列表在 Bot 详情页的 访客 标签中，可以看到所有与 Bot 对话过的访客列表。每个访客显示：
- 访客标识
- 对话次数
- 最后活跃时间
- 画像标签摘要（如果有）
8. 访客画像Bot 会在每次对话后自动分析访客，提取用户特征，构建结构化画像。8.1 画像维度LLM 自动从对话中提取以下维度的信息（仅提取访客明确表述的内容）：
- 销售 Bot：评分反映购买意向
- 医疗 Bot：评分反映病情紧急程度
- 售后 Bot：评分反映用户满意度
9. 数据统计在 Bot 详情页的 数据统计 标签中，可以查看 Bot 的运营数据：
10. 最佳实践10.1 选择合适的文档树
- 客服 Bot：绑定产品手册、FAQ、服务条款等文档树
- 医疗 Bot：绑定疾病知识库、就诊流程、医保政策等文档树
- 企业内部 Bot：绑定员工手册、流程文档、培训材料等
- 人设要具体，避免模糊描述。
专业的医疗客服比客服更有效 - 在人设中明确 Bot 的知识边界和不该回答的问题类型
- 定期检查 Bot 的回复质量，根据实际对话调整人设
- 销售场景：
访客的购买意向和转化可能性 - 售后场景：
用户对产品/服务的满意度 - 医疗场景：
患者的病情紧急程度和就医需求
11. 未来计划
Bot 的 REST API 正在开发中。后续将通过 REST API 对外开放 Bot 管理、对话、访客画像等能力。Bot 嵌入代码（已可用）：
<script src="https://2ryun.com/api/bot/{botId}/widget.js"></script>提示：如有问题或建议，请联系 2ryun 团队。