知识库
知识管理提供传统 RAG（检索增强生成）能力：上传文档到知识库，自动分块与向量化，按问题检索召回相关片段，供智能体调用或人工核查。
知识库按用户组隔离，跨组不可见；平台管理员可见全部知识库。
创建知识库
- 在左侧导航栏单击「知识管理」
- 单击「新建知识库」
- 填写：
| 字段 | 说明 |
|---|---|
| 名称 | 知识库名称（必填，≤128 字符） |
| 用户组 | 知识库归属的用户组（必填，平台管理员可选任意组） |
| 向量模型 | 用于生成文档向量的模型（从模型网关已配置的向量模型中选择，创建后不可修改） |
| 分块方式 | 文档切分策略（见下表），选定后可调整分块长度等参数 |
| 知识图谱 | 是否在解析时提取实体关系构建图谱（见下） |
| 建图模型 | 开启知识图谱时必填，用于实体关系提取 |
| 重排序模型 | 可选；配置后检索结果按相关性重排并显示相似度 |
| 描述 | 知识库用途说明（可选） |
- 单击「确定」创建
向量模型
向量模型统一由平台模型网关提供，按模型管理中登记的「模型类型」自动筛选；旧版本登记的模型按名称关键词（embedding、bge、rerank）识别。如选项为空，请联系管理员在「模型管理」页以「向量」类型配置向量模型（如 bge-m3）。
分块方式
| 方式 | 说明 | 适用 |
|---|---|---|
| 标准分块 | 按固定长度切分文本，速度最快 | 大多数文档 |
| 智能分块 | 优先沿段落和句子边界切分，更好保留语义完整 | 说明文、网页文本 |
| 语义分块 | 按内容语义相似度切分，质量高但解析较慢 | 语义连贯性要求高的场景 |
| 段落分块 | 按段落语义合并切分 | 结构规整的长文档 |
标准 / 智能 / 段落分块可调整「分块长度」与「分块重叠」参数；语义分块仅支持分块长度。
知识图谱
开启后解析时会提取文档中的实体与关系构建知识图谱，检索同时利用图谱关联（召回更全面）；代价是大文档解析明显变慢（每个片段需要额外的模型调用）。未开启时仅做分块与向量化，按语义相似检索。
开启后详情页会出现「知识图谱」Tab，可查看实体关联图（按关联数展示前 100 个实体，支持搜索）。
编辑知识库
知识库以卡片形式展示。单击卡片进入详情页；卡片右上角「···」菜单提供「编辑」与「删除」。编辑可修改：名称 / 描述 / 重排序模型 / 知识图谱开关与建图模型。向量模型与分块方式创建后不可修改（如需变更请删除后重建）。
图谱开关对已有文档的影响
后开启图谱的知识库，此前已解析的文档没有图谱数据。如需补全，请在文档列表勾选相关文档后「批量重新解析」。
文档管理
进入知识库详情页（列表单击知识库卡片），「文档管理」Tab：
上传文档
单击「上传文档」按钮，在弹出窗口中拖拽或单击选择文件：
- 支持 PDF / Word / Markdown / TXT，单文件 ≤ 50MB
- 支持批量上传；上传成功后自动加入解析队列
解析状态
| 状态 | 含义 |
|---|---|
| 已上传 / 待解析 | 已上传，等待解析 |
| 排队中 | 已加入解析队列 |
| 解析中 | 正在分块与向量化 |
| 已解析 | 解析完成，可检索 |
| 解析失败 | 解析异常（悬停查看原因），可重新解析 |
解析在后台执行，页面存在排队/解析中文档时每 3 秒自动刷新，无需手动刷新页面。开启图谱的大文档解析可能需要数分钟。
早期导入的部分文档没有保留原始文件，这类文档的「重新解析」按钮不可用（悬停可见说明），批量重新解析时会自动跳过。
批量操作
勾选多个文档后可「批量重新解析」（如调整图谱开关后补全图谱数据）或「批量删除」。
删除文档
单击「删除」移除文档及其全部分块（不可恢复）。
文档详情
单击文档名称进入文档详情页，左右分栏：
- 原文预览：查看文档原文。Markdown / TXT 直接显示内容，PDF 内嵌预览，其他格式可下载原文件查看
- 分块信息：查看该文档切分后的片段，用于核对分块质量
早期上传的文档不支持原文预览（仅可查看分块信息）。
检索测试
「检索测试」Tab 用于验证知识库召回效果：
- 在输入框输入问题
- 按需调整参数（与输入框同行展示）
- 单击「检索」
| 参数 | 说明 |
|---|---|
| 返回数量 | 召回片段数上限（默认 10） |
| 相似度阈值 | 相似度低于该阈值的内容不返回（默认 0.6）。仅在内容匹配路径生效：未开启知识图谱的知识库，以及开启后选择「内容匹配 / 全面检索」模式时展示 |
| 检索模式 | 开启图谱的知识库可切换（默认自动） |
| 重排序 | 开关知识库配置的重排序模型 |
结果展示每个召回片段的来源文档、相似度与内容。配置了重排序模型时相似度按相关程度计算并重新排序；未配置时相似度为内容相似度、按检索顺序展示。
关联智能体
详情页头部「关联智能体」展示当前绑定了此知识库的智能体，每个智能体标签可单击 × 解除绑定（确认后生效，已部署实例会自动更新配置）。也可以在智能体定义详情页的「知识库」标签页中管理绑定。
智能体检索知识库的范围完全由绑定关系决定，与知识库名称无关——重命名知识库不会影响任何智能体的检索。每个智能体还可独立配置检索参数（TopK、相似度阈值、检索模式、重排序开关），在智能体工作台「知识库」面板的「检索设置」中修改。
删除知识库
单击删除时若知识库已被智能体绑定，会提示绑定的智能体名单；可选择先解绑，或确认「强制删除」（将同时解除全部绑定关系）。
多租户隔离
- 知识库按用户组隔离：组用户仅可见/操作本组知识库
- 平台管理员可见全部知识库，可跨组管理
- 删除用户组会级联删除其下全部知识库与文档
能力开关
知识管理能力可由管理员在部署时控制：
- 启用时：菜单可见，API 正常响应
- 未启用时：菜单隐藏，API 返回「能力未启用」
如菜单不可见，请联系管理员确认是否已启用知识管理能力。