一、工作流概述

工作流是一系列可执行指令的集合，用于实现业务逻辑或完成特定任务，为应用/智能体的数据流动和任务处理提供结构化框架。扣子提供可视化画布，支持拖拽节点搭建工作流及实时调试，适用于数据自动化处理场景（如生成行业调研报告、海报、绘本等）。

与对话流（Chatflow）不同，工作流更侧重功能类请求处理，而对话流是基于对话场景的特殊工作流，适合对话类交互（如智能客服、虚拟伴侣）。二者核心差异如下表：

二、工作流权限说明

不同角色对工作流的操作权限不同，具体如下表：

三、搭建工作流步骤

3.1 创建工作流

1. 登录扣子平台：访问扣子官网，登录账号并进入目标工作空间。

2. 创建资源：在资源库页面右上角点击**+资源**，选择工作流。

3. 设置基本信息：输入工作流名称（如“行业报告生成器”）和描述（建议清晰描述功能，帮助模型理解），点击确认。

   创建后自动跳转至编辑界面，初始画布包含开始节点（启动工作流）和结束节点（返回结果）。

3.2 编排工作流

3.2.1 添加节点

在画布底部面板点击添加节点，选择所需节点类型。扣子支持多种节点，核心包括：

• 基础节点：开始/结束节点、大模型节点、插件节点、工作流节点（嵌套子工作流）。
• 业务逻辑节点：选择器（条件分支）、循环节点、代码节点（自定义逻辑）。
• 数据节点：变量赋值、知识库检索、数据库读写节点。

3.2.2 连接节点与配置参数

1. 连接节点：通过节点间的拖拽连线，定义执行顺序（如“开始节点→大模型节点→结束节点”）。
2. 配置参数：点击节点进入配置面板，根据节点类型设置输入输出：
   • 开始节点：定义输入参数（如report_topic，类型String，描述“行业报告主题”），支持必选/非必选设置。
   • 大模型节点：选择模型（如“豆包-4K”）、编写提示词（如“根据{{report_topic}}生成行业报告”），配置输出格式（文本/JSON）。
   • 插件节点：选择插件（如“ByteArtist图像生成”），设置输入参数（如prompt引用大模型输出）。

3.3 测试与发布工作流

3.3.1 试运行

点击画布右上角试运行，输入测试参数（如文件需上传或输入URL），检查节点运行状态：

• 成功运行的节点边框显示绿色，可点击右上角查看输入输出日志。
• 失败节点边框显示红色，需检查参数配置或节点逻辑。

3.3.2 发布工作流

试运行通过后，点击发布，选择保存的测试集作为默认测试集（可选）。发布后，工作流将在空间内共享，协作者可查看和调用。

四、核心节点配置详解

4.1 开始与结束节点

• 开始节点：定义工作流输入参数，支持String、Number、Object等类型，必选参数未填写时无法启动工作流。
• 结束节点：返回运行结果，支持两种模式：
  • 返回变量：以JSON格式输出所有参数（适用于子工作流或卡片绑定）。
  • 返回文本：直接返回自然语言结果，支持引用变量（如{{summary}}）和流式输出。

4.2 大模型节点

用于调用大语言模型处理文本任务（如生成、总结、翻译），核心配置：

• 模型选择：根据权限选择（个人版默认豆包模型，企业版可接入火山方舟模型）。
• 技能配置：可添加插件、知识库、子工作流，模型将自动判断调用时机（如调用“天气插件”获取数据后生成穿搭建议）。
• 输出格式：支持文本、Markdown、JSON，JSON格式需定义参数结构（如{"title": "报告标题", "content": "报告内容"}）。

4.3 插件节点

调用外部插件扩展能力（如图片生成、联网搜索），配置步骤：

1. 选择插件（如“火山联网问答”）。
2. 设置输入参数：支持固定值或引用上游节点输出（如query: {{user_input}}）。
3. 查看输出示例：点击查看示例获取插件返回格式，便于下游节点引用。

注意：OAuth插件需配置授权模式（单独授权/共享授权），共享授权时所有用户共用开发者账号资源。

五、在智能体/应用中使用工作流

5.1 在智能体中添加工作流

1. 进入智能体编辑页面，在工作流区域点击**+**。
2. 选择我创建的工作流，点击添加。
3. 在人设与回复逻辑中引用工作流名称（如“当用户询问行业报告时，调用【行业报告生成器】工作流”）。

