分段与语义

选择配置对象

现象

进入位置

先检查什么

文件内容缺段、串段或引用无关内容

智能分段

预览、分段内容、启用状态和当前版本

文件没有可读预览或没有分段

管理知识库数据

处理状态、错误信息和源文件

表的指标、筛选或联表结果不正确

语义配置

维度、指标、关联和术语

资料已经换版

管理知识库数据

新数据的处理状态和旧数据的启用状态

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

配置文件分段

开始前，请在管理知识库数据中确认文件已添加，且处理状态为 就绪。

打开文件详情

  1. 打开目标知识库的 高级配置。

  2. 打开 数据 页签。

  3. 点击目标文件名称。

  4. 打开 智能分段。

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

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

检查分段

  1. 在 智能分段 中确认分段列表有内容。

  2. 列表为空时，点击 生成初始分段。

  3. 使用 搜索分段 定位内容。

  4. 使用 分段排序 按原文顺序或召回优先查看分段。

  5. 检查关键分段的正文、图片、表格或转录内容。

问题

处理方式

分段过碎

合并或调整正文，使一个分段保留完整语义

分段过粗

拆分正文，避免命中内容过大

内容乱码或错段

检查源文件和解析内容，再编辑分段

无关内容仍参与检索

停用对应分段

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

编辑分段

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

操作

步骤

编辑分段

选择 编辑分段，修改内容后保存

新建分段

选择 新建分段，输入正文后保存

停用分段

关闭 启用分段

删除分段

选择 删除分段 并确认

更新向量

修改影响检索的内容后，选择 重新 embedding

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

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

管理版本

  1. 在文件详情中打开 版本记录。

  2. 查看版本名称、变更人和变更时间。

  3. 选择需要使用的版本。

  4. 点击 设为当前。

  5. 确认 索引版本 与预期一致。

现象

检查方式

无分段或生成失败

生成初始分段；仍失败时检查处理状态和源文件

修改后回答未变化

检查是否已重新 embedding，以及当前版本是否正确

回答包含无关内容

停用无关分段，或在数据列表中禁用整个文件

整份文件需要更新

重新添加数据，再检查分段版本

配置表语义

语义配置面向数据表，用于数据问答和 SQL 生成。控制台新增条目前，先在 数据源 页签添加至少一张数据表。

打开语义配置

  1. 打开目标知识库的 高级配置。

  2. 打开 语义配置 页签。

  3. 如果尚无语义模型，按界面提示创建第一条语义条目。

新增语义条目

  1. 点击 新增条目。

  2. 选择条目类型。

  3. 填写 Key，例如 total_revenue。

  4. 选择关联表。

  5. 填写列名、表达式、SQL 或定义等必填项。

  6. 保存条目。

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

选择条目类型

类型

何时使用

填写内容

维度列

按地区、时间或类别筛选

用于筛选或分组的列名

事实列

统计金额、数量等数值

可参与计算的列名

业务指标

定义固定统计口径

指标表达式

表关联

联合多个表分析

两张关联表和连接列

术语解释

解释业务术语

术语和定义

命名过滤

复用高频筛选条件

过滤表达式

列偏好

指定推荐或不推荐的列

推荐列和不推荐列

标准问答

固定高频问题的 SQL

问题和 SQL

规则注入

在生成 SQL 时应用业务规则

规则内容和应用阶段

SQL 结果集

复用已治理的 SQL

SQL 和说明

表关联中的两张表必须都是知识库已配置的数据表。先配置高频字段和业务口径，再补充表关联和样例。通过 API 创建条目时，参照创建语义条目中的完整字段说明。

导入、导出和校验

操作

用途

导出

备份或迁移语义条目

导入

从 JSON 批量写入语义条目

校验

检查语义配置完整性

导入仅适用于当前没有语义条目的知识库。执行前确认目标知识库为空，并检查导入内容。

最后更新于