文档中心

云手机

请输入

运行资产管理

查询脚本资产列表 ListAgentRunScript

查询已创建的脚本资产列表，支持分页查询，每条脚本资产返回当前已启用的最新版本详细信息。

使用说明

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

注意事项

本接口整体 QPS 限制为 100 次/秒、单用户 QPS 限制为 20 次/秒。超过限制，API 调用会被限流。

请求说明

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

请求参数

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

Header

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

Query

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

Body

参数	类型	是否必选	示例值	描述
ScriptId	Long	否	1001	按脚本资产 ID 精准筛选，您可以通过 CreateAgentRunScript 接口获取。
AgentType	String	否	cua	脚本资产的类型，取值：注意当前场景下，必须填写为 cua。 mua：（默认）MUA 智能体的脚本资产类型。 cua：CUA 智能体的脚本资产类型。
Resolution	String	否	1920x1080	脚本资产的屏幕分辨率，格式为宽x高，宽和高的取值范围均为 1～16384。
Status	Integer	否	1	脚本资产的启用状态，取值： 0：禁用。 1：启用。
SearchField	String	否	name	搜索字段，取值： description：按脚本资产的说明 Description 搜索。 name：按脚本资产的名称 Name 搜索。 script：按脚本资产的文本内容 Script 搜索。不传时默认按脚本资产名称 Name 搜索。说明您可以调用 GetAgentRunScript 接口获取 Description、Name、Script。
Keyword	String	否	open	搜索的关键词，与 SearchField 配合使用模糊查询。
Limit	Integer	否	10	每页返回的条数，取值范围为 1～100，默认值为 10。
Offset	Integer	否	1	页码，默认值为 1。

返回参数

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

参数	类型	示例值	描述
Total	Integer	1	满足筛选条件的脚本资产总数量。
List	Array	[]	脚本资产列表，每个元素为一条脚本资产的详细信息，数据结构请参见 AgentRunScriptInfo。

AgentRunScriptInfo

参数	类型	示例值	描述
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 错误码请参见错误码。

最近更新时间：2026.10.30 10:33:47

这个页面对您有帮助吗？

有用

无用