You need to enable JavaScript to run this app.
文档中心
云手机

云手机

复制全文
下载 pdf
任务管理
获取任务运行结果 GetAgentResult
复制全文
下载 pdf
获取任务运行结果 GetAgentResult
获取指定任务的最终运行结果。​
使用说明​
调用 MUA OpenAPI 前,必须先访问 跨服务访问请求 为您的账号授权。​
注意事项​
本接口整体 QPS 限制为 100 次/秒、单用户 QPS 限制为 20 次/秒。超过限制,API 调用会被限流。​
请求说明​
  • 请求方式:GET​
  • 请求地址:https://open.volcengineapi.com?Action=GetAgentResult&Version=2023-08-01​
请求参数​
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见 公共参数。​
Query​
​
参数​
类型​
是否必选​
示例值​
描述​
Action​
String​
是​
GetAgentResult​
接口名称。当前 API 的名称为 GetAgentResult。​
Version​
String​
是​
2023-08-01​
接口版本。当前 API 的版本为 2023-08-01。​
RunId​
String​
是​
run-123456​
运行 ID。​
IsDetail​
Boolean​
否​
true​
是否展示详细信息。默认为 false。​
注意​
目前仅支持展示截屏、任务用量和任务所生成的文件名信息。​
​
返回参数​
下表仅列出本接口特有的返回参数。更多信息请参见 返回结构。​
​
参数​
类型​
示例值​
描述​
IsSuccess​
Integer​
1​
返回 1 表示任务成功结束。​
Content​
String​
任务执行完成​
任务运行结果的内容。​
StructOutput​
String​
{}​
仅当对应的代理运行配置中,定义了 OutputSchema 参数时有返回值,返回值根据 OutputSchema 构建的结构化 JSON 格式进行输出。​
ScreenShots​
dict​
{}​
本次任务涉及的所有截屏文件的对象存储 TOS URL。​
  • 仅当 IsDetail 为 true 时有返回值。​
  • 该参数包含的子参数说明请参见下文 ScreenShots。​
Usage​
dict​
{}​
本次任务的用量信息。​
  • 目前仅包含 token 信息。​
  • 仅当 IsDetail 为 true 时有返回值。​
  • 该参数包含的子参数说明请参见下文 Usage。​
RecordingUrl​
String​
"https://cn-beijing.volces.com/xxxxxx"​
录屏链接。如果运行代理任务是开启了录屏功能(IsScreenRecord 取值 true),则会返回该参数。​
Files​
List[String]​
["/sdk_files/<run_id>/1.txt"]​
任务中生成的文件名。​
  • 对应文件会被上传到 TOS。​
  • 仅当 IsDetail 为 true 时有返回值。​
