分段与语义¶

选择配置对象¶

现象	进入位置	先检查什么
文件内容缺段、串段或引用无关内容	智能分段	预览、分段内容、启用状态和当前版本
文件没有可读预览或没有分段	管理知识库数据源	处理状态、错误信息和源文件
表的指标、筛选或联表结果不正确	语义配置	维度、指标、关联和术语
资料已经换版	管理知识库数据源	新来源的处理状态和旧来源的启用状态

保存分段或语义配置后，使用对话与检索中的真实问题验证结果。

配置文件分段¶

开始前，请在管理知识库数据源中确认文件已接入，且处理状态为 已完成。

打开文件详情¶

打开目标知识库的 高级配置。
打开 数据源 页签。
点击目标文件名称。
打开 智能分段。

文件预览 用于检查解析内容，文件信息 用于查看标签和启用状态，版本记录 用于查看分段版本。

如果预览显示没有可用解析内容，请先回到管理知识库数据源检查处理状态和错误信息。

检查分段¶

在 智能分段 中确认分段列表有内容。
列表为空时，点击 生成初始分段。
使用 搜索分段 定位内容。
使用 分段排序 按原文顺序或召回优先查看分段。
检查关键分段的正文、图片、表格或转录内容。

问题	处理方式
分段过碎	合并或调整正文，使一个分段保留完整语义
分段过粗	拆分正文，避免命中内容过大
内容乱码或错段	检查源文件和解析内容，再编辑分段
无关内容仍参与检索	停用对应分段

分段类型和可用字段以界面显示为准，例如文本、图片、图文、表格或转录。

编辑分段¶

仅当前生效版本可以编辑。

操作	步骤
编辑分段	选择编辑分段，修改内容后保存
新建分段	选择新建分段，输入正文后保存
停用分段	关闭启用分段
删除分段	选择删除分段并确认
更新向量	修改影响检索的内容后，选择重新 embedding

编辑图片、表格或转录分段时，按界面提供的 OCR、图片描述、表格预览或播放功能检查内容。

完成修改后，检查当前版本，执行 重新 embedding，再用对话验证来源。

管理版本¶

在文件详情中打开 版本记录。
查看版本名称、变更人和变更时间。
选择需要使用的版本。
点击 设为当前。
确认 索引版本 与预期一致。

现象	检查方式
无分段或生成失败	生成初始分段；仍失败时检查处理状态和源文件
修改后回答未变化	检查是否已重新 embedding，以及当前版本是否正确
回答包含无关内容	停用无关分段，或在数据源列表中禁用整个文件
整份文件需要更新	重新接入来源，再检查分段版本

配置表语义¶

语义配置只面向数据表，用于 NL2SQL 和数据问答。新增语义条目前，数据源中至少应有一张表。

打开语义配置¶

打开目标知识库的 高级配置。
打开 语义配置 页签。
如果尚无语义模型，按界面提示创建第一条语义条目。

新增语义条目¶

点击 新增条目。
选择条目类型。
填写 Key，例如 total_revenue。
选择关联表。
填写列名、表达式、SQL 或定义等必填项。
保存条目。

需要修改时，使用行内编辑。需要移除时，使用删除并确认。

选择条目类型¶

类型	何时使用	配置重点
维度列	按地区、时间或类别筛选	列名、类型、同义词和枚举信息
事实列	统计金额、数量等数值	列名、类型和描述
业务指标	定义固定统计口径	聚合表达式、单位和依赖表
表关联	联合多个表分析	左右表和关联列
术语解释	解释业务术语	术语和定义
命名过滤	复用高频筛选条件	过滤表达式和适用表
列偏好	指定推荐或废弃列	推荐列、废弃列和原因
标准问答	固定高频问题的正确 SQL	自然语言问题和已验证 SQL
规则注入	在生成 SQL 时应用业务规则	规则内容、注入阶段和优先级
SQL 结果集	复用已治理的只读 SQL	Key、SQL 和描述

先配置高频字段和业务口径，再补充表关联和样例。

导入、导出和校验¶

操作	用途
导出	备份或迁移语义条目
导入	从 JSON 批量写入语义条目
校验	检查语义配置完整性

导入会替换当前知识库中的全部语义条目。执行前请确认导入内容。