Appearance
工作流节点与变量
工作流稳定性的核心是节点契约和变量映射。画布连线表示执行关系，上游输出能否被下游使用，仍取决于字段路径、数据类型、作用域和实际执行分支。
认识节点库
点击画布底部 添加节点 打开节点库，可以搜索节点，也可以按能力分类选择。
图 1：当前节点库。面板可继续向下滚动；实际节点取决于流程类型、产品版本、空间权限和已接入资源。
当前节点分类
| 分类 | 当前可添加节点 | 主要用途 |
|---|---|---|
| 基础节点 | 插件、大模型、工作流 | 调用工具、生成内容、复用已有流程 |
| 业务逻辑节点 | 代码、选择器、意图识别、异步任务、循环、批处理、变量聚合 | 控制分支、转换数据以及重复或异步执行 |
| 输入和输出节点 | 输入、输出 | 在流程中接收参数或输出中间消息 |
| 数据库节点 | 查询、新增、更新、删除、SQL 自定义 | 对资源库中的数据库执行结构化读写 |
| 知识和数据节点 | 知识库检索/写入/删除、变量赋值、长期记忆检索/写入 | 使用知识、变量和长期记忆 |
| 图像处理节点 | 图像生成、更多图像插件 | 生成图片或选择已发布的图像插件工具 |
| 音视频处理节点 | 视频生成、更多音视频插件 | 生成视频或选择已发布的音视频插件工具 |
| 组件节点 | HTTP 请求、文本处理、JSON 序列化/反序列化、问答 | 调用接口、转换数据或等待用户回答 |
| 触发器节点 | 设置、查询、删除定时触发器 | 在应用模式或对话流中管理定时任务 |
| 会话管理节点 | 创建、修改、删除和查询会话 | 管理静态或动态会话 |
| 会话历史节点 | 查询、清空会话历史 | 管理大模型可见的上下文消息 |
| 消息节点 | 创建、修改、查询和删除消息 | 管理指定会话中的消息记录 |
节点面板会根据编辑位置和流程类型动态变化：设置变量、终止循环、继续循环只在循环体内部显示；触发器只在应用模式或对话流中显示。开始、结束是画布的边界节点，注释从画布工具栏添加，因此不会出现在“添加节点”面板中。
旧文档中的“图像处理插件节点”不再作为独立分类。当前系统把 更多图像插件 放在“图像处理”，把 更多音视频插件 放在“音视频处理”；选择工具后仍会创建插件节点。
先配置开始与结束节点
开始节点定义调用方必须提供什么，结束节点定义流程稳定返回什么。它们共同组成流程对外契约。
图 2：开始节点输入配置。变量类型菜单中的对象、数组和文件还可以继续选择子类型。
开始节点输入
每个输入至少需要确认：
- 变量名：使用稳定、语义清晰的英文名称；避免含义不明的
input1、data2。 - 变量类型：必须与调用方发送的数据一致。
- 是否必填：只有所有调用方都能稳定提供时才设为必填。
- 字段说明：对象、数组和文件应补充结构、格式、大小或数量限制。
当前可配置类型包括：
- 基础类型：
String、Integer、Number、Boolean、Time、Object。 - 文件与媒体：
File、Image、Svg、Audio、Video、Voice、Doc、PPT、Excel、Txt、Code、Zip。 - 集合类型：
List，以及Array<String>、Array<Integer>、Array<Number>、Array<Boolean>、Array<Time>、各类文件数组和Array<Object>。
新增必填字段会影响已经接入的智能体、应用、子流程和 API。需要兼容旧调用方时，优先新增可选字段，并在流程内部明确默认逻辑。
结束节点输出
结束节点只暴露调用方真正需要的稳定字段：
- 字段名和类型应长期稳定，并与对外说明一致。
- 不要直接返回完整上游响应、内部日志、鉴权信息或敏感字段。
- 条件分支必须最终汇聚到一致的返回结构，或明确约定不同结果类型。
- 返回文本供智能体直接回复时，也应区分展示内容与结构化业务结果。
配置业务节点
大模型节点
配置模型、系统提示词、用户提示词、上下文、输出格式和异常处理。下游需要稳定读取字段时，优先使用结构化输出，并给每个字段指定类型和含义。
插件与子工作流节点
- 只能选择当前空间有权使用且状态可用的插件、工具或子流程。
- 参数映射到上游变量，不要在多个节点重复硬编码同一业务值。
- 子工作流优先引用已发布版本；子流程契约变化后，父流程必须重新检查映射。
- 插件涉及 OAuth 或用户身份时，要区分空间授权与最终用户授权。
HTTP 与代码节点
- HTTP 节点检查方法、URL、Header、Query、Body、超时、状态码和响应映射。
- 密钥或令牌通过受控配置注入，不得写在 URL、提示词或代码中。
- 代码节点只处理边界清晰、可测试的计算或转换，避免把整条业务隐藏在单个脚本中。
- 对外部响应使用前先校验空值、类型和必需字段。
数据库、知识库与记忆节点
- 数据库节点区分测试数据和线上数据，并校验表、字段、条件和用户隔离规则。
- 自定义 SQL 不拼接未经校验的用户输入；写入、更新和删除节点应设置精确条件。
- 知识库检索检查检索词、召回数量、过滤条件和返回片段是否适合模型消费。
- 长期记忆检索与写入需要明确用户、渠道、会话或业务主体，避免跨用户串数据。
变量来源与作用域
变量可能来自开始节点、上游节点输出、循环项、批处理项、会话、系统上下文或人工问答结果。引用前逐项确认：
- 来源节点在当前节点之前执行，并且位于同一条可达路径。
- 字段路径真实存在，对象层级和数组下标正确。
- 来源类型与目标配置要求一致。
- 条件分支没有执行时，变量缺失或为空的处理方式明确。
- 循环项、批处理项和临时变量没有被误当成全局变量。
- 节点删除、复制或输出字段改名后，所有引用位置都已更新。
分支、循环与批处理
- 选择器/条件分支：为无法命中业务条件的输入提供兜底分支。
- 循环：明确循环对象、当前项、退出条件和最大处理范围，避免无法结束。
- 批处理：控制单批数量和并发度，处理部分成功、重试与结果聚合。
- 异步任务：明确触发成功与任务完成的区别，并提供任务状态或结果查询方式。
- 变量聚合：统一分支返回结构，避免下游分别兼容多套字段。
推荐搭建顺序
- 定义开始节点和结束节点契约。
- 连接最短成功路径并执行一次全流程试运行。
- 逐个增加模型、插件、HTTP、数据库等外部依赖节点。
- 每增加一个外部依赖就执行单节点测试。
- 增加条件、循环、批处理和异常路径。
- 使用自动布局、注释和子工作流控制画布复杂度。
- 最后复核未连接节点、无效变量和敏感配置。