Botos
使用手册
首页 知识库 收件箱 使用手册

使用手册#

Botos 智能客服 · 完整操作指南

Botos 是一个能读你的文档、替你回答访客问题的在线客服系统。 上传 PDF / Word / Excel / PPT 或一个网址，它会自动切成片段建索引；AI 答不上来时，一句话转给人工， 你的同事在收件箱里接着聊，全程不中断。

本手册按「注册 → 登录 → 建知识库 → 接待访客 → 嵌入网站」的顺序组织，每节都可以单独查阅。

一、五分钟快速开始#

步骤做什么在哪
1用邮箱和密码注册登录页 → 注册 → 填邮箱与密码
2进入后台（首个账号自动成为管理员）登录后自动跳转知识库
3上传第一份文档知识库 → 文件上传 → 拖入 PDF/Word
4打开首页，点右下角气泡问一句首页 → 右下角机器人头像

做完这四步，AI 就能用你刚上传的内容回答问题了。

二、功能总览#

模块能做什么
知识库文件上传、网址抓取、粘贴文本、FAQ 增删改、检索测试
AI 对话流式回答、带 [1][2] 引用、答不出会明确说不知道
转人工短语命中零延迟转接、模型主动转接、访客点「转人工」按钮
收件箱会话列表、人工回复、恢复 AI、结束会话
接入一行 script 嵌入任意网站，iframe 隔离样式

支持的文档格式与上限：

类型扩展名上限
PDF.pdf4 MB
Word.docx4 MB
Excel.xlsx4 MB
PPT.pptx4 MB
文本.txt .md .csv .json .log4 MB
网页任意 http/https 链接8 MB
不支持 .doc / .xls / .ppt 旧格式，请另存为 .docx / .xlsx / .pptx。 中文 PDF 可以直接解析：系统会读取 PDF 内嵌字体的 ToUnicode 映射表， 包括被压缩进对象流（ObjStm）的字体，能正确还原中文内容。 只有两类提不出文字：扫描件（整页是图片）和字体缺少映射表的 PDF —— 这两种会明确提示，不会把乱码存进知识库。建议先 OCR，或上传原始 Word/Excel。

三、注册账号#

  1. 打开站点，点右上角 登录 / 注册
  2. 切到 注册 标签，填邮箱和密码（至少 6 位），点 注册并进入
  3. 注册成功后自动登录并跳到后台

关于管理员权限：系统里第一个注册成功的账号会被自动设为管理员。 后续注册的账号默认没有管理权限，进入后台会提示「这个账号没有管理权限」，需要管理员在后台授权。

密码用于登录，忘记密码目前需要联系管理员重置。

每个账号都是独立的：注册成功后会为你新建一套独立知识库，并分配一个专属 identifier （形如 u3f9a2c1b8）。你上传的文档、你的访客会话，其他账号都看不到、也访问不到。

你的 identifier 在登录后「知识库」页顶部的「接入到你的网站」卡片里可以看到，接入代码里直接带着它。

四、登录后台#

登录后默认进入 知识库，也可以在顶部导航随时切换：首页 / 知识库 / 收件箱 / 使用手册。

输入管理员口令即可进后台（口令由部署方保管）

五、知识库：让 AI 有东西可答#

知识库是系统的地基。AI 回答的每一句话，都来自这里的内容。

5.1 文件上传#

  1. 进入 知识库 → 文件上传
  2. 把文件拖进虚线框（或点击选择，可多选）
  3. 系统解析出正文后，会先显示 预览卡：类型、字数、预计分块数、正文前 260 字
  4. 确认无误点 保存，才会真正入库并建立索引
预览这一步是故意的：文档解析偶尔会带进页眉页脚，先看一眼再存，比事后删省事。

5.2 网址抓取#

  1. 切到 网址抓取 标签
  2. 粘贴链接，点 抓取预览
  3. 服务端会打开页面、去掉导航和脚本，只保留正文
  4. 确认后点 保存

链接本身是 PDF / Word / Excel / PPT 也可以直接粘——系统会按文档解析，而不是当网页处理。

