跳到正文

等待异步结果

功能简介

轮询等待工作流异步执行完成,直到执行结束(成功或失败)或超时。调用【异步执行工作流】后获得执行ID,本指令会持续轮询直到工作流执行完毕,再返回最终结果。

使用场景

  • 异步执行工作流后需要获取最终执行结果时
  • 需要等待工作流执行完成再继续后续流程时

参数说明

输入参数

参数名 类型 必填 说明
工作流ID 字符串 是 待查询的工作流 ID。支持直接填写工作流 ID,或填写完整工作流链接;若填写链接,程序会自动提取其中的 workflow_id
执行ID 字符串 是 【异步执行工作流】返回的执行 ID
轮询间隔秒 整数 否 每次轮询之间的等待时间,默认 3 秒
最大等待秒 整数 否 轮询最大等待时长,超过后返回当前结果并标记超时,默认 600 秒(10 分钟)

输出参数

参数名 类型 必填 说明
执行结果 字符串 是 执行结束后的结果 JSON,包含 execute_status、output 等
是否超时 布尔值 是 超过最大等待秒时为 True,此时执行结果可能仍为执行中状态

注意事项

注意

  • 轮询逻辑:本指令会持续轮询,直到单次查询结果中的状态为成功或失败,不会在仍为运行中时提前返回
  • 超时处理:超时后返回最后一次查询到的结果,并将「是否超时」置为 true;此时返回中的运行状态可能仍为运行中
  • 数据保存:工作流的输出节点的输出数据最多保存 24 小时,结束节点为 7 天
  • 内容限制:输出节点的输出内容超过 1 MB 时,无法保证返回内容的完整性;若需按节点取全量内容,需按扣子开放平台文档使用查询输出节点执行结果的能力逐节点获取
© 小由和小迪
创建更新
浏览1