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

解决FastGPT私有部署版工作流知识库分支逻辑异常问题

用户在FastGPT私有部署v4.8.11版本的工作流中,配置了「知识库搜索节点→判断器节点→两个AI对话节点」的链路,意图实现:当知识库检索到匹配内容时,使用第一个AI对话节点返回结果;未检索到时,触发第二个联网搜索的AI对话节点。但实际执行时未按预期逻辑运行,未触发预设的联网搜索分支。

现象

用户在FastGPT私有部署v4.8.11版本的工作流中,配置了「知识库搜索节点→判断器节点→两个AI对话节点」的链路,意图实现:当知识库检索到匹配内容时,使用第一个AI对话节点返回结果;未检索到时,触发第二个联网搜索的AI对话节点。但实际执行时未按预期逻辑运行,未触发预设的联网搜索分支。

可能原因

结合配置链路与执行异常,可能的原因包括:1. 判断器节点的条件未正确匹配「知识库无检索结果」的判定逻辑;2. 知识库搜索节点的输出参数未正确接入判断器的判定输入;3. 工作流节点间的参数传递链路存在配置错误。

排查步骤

  1. 进入对应工作流的编辑页面,查看知识库搜索节点的配置,确认其返回的检索结果字段与格式。
  2. 打开判断器节点的配置面板,检查其判定条件是否设置为「知识库搜索结果为空」的匹配规则。
  3. 检查工作流中各节点的连接线,确认知识库搜索节点的输出正确接入判断器的判定输入端口。
  4. 查看工作流的执行日志,确认各节点的执行状态与返回的具体数据内容。

解决与验证

首先调整判断器节点的判定条件,设置为匹配「知识库搜索结果为空」的逻辑,保存工作流配置。随后执行工作流测试:当知识库存在匹配内容时,正常走第一个AI对话节点返回结果;当知识库无匹配内容时,触发第二个联网搜索的AI对话节点,验证是否符合预期配置效果。

来源:FastGPT GitHub issue