AI 工作流教程：7 步搭出能跑通的流程，含参数表与报错排查

搭一条 AI 工作流，从注册平台到第一条任务自动跑起来，按 7 个步骤走，初次上手大约 2 小时。做完的成果是一条能定时触发、有运行日志、失败会自动重试的流程，接到每天重复的那几件事上，每周能省 3 到 5 小时。

一、先准备 4 样东西

4 样东西缺 1 样都会卡在中间。平台账号和模型接口决定流程能不能跑，输入样本和输出落点决定跑出来的东西有没有用。

1. 平台账号：国内常用扣子、Dify、阿里云百炼、腾讯云智能体开发平台，注册后进「工作流」或「应用编排」页面，个人版多数带免费额度，跑通 50 到 200 次够用
2. 模型接口：在平台的模型配置里粘贴 API Key，国产厂商 1 个 Key 多数能通用于该厂商全部模型，额度和并发上限写在控制台的用量页
3. 输入样本：准备 10 条真实数据，比如 10 条客户咨询、10 段产品描述。空数据跑不出问题，也验不出效果
4. 输出落点：先定结果存哪，可选在线表格、数据库、企业微信机器人、邮件，主流平台内置 5 到 8 种输出节点

二、操作步骤：7 步跑通第一条任务

步骤按顺序做，中途别跳。前 3 步定框架，中间 3 步填内容，最后 1 步管运行。

第 1 到 3 步：建空间、连模型、定输入

这 3 步在同一个页面里完成，全程约 20 分钟。

1. 建空间：登录后点左侧「工作空间」，新建 1 个，命名带上用途，例如「咨询分类-测试」。后面所有节点都挂在这个空间下，换空间不用重建流程
2. 连模型：进「模型设置」，粘贴 API Key 后点「测试连接」，返回 200 才算通。再把默认模型选成你要用的那 1 个，分类类任务把温度调到 0.2 到 0.3
3. 定输入：在画布起点拖 1 个「开始」节点，添加 2 个变量，1 个文本型放正文、1 个枚举型放来源渠道。变量名用英文，中文只能填在描述栏

第 4 到 6 步：拆节点、设条件、挂触发

这一段决定流程能不能处理异常。我习惯把一整段任务拆成 4 个节点：清洗、判断、生成、写回。节点数超过 7 个就开始难维护，改 1 个字段要顺着连线找好几处。

1. 拆节点：拖 1 个「大模型」节点，系统提示词写清角色、输出格式、禁止项。输出格式用 JSON，字段固定 3 到 5 个，字段越多越容易跑偏
2. 设条件：拖 1 个「条件分支」节点，按上一步返回的字段分流。比如置信度低于 0.6 走人工复核，高于 0.6 直接写回结果表
3. 挂触发：在流程设置里选触发方式。定时触发按 cron 写，每 30 分钟 1 次；Webhook 触发会给出 1 个地址，外部系统 POST 过来就启动

第 7 步：开日志、设重试

日志和重试都在「运行设置」里，2 个开关默认关闭，需要手工打开。日志保留天数各平台不同，多在 7 到 30 天之间，重要流程建议自己再存 1 份到数据库。重试次数填 2 次，间隔填 10 秒，多数接口抖动在 1 次重试内能恢复。

三、参数怎么填

下面 6 个字段是报错最集中的位置，填之前对照一眼。

四、报错怎么排查

报错集中在 5 类，按下面的顺序看运行日志，多数能在 10 分钟内定位。

1. 401 或鉴权失败：Key 过期或已被删除，回控制台重新生成，粘贴时注意别带首尾空格
2. 429 限流：并发数或每分钟请求数超了，把并发降到 2，或在节点之间加 1 个 3 秒延时
3. JSON 解析失败：模型输出夹带了说明文字，提示词里加一句「只输出 JSON，不要解释」，或在后面加 1 个提取节点
4. 变量取空：上游节点改过名，下游绑定没同步，重新点 1 次变量绑定即可
5. 任务不触发：定时表达式默认走 UTC，想按北京时间 9 点跑要写 1 点，或把时区改成东八区

日志里看哪 3 个值

输入、输出、耗时。跑 10 条样本，把每条耗时和消耗的 token 数记在表里，乘 30 天就是月度用量，能在额度用完之前发现。我给一家做外贸的客户算过，1 条咨询分类消耗 800 到 1200 token，每天 300 条，月度在 1000 万 token 上下，比按次付费的报价单便宜约 4 成。

五、怎么验证成功

3 个动作，做完这条流程就算可用。

1. 跑满 10 条样本，成功 8 条以上算通过，低于 8 条回第 4 步改提示词
2. 手工造 1 条异常数据，比如空正文、超长文本，看流程是否按失败策略处理，不报红即合格
3. 等 1 个定时周期，看日志里有没有自动生成的记录，时间戳对得上才算触发器生效

六、我踩过的 3 个坑

第 1 个坑是提示词里没限制输出字段。上个月做咨询分类，模型返回的 JSON 偶尔多出 1 个「备注」字段，写表格时列错位，140 条数据全部重跑。后来把字段名写进提示词，再在节点后加 1 个校验，这类错没再出现。

第 2 个坑是拿生产数据直接测。测试阶段用了 200 条真实客户咨询，日志里留了手机号，事后清理花了半天。现在测试统一用打码样本，手机号中间 4 位换成星号，姓名只留姓。

第 3 个坑是节点堆太多。一条流程拖了 12 个节点，改 1 个字段要顺着连线找 6 处，最后拆成 2 条短流程，各 5 个节点，维护时间从每次 40 分钟降到 10 分钟。

什么情况下先别上工作流

每天只跑 1 到 2 次、判断标准又讲不清的任务，先手工做 2 周，把规则写下来再上流程。规则没定清就上，改流程的时间比手工做还长。反过来，每天超过 50 条、规则能写成 3 句话的，第 1 天就能省下时间。

七、3 个提高一次跑通率的写法

同一条流程，提示词写法不同，首次成功率差得远。我在 4 个平台上做过同样的分类任务对照，下面 3 条把 10 条样本的通过数从 5 条拉到 8 条以上。

1. 把输出格式写成模板：给出 1 个完整的 JSON 样例，字段名、字段类型、取值范围都写进去，比只用文字描述稳定得多
2. 把禁止项写成短句：每行 1 条，最多 5 条，例如「不要输出解释」「不要编造未提供的信息」，超过 5 条模型会漏掉后面几条
3. 把判断标准量化：写「置信度低于 0.6 时输出 unknown」，比写「不确定时不要猜」有效，量化之后分支节点才接得住

提示词长度控制在哪个区间

系统提示词 300 到 800 字，用户提示词 200 字以内。超过 1500 字以后，模型对后半段的遵守程度下降，同一条约束放在末尾比放在开头，实测命中率低约 20 个百分点。要放的内容多，就拆成 2 个节点，前 1 个节点做提取，后 1 个节点做判断。

跑通之后怎么扩量

先在 1 条流程上跑满 1 周，把日均条数、失败率、单条 token 消耗记进 1 张表。日均 50 条以内，单机定时触发就够；到 200 条以上，把并发提到账号上限，并把写回节点换成批量写入，1 次写 50 条，能把整体耗时压掉 6 成。扩量之前先跟平台确认额度上限，个人版改成企业版一般要 3 到 5 个工作日。

本文信息核对时间：2026-11，各平台界面与免费额度调整较快，搭建前请核对平台最新文档。