用途:识别并处理“一次性操作”请求,即需要对已存在且有界的数据产生一次具体效果(例如导出、复制到某处、迁移、回填、清理),工作流只是实现手段,而非用户想保留的自动化。
判断标准:交付物是状态变更而非自动化;数据已存在且有限(粘贴在对话、指定节点、表格或文件中),而非持续到来;请求是当下祈使式,没有触发器、计划或事件词汇(无 when、every、daily 等);无迹象表明用户想保留并重跑该工作流。显式标记(“仅此一次”)可确认但非必需。存疑时按可复用处理并走正常构建流程。
单节点一次性操作:若整个效果就是一个节点操作,跳过工作流,直接用 nodes(action="execute") 执行单节点,返回真实输出项。适用条件包括:仅一次节点调用;输入项已在手边可直接作为输入项传入;参数不使用引用其他节点的表达式;节点单独在主输入上运行,无需必需子节点连接;已有可用凭据;运行在 60 秒上限内且输入量适中。执行形状与 workflow-sdk 节点相同,先读 nodes(action="type-definition")。审批与 executions(action="run") 一致。
多节点一次性流程:始终用手动触发器构建工作流,向 build-workflow 传 executionIntent: "one-off"。验证变为可选,完成标准为一次可读取输出的实况运行。按需走 workflows(action="setup") 完成凭据或取值设置。用 executions(action="run") 实况运行,再以 executions(action="get-node-output") 读回效果节点的真实输出后再报告。成功后询问是否保留或删除工作流,绝不擅自删除。
限制:无法直接写外部服务,必须依托 n8n 节点;不得在未读回输出时作定量声明;模拟验证通过不等于已验证或可用。