查询工作流异步运行实例的详情

最近更新时间:2025-06-13 01:45:31

我的收藏

1. 接口描述

接口请求域名: lke.tencentcloudapi.com 。

创建了工作流的异步运行实例后,通过本接口可以查询整体的运行详情。

默认接口请求频率限制:20次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:DescribeWorkflowRun。
Version String 公共参数,本接口取值:2023-11-30。
Region String 公共参数,详见产品支持的 地域列表
WorkflowRunId String 工作流运行实例ID
示例值:1dcf5a21-6223-4358-b8a0-b4d6571

3. 输出参数

参数名称 类型 描述
WorkflowRun WorkflowRunDetail 总数
NodeRuns Array of NodeRunBase 节点列表
RequestId String 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 查询工作流运行实例详情

查询工作流运行实例详情

输入示例

复制
复制成功
POST / HTTP/1.1
Host: lke.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeWorkflowRun
<公共请求参数>

{
    "WorkflowRunId": "1dcf5a21-6223-4358-b8a0-b4d6571"
}

输出示例

复制
复制成功
{
    "Response": {
        "WorkflowRun": {
            "RunEnv": 1,
            "AppBizId": "1854548189164339200",
            "WorkflowRunId": "1dcf5a21-6223-4358-b8a0-b4d6",
            "WorkflowId": "412f5a21-6223-4358-b8a0-b4d6",
            "Name": "订酒店",
            "State": 1,
            "FailMessage": "",
            "TotalTokens": 100,
            "StartTime": "1672531200000",
            "EndTime": "1672531300000",
            "CreateTime": "1672531100000",
            "DialogJson": "{\"Workflows\": {\"WorkflowID\":\"1dcf5a21-6223-4358-b8a0-b4d65712f44c\",\"WorkflowName\":\"异步\",\"WorkflowDesc\":\"异步\",\"Nodes\":[{\"NodeID\":\"a2b6549c-85b6-b404-a736-3d738591f297\",\"NodeName\":\"开始\",\"NodeType\":\"START\",\"NodeDesc\":\"\",\"StartNodeData\":{},\"NextNodeIDs\":[\"bb004f48-eabd-4104-6cb1-1fb9f154c24d\"],\"Inputs\":[],\"NodeUI\":\"{\\\"data\\\":{\\\"content\\\":\\\"\\\",\\\"isHovering\\\":false,\\\"isParallel\\\":false,\\\"source\\\":false,\\\"target\\\":true,\\\"debug\\\":null,\\\"error\\\":false,\\\"output\\\":[]},\\\"position\\\":{\\\"x\\\":400,\\\"y\\\":282},\\\"targetPosition\\\":\\\"left\\\",\\\"sourcePosition\\\":\\\"right\\\",\\\"selected\\\":false,\\\"measured\\\":{\\\"width\\\":250,\\\"height\\\":84}}\"},{\"NodeID\":\"4710f3a1-fa47-d542-e3be-5b5ce38be1fe\",\"NodeName\":\"结束\",\"NodeType\":\"END\",\"NodeDesc\":\"\",\"EndNodeData\":{},\"NextNodeIDs\":[],\"Outputs\":[{\"Title\":\"Output\",\"Type\":\"OBJECT\",\"Required\":[],\"Properties\":[],\"Desc\":\"输出内容\"}],\"NodeUI\":\"{\\\"data\\\":{\\\"content\\\":\\\"\\\",\\\"isHovering\\\":false,\\\"isParallel\\\":false,\\\"source\\\":true,\\\"target\\\":false,\\\"debug\\\":null,\\\"error\\\":false,\\\"output\\\":[{\\\"label\\\":\\\"Output\\\",\\\"desc\\\":\\\"输出内容\\\",\\\"optionType\\\":\\\"REFERENCE_OUTPUT\\\",\\\"type\\\":\\\"OBJECT\\\",\\\"children\\\":[]}]},\\\"position\\\":{\\\"x\\\":1200,\\\"y\\\":282},\\\"targetPosition\\\":\\\"left\\\",\\\"sourcePosition\\\":\\\"right\\\",\\\"selected\\\":false,\\\"measured\\\":{\\\"width\\\":250,\\\"height\\\":84}}\"},{\"NodeID\":\"bb004f48-eabd-4104-6cb1-1fb9f154c24d\",\"NodeName\":\"代码1\",\"NodeType\":\"CODE_EXECUTOR\",\"NodeDesc\":\"\",\"CodeExecutorNodeData\":{\"Code\":\"CiMg6K+35L+d5a2Y5Ye95pWw5ZCN5Li6bWFpbizovpPlhaXovpPlh7rlnYfkuLpkaWN077yb5pyA57uI57uT5p6c5Lya5LulanNvbuWtl+espuS4suaWueW8j+i/lOWbnu+8jOivt+WLv+ebtOaOpei/lOWbnuS4jeaUr+aMgWpzb24uZHVtcHPnmoTlr7nosaEKZGVmIG1haW4ocGFyYW1zOiBkaWN0KSAtPiBkaWN0OgogICAgcmV0dXJuIHsKICAgICAgICAncmVzdWx0JzogcGFyYW1zLmdldCgnaW5wdXQnLCAwKQogICAgfQo=\",\"Language\":0},\"NextNodeIDs\":[\"4710f3a1-fa47-d542-e3be-5b5ce38be1fe\"],\"Inputs\":[],\"Outputs\":[{\"Title\":\"Output\",\"Type\":\"OBJECT\",\"Required\":[],\"Properties\":[{\"Title\":\"result\",\"Type\":\"STRING\",\"Required\":[],\"Properties\":[],\"Desc\":\"\"}],\"Desc\":\"输出内容\"}],\"NodeUI\":\"{\\\"data\\\":{\\\"content\\\":{\\\"outputs\\\":[\\\"Output\\\",\\\"Output.result\\\"],\\\"inputs\\\":[]},\\\"isHovering\\\":false,\\\"isParallel\\\":false,\\\"source\\\":true,\\\"target\\\":true,\\\"debug\\\":null,\\\"error\\\":false,\\\"output\\\":[{\\\"id\\\":\\\"b14d43a6-51ea-2df8-fcfc-759261cd5b1b\\\",\\\"value\\\":\\\"Output\\\",\\\"label\\\":\\\"Output\\\",\\\"type\\\":\\\"OBJECT\\\",\\\"children\\\":[{\\\"id\\\":\\\"e8a0a1f1-8bb4-892a-34ba-e020e3f48c99\\\",\\\"value\\\":\\\"result\\\",\\\"label\\\":\\\"result\\\",\\\"type\\\":\\\"STRING\\\",\\\"children\\\":[]}]}]},\\\"position\\\":{\\\"x\\\":700,\\\"y\\\":282},\\\"targetPosition\\\":\\\"left\\\",\\\"sourcePosition\\\":\\\"right\\\",\\\"selected\\\":true,\\\"measured\\\":{\\\"width\\\":250,\\\"height\\\":104}}\"}],\"Edge\":\"[{\\\"source\\\":\\\"a2b6549c-85b6-b404-a736-3d738591f297\\\",\\\"sourceHandle\\\":\\\"a2b6549c-85b6-b404-a736-3d738591f297-source\\\",\\\"target\\\":\\\"bb004f48-eabd-4104-6cb1-1fb9f154c24d\\\",\\\"type\\\":\\\"custom\\\",\\\"data\\\":{\\\"connectedNodeIsHovering\\\":false,\\\"error\\\":false,\\\"isHovering\\\":false},\\\"id\\\":\\\"xy-edge__a2b6549c-85b6-b404-a736-3d738591f297a2b6549c-85b6-b404-a736-3d738591f297-source-bb004f48-eabd-4104-6cb1-1fb9f154c24d\\\"},{\\\"source\\\":\\\"bb004f48-eabd-4104-6cb1-1fb9f154c24d\\\",\\\"sourceHandle\\\":\\\"bb004f48-eabd-4104-6cb1-1fb9f154c24d-source\\\",\\\"target\\\":\\\"4710f3a1-fa47-d542-e3be-5b5ce38be1fe\\\",\\\"targetHandle\\\":\\\"4710f3a1-fa47-d542-e3be-5b5ce38be1fe-target\\\",\\\"type\\\":\\\"custom\\\",\\\"data\\\":{\\\"connectedNodeIsHovering\\\":false,\\\"isHovering\\\":false,\\\"error\\\":false},\\\"id\\\":\\\"xy-edge__bb004f48-eabd-4104-6cb1-1fb9f154c24dbb004f48-eabd-4104-6cb1-1fb9f154c24d-source-4710f3a1-fa47-d542-e3be-5b5ce38be1fe4710f3a1-fa47-d542-e3be-5b5ce38be1fe-target\\\"}]\"}}",
            "Query": "我想订酒店",
            "MainModelName": "workflow-pro",
            "CustomVariables": []
        },
        "NodeRuns": [
            {
                "NodeRunId": "nf5a21-6223-4358-b8a789",
                "NodeId": "e60de932-b050-65ce-261e-027760e93d81",
                "WorkflowRunId": "1dcf5a21-6223-4358-b8a0-b4d6",
                "NodeName": "大模型节点",
                "NodeType": 3,
                "State": 1,
                "FailCode": "",
                "FailMessage": "",
                "CostMilliseconds": 1000,
                "TotalTokens": 100
            }
        ],
        "RequestId": "925208e7-46fa-43b3-a429-ddcbccad24f6"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码 描述
FailedOperation 操作失败。
MissingParameter 缺少参数错误。

如果遇到产品相关问题,您可咨询 在线客服寻求帮助。

返回顶部