获取指定任务的最终运行结果。 ## 使用说明调用 Mobile Use Agent OpenAPI 前，必须先访问[跨服务访问请求](https://console.volcengine.com/iam/service/attach_role/?ServiceName=ipaas)为您的账号授权。 ## 注意事项本接口整体 **QPS 限制为 100 次/秒**、单用户 **QPS 限制为 20 次/秒**。超过限制，API 调用会被限流。 ## 请求说明 * 请求方式：GET * 请求地址：https://open.volcengineapi.com?Action=GetAgentResult&Version=2023\-08\-01 ## 请求参数下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。 ### Query |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |GetAgentResult |接口名称。当前 API 的名称为 `GetAgentResult`。 | |Version |String |是 |2023\-08\-01 |接口版本。当前 API 的版本为 `2023-08-01`。 | |RunId |String |是 |run\-123456 |运行 ID。 | |IsDetail |Boolean |否 |true |是否展示详细信息。默认为 false。

注意

目前仅支持展示截屏、任务用量和任务所生成的文件名信息。

| ## 返回参数下表仅列出本接口特有的返回参数。更多信息请参见[返回结构](https://www.volcengine.com/docs/6394/75713#%E8%BF%94%E5%9B%9E%E7%BB%93%E6%9E%9C)。 |**参数名称** |**类型** |**示例值** |**描述** | |---|---|---|---| |IsSuccess |Integer |1 |返回 `1` 表示任务成功结束。 | |Content |String |任务执行完成 |任务运行结果的内容。 | |StructOutput |String |{} |仅当对应的代理运行配置中，定义了 `OutputSchema` 参数时有返回值，返回值根据 `OutputSchema` 构建的结构化 JSON 格式进行输出。 | |ScreenShots |dict |{} |本次任务涉及的所有截屏文件的对象存储 TOS URL。

* 仅当 `IsDetail` 为 `true` 时有返回值。

* 该参数的返回值示例请参考下文 **返回示例 1**。

* 该参数包含的子参数说明请参见下文 **ScreenShots**。 | |Usage |dict |{} |本次任务的用量信息。

* 目前仅包含 token 信息。

* 仅当 `IsDetail` 为 `true` 时有返回值。

* 该参数的返回值示例请参考下文 **返回示例 1**。

* 该参数包含的子参数说明请参见下文 **Usage**。 | |RecordingUrl |String |"https://cn\-beijing.volces.com/xxxxxx" |录屏链接。如果运行代理任务是开启了录屏功能（IsScreenRecord 取值 true），则会返回该参数。 | |Files |List[String] |["/sdk_files//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` 展示详细信息的示例。 ```HTTP GET https://open.volcengineapi.com?Action=GetAgentResult&Version=2023-08-01&RunId=run-123456&IsDetail=true ``` ## 返回示例 1 ```JSON { "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//1.txt"] } } ``` ## 请求示例 2 `IsDetail=false` 不展示详细信息的示例。 ```HTTP GET https://open.volcengineapi.com?Action=GetAgentResult&Version=2023-08-01&RunId=run-123456&IsDetail=false ``` ## 返回示例 2 ```JSON { "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": "已成功打开**并切换到搜索页的**热榜，获取到热搜榜前五条信息" } } } ``` ## 错误码 Mobile Use Agent OpenAPI 错误码请参见[错误码](https://www.volcengine.com/docs/6394/1956026)；更多错误码信息，可访问[公共错误码](https://www.volcengine.com/docs/6394/1134303)。

云手机