Flowise

Flowise 快速入门

低代码 AI Agent 工厂 —— 拖拽节点，三分钟上线一个 AI 聊天机器人。

这是什么？适合谁？

Flowise 是开源的拖拽式 LLM 应用构建平台，专注于让非技术人员也能快速搭建 AI Agent 和聊天机器人。它提供 100+ 预置集成（文档加载器、向量数据库、工具、LLM），支持一键部署为 API 或嵌入网页。GitHub 54K+ stars，Apache 2.0 开源，最新版 v3.1.3（2026-06-25），Docker 拉取量超 666 万次。

适合谁？一是企业 IT 团队，需要快速搭建内部 AI 助手（HR 问答、IT 帮助台）；二是产品经理，想验证 AI 功能原型；三是自由职业者，为客户快速交付 AI 聊天机器人。不适合：需要复杂多 Agent 协作的场景（用 LangGraph 或 CrewAI），以及需要极致性能的生产环境。

准备工作

• 安装：npm install -g flowise 或 Docker
• API 密钥：至少一个 LLM 提供商的 API Key
• 浏览器：Flowise 在 localhost:3000 运行
• Node.js：需要 v18.15.0+ 或 v20+

3 步快速上手

第 1 步：安装并启动

npm install -g flowise
npx flowise start

或使用 Docker：

docker compose up -d  # 从 repo 的 docker/ 目录

第 2 步：打开界面

浏览器打开 http://localhost:3000。

第 3 步：搭建第一个聊天机器人

添加 ChatOpenAI 节点 → 添加 Conversational Retrieval QA Chain 节点 → 连接 → 上传文档 → 开始对话。或使用全新的 Assistant 模式，填写指令即可创建 AI 助手。

常见踩坑

踩坑 1：Node.js 版本不兼容

• 症状：启动后白屏或报错
• 原因：Flowise 需要 Node.js 18.15.0+ 或 v20+，低版本或特定版本（如 v18.20.5、v23.3.0）存在兼容问题
• 解决：nvm install 20 && nvm use 20
• 参考：GitHub Issue #3583

踩坑 2：嵌入模型配置错误

• 症状：文档上传后无法检索
• 原因：未配置嵌入模型
• 解决：添加 Embeddings 节点（如 OpenAI Embeddings），或在设置中配置默认嵌入模型

踩坑 3：Docker JWT Secret 未配置

• 症状：Docker 部署后启动报 “JwtStrategy requires a secret or key”
• 原因：.env 文件未正确配置 JWT 密钥
• 解决：创建 .env 文件并设置 JWT_SECRET=your-secret-key，然后重启容器
• 参考：GitHub Issue #4563

踩坑 4：Agentflow 并行节点状态污染

• 症状：多个并行节点执行后，结果互相混淆或数据流异常
• 原因：Agentflow V2 并行节点存在状态共享问题，一个节点的输出影响另一个节点
• 解决：将并行节点改为串行执行，或在各节点间显式传递数据
• 参考：GitHub Issue #4710

踩坑 5：构建时内存不足

• 症状：从源码构建（pnpm build）时报 JavaScript heap out of memory
• 原因：构建过程需要大量内存
• 解决：运行 NODE_OPTIONS="--max-old-space-size=4096" pnpm build 增加内存限制
• 参考：Flowise README 构建说明

踩坑 6：HITL（Human-in-the-Loop）流程中断

• 症状：包含「Human Input」节点的子工作流没有等待用户输入就继续父工作流
• 原因：子工作流中 HITL 节点的等待机制与父工作流时序冲突
• 解决：简化工作流层级，避免在嵌套子流程中使用 HITL 节点
• 参考：GitHub Issue #5082

踩坑 7：pgvector upsert 异常

• 症状：使用 pgvector 向量库时 upsert 操作不生效
• 原因：pgvector 组件的 upsert 实现存在 Bug
• 解决：暂时使用其他向量数据库（如 Chroma、Pinecone），或等待修复
• 参考：GitHub Issue #5611

踩坑 8：v3.1.0+ HTTP 安全校验拦截内部请求

• 症状：工作流中请求 localhost 或内部服务时被拒绝
• 原因：v3.1.0 起默认启用 HTTP 安全验证，拒绝非公开请求
• 解决：在设置中关闭此校验，或配置白名单

初级用法

