Flowise 工作流配置:可视化编排对话流程的实操步骤
Flowise 的工作流配置本质上是在 Chatflow 画布中拖入节点、连线并设置参数。
你不需要写前端代码,只要把对话链、模型和提示词节点拼起来,就能得到一个可运行的对话流程。
下面从启动服务到验证输出,按顺序说明关键操作。
启动 Flowise 服务
Flowise 官方推荐用 Docker 运行,适合本地测试和轻量生产。
在已安装 Docker 的 Linux 或 macOS 终端执行:
docker run -d --name flowise -p 3000:3000 flowiseai/flowise
启动后访问 http://服务器IP:3000,能看到登录或注册页面即表示服务正常。
如果打不开,先检查容器状态:
docker ps -a | grep flowise
docker logs flowise --tail 50
常见原因是端口被占用或防火墙未放行 3000 端口。
云服务器需要在安全组中放行对应 TCP 端口。
创建 Chatflow 并添加节点
登录后点击左侧导航的 Chatflows,点击右上角 Add New。
进入画布后,从左上角节点面板拖入以下节点:
- Conversation Chain:作为对话链入口,管理上下文。
- ChatOpenAI(或你使用的模型节点):提供大模型能力。
- Prompt Template:定义系统提示词或对话模板。
把 ChatOpenAI 的模型输出连到 Conversation Chain 的 Language Model 输入,把 Prompt Template 连到 Conversation Chain 的 Prompt 输入。
连线方向以节点端口标签为准,不要接反。
配置节点参数
点击 ChatOpenAI 节点,在右侧面板填写 API Key 和 Model Name。
API Key 建议通过环境变量注入,不要直接写死在画布配置里。
如果使用 OpenAI 兼容接口,需要同时填写 Base Path,例如 https://api.example.com/v1,具体地址以你所用服务商文档为准。
Prompt Template 节点中填写系统提示词,例如:
你是一个服务器运维助手,回答要简洁,优先给出命令和步骤。
Conversation Chain 节点保持默认参数即可,Memory 可选。
需要多轮对话记忆时,再添加 Buffer Memory 节点并连线。
测试运行与验证
画布右上角有一个聊天图标,点击打开测试窗口。
输入一句测试问题,例如“如何查看 Linux 内存占用”,观察是否返回合理回答。
验证时重点看三件事:
- 模型节点是否报鉴权错误,通常是 API Key 或 Base Path 不对。
- 连线是否完整,Conversation Chain 缺少 Language Model 输入会直接报错。
- 返回内容是否符合 Prompt 约束,如果不符合,调整提示词后重新测试。
测试通过后,点击右上角 Save 保存 Chatflow。
需要对外提供接口时,可在 Chatflow 详情页找到 API 访问地址和认证方式。
常见问题与避坑
节点连线后没有输出:先检查 Conversation Chain 的输入端口是否都有连线,再看浏览器开发者工具 Network 面板是否有 4xx 或 5xx 响应。
模型返回超时:确认服务器能访问模型 API 地址,可以用 curl 测试连通性。
国内服务器访问境外 API 时,网络延迟或阻断是常见原因。
保存后重新打开配置丢失:确认使用的是同一个 Chatflow 且已点击 Save,不要只关闭浏览器标签页。
不要在生产环境直接暴露 3000 端口:建议在前面加 Nginx 反向代理并配置 HTTPS,同时设置 Flowise 的访问认证。
Flowise 工作流配置的关键在于节点连线和参数准确,先跑通最小对话链,再逐步添加记忆、工具和条件分支,比一次性堆满节点更容易排查问题。