管理员建库分发、维护者上传内容、所有 AI 经同一个检索入口使用

知识库

知识库把企业的文档变成所有 AI 都能引用的答案来源。它只有两个权限动词：使用（可检索、可看原文）和维护（使用 + 上传、删文档、重新索引）。管理员建库并分发，维护者灌内容，所有 AI——页内检索、智能体、外部客户端（Claude Code / Cursor / 自有系统）——都走同一个检索入口 kb_search，结果永远按调用者本人的权限现算。

这份文档按五条旅程编写。每条旅程都标注了你所在的页面。

J1 管理员建库并分发

页面：/admin/knowledge-bases（管理控制台）

1. 保存后库卡片会显示「使用 销售部·解决方案部 / 维护 张三 / 文档 0」。

没有配置任何分发目标的库，只有创建者和管理员可见。权限按人当下的部门身份现算，调岗、离职不需要重新授权。

J2 维护者上传内容并检索

页面：/knowledge-bases（知识库首页）

1. 打开 /knowledge-bases，可以看到分发给自己（可使用）和由自己维护的库。维护中的库带「维护」标记。
2. 点击库卡片进入详情页，切换到「文档」。
3. 点击「上传文档」，拖入文件（支持 pdf / docx / pptx / xlsx / csv / md / txt / html / epub / eml / 常见图片；.doc 和 ODF 系不在支持列表）。
4. 等待上传解析完成，文档状态变为「可用」。解析失败的文档会标注原因，可点击「重索引」重试。
5. 切换到「检索」页签，输入查询词（如「金融客户 OB 迁移」），确认能命中刚上传的内容，并点「原文」查看高亮片段。

维护者没有任何权限设置项——比使用者多的只有「上传 / 删除 / 重新索引」三个按钮。

J3 外部 AI 接入（Claude Code / 自有系统）

页面：/knowledge-bases 库详情页右栏，或 /mcp 广场的「Zenova 知识库」卡

1. 打开一个你有权限的库详情页（或 /mcp 广场的「Zenova 知识库」卡），查看右栏「服务配置」：传输协议 streamable-http、工具 kb_search 等。
2. 点击「获取连接配置」，选择 令牌有效期，点击「确认签发 Token」。
3. 复制「MCP 配置 JSON」，粘贴到客户端的 MCP 配置位置（Claude Code / Cursor / 自有系统的接入方式见 Zenova 用户手册 的「应用、MCP 和技能」）。
4. 在客户端里提问（如「有没有金融客户的 OB 迁移案例」），客户端会调用 kb_search 工具，回答带引用定位。
5. 回到库详情页的「检索」页签可以做同样的测试。

注意：Token 以你的账号访问 kb_search，检索结果按你的权限裁剪。你被移出分发范围后，同一枚 Token 的检索结果立即变为空——Token 不是授权，授权只看分发目标。首次连接时客户端会弹出授权同意页。

J4 智能体使用知识库（Zenova）

页面：Zenova 智能体详情页「工具」

1. 智能体作者在 /agents/<智能体> 的「工具」里添加「Zenova 知识库」卡。
2. 把「库范围」设为「限定」，勾选允许该智能体检索的库（如「售前案例库」「产品文档」）；不限定则按使用者的可见范围检索。
3. 发布智能体。
4. 使用者在聊天里 @智能体 提问（如「3.2 支持 OceanBase 吗」），智能体会调用 kb_search 工具检索，回答带编号引用，点引用可查看文档原文与高亮片段。

智能体检索时带的是使用者本人的身份：同一个使用者在智能体里、在外部客户端里、在页面上检索同一个库，结果集一致。

J5 权限变更立即生效

页面：/admin/knowledge-bases → 库 → 分发目标

1. 移除「允许维护」目标会同步收回上传 / 删除 / 重索引权限。

常见问题

我看不到某个知识库

知识库按「允许使用」分发裁剪。确认你的部门或账号在分发目标里；如果刚被加入，刷新页面即可。没有被分发任何目标的库对你完全不可见（不是只读）。

检索结果没有语义相关性排序

库尚未配置嵌入服务时走全文检索。管理员在「系统设置 › 全局设置 ›「常规」页签 › 默认模型」中配置默认向量模型后，新上传的文档自动带语义检索；已有文档用「重索引」补齐。

外部客户端调用 kb_search 返回 401 / 空

401 通常是 Token 过期或被吊销，回详情页重新签发。返回空结果但页面检索正常，说明你的账号对该库没有「允许使用」授权，联系管理员补分发。