工作流
工作流是蓝域（LanSphere）提供的单轮自动化应用：接收一次输入后，按你编排好的节点流程自动执行，直达输出结果，全程无需人工交互。
本篇介绍工作流的适用场景、画布操作、三类触发器、连线与变量引用、环境变量、调试方法，以及保存与发布，适合需要搭建自动化流程的开发人员阅读。各节点的详细配置方法请参阅《节点参考》。
适用场景
工作流适合「一次输入、一次输出」的自动化作业，典型场景包括：
- 数据处理：对输入的文本、文件或结构化数据进行解析、提取、汇总与格式化。
- 定时任务：按设定的周期规则自动运行，例如定时采集数据、定时生成报表。
- 批量作业：对批量数据逐条执行相同的处理逻辑，例如批量审核、批量改写。
- 接口编排：串联多个系统接口与内部工具，把跨系统的多步操作整合为一次调用。
创建工作流
- 点击左侧菜单顶部的「新建项目」。
- 在弹窗中选择应用类型「工作流」。
- 填写应用名称（必填，1-30 字符，仅支持汉字、大小写字母、数字、中划线）；应用描述选填，最大 300 字符；头像支持自定义上传。
- 确认后进入「应用开发」页，即可在画布上编排流程。
提示：除空白创建外，你也可以从模板商店创建，或导入 DSL 文件创建。旧版智能体 DSL 会被拒绝导入，请前往智能体模块创建。
画布操作
工作流在可视化画布上编排，基本操作如下：
- 添加节点：在节点列表中点击目标节点即可添加到画布，节点仅支持点击添加，不支持拖拽。
- 查找节点：节点列表可展开、收缩，并支持按名称模糊搜索，节点较多时可快速定位。
- 「输入」节点全局唯一：一个工作流只允许存在一个「输入」节点；画布中已存在时，节点列表会自动隐藏该节点。
- 画布缩放：使用画布底部的「放大」「缩小」按钮调整视图比例。
- 撤销与恢复：画布底部提供「撤销」「恢复」，支持节点增删与节点内编辑内容的回退。
- 变更历史：画布底部的「变更历史」可查看画布的修改记录。
开始节点：三类触发器
每个工作流从触发器开始运行，开始类节点共三种：
| 触发器 | 触发方式与用途 |
|---|---|
| 输入 | 手动触发。运行时由使用者填写输入参数，是最常用的开始方式，适合表单式的单轮作业 |
| 定时执行 | 按设定的周期规则自动触发工作流运行，适合定时采集、定时汇总等无人值守任务 |
| Webhook 回调 | 生成回调地址，外部系统调用该地址即触发工作流，适合与其他系统的事件联动 |
连线与节点配置
节点之间通过连线传递数据：前一节点运行产生的输出，可在后一节点的配置中被引用为输入变量，从而把多个节点串联成完整流程。例如「HTTP 请求」节点获取的报文，可作为「大模型」节点的输入进行汇总，再由「输出」节点返回结果。
点击画布中的节点即可打开该节点的配置面板，按面板提示完成参数设置与变量引用。各节点「是什么、配什么、输出什么」的完整说明，请参阅《节点参考》。
提示：连线与变量引用是工作流编排的核心。建议先理清每个节点的输入来自哪里、输出交给谁，再开始连线。
工具类节点
除内置功能节点外，节点列表还提供四类工具类节点，用于调用平台内外的能力：
- 系统插件：调用已安装并启用的系统插件能力。
- 工作流：调用已发布为组件的工作流（来自「协作组件 → 工作流」），实现流程复用。
- MCP：调用已在「MCP 服务」中添加的服务所提供的工具。
- 自定义工具：调用在「插件管理」中创建的自定义工具。
点击其中任一类后，会弹出对应的工具列表弹窗，从列表中选择要调用的工具即完成节点添加。
环境变量
环境变量是应用级的动态参数，用于统一存放服务地址、密钥等随环境变化的值，流程中的节点可统一引用，避免在多个节点中重复填写。
环境变量支持设置为「保密变量」：设置后变量值以星号隐藏，适合存放密钥等敏感信息。
提示：不同部署环境（如测试与正式）的服务地址、密钥往往不同，建议一律通过环境变量传入，避免把具体值写死在节点配置中。
变量检查
「变量检查」用于在运行前检测流程中的变量定义、类型匹配与引用有效性，帮助你尽早发现「引用了不存在的变量」「变量类型不匹配」等配置问题。建议每次较大改动后执行一次变量检查。
调试
工作流支持两个粒度的调试：
- 单节点调试：只运行选中的单个节点，用于验证该节点的配置是否正确，适合逐个排查问题。
- 整体调试：从开始节点完整运行整个流程，验证端到端的执行效果。
推荐的调试顺序是：先对关键节点做单节点调试，确认输入输出符合预期，再执行整体调试。运行后，每个节点都可查看本次的输入、输出与报错信息，便于定位失败环节；「调试历史」中可查看过往的运行记录，用于对比不同版本的执行结果。
检查清单
发布前，系统会自动执行「检查清单」，对流程的配置完整性与逻辑正确性进行检查。请按检查结果的提示逐项修正，全部通过后再发布。
保存与发布
画布右上方「保存」按钮的悬浮下拉固定为三项：
| 操作 | 说明 |
|---|---|
| 保存 | 保存为草稿，仅本人可见；草稿不可发布到应用广场 |
| 发布到应用广场 | 保存最新内容后上架应用广场，平台内全员（含阅览成员）可见可用 |
| 发布为组件 | 仅工作流类型可见。保存后配置组件信息，成为工作流组件，自动同步到「协作组件 → 工作流」，供其他应用调用 |
注意：「发布为组件」与「发布到应用广场」互斥，且通过「发布为组件」入口发布的组件不上架应用广场。
除应用广场外，工作流还可通过「发布渠道」页签开通网页链接、API 访问等渠道。工作流不支持发布到蓝信AI助理，如需面向蓝信终端用户的对话式应用，请使用对话流或智能体。各渠道的完整说明请参阅《发布渠道》。
应用状态说明
工作流从创建到上线会经历以下状态：创建（未保存）→ 保存（草稿，仅本人可见）→ 发布（应用广场/组件，各渠道独立）→ WebApp 线上应用（开通网页链接后，与发布渠道可共存）。发布渠道页签的「版本管理」会记录每次已发布的版本说明、发布人与时间，支持回溯查看。
相关阅读
- 《节点参考》：全部节点的功能、关键配置与输出说明。
- 《对话流》：需要多轮交互与上下文记忆时的应用类型。
- 《发布渠道》：网页链接、API 访问、应用广场、发布为组件的完整流程。
- 《协作组件》：片段、工作流组件、智能体组件的复用与调用。