​
ScreenShots​
​
参数名称​
类型​
示例值​
描述​
id​
String​
3932221a-c5ec-4058-a06e-23a0c747****​
编号 ID,每张截屏的唯一标识。​
original_dimensions​
int[]​
[720,1280]​
处理前的截屏分辨率,格式为 [宽度, 高度]。​
original_screenshot​
String​
https://xxx.tos-cn-beijing.volces.com/screenshot_3399c619e7894af6b38fd25b74d****​
处理前的截屏 URL。​
screenshot​
String​
https://xxx.tos-cn-beijing.volces.com/screenshot_3399c619e7894af6b38fd25b74d****​
处理后的截屏 URL。​
screenshot_dimensions​
int[]​
[720,1280]​
处理后的截屏分辨率,格式为 [宽度, 高度]。​
​
Usage​
​
参数名称​
类型​
示例值​
描述​
in_tokens​
int​
9183​
任务中输入模型的总 token 数。​
out_tokens​
int​
459​
任务中模型输出的总 token 数。​
​
请求示例 1​
IsDetail=true 展示详细信息的示例。​
​
GET https://open.volcengineapi.com?Action=GetAgentResult&Version=2023-08-01&RunId=run-123456&IsDetail=true​
​
返回示例 1​
​
{​
"ResponseMetadata": {​
"RequestId": "20251127173****",​
"Action": "GetAgentResult",​
"Version": "2023-08-01",​
"Service": "ipaas",​
"Region": "cn-north-1"​
},​
"Result": {​
"IsSuccess": 1,​
"Content": "已为你打开**并切换到搜索页的**热榜,获取到热搜榜前五信息如下:",​
"StructOutput": {​
"hot_searches": [{​
"heat_value": {​
"unit": "万",​
"value": "1226.7"​
},​
"rank": 1,​
"tag": "热",​
"title": "**称愿意对话**..."​
}, {​
"heat_value": {​
"unit": "万",​
"value": "1175.6"​
},​
"rank": 2,​
"tag": "热",​
"title": "刷到了好多“偷甘蔗”第一..."​
}, {​
"heat_value": {​
"unit": "万",​
"value": "1126.0"​
},​
"rank": 3,​
"tag": "热",​
"title": "**启动聚变领域国际科..."​
}, {​
"heat_value": {​
"unit": "万",​
"value": "1098.9"​
},​
"rank": 4,​
"tag": "热",​
"title": "友谊这篇章 该是路漫同相依"​
}, {​
"heat_value": {​
"unit": "万",​
"value": "1038.0"​
},​
"rank": 5,​
"tag": "热",​
"title": "续**吗"​
}],​
"summary": "已成功打开**并切换到搜索页的**热榜,获取到热搜榜前五条信息"​
},​
"ScreenShots": {​
"3932221a-c5ec-4058-a06e-23a0c747****": {​
"id": "3932221a-c5ec-4058-a06e-23a0c747****",​
"llm_type": null,​
"original_dimensions": [720, 1280],​
"original_screenshot": "https://xxx.tos-cn-beijing.volces.com/screenshot_44ea43937644424eaf9262dbf0e4****_2025112709****.png?X-Tos-Algorithm=TOS4-HMAC-SHA256\u0026X-Tos-Credential=AKTP0UXb1XiMdMD3TZUPWj9XarRdhFFUrF3KNOQBA1**%2F20251127%2Fcn-beijing%2Ftos%2Frequest\u0026X-Tos-Date=20251127T092342Z\u0026X-Tos-Expires=3600\u0026X-Tos-Security-Token=nChB****zWOMtohnag\u0026X-Tos-Signature=a88fde615da****6c3159eb54d6aad8\u0026X-Tos-SignedHeaders=host",​
"screenshot": "https://xxx.tos-cn-beijing.volces.com/screenshot_44ea43937644424eaf9262dbf0e4****_2025112709****.png?X-Tos-Algorithm=TOS4-HMAC-SHA256\u0026X-Tos-Credential=AKTP0UXb1XiMdMD3TZUPWj9XarRdhFFUrF3KNOQBA1**%2F20251127%2Fcn-beijing%2Ftos%2Frequest\u0026X-Tos-Date=20251127T092342Z\u0026X-Tos-Expires=3600\u0026X-Tos-Security-Token=nChB****zWOMtohnag\u0026X-Tos-Signature=a88fde615da****6c3159eb54d6aad8\u0026X-Tos-SignedHeaders=host",​
"screenshot_dimensions": [720, 1280]​
}​
},​
"Usage": {​
"in_tokens": 9183,​
"out_tokens": 459​
},​
"RecordingUrl": "https://cn-beijing.volces.com/xxxxxx",​
"Files": ["/sdk_files/<run_id>/1.txt"]​
}​
}​
​
请求示例 2​
IsDetail=false 不展示详细信息的示例。​
​
GET https://open.volcengineapi.com?Action=GetAgentResult&Version=2023-08-01&RunId=run-123456&IsDetail=false​
​
返回示例 2​
​
{​
"ResponseMetadata": {​
"RequestId": "20251127173****",​
"Action": "GetAgentResult",​
"Version": "2023-08-01",​
"Service": "ipaas",​
"Region": "cn-north-1"​
},​
"Result": {​
"IsSuccess": 1,​
"Content": "已为你打开**并切换到搜索页的**热榜,获取到热搜榜前五信息如下:",​
"StructOutput": {​
"hot_searches": [{​
"heat_value": {​
"unit": "万",​
"value": "1226.7"​
},​
"rank": 1,​
"tag": "热",​
"title": "**称愿意对话**..."​
}, {​
"heat_value": {​
"unit": "万",​
"value": "1175.6"​
},​
"rank": 2,​
"tag": "热",​
"title": "刷到了好多“偷甘蔗”第一..."​
}, {​
"heat_value": {​
"unit": "万",​
"value": "1126.0"​
},​
"rank": 3,​
"tag": "热",​
"title": "**启动聚变领域国际科..."​
}, {​
"heat_value": {​
"unit": "万",​
"value": "1098.9"​
},​
"rank": 4,​
"tag": "热",​
"title": "友谊这篇章 该是路漫同相依"​
}, {​
"heat_value": {​
"unit": "万",​
"value": "1038.0"​
},​
"rank": 5,​
"tag": "热",​
"title": "续**吗"​
}],​
"summary": "已成功打开**并切换到搜索页的**热榜,获取到热搜榜前五条信息"​
}​
}​
}​
​
错误码​
MUA OpenAPI 错误码请参见 错误码。​
最近更新时间:2026.09.30 16:45:08
这个页面对您有帮助吗?
有用
有用
无用
无用