FastGPT工作流配置:在可视化画布编排问答流程
FastGPT 的工作流配置,本质上是在「工作流」类型应用里,用可视化画布把流程入口、知识库检索、AI 对话和输出节点串起来。
它适合需要多步骤处理、条件分支或先查知识库再回答的场景;
如果你只是单轮直接问答,普通对话应用也能满足,不必强行上工作流。
先确认你用的是工作流应用
登录 FastGPT 后台后,进入「工作台」或「应用」列表,点击「新建应用」,应用类型选择「工作流」。
创建完成后会进入画布编辑页,左侧是节点面板,中间是画布,右侧是节点配置区。
需要提前准备两样东西:
- 一个已经建好并完成训练或索引的知识库,里面至少有可检索的文档;
- 一个可用的 AI 模型渠道,在「模型配置」里已经添加并测试通过。
如果知识库状态还显示索引中,先等它完成,否则知识库搜索节点可能返回空结果。
在画布上搭出最小可用流程
一个能跑通的最小工作流通常包含四个节点:流程入口、知识库搜索、AI 对话、指定回复。
操作顺序如下:
- 从左侧节点面板拖入「流程入口」,它代表用户输入的问题。
- 拖入「知识库搜索」节点,在右侧配置区选择目标知识库,把「流程入口」的用户问题连接到搜索节点的查询输入。
- 拖入「AI 对话」节点,把知识库搜索的结果作为上下文接入,同时在提示词里要求模型基于检索内容回答。
- 拖入「指定回复」节点,把 AI 对话的输出接到回复内容,并连到流程结束。
关键连接关系可以用一句话检查:用户问题进入知识库搜索,搜索结果进入 AI 对话,AI 对话输出进入指定回复。
少接一条线,发布后就会出现空回复或节点未执行。
节点参数怎么填才不容易出错
知识库搜索节点重点看三个配置:知识库选择、相似度阈值和返回条数。
阈值设得太高会搜不到内容,设得太低会带入无关段落,建议先用默认值跑一轮,再根据实际返回调整。
AI 对话节点要确认模型渠道可用,并在提示词中明确「如果检索内容为空,请直接说明没有找到相关资料,不要编造」。
这一步能减少模型在无检索结果时自由发挥。
指定回复节点负责把最终内容返回给用户。
如果 AI 对话输出是流式内容,保持默认输出方式即可;
需要固定话术兜底时,可以在前面加条件判断,但最小流程先不加分支,降低调试难度。
发布前先调试再上线
画布右上角有「调试」或「运行」入口,输入一个你知识库里确实存在的问题,观察每个节点的执行状态。
正常情况下知识库搜索节点应显示命中条数,AI 对话节点显示模型返回内容,指定回复节点显示最终输出。
如果某个节点显示未执行,优先检查连线是否断开;
如果知识库搜索返回 0 条,检查知识库是否选中、文档索引是否完成、相似度阈值是否过高;
如果 AI 对话报模型错误,回到模型配置确认渠道和密钥有效。
调试通过后点击「发布」,工作流才会对外提供访问。
修改画布后需要重新发布,否则线上仍是旧版本。
两个容易忽略的细节
工作流里的节点顺序不等于画布位置,真正决定执行顺序的是连线关系,拖乱位置不影响运行,但断线一定会影响。
另外,知识库搜索节点返回的是文档片段,不是完整答案,提示词里要引导模型基于片段归纳,而不是要求它逐字复述,否则回答容易生硬。
完成以上配置后,你可以用几个不同难度的问题做一轮回归测试,确认检索、回答和兜底话术都符合预期,再正式对外使用。