Clouisle云屿

工作流

按创建、编排、调试、发布的顺序搭建一条可执行、可排查、可上线的工作流。

功能概述

工作流用于处理“必须按步骤执行”的任务。
相比 Agent 更偏对话入口,工作流更适合结构化输入、多节点处理、条件分支和系统联动。

适用场景

工作流常用于:

  • Webhook 触发的自动化流程
  • 需要多步判断和处理的业务任务
  • 需要串联模型、知识库和工具的复杂链路
  • 定时执行或批处理任务

前置条件

开始前建议准备:

  • 明确的输入和输出定义
  • 至少一组测试数据
  • 需要用到的模型、知识库或工具
  • 一条尽量简单的主干流程草图

操作步骤

第 1 步:在应用列表中确认工作流入口

先进入 应用 页面,切换到 工作流 或在全部列表中查看现有工作流。
这一步主要是确认:

  • 当前是否已有可复用流程
  • 命名、状态和用途是否已有统一规范
  • 新流程应该归属在哪类业务下

第 2 步:点击“创建应用”,选择工作流类型

点击 创建应用 后,在弹窗中切换为 工作流
再填写名称和描述,先建立这条流程的业务身份。

创建工作流弹窗

第一次命名建议直接体现输入和输出关系,例如“表单问答汇总流程”“线索分配流程”,避免后续维护时看不懂用途。

第 3 步:进入编辑器,先搭最短成功路径

进入工作流编辑器后,不要一开始就把所有节点铺满。
建议先只搭一条最小链路,例如:

  • 开始节点
  • 一个核心处理节点
  • 结束节点

工作流编辑器

这样做的目的是先验证“流程能跑通”,而不是一上来就追求完整。

第 4 步:再补变量、知识、工具和条件分支

当主干能运行后,再按顺序补充:

  • 全局变量
  • 知识检索节点
  • 工具调用节点
  • 条件判断或循环节点

建议每增加一类节点就做一次调试,这样后面失败时更容易定位是哪一步引入的问题。

第 5 步:使用调试模式查看节点输入输出

调试时应重点看:

  • 哪个节点先执行
  • 每个节点收到什么输入
  • 每个节点输出了什么结果
  • 哪一步开始和预期不一致

如果你只看最终结果,而不看节点级执行记录,流程一旦变复杂就很难排查。

第 6 步:确认输出格式和分支逻辑后再发布

只有在下面几项都确认后,再考虑发布:

  • 输入样例能稳定跑通
  • 条件分支走向正确
  • 工具和知识节点返回可用结果
  • 输出结果结构满足业务需要

结果验证

一个可上线的工作流,至少应满足:

  • 可以从创建弹窗进入编辑器
  • 最短主干流程能稳定执行
  • 调试时能看清每个节点的输入输出
  • 发布前已覆盖正常路径和关键异常路径

常见问题

为什么工作流看起来很完整,但就是经常失败

通常是因为一开始节点加得太多,没有先验证主干。
建议回退到最短路径,确认基础链路稳定后再逐步加复杂节点。

为什么最终输出不对,但看不出问题在哪

优先去看节点级执行记录,而不是只看最终结果。
大多数问题都出在某个节点的输入、变量映射或工具返回结构上。

为什么第一次建议优先手动触发

因为手动触发最容易调试。
如果一开始就接 Webhook 或定时任务,出了问题会同时叠加网络、鉴权和外部系统变量。

注意事项

  • 第一次先搭主干,不要一开始就铺满所有节点
  • 每增加一类节点就调试一次
  • 正式接外部系统前,先在调试模式把样例跑透

目录