用于创建一个新的代理运行配置。创建成功后，CUA 可以基于该配置管理运行过程中产生的截图、任务产物或技能相关文件。 ## 使用说明调用 Computer Use Agent OpenAPI 前，必须先访问 [跨服务访问请求](https://console.volcengine.com/iam/service/attach_role/?ServiceName=ipaas) 为您的账号授权。 ## 注意事项 * 如果您需要使用指定的对象存储（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 ## 请求参数下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见 [公共参数](https://www.volcengine.com/docs/6369/67268)。 ### Header |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Content\-Type |String |是 |application/json |请求头信息。 | ### Query |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |CreateAgentRunConfig |接口名称。当前 API 的名称为 `CreateAgentRunConfig`。 | |Version |String |是 |2023\-08\-01 |接口版本。当前 API 的版本为 `2023-08-01`。 | ### Body |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |AgentType |String |是 |cua |Agent 类型，此场景下仅支持 `cua`。 | |ProjectName |String |否 |project\-a |项目名称，传入后代理运行配置仅对指定项目生效；不传或传空字符串时，代理运行配置将作为当前账号下所有 CUA 项目的默认配置，各项目若有单独配置则优先使用各自的配置。 | |TosBucket |String |否 |my\-bucket |对象存储 TOS 存储桶名称，您可以参见 [创建存储配置](https://docs.volcengine.com/docs/6394/2550939#xl494aZu) 获取存储桶名称。 | |TosEndpoint |String |否 |tos\-s\*\*\* |对象存储 TOS 访问域名，您可以参见 [创建存储配置](https://docs.volcengine.com/docs/6394/2550939#xl494aZu) 获取访问域名。 | |TosRegion |String |否 |cn\-beijing |对象存储 TOS 区域，您可以参见 [创建存储配置](https://docs.volcengine.com/docs/6394/2550939#xl494aZu) 获取区域。 | |UseCase |String |否 |screenshots |存储桶的用途标识，支持在同一账号下按不同用途创建多条配置。可选值如下：

* `screenshots`：（默认值）截图，指 CUA 运行过程中产生的截图。

* `artifacts`：产物，指 CUA 运行过程中生成的文件等。

* `skill`：技能，指 CUA 所使用的技能。 | ## 返回参数下表仅列出本接口特有的返回参数。更多信息请参见 [返回结构](https://www.volcengine.com/docs/6394/75713#%E8%BF%94%E5%9B%9E%E7%BB%93%E6%9E%9C)。 |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |ConfigId |Int |7294\*\*\* |配置 ID，是代理运行配置的唯一标识。 | ## 请求示例 ```JSON POST https://open.volcengineapi.com?Action=CreateAgentRunConfig&Version=2023-08-01 { "AgentType": "cua", "ProjectName": "project-a", "TosBucket": "my-bucket", "TosEndpoint": "tos-s***", "TosRegion": "cn-beijing", "UseCase": "screenshots" } ``` ## 返回示例 ```JSON { "ResponseMetadata": { "RequestId": "20230604110420****100232280022D31", "Action": "CreateAgentRunConfig", "Version": "2023-08-01", "Service": "ipaas", "Region": "cn-north-1" }, "Result":{ "ConfigId": 7294*** } } ``` ## 错误码 Computer Use Agent OpenAPI 错误码请参见 [错误码](https://www.volcengine.com/docs/6394/2558652)。

云手机