分段管理

AI: 知识库专业版+

文档上传后,NocoBase 会先按分段参数把正文拆成若干分段,再把启用中的分段写入向量存储。RAG 检索命中的也是这些分段,而不是整篇原始文档。「Split document」「Chunk size」「Chunk overlap」会影响分段数量、上下文长度和相邻分段的衔接。

打开分段管理

进入知识库的「Documents」页面,在某篇文档右侧点击「Segments」,会打开「Segment management」弹窗。这里展示当前文档生成的所有分段。

20260617004439

查看分段列表

分段列表包含这些信息:

字段含义
「No.」分段序号,从 1 开始显示
「Preview」分段内容预览
「Characters」当前分段字符数
「Related questions」当前分段配置的关联问题数量
「Enabled」是否参与向量化和检索
「Updated at」分段最近更新时间

打开「Enabled only」后,列表只显示启用中的分段。这个开关只影响列表显示,不会修改分段数据。

历史数据说明

如果某篇文档是通过旧版本知识库插件上传的,可能没有单独保存分段信息。旧版本知识库插件会把分段内容和分段向量一起保存在向量数据库中,因此「Segment management」里的分段列表可能为空。

这种情况不影响知识库检索。只有需要查看或编辑分段列表时,才需要重新向量化或重新分段;通常不需要仅为了让列表显示数据而重新处理文档。

编辑分段

点击某个分段右侧的「Edit」可以打开分段详情。

20260617004531

在详情里可以修改:

  • 「Content」:分段正文
  • 「Related questions」:额外的可检索问法
关联问题

「Related questions」用于给当前分段补充常见问法。它不会改写分段正文,但会参与向量检索;如果用户输入的问题和某条关联问题匹配度较高,检索结果会返回这条关联问题对应的文档分段。

保存后,NocoBase 会更新分段文件,并触发当前文档重新向量化。回到「Documents」列表时,状态可能会短暂显示为「Pending」。

启用、禁用和删除分段

「Enabled」开关用于控制单个分段是否参与检索:

  • 启用:分段会被写入向量存储,可以被 RAG 和命中测试检索到
  • 禁用:分段保留在列表中,但不会参与后续向量化和检索

点击「Delete」会删除当前分段及其向量数据。删除后文档的分段数、字符数会重新统计。

注意

禁用或删除分段都会触发重新向量化。处理完成前,文档状态可能显示为「Pending」。

重新分段

点击右上角「Segment settings」,可以为当前文档重新设置分段参数。

20260617004702

其中:

  • 「Split document」:是否按参数拆分文档。开启后会生成多个分段;关闭后会把整篇文档作为一个分段
  • 「Chunk size」:每个分段的最大字符数,默认 6000。值越小,分段越细;值越大,单个命中结果包含的上下文越多
  • 「Chunk overlap」:相邻分段之间保留的重叠字符数,默认 1200。适当重叠可以减少段落边界造成的上下文断裂

点击「Resegment」会按当前参数重新生成分段。

注意

重新分段会丢弃已经手工编辑过的分段内容和关联问题。只有确认需要按新参数重建分段时,再执行这个操作。