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。
- Tencent Cloud SDK 3.0 for Python: GitHub, Gitee
- Tencent Cloud SDK 3.0 for Java: GitHub, Gitee
- Tencent Cloud SDK 3.0 for PHP: GitHub, Gitee
- Tencent Cloud SDK 3.0 for Go: GitHub, Gitee
- Tencent Cloud SDK 3.0 for Node.js: GitHub, Gitee
- Tencent Cloud SDK 3.0 for .NET: GitHub, Gitee
- Tencent Cloud SDK 3.0 for C++: GitHub, Gitee
- Tencent Cloud SDK 3.0 for Ruby: GitHub, Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 描述 |
---|---|
FailedOperation | 操作失败。 |
MissingParameter | 缺少参数错误。 |