知识未切片或向量化失败、权限未授予项目、检索策略过度过滤、切片内容被清洗过滤是四大根因；需依次检查切片状态、向量构建状态、项目授权、高级设置及切片内容完整性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
火山引擎知识库已上传11万条制度文档，但员工在「AI老铁」中提问“融资融券开户流程”，返回结果为空或匹配到无关条目，业务方急需定位是知识未切片、权限未生效，还是检索策略配置错误。
确认知识是否已完成切片与向量化
登录火山引擎控制台 → 企业知识引擎 → 项目中心 → 知识库列表 → 找到对应知识库 → 点击「详情」→ 查看「切片状态」列。若显示“待处理”或“失败”，说明原始文件未成功解析为可检索单元。
切片失败常见原因为PDF含扫描图、Excel存在合并单元格、Word内嵌不可读OLE对象——此时需重新上传清理后的文件，【切片失败的知识条目不会进入向量索引，必然无法召回】。
若状态为“已完成”，继续检查「向量构建状态」是否为“成功”。向量化失败会导致知识虽有切片，但无语义表征，搜索仅能依赖关键词硬匹配，召回率极低。
验证知识库权限是否已授予当前项目
打开控制台左侧导航栏「项目授权」页面，确认目标项目右侧的「企业知识引擎」权限开关为开启状态。
注意：项目授权不等同于IAM用户权限，即使管理员账号能查看知识库，若未对当前运行智能体的项目显式授权，调用时将静默降级为无知识上下文问答，【未授权项目调用knowledge_search工具会返回空结果，且不报错】。
如使用的是default项目，请确保左下角项目切换器中显示的就是default；若为自定义项目，必须手动点击该名称完成切换后再授权。
检查检索参数是否触发了过度过滤
方法一：通过API调试直接传参验证
使用curl或Postman调用knowledge_search接口，构造最小请求体：{"query":"融资融券开户流程","top_k":5}，观察返回的usage.tool_usage_details中actual_retrieved_count是否大于0。若为0，说明根本未命中任何切片。
方法二：在控制台临时关闭关键词并行与重排
进入知识库「高级设置」→ 将「关键词并行数」设为1、「启用结果重排」关闭 → 保存后立即重试搜索。并行数过高可能因部分改写词质量差，拉低整体召回分；重排模型若未适配金融术语，反而会压制高相关原始切片。
这一步操作起来很简单，直接在设置页滑动开关即可，无需重启服务。
排查知识切片内容是否被清洗过滤
第一步：在知识库详情页点击「切片管理」→ 输入关键词“融资融券”进行站内搜索。
第二步：逐条检查命中的切片文本预览，确认是否包含“开户”“流程”“材料清单”“风险揭示书”等核心要素。
第三步：若切片内容仅为标题（如“融资融券管理办法”）或纯页眉页脚，说明解析时启用了“仅提取正文”策略，而实际制度文件中关键流程藏在附件表格或批注里——此时需回到知识接入阶段，修改解析配置中的「结构化提取规则」，勾选“保留表格内容”和“提取批注文本”。
第四步：导出一条典型失败切片的原始段落，用在线分词工具对比“融资融券开户流程”的TF-IDF权重，验证是否因术语拆分异常（如“融资融券”被切为“融资/融券”两个独立词）导致语义断裂。
