从Java转行大模型应用，扣子工作流学习

一、什么是扣子工作流

平台用于构建自动化业务流程的核心能力，本质是通过可视化拖拽方式，将多个功能节点按特定逻辑编排，实现复杂任务自动化执行的流程编排工具。

其核心逻辑是"模块化搭积木"：将复杂任务拆解为多个独立子任务，每个子任务由一个节点完成，通过变量系统（输入/中间/输出变量）实现节点间的数据流转，最终形成完整的自动化流程。

核心特点的具体说明：

• 可视化操作：无需复杂编码，通过拖拽节点、连接逻辑即可完成流程搭建，画布可清晰展示数据流转和任务执行顺序；

• 多节点支持：集成插件、大模型、代码、知识库等多种节点，可灵活扩展功能边界，适配不同场景需求；

• 自动化执行：一旦编排完成并触发，流程会按预设逻辑自动执行，无需人工逐步骤操作，提升任务处理效率；

• 可扩展性强：支持并行处理、错误重试、日志记录与权限分级管理，还可通过子工作流嵌套实现复杂逻辑的模块化开发。

适用场景：主要用于处理功能类请求，适合数据自动化处理、批量任务执行等场景，例如生成行业调研报告、批量生成海报、数据表格分析、旅游规划等。

二、工作流与对话流的区别

对话流是基于对话场景的特殊工作流，二者共享大部分节点类型，核心区别集中在场景适配、会话能力、配置细节等方面，具体差异如下表所示，同时补充关键细节说明，便于精准区分和选型：

对比维度	工作流（Workflow）	对话流（Chatflow）
核心场景	处理功能类请求，侧重任务自动化、批量处理，如数据加工、海报生成、报告生成等非交互式场景	处理对话类请求，侧重多轮交互式场景，如智能客服、虚拟伴侣、对话式AI助手等，需与用户连贯交互
会话能力	不绑定会话，无上下文记忆，大模型、意图识别等节点不支持查看对话历史	绑定唯一会话，可读取历史对话消息，也可记录本次运行消息，具备上下文记忆能力，模型类节点支持读取对话历史
开始节点	预置1个非必填String类型参数（默认命名为input），可删除或修改	预置2个必选参数（USER_INPUT：用户原始输入；CONVERSATION_NAME：绑定的会话），不可删除或修改
角色配置	不支持角色配置，无头像、开场白、音色等个性化设置	支持角色配置，可设置角色名称、头像、开场白、音色等，适配对话场景的个性化需求
用户界面	支持布局组件、展示组件等丰富组件类型，可搭建多样化界面	仅支持AI对话组件，可包装为聊天面板，适配移动端、网页端展示
发布渠道	支持发布到API，绑定界面后可发布到模板、商店，暂不支持社交渠道、Chat SDK、小程序	支持发布到API&SDK、小程序、社交渠道、商店、模板等所有扣子提供的发布渠道
API调用	通过"执行工作流"或"执行工作流（流式响应）"调用	通过"执行对话流"调用

补充说明：二者可相互转换，转换后节点配置会相应调整------对话流转为工作流后，模型类节点失去对话历史读取能力，开始节点预置参数转为普通参数；工作流转为对话流后，开始节点会新增两个必选预置参数。

选型建议：需搭建工具类AI应用、实现任务自动化，选工作流；需搭建对话式AI应用、实现多轮交互，选对话流。

三、工作流的使用限制

扣子工作流的使用限制主要集中在超时时间、节点数量、资源消耗、请求大小等方面，具体分类说明，明确边界和注意事项，避免使用中出现报错或异常：

（一）超时时间限制

不同节点及工作流整体有明确超时规则，部分节点可手动调整，具体如下：

• 模型节点、插件节点（非端插件）、语音播客、HTTP节点：默认超时3分钟，最大值10分钟；

• 视频生成节点：默认超时2分钟，最大值10分钟；

• 数据库节点、意图识别节点、代码节点、画板节点、图像生成节点等其他节点：无单节点超时限制；

• 工作流整体：同步运行默认10分钟，异步运行默认24小时；未开启异步时，建议执行时间控制在5分钟内，避免影响结果准确性；

