知识库
知识管理提供传统 RAG（检索增强生成）能力：上传文档到知识库，自动分块与向量化，按问题检索召回相关片段，供智能体调用或人工核查。
知识库按用户组隔离，跨组不可见；平台管理员可见全部知识库。
创建知识库
- 在左侧导航栏单击「知识管理」→「知识库」
- 单击右上角「新建知识库」
- 填写：
| 字段 | 说明 |
|---|---|
| 名称 | 知识库名称（必填，≤128 字符） |
| 用户组 | 知识库归属的用户组（必填，平台管理员可选任意组） |
| 向量模型 | 用于生成文档向量的模型（从模型网关已配置的向量模型中选择） |
| 分块方法 | 文档切分策略：naive（通用）/ book / paper / qa |
| 描述 | 知识库用途说明（可选） |
- 单击「确定」创建
向量模型
向量模型统一由平台模型网关提供。如选项为空，请联系管理员在「模型管理」页配置向量模型（如 bge-m3）。
文档管理
进入知识库详情页（列表单击「详情」），「文档管理」Tab：
上传文档
- 拖拽文件到上传区域，或单击选择文件
- 支持 PDF / Word / Markdown / TXT，单文件 ≤ 50MB
- 支持批量上传
解析文档
上传后文档状态为「待解析」。单击「解析」触发分块与向量化：
| 状态 | 含义 |
|---|---|
| 待解析 | 已上传，未解析 |
| 解析中 | 正在分块与向量化（显示进度百分比） |
| 已解析 | 解析完成，可检索 |
| 解析失败 | 解析异常，可重新解析 |
解析为异步任务，大文件可能需要数分钟。解析中可离开页面，稍后刷新查看状态。
删除文档
单击「删除」移除文档及其全部分块（不可恢复）。
检索测试
「检索测试」Tab 用于验证知识库召回效果：
- 在输入框输入问题
- 设置「返回数量」（top-k，默认 10）
- 单击「检索」
结果展示每个召回片段的来源文档、相似度得分、内容。可据此调整分块方法或向量模型。
分块预览
「分块预览」Tab 查看某文档切分后的具体片段，用于核对分块质量：
- 选择文档
- 查看分块列表（含片段内容与分块 ID）
多租户隔离
- 知识库按用户组隔离：组用户仅可见/操作本组知识库
- 平台管理员可见全部知识库，可跨组管理
- 删除用户组会级联删除其下全部知识库与文档
能力开关
知识管理能力可由管理员在部署时控制：
- 启用时：菜单可见，API 正常响应
- 未启用时：菜单隐藏，API 返回「能力未启用」
如菜单不可见，请联系管理员确认是否已启用知识管理能力。