创建一条可复用的 CUA ScriptRun 脚本资产，在自动化任务中可以引用并执行。

ScriptRun：是 CUA 的一种运行模式，按脚本执行——您预先写好一段操作脚本（比如点击、等待、截图），任务启动时按脚本逐行执行。

使用说明

调用 CUA OpenAPI 前，必须先访问跨服务访问请求为您的账号授权。

注意事项

创建成功后，您可以调用一键运行代理任务 RunAgentTaskOneStep 或运行代理任务 RunAgentTask 接口，通过 RunMode=ScriptRun，同时传 ScriptId=<创建接口返回的脚本资产 ID> 来引用脚本资产。

请求说明

请求地址：https://open.volcengineapi.com?Action=CreateAgentRunScript&Version=2023-08-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Header

参数	类型	是否必选	示例值	描述
Content-Type	String	是	application/json	请求头信息。

Query

参数	类型	是否必选	示例值	描述
Action	String	是	CreateAgentRunScript	接口名称。当前 API 的名称为 CreateAgentRunScript。
Version	String	是	2023-08-01	接口版本。当前 API 的版本为 2023-08-01。

Body

参数	类型	是否必选	示例值	描述
Name	String	是	open-app	脚本资产的名称，长度为 1～128 个字符。
AgentType	String	是	cua	脚本资产的类型，取值：注意当前场景下，必须填写为 cua。 mua：（默认）MUA 智能体的脚本资产类型。 cua：CUA 智能体的脚本资产类型。
Script	String	条件必选	tap(500,800)\nwait(2)	脚本资产的文本内容。写法请参见 Script 脚本内容规范。大小不超过 100 KB，有效操作指令不超过 500 行。注意 Script 与 File 两者必须传其一，不可以同时传入或同时不传。
File	File	条件必选	demo.script	脚本资产的文件。文件内容写法请参见 Script 脚本内容规范，CUA 将直接读取文件内容作为脚本执行。请以文件形式上传，支持 .script 等文本格式文件。注意 Script 与 File 两者必须传其一，不可以同时传入或同时不传。
Description	String	否	打开应用并截图	脚本资产的说明，长度为 0～2048 个字符。不传或传入空字符串时，表示不填写说明。
Resolution	String	否	1920x1080	脚本资产的屏幕分辨率，格式为宽x高，宽和高的取值范围均为 1～16384。默认为空，表示不设置屏幕分辨率。
Status	Integer	否	1	脚本资产的启用状态，取值： 0：禁用。 1：（默认）启用。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
ScriptId	Long	1001	脚本资产的 ID。
AgentType	String	cua	脚本资产的类型，取值： mua：MUA 智能体的脚本资产类型。 cua：CUA 智能体的脚本资产类型。
Name	String	open-app	脚本资产的名称。
Description	String		脚本资产的说明。
Script	String	tap(500,800)\nwait(2)	脚本资产的文本内容。
Resolution	String	1920x1080	脚本资产的屏幕分辨率。
Status	Integer	1	脚本资产的启用状态，取值： 0：禁用。 1：启用。
CreatedAt	Long	1785738000	脚本资产的创建时间，Unix 时间戳，单位为秒。
UpdatedAt	Long	1785739000	脚本资产的更新时间，Unix 时间戳，单位为秒。

请求示例

返回示例

错误码

CUA OpenAPI 错误码请参见错误码。