Appearance
低代码工作流介绍
工作流和对话流用于把模型、插件、知识库、数据库、代码及业务判断编排成可复用流程。发布后的流程可以被智能体、低代码应用、其他工作流、任务中心或获得授权的外部调用方使用。
工作流更关注“一次输入、按步骤处理、返回结果”；对话流更关注“围绕同一会话持续接收消息、保留上下文并多轮响应”。两者使用同一套画布和节点体系，但调试方式、会话能力和适用场景不同。
本栏目导航
入口与资源边界
- 页面入口：资源 > 低代码 > 工作流。
- 页面地址：
/workbench/resource-library?type=workflow。 - 列表范围：工作流页签同时管理普通工作流和对话流，可以按流程类型、创建者和发布状态筛选。
- 资源归属：资源库流程归属于当前工作空间，发布后可以在当前空间中复用。
- 应用内流程：在低代码应用或智能体编辑器中创建的流程可以拥有独立的应用资源作用域，不应默认视为资源库中的同一份资源。
复制、导入或跨空间迁移会创建独立流程。源流程后续更新不会自动同步到副本，副本引用的模型、插件、知识库和数据库也需要在目标空间重新检查。
工作流与对话流的区别
| 对比项 | 普通工作流 | 对话流 |
|---|---|---|
| 核心目标 | 完成一次明确的数据处理或业务任务 | 围绕同一用户会话进行多轮理解和响应 |
| 典型输入 | 表单参数、JSON、文件、任务数据或上游节点输出 | 用户消息、会话信息、应用或智能体上下文 |
| 运行方式 | 一次试运行后得到完整输出，也可以包含异步任务和人工问答节点 | 先关联智能体或应用，再启动并持续进行对话调试 |
| 状态重点 | 节点输入输出、条件分支、重试、超时和最终结果 | 角色、人设、会话历史、消息、用户追问和上下文隔离 |
| 典型场景 | 数据加工、报告生成、批处理、接口编排、自动化任务 | 客服问答、业务咨询、多轮信息收集、持续式助手 |
| 常用专属能力 | 开始/结束、批处理、循环、条件、异步任务、定时任务 | 角色、会话管理、会话历史、消息管理、多轮调试 |
如果流程只需要根据固定输入完成一次任务，优先选择工作流；如果模型必须结合之前的消息继续理解用户，选择对话流。不要仅因为流程中存在大模型节点就创建对话流。
创建流程
点击资源库右上角 资源，可以分别选择 工作流 或 对话流。创建表单包含流程图标、名称和描述。
图 1：创建工作流。工作流和对话流在同一资源页管理，但需要从创建菜单中分别选择类型。
创建字段
| 字段 | 规则与建议 |
|---|---|
| 流程图标 | 可以上传图片替换默认图标。使用稳定、易识别且能区分工作流和对话流的图标 |
| 名称 | 必填，最多 30 个字符；只允许字母、数字和下划线，并且必须以字母开头 |
| 描述 | 必填，最多 600 个字符；说明流程解决的问题、适用输入、主要输出和不应调用的场景 |
流程名称可能被节点引用、接口调用或运行记录使用，创建后应尽量保持稳定。描述不仅面向开发者，也会帮助模型判断何时调用该流程，因此不要只写“测试”“处理数据”等模糊内容。
导入已有流程
资源库顶部的 导入 入口支持：
.zip工作流导出包。.flow流程文件。.json流程定义文件。
导入会创建新的工作流资源并进入编辑器。导入前应确认文件来源可信；导入后应检查节点资源、变量和模型，不要把“导入成功”当作“可以直接运行”。
编辑器结构
流程编辑器由顶部状态与发布区、画布、节点、连线、画布工具栏和节点配置面板组成。
图 2：工作流编辑器。节点之间的连线既表示执行顺序，也表示上游结果可以被下游配置引用。
顶部区域
- 流程名称和图标：点击编辑入口可以修改基本信息。
- 自动保存状态：显示“自动保存中”“自动保存失败”或最近一次自动保存时间。
- 未发布修改：提示当前草稿与已发布版本存在差异。
- 引用关系：查看当前流程被哪些资源或项目使用。
- 历史：查看提交版本和发布版本。
- 协作：启用或管理多人协作。
- 发布：填写版本信息并形成可供调用方使用的稳定版本。
- 更多操作：根据权限提供其他流程级操作。
自动保存只表示草稿已经保存，不等于已经发布。其他智能体、工作流或应用通常仍然使用已发布版本。
画布与节点
- 节点卡片展示节点名称、主要输入、输出和关键配置。
- 从上游节点连接到下游节点，形成流程执行路径。
- 开始节点定义流程入口变量，结束节点定义最终输出和返回方式。
- 点击节点后，在配置面板维护模型、资源、参数、提示词、异常处理等内容。
- 节点上的 测试节点 可以只运行当前节点，适合快速定位问题。
- 未连接节点不会自动参与主流程，应明确判断它是待用草稿还是遗漏连接。
画布工具栏
工具栏提供交互模式、撤销、重做、缩放、适配视图、注释、自动布局、导出图片、小地图、添加节点、调试和试运行等能力。
大型流程建议使用自动布局、注释和小地图保持可读性。不要用大量交叉连线堆叠复杂逻辑；当一组逻辑能够独立复用时，可以拆成子工作流。
节点类型
编辑器中的节点会按能力分类。实际可见节点取决于工作流类型、应用模式、空间权限和已接入资源。
| 分类 | 典型节点 | 主要用途 |
|---|---|---|
| 核心能力 | 大模型、插件、工作流 | 生成内容、调用外部工具、复用已发布子流程 |
| 业务逻辑 | 条件、意图识别、循环、批处理、异步任务、变量聚合 | 控制分支、重复执行、并发和复杂数据处理 |
| 输入与输出 | 开始、结束、输出 | 声明流程契约，并向调用方返回文本或结构化变量 |
| 接口与代码 | HTTP 请求、代码、文本处理 | 调用接口、执行自定义逻辑、转换字符串或 JSON |
| 知识与数据 | 知识库检索、知识写入/删除、长期记忆、变量 | 检索或维护资源库数据并传递状态 |
| 数据库 | 查询、新增、更新、删除、SQL 自定义 | 对资源库数据库执行结构化读写 |
| 触发器 | 设置、查询、删除定时触发器 | 创建和管理定时执行任务；具体可用性以流程上下文为准 |
| 图像与音视频 | 图像生成、视频生成、画板、图像参考 | 生成或加工多媒体内容 |
| 会话与消息 | 创建/修改/删除会话、查询会话历史、创建/修改/删除消息 | 为对话流维护会话和消息状态 |
| 交互组件 | 问答等 | 暂停流程等待用户输入，再继续执行后续节点 |
大模型节点
大模型节点通常需要配置模型、系统提示词、用户提示词、输入变量、输出格式、会话历史和异常处理。提示词可以使用 {{变量名}}、{{变量名.子字段}} 或数组下标引用变量。
输出需要供数据库、卡片或下游代码稳定消费时，优先使用结构化输出，并明确字段类型。开启流式输出时要注意：已经开始向用户输出后，部分异常不能再通过重试或异常分支无感处理。
插件与子工作流节点
- 插件节点只能选择当前空间有权使用的插件和工具。
- 参数应映射到上游变量，不要在多个节点重复硬编码同一业务值。
- 子工作流节点优先选择已发布版本，并检查输入输出契约。
- 子流程变更后，父流程不会自动理解新增或删除字段，应重新打开节点检查映射。
HTTP、代码和数据库节点
- HTTP 节点需要配置方法、URL、Header、Query、Body 和输出字段，并处理超时、鉴权失败和非成功状态码。
- 代码节点应只承担清晰、可测试的转换或计算逻辑，避免把整条业务流程隐藏在一段代码中。
- 数据库节点要区分测试数据和线上数据，并遵守用户及渠道隔离规则。
- SQL 自定义节点应限定可操作范围，避免将未校验的用户输入直接拼接进 SQL。
变量与数据流
变量是连接节点的核心契约。上游输出只有在类型和路径正确时，才能被下游稳定引用。
开始节点
开始节点声明调用方必须提供的输入。为每个变量设置：
- 语义清晰的变量名。
- 字符串、数字、布尔、对象、数组等正确类型。
- 是否必填、默认值和字段说明。
- 对象和数组中的子字段结构。
新增必填输入会影响所有调用方。已经发布的流程需要兼容升级时，优先新增可选字段并设置合理默认值。
节点输出与变量引用
- 下游节点只引用实际存在的上游输出。
- 变量类型必须与目标配置要求一致。
- 条件分支中的变量要考虑并非每条路径都会产生值。
- 循环和批处理中的临时变量有各自作用域，不应误当作全局输出。
- 节点被删除或输出字段改名后，要检查所有引用位置。
结束节点
结束节点决定流程最终返回内容。普通工作流通常返回变量或结构化对象；面向智能体回复的流程也可以组合文本内容。只返回调用方真正需要的数据，避免把完整上游响应、内部日志或敏感字段直接暴露出去。
单节点测试与全流程试运行
单节点测试用于验证当前节点配置；全流程试运行从开始节点执行到结束节点，更适合验证变量传递、分支选择和最终输出。
普通工作流试运行
点击底部 试运行，右侧打开参数面板。可以按开始节点字段填写，也可以切换 JSON 模式输入结构化数据。
图 3：普通工作流试运行。输入项来自开始节点，执行后可以查看节点状态、最终结果和日志。
建议按以下顺序验证：
- 使用最小合法输入运行一次成功路径。
- 检查实际经过的节点和条件分支。
- 查看各节点输入、输出、耗时、Token 和错误信息。
- 核对结束节点输出是否符合流程契约。
- 再测试空值、非法枚举、超长文本、上游超时和权限不足。
- 含问答节点时，按页面提示回复问题并继续运行。
点击 查看日志 可以进一步定位节点失败。修复应基于实际失败节点、输入和调用链，不要用无证据重试或吞掉异常掩盖问题。
对话流调试
对话流试运行需要先选择关联的智能体或低代码应用，因为对话流依赖调用方提供的角色、会话和应用上下文。填写首轮输入后，点击 保存并开始对话调试，再在调试会话中持续发送消息。
图 4：对话流调试。未关联智能体或应用时，问题面板会阻止启动，并显示需要处理的校验项。
对话流调试重点检查：
- 角色人设和回复逻辑是否符合关联智能体或应用。
- 首轮消息、后续追问和省略表达能否被正确理解。
- 大模型是否读取了正确范围的会话历史。
- 创建、查询、修改和清空会话或消息的节点是否作用于当前用户。
- 多个用户、多个渠道和多个会话之间是否正确隔离。
- 问答节点、工具调用和最终回复是否能在多轮过程中继续推进。
- 每次重新打开调试是否按新会话处理，避免把上一轮输入错误地重复发送。
校验与问题面板
编辑器会检查节点配置和变量引用，并在问题面板中展示待处理项。常见问题包括：
- 必填字段为空。
- 引用变量不存在或类型不匹配。
- 节点未连接或执行路径不完整。
- 未选择模型、插件工具、知识库或数据库。
- 对话流未关联智能体或应用。
- 输出变量重名或名称格式不正确。
- URL、JSON、提示词或表达式中包含无效变量。
发布前应逐项处理问题。确实属于暂存节点时，也要确认它不会进入执行路径或误导后续维护者。
自动保存、提交与发布
自动保存
流程编辑会自动保存草稿。顶部显示“已自动保存”仅表示当前草稿安全写入，不会自动更新线上已发布版本。
发布
发布时需要填写版本号和版本说明。系统在发布前未检测到成功试运行时会提示风险，可以返回试运行，也可以坚持发布。正式流程不建议跳过试运行。
发布前确认：
- 问题面板没有未处理错误。
- 成功路径和关键异常路径均已试运行。
- 开始/结束节点契约稳定。
- 插件、模型、知识库、数据库和子流程在当前空间可用。
- 定时触发器等依赖发布版本的能力已经完成配置。
- 版本说明写清节点、参数、模型和资源依赖的变化。
修改已经发布的流程后，页面会显示“有尚未发布的修改”。调用方仍可能运行旧版本，因此上线前要明确本次修改何时发布以及是否兼容旧输入。
历史版本
历史入口可以按全部、提交和发布筛选记录。版本操作包括：
- 查看版本。
- 将历史版本加载到草稿。
- 导出已经发布的历史版本。
把历史版本加载到草稿后仍应重新试运行并发布；不要把历史回退当作立即覆盖线上版本。
多人协作
流程可以开启多人协作。启用后：
- 每位协作者拥有独立草稿。
- 协作者可以提交版本到工作空间。
- 多人同时修改时，可以拉取其他人提交的版本并合入自己的草稿。
- 发布前需要先形成可发布的提交版本。
- 资源列表会显示“已开启多人协作”。
协作负责人可以邀请和管理协作者。关闭协作模式会删除协作者草稿，未提交修改将丢失；存在协作者时需要先处理成员和草稿状态。没有编辑权限的成员进入编辑器时会看到只读预览，不能新增节点或修改配置。
流程级操作
资源列表为工作流和对话流提供以下操作，具体可用性受资源归属、发布状态和权限影响：
- 编辑：进入画布继续维护。
- 切换为对话流 / 工作流：转换流程类型。
- 复制：在当前空间创建独立副本。
- 复制到其他空间：发布后复制到用户有权限的目标空间。
- 导出：下载流程导出包用于备份或迁移。
- 删除：仅创建者或有相应管理权限的成员可以执行。
类型切换
类型切换不会自动把普通流程改造成高质量对话流程，也不会自动清理会话节点。切换前应检查：
- 开始节点输入和结束节点返回是否仍适合新类型。
- 角色、会话历史和消息节点是否齐全或是否应移除。
- 调试方式和调用方是否已经调整。
- 已发布调用方是否仍依赖旧流程类型。
类型切换后必须重新执行完整调试并发布新版本。
复制与跨空间迁移
复制主要迁移流程定义。目标空间还需要检查：
- 模型是否存在且有调用权限。
- 插件和工具是否已经发布并完成授权。
- 知识库、数据库、记忆库、卡片和子工作流是否可用。
- OAuth、Token、私网连接和用户授权是否需要重配。
- 测试数据、线上数据和会话数据是否符合目标空间隔离规则。
删除
删除前应先查看引用关系并确认智能体、应用、子流程、定时任务和批量任务已经迁移。页面没有明确恢复入口时，应把删除视为不可直接撤销的操作。
运行方式与任务中心
流程可以由不同入口触发：
- 智能体根据用户意图调用已发布工作流。
- 低代码应用在页面交互或业务事件中执行流程。
- 其他工作流通过子工作流节点复用。
- 定时触发器按配置时间执行已发布流程。
- 批量或长耗时任务进入任务中心查看进度和结果。
- 外部系统通过获得授权的 API 调用流程。
调用方应始终传入与发布契约匹配的参数。任务中心负责运行任务，不负责维护工作流定义；需要修改节点时仍应返回资源库编辑器。
权限与安全
- 只引用当前工作空间有权使用的模型和资源。
- HTTP、插件和代码节点中不得硬编码密钥或真实用户凭据。
- 日志、试运行输入和节点输出可能包含敏感数据，测试时使用脱敏样本。
- 数据库、记忆库和会话节点必须按最终用户、渠道和空间正确隔离。
- 高风险操作应增加人工问答、审批或明确确认节点，未经确认不得直接执行。
- 修改被广泛引用的流程前先查看引用关系，并为调用方预留迁移时间。
- 外部服务失败要设置清晰的超时、重试上限和可见错误，避免无限重试。
- 只读成员不得通过复制敏感输入或日志绕过空间权限。
推荐搭建流程
- 明确流程类型：一次任务选工作流，多轮上下文选对话流。
- 先设计输入输出：在开始和结束节点确定稳定契约。
- 完成最小主路径：先连接最少节点跑通成功流程。
- 逐个配置节点：为模型、插件、知识和数据节点设置清晰输入输出。
- 补充分支与异常：处理空值、服务失败、超时、用户拒绝和需要人工确认的情况。
- 执行单节点测试：先定位每个外部依赖是否工作。
- 执行全流程试运行：覆盖成功、异常和边界输入；对话流还要测试多轮追问。
- 检查问题与引用：清理无效变量、孤立节点和缺失资源。
- 填写版本并发布：说明契约和依赖变化。
- 在真实调用方验证：从智能体、应用、子流程或任务中心完成一次端到端调用。
常见问题
为什么已经自动保存，调用方仍然看不到修改？
自动保存保存的是草稿，调用方通常使用已发布版本。确认顶部是否显示“有尚未发布的修改”，重新试运行并发布新版本。
为什么试运行输入项和预期不一致？
试运行参数来自开始节点。检查开始节点变量名称、类型、必填和嵌套结构，并确认当前打开的是正确草稿或历史版本。
为什么节点有输出，下游仍提示变量不存在？
检查引用路径、字段名称和类型，还要确认上游节点确实位于当前执行路径。如果变量只在某个条件分支或循环作用域中产生，其他路径可能无法引用。
为什么对话流不能开始调试？
对话流必须先关联智能体或低代码应用，并填写必填输入。查看问题面板，处理关联内容、角色、节点配置和变量错误后，再点击“保存并开始对话调试”。
为什么打开流程只能查看不能编辑？
当前账号可能不是流程创建者，也没有协作或编辑权限。只读模式下可以查看节点和引用关系，但不能修改画布。需要资源负责人邀请为协作者或调整空间权限。
为什么复制到其他空间后运行失败？
流程定义虽然已复制，但模型、插件、知识库、数据库、卡片、子工作流和鉴权不一定同时迁移。进入目标空间逐项重新选择资源并完成最小试运行。
可以直接把工作流切换成对话流吗？
系统提供类型切换，但切换只是改变流程形态，不会自动补齐角色、会话和多轮调试设计。切换后需要重新检查所有节点、调用方和发布契约。