教一个机器人回答「这系统怎么用」
一句话：建一个智能体，人设写死「只依据检索到的手册片段作答」，绑上知识库、一个工具都不绑，发布。然后在对话里问它「怎么给角色配行级数据权限？」——它给的答案下面挂着一块「知识引用」，写明命中了哪几篇手册、每篇几个分段，点开就是原文，标题还是个链接，能直接跳到手册站对应那一页。这一章是首页视频的第 04 章。
演示环境里已经有成品
用 admin / admin123 登录，AI → AI 助手 → 智能体管理 里的 使用手册助手（编码 doc_tour_helper）就是这一章的成品。想直接试：去 智能助手 点「新建对话」，在智能体选择器里选它，问「怎么给角色配行级数据权限？」。
功能在哪
| 页面 | 菜单路径 | 这一章用它干什么 |
|---|---|---|
| 智能体管理 ★ | AI → AI 助手 → 智能体管理 | 建智能体、写人设、绑知识库、发布 |
| 智能助手 ★ | AI → AI 助手 → 智能助手 | 选中它提问，看答案与「知识引用」 |
| 知识库 | AI → 控制台 | 前置：手册语料得先灌进向量库（演示环境已灌好） |
| 权限诊断 ★ | 系统管理 → 组织权限 → 权限诊断 | 验证答案对不对：拿它回答的步骤去实际查一遍 |
前置条件
常用操作
第 1 步：新建智能体
进 AI → AI 助手 → 智能体管理，点「新增」。
它不是弹窗，而是整页设计器：左列写人设，右列绑模型、知识库与工具。
填两个基本项：
| 字段 | 填什么 |
|---|---|
| 名称 | 使用手册助手 |
| 编码 | doc_tour_helper |
编码保存后不可改
改编码等于换一个智能体（历史会话、计量记录都挂在旧编码上）。想好再填。
第 2 步：写人设
左列那个大输入框（人设）填下面这段。这是视频里用的原文，可以直接抄：
你是「启凌智搭」平台的使用手册助手。
职责：回答这个平台怎么配、怎么用、配错了怎么排。
依据：只依据检索到的手册片段作答。片段里没有的，直接说「手册里没写」——不要猜、不要编、不要拿别的系统的经验来补。
格式：先给结论，再给步骤；提到页面时写清菜单路径和按钮名。
边界：与本平台无关的问题不答；也不要替用户执行任何写操作。
这段人设为什么这么写
四句话各管一件事，缺一句就会跑偏：
- 「只依据检索到的手册片段」+「片段里没有的直接说手册里没写」——这是防编造的两道闸。只写前半句，模型仍会拿通用知识补空白；
- 「先给结论，再给步骤」——不写格式要求，它会先讲三段背景才说到点上；
- 「不要替用户执行任何写操作」——即便这个智能体没绑工具，也值得写一句，防止后续有人给它加上工具。
第 3 步：绑知识库
右列找到「知识库」那张卡，点下拉，选「平台产品手册（AI 助手内置）」。
下拉里只会出现已启用的知识库。选不到就说明那个库还没启用，或语料还没灌。演示环境里同名下拉还有四个「测试 XxxVectorStore」的库，那是给开发调试用的空库，别选错。
第 4 步：工具——一个都不要绑
右列「工具」那张卡，点开下拉看一眼有哪些候选，然后按 Esc 关掉，一个都不选。
这是硬约束，不是省事
智能体一旦绑了工具，对话就改走「思考 → 调工具 → 再思考」的调查循环，而知识库检索会被整段跳过——references 恒为空，答案下面那块「知识引用」永远不渲染。
也就是说：「查手册答问题」和「调工具查数据」这两种能力，在这一版里是互斥的，一个智能体只能选一条路。想要两个都要，就建两个智能体：这一章的绑知识库不绑工具，第 05 章的绑工具不绑知识库。
第 5 步：模型留空
「模型」那张卡什么都不选。留空表示用助手配置里的平台默认模型，而且是动态取的：默认模型故障时会自动切到下一个可用的。挑死一个模型等于把整个智能体押在那一个 API 密钥上。
第 6 步：保存并发布
点页头的「保存并发布」。做对了会弹绿色提示「已保存并发布」。
已发布版本是不可变快照
发布之后再回设计器改人设或换知识库，改的是新草稿，不影响已经发布的那一版。要让改动生效，得再点一次「保存并发布」。这也是为什么改配置要从列表页进去派生草稿，而不是直接改线上版本。
第 7 步：新建对话并选中它
进 AI → AI 助手 → 智能助手，点「新建对话」，再点会话面板上的智能体选择器，选「使用手册助手」。
必须「新建对话」，不能在已有会话里换
会话一旦落库就锁定了智能体，中途换不了——选择器在已有会话里是灰的或改了不生效。刚发布的智能体如果没出现在选择器里，整页刷新一次（F5）。
第 8 步：问它一个手册里有答案的问题
输入框里填：
怎么给角色配行级数据权限？点「发送」。「进行中」的唯一信号是发送按钮变成「停止」；变回「发送」就是答完了。
答案下面挂着一块「知识引用」，一行一个 chip，chip 上的文字形如 配置行级数据权限（2 条）——标题 + 命中的分段数。本轮这一问命中 4 篇手册、共 5 条分段：配置行级数据权限（2 条）、角色资源授权 ★（1 条）、权限规则 ★（1 条）、权限资源 ★（1 条）。
检索参数是 top_k=5、similarity_threshold=0.2：一次最多取 5 条分段、相似度低于 0.2 的直接丢掉。所以「5 条」是上限不是保证——问得偏就一条都不中，答案下面也就没有「知识引用」这一块。
第 9 步：点开出处，逐条核对
chip 上有两处可点，作用完全不同，别点错：
| 点哪里 | 会发生什么 |
|---|---|
| chip 里的标题文字 | 它是一个链接（target="_blank"），新标签打开手册站上对应那一页 |
| chip 末尾的**「（N 条）」** | 弹出分段详情，把命中的原文分段逐条列出来，可以逐条核对 |
为什么要核对
「答案带出处」的价值不在有出处，而在出处能点开、点开能对上。核对一次你就知道这个机器人能不能信：命中分段里有的内容它才说，没有的它应该说「手册里没写」。拿一个手册里根本没写的问题去问它（比如「怎么配置企业微信集成」），它会照人设拒答——这就是人设那句「不要猜、不要编」在起作用。
出处链接可能退化成纯文本
链接指向手册站的对应页面，需要实例上配好手册站地址。没配的话标题就不是链接、只是纯文本，分段详情照样能看。演示环境上这一项目前是阻塞状态（域名被云厂商拦截），所以标题可能点不开——这是环境问题，不是功能坏了。
视角对照
| 视角 | 表现 |
|---|---|
超管 admin | 本章视角。能建、能发布、能问 |
租户管理员 docadmin | 有 AI 菜单的话同样能建；建出来的智能体归本租户 |
普通员工 salesman01 | 没有智能体管理菜单；能不能在助手页选中它，取决于该智能体有没有授给他的角色 |
套餐受限租户 aoteman | 看套餐：套餐里没有 AI 相关菜单就整块看不到 |
进阶
- 智能体管理 ★：人设、知识库、工具、模型四张卡的完整字段说明，以及版本与发布状态；
- ReAct 循环与流式对话：为什么绑了工具就跳过知识库检索（开发视角，含代码位置）；
- 安全与提示注入防护：人设是指令段，检索到的手册片段是数据段，两者怎么隔离；
- 第 05 章：一个 SQL 接口，就是一个 AI 工具：互斥的另一条路——绑工具、不绑知识库。
常见问题
Q：答案下面没有「知识引用」这一块？ A：三种可能，按顺序排：① 这个智能体绑了工具——绑了就走调查循环，检索被整段跳过（见第 4 步的 danger）；② 这一轮没检索到任何高于阈值的分段，问题问得太泛或手册里确实没有；③ 知识库没绑上或语料是空的。第③种去用量看板 ★与知识库同步诊断里看语料规模。
Q：它答的和手册里写的不一样？ A：先点开「（N 条）」看命中的原文分段。如果分段里就是它说的那样，是手册该改；如果分段里没有、它却言之凿凿，那是编造——把人设里「片段里没有的，直接说「手册里没写」」这句加重，或换更强的模型。
Q：问它「怎么建一张表」，它给我弹了一张草稿卡？ A：意图分类把它判成了「要建东西」而不是「问问题」，于是走了第 01 章那条路。不要点「确认并运行」，新建对话重问，问法改成纯疑问句（「建表的步骤是什么」而不是「帮我建一张表」）。
Q：想改人设，改完发现没生效？ A：已发布版本是不可变快照，改完要再点一次「保存并发布」。另外，已经存在的会话不会用新配置——新建一个对话才走新版本。
Q：为什么不给它也绑上工具，一个机器人两用？ A：这一版就是不行，绑了工具知识库检索整段被跳过。想两用只能建两个智能体，在会话里按需切换（记得每次切换都要新建对话）。
Q：模型那一栏到底要不要选？ A：不要选。留空 = 用平台默认模型，且默认模型不可用时会自动切下一个。挑死一个模型，那个密钥一失效整个智能体就哑了。