AI 工作流输入输出契约

一句话：为每个自动化步骤定义接收什么、返回什么、错误时怎么表达。

它是什么

输入输出契约是工作流中各步骤之间的明确约定，包括字段名、类型、必填项、允许值、长度和错误结构。没有契约时，一个节点把日期输出为文字，下一节点却期待时间戳，流程就会随机失败。AI 节点尤其需要固定结构，因为自然语言结果存在变化。契约应同时包含正常输出与失败输出。

适合干什么

• 适合 n8n、Zapier、API、Agents、批量内容和多个模型串联的自动化。

不适合干什么

• 不适合只用示例数据代替完整规则，也不适合节点发生错误时返回看似正常的空内容。

普通人怎么用

选择一个两步流程，为第一步的每个输出字段写明名称、类型和示例。

进阶用户怎么用

进阶用户可使用 JSON Schema 和自动测试，在部署前生成边界输入并验证所有节点。

常见误区

• 常见误区是模型已经被要求输出 JSON，所以不需要校验。JSON 合法不代表字段完整或含义正确。

和相似工具的区别

• 提示词定义模型任务，契约定义系统边界。
• 数据模型描述业务对象，节点契约描述一次调用。
• 类型校验发现结构错误，业务校验发现内容不合理。

入门步骤

• 对一个现有工作流故意删除字段或传入错误类型，检查是否能产生明确错误。