1. Assistant 模式快速创建助手 — 选择”Assistant”构建器，输入角色设定（如”你是一个 HR 助手”），上传员工手册 PDF，一个 HR 问答机器人就做好了
2. Embedded Chat Widget — 完成聊天机器人后，一键获取嵌入代码（<script> 标签），粘贴到你的网站 HTML 中，访问者即可对话
3. 使用模板快速启动 — Flowise 内置多种模板（客服机器人、文档问答、SQL 查询助手），基于模板修改比自己从零搭建快 10 倍
4. 上传文档搭建 RAG — 直接上传 PDF / TXT / CSV 等格式文档，Flowise 自动分块、嵌入并建立检索索引

高级玩法

1. 多 Agent 编排（Agentflow） — 使用 Agentflow 构建器搭建多 Agent 系统，每个 Agent 分配不同工具和 Memory，实现复杂业务流程编排
2. MCP Server 集成 — 添加 MCP 节点连接外部 MCP 服务器，让 Flowise Agent 能够调用实时外部工具（数据库查询、API 调用等）
3. HITL（人工审核）工作流 — 在关键决策点插入 Human Input 节点，让 AI 处理日常问题，只有特殊请求才转接人工
4. 自定义评估流水线 — 使用 Evaluations 功能创建评估数据集和评估器，自动化测试不同工作流的输出质量
5. 可观测性集成 — 配置 OpenTelemetry 或 Langfuse / LangSmith，追踪每个工作流的 Token 消耗、延迟和错误率

小技巧

1. 使用 npx 快速启动 — npx flowise start 无需全局安装，直接临时测试最新版本
2. Docker 部署推荐 — Flowise Docker 镜像已有 666 万+ 拉取量，经过充分验证，比 npm 安装更稳定
3. 分支节点实现条件逻辑 — 使用 If/Else 逻辑节点，根据 AI 输出走不同分支，比如”正面评价→自动回复，投诉→转人工”
4. 工作流导入/导出 — 完成的工作流可导出为 JSON，分享给团队成员或备份
5. 日志查看技巧 — 工作流运行时展开节点查看 Logs 面板，每个节点的输入输出一目了然，排错利器

进阶学习建议

• 深入 Agentflow V2 编排：关注 Flowise 的 Agentflow V2 功能，这是其核心差异化的多 Agent 编排能力，学习如何组织分支、循环和路由逻辑
• 研究 MCP 集成方案：Flowise 已支持 MCP 节点，尝试将其与本地 MCP 服务器（如数据库查询、文件系统操作）对接，扩展 Agent 能力边界
• 监控与评估体系：部署到生产后一定要配置 Evaluations 和日志流，设置评估数据集定期验证工作流质量，避免模型更新后输出退化
• 利用 REST API 自动化：所有工作流都可作为 REST API 调用，编写脚本批量测试不同输入的输出质量，建立持续验证机制

FAQ 常见问题

Q: Flowise 收费吗？

A: 核心功能完全开源免费（Apache 2.0）。Flowise Cloud 付费计划：Free $0/月（2 个 Flow、100 次预测）、Starter $35/月（无限 Flow、10,000 次预测）、Pro $65/月（50,000 次预测、5 个用户、优先支持）。自部署使用核心功能完全免费。

Q: Flowise 和 Langflow 的区别？

A: Flowise（TypeScript, Apache 2.0, 54K stars）更偏重低代码、Assistant 快速搭建，适合非技术人员；Langflow（Python, MIT, 152K stars）更偏重 LangChain 生态和 Python 开发者。两者定位接近但技术栈不同。

Q: 支持哪些 LLM？

A: 支持 OpenAI、Anthropic Claude、Google Gemini、Ollama 本地模型、Azure OpenAI、AWS Bedrock 等几乎所有主流 LLM。通过自定义 API 节点还可接入其他兼容 API。

Q: 可以部署到生产环境吗？

A: 可以。Flowise 支持 Docker/K8s 部署、可嵌入网页的 Chat Widget、REST API 访问。企业客户包括 AWS、Priceline、Accenture 等。

Q: 社区活跃度如何？

A: Discord 社区 50K+ 成员，GitHub 100+ 贡献者，npm 月下载量约 10,706，Docker 拉取超 666 万次。官方文档更新频繁，社区解答活跃。

参考链接

• Flowise 官网
• Flowise GitHub
• Flowise 文档
• Flowise Cloud
• GitHub Issues
• Flowise Discord

免责声明

本文基于官方文档和公开资料整理，AI辅助生成，MagicNetWorld 尚未完成独立实测