故障排查GitHub issue2 分钟阅读排错/错误码

解决FastGPT私有部署版知识库语义检索结果分数为0的问题

用户在FastGPT私有部署v4.14.8版本中,进入知识库的搜索测试页面执行语义检索功能时,检索结果分数为0,无匹配的检索内容。 目前无明确报错指向,可能的相关方向包括:知识库嵌入向量生成异常、查询文本与知识库向量匹配度过低、语义检索阈值配置过高、向量数据库数据同步异常等,具体原因需按实际环境确认。 1.

现象

用户在FastGPT私有部署v4.14.8版本中,进入知识库的搜索测试页面执行语义检索功能时,检索结果分数为0,无匹配的检索内容。

可能原因

目前无明确报错指向,可能的相关方向包括:知识库嵌入向量生成异常、查询文本与知识库向量匹配度过低、语义检索阈值配置过高、向量数据库数据同步异常等,具体原因需按实际环境确认。

排查步骤(有序列表,每步可照做)

  1. 进入对应知识库的管理页面,查看文档嵌入向量生成记录,确认无失败的向量生成任务。
  2. 在知识库搜索测试页面,调整语义检索的阈值参数(若存在),适当降低阈值后重新执行检索测试。
  3. 检查向量数据库的连接状态,确认知识库数据已完成同步至向量数据库。
  4. 更换为与知识库文档内容更匹配的查询文本,再次执行语义检索操作。

解决与验证

针对排查出的具体问题进行针对性修复:若为检索阈值过高,调整至合理范围后验证效果;若为向量生成异常,重新触发知识库嵌入向量生成任务;若为向量数据库同步异常,执行数据同步操作。验证方式为再次执行语义检索,确认检索结果分数不为0且存在匹配的检索内容。

来源:https://github.com/labring/FastGPT/issues/6680