纯前端渲染（内容靠 JS 生成）的页面抓不到，会提示「没提取到有效正文」。

5.3 粘贴文本#

适合内部资料、会议纪要等无法公开访问的内容：填标题 → 贴正文 → 保存。

5.4 常见问题（FAQ）#

一问一答，最适合高频问题：

  1. 切到 常见问题 标签
  2. 填「问题」和「答案」，点 保存 FAQ
  3. 在下方表格里可以 编辑 或 删除

FAQ 有两个作用：出现在聊天窗口的快捷提问里，也参与 AI 检索。

5.5 检索测试#

改完知识库一定要测。输入一个真实用户会问的问题，看命中情况：

5.6 删除与维护#

在 知识库内容 表格里点 删除，会连同该文档的所有切片一起删除。 建议定期清理过期文档——知识库越干净，回答越准。

六、对话：AI 回答与转人工#

6.1 访客侧#

访客点右下角机器人头像即可开始对话：

6.2 收件箱（人工接管）#

进入 收件箱，左侧是会话列表（每 3 秒自动刷新），右侧是对话与回复框。

操作效果
点会话查看完整历史
输入并发送以人工身份回复，访客端不刷新即可看到
恢复 AI把会话交回 AI，状态回到「AI 在线」
结束会话标记处理完毕，同样回到 AI

状态含义：

状态含义谁来答
AI 处理中正常状态AI
等待人工接入已转人工，还没人回复无人（等人工）
人工处理中人工已回复过只有人工
人工接管期间 AI 不会抢答，这一约束在数据库层强制生效，客户端旧版本也无法绕过。

七、部署与接入#

7.1 嵌入到自己的网站#

在任意页面的 </body> 前加一行：

html
<script src="https://botos.ai-opc.cc/widget.js?identifier=demo&v=1" async></script>

保存刷新，右下角就会出现机器人头像。组件用 iframe 隔离，不会和你网站的样式打架。

7.2 identifier 参数怎么来的#

identifier 是站点标识，它决定组件去读哪一套知识库、欢迎语和客服配置。

问题答案
在哪看登录后台 → 知识库页顶部「接入到你的网站」卡片，直接写着你的专属标识
当前值形如 u3f9a2c1b8，注册时自动分配，和你的账号绑定
要申请吗不需要。注册即生成，和后台用的是同一份数据
什么时候会变不会变。它是你账号的固定标识；想再要一套独立客服，用另一个邮箱注册即可

接入代码长这样，三个部分：

html
<script src="https://botos.ai-opc.cc/widget.js?identifier=demo&v=1" async></script>

7.3 组件控制#

参数说明
identifier组件标识，对应后台的组件配置（当前演示为 demo）
v资源版本号，改了代码后换一个值即可让访客立刻拿到新版

也可以用脚本控制显示：

js
window.Botos.show()   // 打开对话
window.Botos.hide()   // 收起对话

7.4 部署说明#

本项目是「静态页 + 一个 Python 抽取服务」，不依赖任何第三方包：

bash
cd knocket-lite
PORT=3000 python3 server.py

八、常见问题#

Q：上传后 AI 还是答不出来？ 先到「检索测试」用同样的问法测一次。不命中说明内容没进库或问法和原文差太远—— 补充一条 FAQ 是最快的解法。

Q：PDF 上传提示「提不出可读文字」？ 多半是扫描件（整页图片）或字体缺少映射表。中文文字型 PDF 是支持的（含对象流压缩的字体）； 遇到报错时界面会显示一行「诊断」，把对象数/字体数/文本流数带出来，便于判断问题类型。

Q：AI 会不会乱编？ 系统提示词里明确要求「检索不到就说不知道」，回答也会带引用编号，便于你核对原文。 但涉及价格、合同、法律条款，仍建议人工复核。

Q：访客刷新后对话记录会丢吗？ 不会。每条消息都实时写进数据库，刷新后按历史重新加载。

Q：能同时接待多个访客吗？ 可以。每个访客一条独立会话，收件箱按最后消息时间排序。

九、数据与安全#

Botos · 使用手册