更新指定脚本资产。更新后，后续任务执行时将使用最新的脚本资产内容。 ## 使用说明调用 MUA OpenAPI 前，必须先访问 [跨服务访问请求](https://console.volcengine.com/iam/service/attach_role/?ServiceName=ipaas) 为您的账号授权。 ## 注意事项本接口整体 **QPS 限制为 50 次/秒**、单用户 **QPS 限制为 10 次/秒**。超过限制，API 调用会被限流。 ## 请求说明 * 请求方式：POST * 请求地址：https://open.volcengineapi.com?Action=UpdateAgentRunScript&Version=2023\-08\-01 ## 请求参数下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见 [公共参数](https://www.volcengine.com/docs/6369/67268)。 ### Header |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Content\-Type |String |是 |application/json |请求头信息。 | ### Query |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |UpdateAgentRunScript |接口名称。当前 API 的名称为 `UpdateAgentRunScript`。 | |Version |String |是 |2023\-08\-01 |接口版本。当前 API 的版本为 `2023-08-01`。 | ### Body |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |ScriptId |Long |是 |1001 |指定需更新的脚本资产的 ID。您可以通过 [ListAgentRunScript](https://docs.volcengine.com/docs/Cloudphone/list-agent-run-script) 接口获取。 | |Name |String |否 |open\-app\-v2 |更新后的脚本资产的名称，长度为 1～128 个字符。 | |Description |String |否 |新版本说明 |更新后的脚本资产的说明，长度为 0～2048 个字符。传入空字符串时将清空已有脚本说明。 | |Script |String |否 |tap(500, 800)\nwait(3)\ntake_screenshot() |更新后的脚本资产的文本内容。写法请参见 Script 脚本内容规范。大小不超过 100 KB，有效操作指令不超过 500 行。

> **注意**

> `Script` 与 `File` 两者必须传其一，不可以同时传入或同时不传。
| |File |File |否 |demo.script |更新后的脚本资产的文件。文件内容写法请参见 Script 脚本内容规范，MUA 将直接读取文件内容作为脚本执行。请以文件形式上传，支持 `.script` 等文本格式文件。

> **注意**

> `Script` 与 `File` 两者必须传其一，不可以同时传入或同时不传。
| |Resolution |String |否 |1920x1080 |更新后的脚本资产的屏幕分辨率，格式为宽x高，宽和高的取值范围均为 1～16384。传入空字符串时将清空已有屏幕分辨率。 | |Status |Integer |否 |1 |脚本资产的启用状态，取值：

* `0`：禁用。

* `1`：启用。 | ## 返回参数下表仅列出本接口特有的返回参数。更多信息请参见 [返回结构](https://docs.volcengine.com/docs/Cloudphone/OpenAPICallInstructions-1)。 |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |ScriptId |Long |1001 |脚本资产的 ID。 | |AgentType |String |mua |脚本资产的类型，取值：

* `mua`：MUA 智能体的脚本资产类型。

* `cua`：CUA 智能体的脚本资产类型。 | |Name |String |open\-app\-v2 |脚本资产的名称。 | |Description |String |新版本说明 |脚本资产的说明。 | |Script |String |tap(500, 800)\nwait(3)\ntake_screenshot() |脚本资产的文本内容。 | |Resolution |String |1920x1080 |脚本资产的屏幕分辨率。 | |Status |Integer |1 |脚本资产的启用状态，取值：

* `0`：禁用。

* `1`：启用。 | |CreatedAt |Long |1785738100 |脚本资产的创建时间，Unix 时间戳，单位为秒。 | |UpdatedAt |Long |1785739100 |脚本资产的更新时间，Unix 时间戳，单位为秒。 | ## 请求示例 ```JSON POST https://open.volcengineapi.com?Action=UpdateAgentRunScript&Version=2023-08-01 { "ScriptId": 1001, "Name": "open-app-v2", "Description": "新版本说明", "Script": "tap(500, 800)\nwait(3)\ntake_screenshot()", "Resolution": "1920x1080", "Status": 1 } ``` ## 返回示例 ```JSON { "ResponseMetadata": { "RequestId": "2026082512***", "Action": "UpdateAgentRunScript", "Version": "2023-08-01", "Service": "ipaas", "Region": "cn-north-1" }, "Result": { "ScriptId": 1001, "AgentType": "mua", "Name": "open-app-v2", "Description": "新版本说明", "Script": "tap(500, 800)\nwait(3)\ntake_screenshot()", "Resolution": "1920x1080", "Status": 1, "CreatedAt": 1785738100, "UpdatedAt": 1785739100 } } ``` ## 错误码 MUA OpenAPI 错误码请参见 [错误码](https://docs.volcengine.com/docs/Cloudphone/errorcode-2)。

云手机