• 特殊说明：2025年4月24日前创建的大模型节点默认超时10分钟，IDE插件默认1分钟；端插件类型无超时限制；部分节点不支持手动调整超时时间，可通过异常处理配置调整支持的节点。

（二）节点相关限制

• 节点数量：每个工作流最多添加1000个节点，每次运行（含循环节点、子工作流节点）最多执行1000个节点；

• 代码节点：每个工作流最多添加50个代码节点；

• 图像节点并发：叠图、添加文字插件节点并发限制为单节点10次/秒，其他官方图像插件和图像节点为单节点4次/秒。

（三）资源与请求限制

• 运行次数：试运行消耗模型token扣减资源点，个人免费版资源点用完后次日可继续使用，付费版可购买资源包或充值抵扣；

• 请求大小：工作流整体请求大小上限20MB（含输入参数、消息历史等所有相关数据）；

• 节点入参：节点输入、输出上限均为10MB，其中代码节点、插件节点入参上限2MB，超出会报错或被截断；

• 用户变量长度：最大支持约6万字符，不建议存储过长内容，避免影响性能。

四、如何使用工作流（完整操作流程）

使用扣子工作流的核心流程分为"创建-编排-测试-发布-使用-管理"六大步骤，全程可视化操作，无需复杂编码，具体步骤详解如下，适配智能体和应用两种使用场景：

（一）前提准备

登录扣子平台，进入目标工作空间（若未创建，需先创建工作空间），确保拥有对应空间的操作权限（创建、编辑、发布等）。

（二）步骤1：创建工作流

1. 在左侧导航栏选择"工作空间"，在页面顶部选择目标工作空间；

2. 进入"资源库"页面，点击右上角"+资源"，选择"工作流"；

3. 设置工作流名称和描述（建议清晰明确，便于大模型理解功能，也便于后续管理），点击"确认"；

4. 创建成功后，自动跳转至工作流编辑页面，默认包含1个开始节点（起点，定义输入参数）和1个结束节点（终点，返回运行结果）。

（三）步骤2：编排工作流（核心步骤）

1. 添加节点：在底部面板选择所需节点（如插件、大模型、代码、循环等），拖拽至画布中；若已收藏插件，面板会自动展示，便于快速调用；

2. 连接节点：将节点按任务执行顺序连接，通过引用一个节点的输出作为另一个节点的输入，形成数据流转链路（如大模型节点的输出可作为代码节点的输入）；

3. 配置节点：为每个节点设置输入/输出参数，例如给大模型节点配置提示词，给插件节点配置调用参数，给代码节点编写自定义代码；

4. （可选）设置异常处理：针对易超时、易出错的节点，配置错误重试、超时提醒等规则，提升流程稳定性。

（四）步骤3：测试并发布工作流

1. 试运行：点击编辑页面的"试运行"，若输入参数包含图片、视频等文件，可上传文件或输入文件URL；运行成功的节点边框显示绿色，可在节点右上角查看输入/输出详情，若失败则排查节点配置或参数；

2. 发布：试运行通过后，点击"发布"，可选择试运行阶段保存的测试集作为默认测试集，发布后该空间内其他用户可使用该工作流并通过测试集调试。

（五）步骤4：在智能体/应用中使用工作流

1. 在智能体中使用

1. 进入目标智能体的编排页面，在"工作流区域"点击右侧加号；

2. 在弹出的对话框中，选择"我创建的"，找到已发布的工作流并添加；

3. 在智能体"人设与回复逻辑"区域，引用工作流名称，即可实现智能体触发工作流；

4. （可选）开启异步运行：若工作流复杂、耗时久，可在工作流设置中开启异步运行，设置默认回复文案（工作流运行时智能体先回复用户，运行完毕后再返回最终结果）。

2. 在应用中使用

1. 在项目中选择"新建工作流"（仅可在该项目使用，不可共享），或"引入资源库文件"（复制已发布的工作流，修改不影响原资源）；

2. 根据项目需求，修改节点配置或新增节点，完成后测试并启用。

（六）步骤5：管理工作流

• 查看引用资源：点击工作流编排页面右上角"引用关系"，可查看工作流引用的子工作流、插件、知识库等资源，便于定位问题；

