获取任务运行结果 GetAgentResult--云手机-火山引擎

文档中心

立即注册

云手机

任务管理

获取任务运行结果 GetAgentResult

获取指定任务的最终运行结果。

使用说明

调用 Mobile Use 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` 时有返回值。该参数的返回值示例请参考下文返回示例 1。该参数包含的子参数说明请参见下文 ScreenShots。
Usage	dict	{}	本次任务的用量信息。目前仅包含 token 信息。仅当 `IsDetail` 为 `true` 时有返回值。该参数的返回值示例请参考下文返回示例 1。该参数包含的子参数说明请参见下文 Usage。

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
                }
        }
}

请求示例 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": "已成功打开**并切换到搜索页的**热榜，获取到热搜榜前五条信息"
                }
        }
}

错误码

Mobile Use OpenAPI 错误码请参见错误码；更多错误码信息，可访问公共错误码。

最近更新时间：2025.12.05 17:54:55

这个页面对您有帮助吗？

有用

无用