5分钟跑通Langflow可视化工作流从安装到第一个Agent【免费下载链接】langflowLangflow is a powerful tool for building and deploying AI-powered agents and workflows.项目地址: https://gitcode.com/GitHub_Trending/la/langflowLangflow是一个构建AI Agent的可视化工作流工具拖组件到画布上连好端口画出的流程就能作为API和MCP服务器被调用。本文带你从装好跑起来到看懂界面、走通一个带工具的Agent全程可复制约5分钟。二、跑起来之前环境核对与一条命令安装先对照下表确认环境全部满足再往下走项目要求Python3.10–3.14包管理器推荐uv更快、依赖解析更稳硬件最低双核CPU 2GB内存推荐多核 4GB以上其他一个可用的大模型API Key如OpenAI跑Agent时必须用到在空目录下执行这两条命令装完直接启动uv pip install langflow -U uv run langflow run启动后访问http://127.0.0.1:7860能看到登录页就算跑起来了。三、界面长什么样画布分三个区打开首页就是一个工作区布局只有三块左侧组件面板按类别分好的组件库输入输出、模型、工具、向量库等点一下就能加到画布。中央画布拖组件、拉线连端口的地方一条连线就是一次数据传递。右侧属性面板点选某个组件后在这里改参数比如填模型名、API Key。顶部工具栏里的Playground调试运行和Share拿API调用代码是后面最常用的两个按钮记住位置就行。四、它到底能干什么三个能力记住就够1. 拖拽搭建流程不用写胶水代码场景想要一个用户提问 → 模型回答的最小对话流。操作拖Chat Input、Prompt、Language Model、Chat Output四个组件到画布按数据流向依次连线。结果四根线连完流程就能在Playground里跑通全程没写一行代码。2. Playground逐步调试看到Agent的决策过程场景Agent没按预期调用工具不知道卡在哪一步。操作点Playground输入一句数学题如I want to add 4 and 4观察右侧展示的步骤。结果能直接看到它选了哪个工具、执行了什么动作、返回了什么坏组件一眼定位。3. 把流程发布成API或MCP工具接进自己的应用场景流程调好了想在业务系统里通过HTTP调用它。操作编辑流程时点Share → API access面板会生成带FLOW_ID和请求头的现成代码片段。结果拿到/api/v1/run/FLOW_ID的调用方式Python、JS、curl三选一复制即可。五、案例从头走通一个带工具的Agent用官方Simple Agent模板做一个会算数、会抓网页的Agent它自带 Agent、Calculator、URL 组件适合当第一个案例。第一步加载模板点New Flow选Simple Agent模板。为什么用它模板把Agent和两个工具组件都连好了你可以先验证环境模型流程整条链路而不是从零连线的报错里排查环境问题。第二步给Agent配模型点 Agent 组件在Setup Provider里选模型提供商、填API Key再从Language Model下拉框选中模型。为什么必须做这步Agent靠语言模型来决定调哪个工具没配模型时流程能加载但一跑就报错。第三步进Playground实测点Playground先问I want to add 4 and 4应看到它调用 Calculator 工具返回8再问一句时事类问题验证它会切换到 URL 工具去抓内容。为什么先测工具调用工具路由是这个流程的核心逻辑Playground里能逐步看到选工具的推理过程测通了再谈发布。六、从Demo到生产三个容易踩的坑坑1Docker启动报PermissionError: [Errno 13]路径是/app/langflow/secret_key现象容器起不来日志指向secret_key写入失败。原因容器以非root用户运行但旧的langflow-data卷是早期镜像以root初始化的新容器用户没写权限。解法停掉容器删掉langflow-data这个卷数据在postgres卷里不受影响拉新镜像重新docker compose up -d新卷会以正确属主重建。坑2调大LANGFLOW_WORKERS后流程构建偶发卡住或查不到进度现象多worker部署时同一个流程在不同worker上的构建状态对不上前端转圈。原因构建任务队列默认在内存里是每个进程私有的worker A发起的构建worker B看不到。解法给所有worker配置共享的Redis任务队列LANGFLOW_JOB_QUEUE_TYPEredis加队列地址任意worker都能接管任意构建。坑3外部调用报 An API key must be passed as query or header现象脚本里调/api/v1/run/...被拒。原因Langflow API Key是用户级的默认不会自动带上也不是模型的Key。解法点右上角用户图标 →Settings → Langflow API Keys新建一个Key请求里加x-api-key请求头再试。七、下一步去哪三阶段学习路径入门本周把官方快速上手完整做一遍熟悉Playground和API接入路径见 docs/docs/Get-Started/get-started-quickstart.mdx。进阶2–4周写自己的自定义组件先看内置组件的代码结构找参考源码在src/backend/base/langflow/components/。生产1–2个月上多worker Redis PostgreSQL的部署形态照着 docs/docs/Deployment/deployment-multi-worker.mdx 配一遍即可。【免费下载链接】langflowLangflow is a powerful tool for building and deploying AI-powered agents and workflows.项目地址: https://gitcode.com/GitHub_Trending/la/langflow创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考