火山引擎知识库标题缺失会导致RAG溯源失败；需确认「标题提取策略」开启，并通过Word样式、Markdown #号或JSONL/CVS手动注入title字段（≤256字符）；最后通过样本切片、BM25检索及API响应验证title是否正确入库。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
火山引擎知识库构建过程中，若原始文档标题在切片时被截断或丢失，会导致后续检索时无法准确识别文本块所属章节、上下文层级及业务归属，直接造成知识召回错位或失效。
确认文档标题是否参与切片
进入火山引擎控制台 → 知识库管理 → 选择目标知识库 → 点击「配置」→ 查看「切片设置」中「标题提取策略」开关状态。默认开启，但若原始文档为纯文本无结构标记（如无#、##、
等），系统可能无法识别标题层级。
若开关关闭，所有切片将统一无标题；若开启但未识别到有效标题，则该文档所有子块的title字段为空字符串——【这会直接导致RAG问答中“依据哪份制度”类问题无法溯源】。
保留标题的三种强制手段
方法一：在Word/PDF源文件中使用标准语义标题样式
对正文标题应用「标题1」「标题2」等内置样式（非加粗/字号模拟），火山引擎解析器可据此锚定章节边界并继承标题文本至每个切片的metadata.title字段。
方法二：在Markdown文档中用#号显式声明层级
确保每级标题独占一行且以#开头（如“# 客户开户流程”），避免#后紧跟中文标点或空格。系统会将#号行内容自动提取为该段落切片的title值，即使该段被进一步按段落切分也不会丢失。
方法三：上传前手动注入title字段（适用于JSONL/CSV格式）
若使用自定义数据源，需在每条记录中显式添加"title": "XXX"键值对。注意：该字段长度上限为256字符，超长部分会被静默截断——【截断发生在入库前，且不报错】。
验证标题是否成功入库
第一步：在控制台知识库详情页点击「查看样本切片」
第二步：检查任意一条切片的JSON结构，定位title字段是否非空且内容合理
第三步：执行一次带“标题包含XXX”的BM25关键词检索，观察返回结果是否精准命中对应章节
第四步：调用/v1/kb/{kb_id}/search接口，传入query="请说明开户材料要求"，检查响应中hit.item.metadata.title是否为“客户开户流程”或类似准确标题
