查询工作流组件的异步执行结果
更新时间：2025-12-22
POST
https://qianfan.baidubce.com/v2/tools/workflow/async/retrieve
调用异步执行工作流组件API 时，如果选择，响应信息中会返回execute_id，开发者可以通过本接口查询指定事件的执行结果。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看 认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
请求结构
POST /v2/tools/workflow/async/retrieve HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"execute_id":"bdf13eb1-****-a63d454ca872"
}示例代码
请求示例
curl https://qianfan.baidubce.com//v2/tools/workflow/async/retrieve \
-H "Content-Type: application/json" \
-H "Authorization: Bearer bce-v3/ALTAK-***4fc93bd3c713300542be00bc85" \
-d '{
"execute_id": "bdf13eb1-***-a63d454ca872"
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
response
oneOf {2}
多选一且必需“只能”符合其中一个
可选
显示子属性
隐藏子属性
response
object {10}
正确响应参数。
显示子属性
隐藏子属性
conversation_id
string
对话ID。
必选
message_id
string
一问或一答的标识ID。
必选
trace_id
string
正确响应ID。
必选
user_id
string
用户ID，用于计费依赖。
必选
end_user_id
string
终端用户ID。
可选
is_completion
string
异步工作流是否已经运行结束。
- true：运行结束
- false：未运行结束
必选
content
array
工作流的执行结果。
必选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
name
string
当前返回内容所对应的执行步骤名称。在异步执行场景下为“异步执行”。
必选
type
string
代表 event 类型。该字段的取值决定了 text 字段的内容结构。异步执行时固定为 "asynchronize"。
必选
text
object {2}
当前event元素内容。
必选
显示子属性
隐藏子属性
event
array
工作流执行过程中产生的事件序列。
必选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
type
string
事件类型。
必选
name
string
事件名称。
必选
text
object {0}
事件内容。
必选
显示子属性
隐藏子属性
暂无参数
node_results
array
各节点的执行结果详情。
必选
显示子属性
隐藏子属性
items
object {10}
显示子属性
隐藏子属性
node_id
string
节点ID。
必选
node_template_id
string
节点类型。
必选
node_name
string
节点名称。
必选
node_status
string
节点状态。
必选
inputs
object {0}
节点输入。
必选
显示子属性
隐藏子属性
暂无参数
outputs
object {0}
节点输出。
必选
显示子属性
隐藏子属性
暂无参数
node_execute_start_time
number
节点执行开始时间。
必选
node_execute_cost
number
节点执行耗时。
必选
input_tokens
integer
该节点消耗的输入token数。
必选
output_tokens
integer
该节点生成的输出token数。
必选
metrics
object {2}
必选
显示子属性
隐藏子属性
begin_time
string
工作流开始执行的UTC时间戳。
必选
duration
number
总执行耗时（秒）。
必选
usage
object {4}
token统计信息。
必选
显示子属性
隐藏子属性
prompt_tokens
integer
输入的 prompt token 数。
必选
completion_tokens
integer
模型生成的 token 数。
必选
total_tokens
integer
本次请求消耗的总 token 数量，包括输入和输出的数量。
必选
nodes
array
按节点拆分的 token 使用详情。
必选
显示子属性
隐藏子属性
items
object {2}
显示子属性
隐藏子属性
node_id
string
节点 ID。
必选
models_usage
array
该节点调用的大模型使用情况。
必选
显示子属性
隐藏子属性
items
object {4}
显示子属性
隐藏子属性
model_name
string
使用的模型名称。
必选
prompt_tokens
integer
该模型调用的输入 token 数。
必选
completion_tokens
integer
该模型调用的输出 token 数。
必选
total_tokens
integer
本次调用的总 token 数。
必选
event
object {7}
可选
显示子属性
隐藏子属性
id
string
运行事件ID。
可选
status
string
运行状态。
可选
name
string
工作流Agent名称。
可选
created_time
string
创建时间，符合UTC格式。
可选
error_code
string
错误码，成功响应时为空。
可选
error_code_int
integer
错误码（整数形式），0表示无错误。
可选
error_message
string
错误描述信息，成功响应时为空。
可选
response
object {3}
错误响应参数。
显示子属性
隐藏子属性
request_id
string
错误响应ID。
必选
code
string
错误代码，当发生异常时返回。
可选
message
string
错误消息，当发生异常时返回。
可选
JSON
{
"conversation_id": "",
"message_id": "1296d9a9-***-f22e8e62c9d2",
"trace_id": "fef6e49d-***-e665f3c426d3",
"user_id": "47996032-***-0dc1409ec54f",
"is_completion": true,
"role": "tool",
"content": [
{
"type": "asynchronize",
"name": "异步执行",
"text": {
"event": [],
"node_results": [
{
"node_id": "fa***fc6b",
"node_template_id": "start",
"node_name": "开始",
"node_status": "success",
"inputs": {},
"outputs": {},
"node_execute_start_time": 1766040426.7842278,
"node_execute_cost": 0.00016307830810546875,
"input_tokens": 0,
"output_tokens": 0
},
{
"node_id": "fb***a39e",
"node_template_id": "rewrite_query",
"node_name": "Query多轮改写",
"node_status": "success",
"inputs": {
"query": "hello"
},
"outputs": {
"rewrite_query": "hello"
},
"node_execute_start_time": 1766040426.7859228,
"node_execute_cost": 0.00028514862060546875,
"input_tokens": 0,
"output_tokens": 0
},
{
"node_id": "79***d0c3",
"node_template_id": "doc_search",
"node_name": "知识检索",
"node_status": "success",
"inputs": {
"Query": "hello"
},
"outputs": {
"OutputList": [
{
"content": "ene\":\"正确响应示例\",\"sceneDesc\":\"\",\"languageTabs\":[{\"code\":\"HTTP/1.1 200 OK\\n{\\n \\\"requestId\\\": \\\"c2db9c49-***-b26272075ae9\\\",\\n \\\"marker\\\": \\\"\\\",\\n \\\"isTruncated\\\": false,\\n \\\"nextMarker\\\": \\\"3bec3435-***-1527da3713ed\\\",\\n \\\"maxKeys\\\": 1,\\n \\\"data\\\": [\\n {\\n \\\"id\\\": \\\"3bec3435-***-1527da3713ed\\\",\\n \\\"name\\\": \\\"医疗卫生常识.doc\\\",\\n \\\"createdAt\\\": \\\"2024-06-03T02:39:04Z\\\",\\n \\\"displayStatus\\\": \\\"available\\\",\\n \\\"wordCount\\\": 80618,\\n \\\"enabled\\\": true,\\n \\\"meta\\\": {\\n",
"document_name": "查询知识库文档列表.md",
"dataset_id": "58d5ad28-***-149680c1932e",
"dataset_name": "千帆API库2",
"word_count": 595,
"segment_id": "66420045-***-4ce6dab31219",
"document_id": "bc8e4089-***-17ee967c42ee",
"original_chunk_id": null,
"original_chunk_offset": 0,
"score": 0.5060955882072449,
"url": ""
},
{
"content": "c2f188b4-***-034e77ce8c89\",</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\"> \"content\": \"你好\"</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">}'</span></span></code></pre>\n</div>\n</div>\n</div>\n</div>\n</div>\n</section>\n<section id=\"response-params\">\n<h2 class=\"section-title\" id=\"返回响应\">返回响应<a class=\"anchor\" aria-label=\"返回响应 permalink\" href=\"#%E8%BF%94%E5%9B%9E%E5%93%8D%E5%BA%94\"></a></h2>\n<div class=\"horizontal-container\">\n<div class=\"horizontal-left-panel\">\n<div class=\"param-card param-card-empty\">\n<div class=\"param-card-header\">\n<div class=\"param-card-tit",
"document_name": "新增切片.md",
"dataset_id": "58d5ad28-***-149680c1932e",
"dataset_name": "千帆API库2",
"word_count": 600,
"segment_id": "baa56bdd-***-47af1452014b",
"document_id": "e2095b77-***-783594213b1d",
"original_chunk_id": null,
"original_chunk_offset": 0,
"score": 0.48818427324295044,
"url": ""
},
{
"content": ": </span><span style=\"color:#A5D6FF\">\"5e827931-4bc2-4cfe-b40c-0fe9371234b8\"</span><span style=\"color:#E6EDF3\">,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\"> \"documentId\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#A5D6FF\">\"c2f288b4-e9ed-46df-a1b7-034e77ce8c89\"</span><span style=\"color:#E6EDF3\">,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\"> \"content\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#A5D6FF\">\"你好\"</span><span style=\"color:#E6EDF3\">,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\"> \"wordCount\"<",
"document_name": "获取切片详情.md",
"dataset_id": "58d5ad28-***-149680c1932e",
"dataset_name": "千帆API库2",
"word_count": 600,
"segment_id": "15e9d27b-***-b32021c2040c",
"document_id": "d7509bdb-***-89591cc32cda",
"original_chunk_id": null,
"original_chunk_offset": 0,
"score": 0.48678895831108093,
"url": ""
},
{
"content": "color:#A5D6FF\\\"> \\\"name\\\"</span><span style=\\\"color:#E6EDF3\\\">: </span><span style=\\\"color:#A5D6FF\\\">\\\"knowledge_base\\\"</span><span style=\\\"color:#E6EDF3\\\">,</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\"> \\\"description\\\"</span><span style=\\\"color:#E6EDF3\\\">: </span><span style=\\\"color:#A5D6FF\\\">\\\"knowledge_base description\\\"</span><span style=\\\"color:#E6EDF3\\\">,</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\"> \\\"config\\\"</span><span style=\\\"color:#E6EDF3\\\">: {</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\"> \\\"index\\\"</spa",
"document_name": "获取知识库详情.md",
"dataset_id": "58d5ad28-***-149680c1932e",
"dataset_name": "千帆API库2",
"word_count": 600,
"segment_id": "7b8ebe14-***-9a7f395e343c",
"document_id": "70115712-***-f6958c002fec",
"original_chunk_id": null,
"original_chunk_offset": 0,
"score": 0.47123846411705017,
"url": ""
},
{
"content": "372f7-f***-2001ea15e1a4\",</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\"> \"content\": \"你好\",</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\"> \"enable\": true</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">}'</span></span></code></pre>\n</div>\n</div>\n</div>\n</div>\n</div>\n</section>\n<section id=\"response-params\">\n<h2 class=\"section-title\" id=\"返回响应\">返回响应<a class=\"anchor\" aria-label=\"返回响应 permalink\" href=\"#%E8%BF%94%E5%9B%9E%E5%93%8D%E5%BA%94\"></a></h2>\n<div class=\"horizontal-container\">\n<div class=\"horizontal-left-panel\">\n<div class=\"param-card",
"document_name": "更新切片.md",
"dataset_id": "58d5ad28-***-149680c1932e",
"dataset_name": "千帆API库2",
"word_count": 600,
"segment_id": "4fd13dda-***-8c8608f00de4",
"document_id": "e54392bf-***-3368faae532e",
"original_chunk_id": null,
"original_chunk_offset": 0,
"score": 0.4695202708244324,
"url": ""
},
{
"content": "olor:#A5D6FF\\\"> \\\"documentId\\\": \\\"c2f188b4-***-034e77ce8c89\\\",</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\"> \\\"content\\\": \\\"你好\\\"</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">}'</span></span></code></pre>\"}]}],\"responseHeader\":false,\"responseBody\":{\"type\":\"object\",\"required\":[\"requestId\",\"id\"],\"properties\":{\"id\":{\"type\":\"string\",\"description\":\"切片id\"},\"requestId\":{\"type\":\"string\",\"description\":\"请求ID\"}}},\"responseExampleCode\":[{\"scene\":\"正确响应示例\",\"sceneDesc\":\"\",\"languageTabs\":[{\"code\":\"HTTP/1.1 200 OK\\n{\\n \\\"requestId\\\": \\\"f5fb7546-33d5-",
"document_name": "新增切片.md",
"dataset_id": "58d5ad28-***-149680c1932e",
"dataset_name": "千帆API库2",
"word_count": 600,
"segment_id": "3ac40a2b-***-2d23c6992271",
"document_id": "e2095b77-***-783594213b1d",
"original_chunk_id": null,
"original_chunk_offset": 0,
"score": 0.46141111850738525,
"url": ""
}
]
},
"node_execute_start_time": 1766040426.7868853,
"node_execute_cost": 1.012594223022461,
"input_tokens": 0,
"output_tokens": 0
},
{
"node_id": "8b***5925",
"node_template_id": "llm-runtime",
"node_name": "大模型总结",
"node_status": "success",
"inputs": {
"slice": "['ene\":\"正确响应示例\",\"sceneDesc\":\"\",\"languageTabs\":[{\"code\":\"HTTP/1.1 200 OK\\\\n{\\\\n \\\\\"requestId\\\\\": \\\\\"c2db9c49-***-b26272075ae9\\\\\",\\\\n \\\\\"marker\\\\\": \\\\\"\\\\\",\\\\n \\\\\"isTruncated\\\\\": false,\\\\n \\\\\"nextMarker\\\\\": \\\\\"3bec3435-***-1527da3713ed\\\\\",\\\\n \\\\\"maxKeys\\\\\": 1,\\\\n \\\\\"data\\\\\": [\\\\n {\\\\n \\\\\"id\\\\\": \\\\\"3bec3435-***-1527da3713ed\\\\\",\\\\n \\\\\"name\\\\\": \\\\\"医疗卫生常识.doc\\\\\",\\\\n \\\\\"createdAt\\\\\": \\\\\"2024-06-03T02:39:04Z\\\\\",\\\\n \\\\\"displayStatus\\\\\": \\\\\"available\\\\\",\\\\n \\\\\"wordCount\\\\\": 80618,\\\\n \\\\\"enabled\\\\\": true,\\\\n \\\\\"meta\\\\\": {\\\\n', 'c2f188b4-***-034e77ce8c89\",</span></span>\\n<span class=\"line\"><span style=\"color:#A5D6FF\"> \"content\": \"你好\"</span></span>\\n<span class=\"line\"><span style=\"color:#A5D6FF\">}\\'</span></span></code></pre>\\n</div>\\n</div>\\n</div>\\n</div>\\n</div>\\n</section>\\n<section id=\"response-params\">\\n<h2 class=\"section-title\" id=\"返回响应\">返回响应<a class=\"anchor\" aria-label=\"返回响应 permalink\" href=\"#%E8%BF%94%E5%9B%9E%E5%93%8D%E5%BA%94\"></a></h2>\\n<div class=\"horizontal-container\">\\n<div class=\"horizontal-left-panel\">\\n<div class=\"param-card param-card-empty\">\\n<div class=\"param-card-header\">\\n<div class=\"param-card-tit', ': </span><span style=\"color:#A5D6FF\">\"5e827931-***-0fe9371234b8\"</span><span style=\"color:#E6EDF3\">,</span></span>\\n<span class=\"line\"><span style=\"color:#A5D6FF\"> \"documentId\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#A5D6FF\">\"c2f288b4-***-034e77ce8c89\"</span><span style=\"color:#E6EDF3\">,</span></span>\\n<span class=\"line\"><span style=\"color:#A5D6FF\"> \"content\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#A5D6FF\">\"你好\"</span><span style=\"color:#E6EDF3\">,</span></span>\\n<span class=\"line\"><span style=\"color:#A5D6FF\"> \"wordCount\"<', 'color:#A5D6FF\\\\\"> \\\\\"name\\\\\"</span><span style=\\\\\"color:#E6EDF3\\\\\">: </span><span style=\\\\\"color:#A5D6FF\\\\\">\\\\\"knowledge_base\\\\\"</span><span style=\\\\\"color:#E6EDF3\\\\\">,</span></span>\\\\n<span class=\\\\\"line\\\\\"><span style=\\\\\"color:#A5D6FF\\\\\"> \\\\\"description\\\\\"</span><span style=\\\\\"color:#E6EDF3\\\\\">: </span><span style=\\\\\"color:#A5D6FF\\\\\">\\\\\"knowledge_base description\\\\\"</span><span style=\\\\\"color:#E6EDF3\\\\\">,</span></span>\\\\n<span class=\\\\\"line\\\\\"><span style=\\\\\"color:#A5D6FF\\\\\"> \\\\\"config\\\\\"</span><span style=\\\\\"color:#E6EDF3\\\\\">: {</span></span>\\\\n<span class=\\\\\"line\\\\\"><span style=\\\\\"color:#A5D6FF\\\\\"> \\\\\"index\\\\\"</spa', '372f7-***-2001ea15e1a4\",</span></span>\\n<span class=\"line\"><span style=\"color:#A5D6FF\"> \"content\": \"你好\",</span></span>\\n<span class=\"line\"><span style=\"color:#A5D6FF\"> \"enable\": true</span></span>\\n<span class=\"line\"><span style=\"color:#A5D6FF\">}\\'</span></span></code></pre>\\n</div>\\n</div>\\n</div>\\n</div>\\n</div>\\n</section>\\n<section id=\"response-params\">\\n<h2 class=\"section-title\" id=\"返回响应\">返回响应<a class=\"anchor\" aria-label=\"返回响应 permalink\" href=\"#%E8%BF%94%E5%9B%9E%E5%93%8D%E5%BA%94\"></a></h2>\\n<div class=\"horizontal-container\">\\n<div class=\"horizontal-left-panel\">\\n<div class=\"param-card', 'olor:#A5D6FF\\\\\"> \\\\\"documentId\\\\\": \\\\\"c2f188b4-***-034e77ce8c89\\\\\",</span></span>\\\\n<span class=\\\\\"line\\\\\"><span style=\\\\\"color:#A5D6FF\\\\\"> \\\\\"content\\\\\": \\\\\"你好\\\\\"</span></span>\\\\n<span class=\\\\\"line\\\\\"><span style=\\\\\"color:#A5D6FF\\\\\">}\\'</span></span></code></pre>\"}]}],\"responseHeader\":false,\"responseBody\":{\"type\":\"object\",\"required\":[\"requestId\",\"id\"],\"properties\":{\"id\":{\"type\":\"string\",\"description\":\"切片id\"},\"requestId\":{\"type\":\"string\",\"description\":\"请求ID\"}}},\"responseExampleCode\":[{\"scene\":\"正确响应示例\",\"sceneDesc\":\"\",\"languageTabs\":[{\"code\":\"HTTP/1.1 200 OK\\\\n{\\\\n \\\\\"requestId\\\\\": \\\\\"f5fb7546-33d5-']",
"query": "hello"
},
"outputs": {
"result": "“hello”的常见回应是“你好” （根据搜索结果中的示例内容：`\"content\": \"你好\"` 给出回应） 。"
},
"node_execute_start_time": 1766040427.8018146,
"node_execute_cost": 2.6471712589263916,
"input_tokens": 0,
"output_tokens": 0
},
{
"node_id": "91***3d4d",
"node_template_id": "end",
"node_name": "结束",
"node_status": "success",
"inputs": {
"final_result": "“hello”的常见回应是“你好” （根据搜索结果中的示例内容：`\"content\": \"你好\"` 给出回应） 。",
"rewrite_query": "hello"
},
"outputs": {
"final_result": "“hello”的常见回应是“你好” （根据搜索结果中的示例内容：`\"content\": \"你好\"` 给出回应） 。",
"rewrite_query": "hello"
},
"node_execute_start_time": 1766040430.4513052,
"node_execute_cost": 0.010913372039794922,
"input_tokens": 0,
"output_tokens": 0
}
]
},
"metrics": {
"begin_time": "2025-12-18T14:47:06.623664",
"duration": 3.839
},
"usage": {
"prompt_tokens": 1558,
"completion_tokens": 28,
"total_tokens": 1586,
"nodes": [
{
"node_id": "8b***5925",
"models_usage": [
{
"model_name": "ernie-4.5-turbo-32k",
"prompt_tokens": 1558,
"completion_tokens": 28,
"total_tokens": 1586
}
]
}
]
},
"event": {
"id": "f9***4733",
"status": "done",
"name": "test",
"created_time": "2025-12-18T14:47:06.780482",
"error_code": "",
"error_code_int": 0,
"error_message": ""
}
}
]
}JSON
{
"code": "PermissionDeniedError",
"message": "当前用户无权访问该任务",
"request_id": "750298e3-***-9bc3c7c8f8bb"
}评价此篇文章