Skip to content

知识库管理

查看本租户所有的知识库(含租户共享和员工个人)的运营视图——总数、健康度、文档数、异常情况。知识库本体由员工在客户端创建(自助上传文档、配召回参数),本页是管理员审计 / 排障入口,不直接做新建 / 删除。

进入路径

左侧菜单 知识库知识库管理

概念速览

概念一句话
知识库 (KB)一组文档的集合,员工聊天 / 数字员工对话时按这个集合做检索增强。
租户共享本租户所有成员都能查询的知识库,通常由管理员或专门的角色维护。
个人私有单个员工自己建的知识库,仅本人和被授权的人可访问。
文档数该知识库当前已导入的文档总数。
状态可用(绿色,可被检索)/ 待同步(黄色,正在初始化或导入)/ 异常(红色,导入失败需排查)。
服务该知识库挂在哪套后端(RAGFlow / Dify),由平台层 知识库服务配置 决定(租户视角看是只读信息)。

页面一览

截图占位:知识库管理 — tenant-kb-list.png
> 顶部 4 个统计卡:**知识库总数 / 可用 / 文档数 / 异常**。toolbar:搜索框 + 可见性下拉 + 状态下拉 + 刷新。主表 7 列:名称(含编号)/ 归属(租户共享 or 用户私有)/ 服务 / 文档数 / 状态 / 创建时间 / 操作(详情)。

操作步骤

1. 概览整租户知识库健康度

顶部 4 个统计卡一眼扫:

  • 知识库总数:本租户名下所有知识库(含员工个人的)。
  • 可用:状态为「可用」的数量。
  • 文档数:所有知识库的文档总和。
  • 异常:状态为「异常」的数量——非 0 时建议立刻去排查

2. 筛选 / 搜索

  • 搜索框:按名称、编号、服务、Dataset ID 模糊匹配。
  • 可见性下拉
    • 全部可见性 / 租户共享 / 个人私有 / 部门可见
  • 状态下拉:全部 / 可用 / 待同步 / 异常
  • 异常排障常用组合:可见性=全部 + 状态=异常。

3. 查看某个知识库的详情

  • 行末 详情 → 进入该知识库的详情页(独立路由)。
  • 详情页里可以做:
    • 召回测试:输关键词,看哪些文档片段被检索出来、相关性多少。
    • 引用统计:哪些数字员工 / 对话引用了这个知识库。
    • 审计:谁创建、谁修改、谁访问过。

4. 处理异常知识库

如果发现某个知识库状态是「异常」:

  1. 在本页点 详情 进入。
  2. 查看异常文档(参考 文档管理 页面)。
  3. 多数是单个文档解析失败——在 文档管理 里点「重试」即可。
  4. 整库异常(多个文档失败)通常是 知识库服务 后端问题,联系平台运维。

本页不能做的事

操作去哪做
创建新知识库员工在客户端创建(自助)
上传文档员工在客户端或知识库详情页操作
删除知识库员工在客户端自己的知识库管理里删(或管理员通过平台审计权限)
修改召回参数(条数 / 阈值)员工在客户端自助调整

本页是只读 + 排障视角,写操作都走客户端,保证用户拥有自己数据的控制权。

字段约束

  • 归属列「租户共享」= 全租户可见;「用户私有」= 仅创建人和被授权的人可见。
  • 服务列为空 = 后端服务配置异常或知识库还没绑定,联系平台运维。
  • 状态非「可用」时,员工在客户端用该知识库做检索可能返回空结果。

相关菜单

常见问题

Q:本页能新建知识库吗? A:不能。知识库由员工在客户端自助创建——管理员的角色是审计 + 健康监控,不替员工做数据维护,避免越权误操作。

Q:「异常」状态的知识库还能用吗? A:取决于异常程度。单文档失败不影响其他文档检索;整库初始化失败则完全不可用。详情页里能看到具体失败原因。

Q:员工私有的知识库我能看到内容吗? A:在本列表里能看到元信息(名称、文档数、状态),不能直接看文档内容。要查内容需走审计权限,进入「跨用户查私有 KB」流程(涉及合规和审计日志)。

Q:文档数为什么和员工看到的不一样? A:员工看到的是他能访问到的文档(按可见性过滤);本页显示实际导入的总数。管理员视角更全。

Q:能批量导出本租户所有 KB 的健康度报告吗? A:当前没有页面入口;如果需要可联系运维出一份报表,包含每个 KB 的状态、文档数、最近活跃时间。

© 知办AI Team — 开发者公开文档. 平台运维 / 内部架构文档见内部 wiki.