知识库问题

生效前提

• 回答请求需显式携带 useKnowledgeBase=true。
• 文档参与数量由 knowledgeBaseMaxDocuments 控制，范围 1-10。
• 仅“开关已打开”不代表检索一定生效，仍需有有效文档与相关问题。

上传约束

• 单文件最大 50MB。
• 总文档数最多 10 份。
• 单文档字数上限 200000。
• 解析失败或索引失败会中断上传流程，不进入命中阶段。

高频问题判定

• 上传失败但开关可开：通常是上传阶段被限制项拦截，不是检索故障。
• 更新简历后回答无变化：先排除问题上下文未变化，再做开关对照测试。
• 开启后响应变慢：通常是检索与上下文拼装带来的预期耗时。

标准排查步骤

1. 先看上传是否成功（大小、数量、字数、配额）。
2. 再看索引是否完成（文档是否仍在列表且可检索）。
3. 再看请求参数是否正确传入（useKnowledgeBase 与文档数限制）。
4. 最后做同问题对照测试（关闭/开启知识库）。

效果验收

• 关闭与开启知识库时，回答内容出现可解释差异。
• 文档相关问题能稳定命中对应资料。
• 文档越聚焦，回答相关性越高。