创建代理运行配置 CreateAgentRunConfig--云手机-火山引擎

文档中心

立即注册

云手机

请输入

配置管理

创建代理运行配置 CreateAgentRunConfig

运行代理任务之前，您需要先调用该接口创建代理运行配置。单个火山引擎账号下该配置唯一。

使用说明

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

注意事项

单个火山引擎账号下，仅支持创建一个代理运行配置。
如果您需要使用指定的对象存储（TOS），则需同时传入 TosBucket、TosEndpoint、TosRegion 参数。
如果不传入 TosBucket、TosEndpoint、TosRegion 参数，会使用默认的 TOS，默认 TOS 不会持久化存储任务的截屏信息，任务完成后会立马删除。
本接口整体 QPS 限制为 50 次/秒、单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流。

请求说明

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

请求参数

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

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

Query

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

Body

参数	类型	是否必选	示例值	描述
TosBucket	String	否	my-bucket	对象存储 TOS 存储桶名称。
TosEndpoint	String	否	tos-s3-cn-beijing.volces.com	对象存储 TOS 端点地址。
TosRegion	String	否	cn-beijing	对象存储 TOS 区域。

返回参数

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

参数	类型	示例值	描述
ConfigId	int	8510	配置 ID，是代理运行配置的唯一标识。
Tips	string	agent run config already exists, please call update API to modify	提示信息。例如，重复创建代理运行配置时，该参数会返回相应的提示信息。

请求示例

POST https://open.volcengineapi.com?Action=CreateAgentRunConfig&Version=2023-08-01
{
        "TosBucket": "my-bucket",
        "TosEndpoint": "tos-s3-cn-beijing.volces.com",
        "TosRegion": "cn-beijing"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "CreateAgentRunConfig",
        "Version": "2023-08-01",
        "Service": "ipaas",
        "Region": "cn-north-1"
    },
    "Result":{
        "ConfigId": 8510,
        "Tips": "agent run config already exists, please call update API to modify",
    }
}

错误码

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

最近更新时间：2025.12.30 15:29:13

这个页面对您有帮助吗？

有用

无用

云手机