异步运行设置：若工作流耗时较长（如视频生成），可在工作流设置中开启异步运行，超时时间延长至24小时，智能体将先返回预设回复，运行完成后再推送结果。

5.2 在应用中添加工作流

应用中使用工作流需通过资源库引入或新建：

• 引入资源库：复制空间内已发布的工作流，修改不影响原版本。
• 新建工作流：仅在当前应用内可用，不共享至资源库。

六、工作流管理

6.1 查看引用资源

在工作流编辑页面点击右上角引用关系，可查看当前工作流引用的子工作流、插件、知识库等资源，箭头方向表示引用关系（如“A→B”表示A引用B）。

6.2 导出与导入

工作流支持导出为加密Zip包，用于跨空间/账号迁移，操作步骤：

1. 导出：在资源库/编辑页面点击导出，选择是否包含鉴权信息（如API密钥，谨慎选择）。
2. 导入：在目标空间资源库点击导入，上传Zip包，系统自动预填名称描述。

注意：跨空间导入时，知识库、私有插件等资源需重新关联，否则节点会失效。

6.3 复制与删除

• 复制：在编辑页面点击创建副本，生成独立工作流（支持跨画布复制节点）。
• 删除：在资源库点击删除，若已添加至智能体，将同步移除。

七、使用限制

八、常见问题

1. 工作流运行超时？

   • 检查是否包含耗时节点（如视频生成），建议开启异步运行。
   • 拆分复杂工作流为多个子工作流，分步执行。

2. 节点输出为空？

   • 检查上游节点是否正常运行，输入参数是否缺失。
   • 插件节点需确认API密钥有效性，大模型节点检查提示词是否清晰。

3. 如何批量处理数据？

   • 使用批处理节点，设置并行数量（不超过插件调用频率限制）和次数上限（默认100次）。

通过以上步骤，即可完成工作流的搭建、配置与使用。更多高级功能（如循环节点、数据库操作）可参考扣子官方文档。### 高级配置补充

1. 工作流版本管理

• 创建版本：在工作流编辑页面右上角点击「版本」→「创建版本」，输入版本名称和描述（如"v1.0-初始发布"）
• 版本切换：通过版本列表选择历史版本，支持对比不同版本的节点差异
• 回滚机制：在版本详情页点击「回滚到此版本」，系统会生成新的草稿覆盖当前编辑内容

2. 节点异常处理高级配置

3. 变量聚合节点使用指南

适用场景：当多个并行节点输出需要汇总处理时（如多来源数据整合）

1. 添加「变量聚合节点」并连接上游输出
2. 配置聚合规则：
   • 数组拼接：将多个数组变量合并为一个数组
   • 对象合并：合并多个JSON对象的键值对
   • 数值计算：对数字类型变量进行求和/平均值计算
3. 示例配置：

   {"aggregation_type": "object_merge","variables": ["plugin_output", "llm_result"],"conflict_strategy": "overwrite"  // 键冲突时覆盖旧值
   }
   

常见问题解答

Q: 工作流运行超时如何排查？

A: 可通过以下步骤诊断：

1. 检查「节点执行日志」，定位耗时最长的节点
2. 若为模型节点：尝试降低max_token参数或拆分任务
3. 若为插件节点：检查第三方API响应时间，开启「模拟集」调试

Q: 如何实现工作流的权限管理？

A: 在工作空间设置中配置：

• 私有工作流：仅创建者可见
• 空间内共享：空间成员可查看但不可编辑
• 协作者权限：添加指定成员为协作者赋予编辑权限

注：所有高级配置截图可参考官网「工作流高级功能」章节，实际操作时建议开启「开发者模式」查看详细日志### 补充图片说明及引用

3.1 创建工作流

图1：工作流创建入口示意图，显示"资源库→+资源→工作流"操作路径

4.2 大模型节点

图2：大模型节点技能配置面板，包含模型选择、技能添加和输出格式设置

高级配置补充-异常处理

图3：异常处理参数配置界面，显示超时时间、重试策略和异常分支设置

7. 常见问题

图4：工作流异常类型分析，包含工作项执行失败、超时、资源不可用等场景

图5：资源执行状态流转图，展示从任务指派到完成/失败的全流程

注：图1-3为基于官网流程生成的示意图，图4-5来源于扣子官方技术文档