菜单

工作流-查询工作流异步执行结果

1、功能说明

该指令用于查询扣子平台中异步运行工作流的最终执行结果。需传入异步执行时返回的execute_id和对应的工作流ID，支持查看执行状态、输出内容、资源消耗等信息，API 调用失败时指令会抛出错误。

API 接口详细信息见：https://www.coze.cn/open/docs/developer_guides/workflow_history

2、配置参数

参数名	必填	说明
Token	是	用于身份鉴权的访问令牌，需开通`listRunHistory`权限，鉴权规则参考扣子平台规范。
工作流 ID	是	异步运行的目标工作流唯一标识，可从工作流编排页面 URL 中获取（`workflow`参数后数字）。
工作流执行 ID	是	异步执行工作流时返回的唯一 ID（即execute_id），用于定位具体执行记录。
返回结果	是	接口返回的完整响应内容，为字典格式，包含执行状态、输出结果等信息。

返回结果示例

1. 执行成功响应

{
  "code": 0,
  "msg": "",
  "data": [
    {
      "execute_id": "743104097880585****",
      "execute_status": "Success",
      "output": "{\"Output\":\"工作流异步执行完成，处理结果：生成10条数据报告\",\"数据统计节点\":\"处理数据总量200条，成功198条\"}",
      "create_time": 1730174063,
      "update_time": 1730174065,
      "usage": {
        "input_count": 80,
        "output_count": 120,
        "token_count": 200
      },
      "debug_url": "https://www.coze.cn/work_flow?execute_id=743104097880585****&space_id=730976060439760****&workflow_id=742963539464539****",
      "logid": "20241029115423ED85C3401395715F726E"
    }
  ],
  "detail": {
    "logid": "20241029152003BC531DC784F1897B****"
  }
}

2. 执行中响应

{
  "code": 0,
  "msg": "",
  "data": [
    {
      "execute_id": "743104097880585****",
      "execute_status": "Running",
      "output": "",
      "create_time": 1730174063,
      "update_time": 1730174070,
      "usage": {
        "input_count": 80,
        "output_count": 0,
        "token_count": 80
      },
      "debug_url": "https://www.coze.cn/work_flow?execute_id=743104097880585****&space_id=730976060439760****&workflow_id=742963539464539****",
      "logid": "20241029115423ED85C3401395715F726E"
    }
  ],
  "detail": {
    "logid": "20241029152003BC531DC784F1897B****"
  }
}

3、示例场景

场景：查询长耗时工作流异步执行结果

从 “执行工作流” 指令的异步响应中，提取execute_id（如743104097880585****）和对应的工作流ID。
在本指令的 “Token” 参数中填入有效鉴权令牌，“工作流 ID” 和 “执行 ID（execute_id）” 分别填入上述提取的值。
运行指令，若返回execute_status: "Success"，可从output字段解析工作流输出结果；若为 “Running”，需等待一段时间后重新查询；若API调用失败，指令会抛出错误，可以通过指令错误信息排查失败原因。

4、注意事项

参数关联性：工作流ID与execute_id必须对应同一异步执行记录，否则会查询失败（返回无数据或错误）。
结果时效性：工作流输出节点数据仅保存 24 小时，结束节点数据保存 7 天，需在有效期内查询结果。
输出完整性：若is_output_trimmed: true，表示输出内容因超过 1MB 被截断，需通过 “查询工作流节点输出” API 单独获取各节点完整输出。
debug_url 用途：返回的debug_url可用于可视化查看各节点执行详情（有效期 7 天），便于排障。

上一个

扣子CozeAPI

下一个

文件-上传文件

最近修改: 2026-02-10

大纲