故障排查GitHub issue2 分钟阅读故障排查

解决FastGPT知识库搜索上限变更后无法限制单问题返回结果的问题

FastGPT公有云新版本将知识库单次搜索的上限从条数限制调整为tokens数量限制。使用时,发起单个问题的提问,系统会返回包含多个问题(如问题1至问题5)的知识库匹配结果。旧版本可通过单次搜索条数上限(topK)限制仅返回对应问题的答案,新版本难以通过tokens数量上限实现该限制。

现象

FastGPT公有云新版本将知识库单次搜索的上限从条数限制调整为tokens数量限制。使用时,发起单个问题的提问,系统会返回包含多个问题(如问题1至问题5)的知识库匹配结果。旧版本可通过单次搜索条数上限(top_K)限制仅返回对应问题的答案,新版本难以通过tokens数量上限实现该限制。

可能原因

FastGPT公有云新版本对知识库搜索的上限配置逻辑进行了调整,将原有的单条搜索条数限制参数替换为tokens数量限制参数,导致原有控制单问题匹配结果的方式无法直接生效。

排查步骤

  1. 确认当前使用的FastGPT版本为公有云版本。
  2. 进入知识库配置页面,查看当前生效的搜索上限参数类型。
  3. 发起单个业务问题的提问,观察返回的知识库匹配结果是否包含多个无关问题的内容。

解决与验证

根据当前配置的tokens数量上限参数,调整参数值以限制单次搜索匹配的tokens总量,从而缩小返回结果的范围。发起单个问题的提问,验证返回结果仅包含对应问题的知识库内容。需按实际环境确认具体参数的调整路径与效果。

来源: FastGPT 官方来源

适用性与版本范围

本页适用于官方来源记录的 故障排查 场景。执行变更前,需核对 FastGPT、依赖、API 与部署版本。

安全护栏

凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。

回滚指引

恢复变更前的技术内容权威快照、已保存配置与数据快照,再执行最小验证场景。