• 复制工作流：在编辑页面点击"创建副本"，可将工作流复制到个人工作流列表，支持跨画布复制节点；

• 删除工作流：在工作流列表中找到目标工作流，点击操作列"删除"；若已添加至智能体，删除时会同步删除智能体中的该工作流。

五、工作流节点学习

节点是工作流的核心组成单元，每个节点是具备特定功能的独立模块，有明确的输入/输出接口，扣子平台提供多种节点类型，按功能分类整理，重点记录核心用途和适用场景，便于快速选型和使用：

（一）基础必选节点（每个工作流必备）

• 开始节点：工作流的起点，定义输入参数，默认包含1个非必填String类型参数（input），可根据需求修改或新增参数，用于接收用户原始输入或外部传入数据；

• 结束节点：工作流的终点，用于返回运行结果，支持以"返回变量"或"返回文本"两种方式输出，需绑定上游节点的输出结果，确保流程闭环。

（二）核心功能节点（常用重点）

1. 插件节点

功能：调用已集成的插件工具，实现特定功能，无需自定义开发；

适用场景：快速扩展能力边界，如天气查询、酒店搜索、联网搜索、图片处理等；支持自定义插件接入，满足官方插件无法覆盖的需求；

注意：部分插件为付费插件，调用时会按规则计费。

2. 大模型节点

功能：调用选定的大语言模型（LLM），根据输入和提示词生成文本输出，为工作流注入智能；

适用场景：处理自然语言理解、内容生成、总结、推理等任务，如文案生成、需求分析、文本总结等；

注意：输出质量依赖模型能力，基础版账号可使用的模型有限，专业版可接入更多高性能模型；运行会消耗模型token，属于付费节点。

3. 代码节点

功能：执行自定义Python或JavaScript代码；

适用场景：实现现有节点无法提供的复杂逻辑、算法、数据格式转换，或与外部API/系统集成，如复杂数据计算、特殊格式处理等；

限制：每个工作流最多添加50个，入参上限2MB。

4. 知识库相关节点

• 知识库检索节点：根据查询条件（Query），从指定知识库中召回最匹配的文本片段，解决大模型"幻觉"或知识陈旧问题，适用于智能问答、企业知识检索等场景；

• 知识库写入节点：主动向指定知识库上传、存储新文档，实现知识库动态扩展，为异步操作，上传文档对所有用户可见。

5. 逻辑控制节点

• 选择器节点：类似编程中的if-else语句，根据输入条件判断，引导工作流执行不同分支，适用于任务分发、流程切换（如客服系统中区分"退货""换货"流程）；

• 循环节点：重复执行内部节点，支持3种类型（遍历数组、指定次数、无限循环，无限循环需搭配终止条件），适用于批量处理任务（如长文本分段生成、批量生成图片）。

（三）辅助功能节点

• 文本处理节点：对输入文本进行拼接、分隔、清洗、格式化等操作，规整数据格式，适配下游节点输入需求，提升处理准确性；

• 变量赋值节点：创建或修改变量值，临时存储用户输入、中间计算结果等，供后续节点使用，是实现复杂状态管理和个性化服务的基础；

• 意图识别节点：基于大模型能力，识别用户输入的真实意图（如咨询、投诉、购买）并分类，作为"总调度"，将流程导向对应分支，比选择器节点更智能；

• 长期记忆节点：从智能体长期记忆中召回当前用户的个性化信息（如喜好、历史对话摘要），实现个性化服务（如个性化新闻推荐）；

• 工作流节点（子工作流）：在当前工作流中调用另一个已创建的工作流，实现模块化开发，将通用功能封装为子工作流，提升流程清晰度和可维护性。

（四）节点使用注意事项

• 所有节点需正确配置输入/输出参数，确保数据流转顺畅，否则会导致流程运行失败；

• 付费节点（大模型、图像生成、知识库写入等）运行时会产生费用，需关注资源点消耗；

• 节点连接需遵循逻辑顺序，避免出现循环依赖，确保工作流为有向无环图（DAG）；

• 常用节点可收藏，便于后续快速调用，提升编排效率。