通过指定代理运行配置 ID，更新已创建的代理运行配置。 ## 使用说明 * 调用 Computer Use Agent OpenAPI 前，必须先访问 [跨服务访问请求](https://console.volcengine.com/iam/service/attach_role/?ServiceName=ipaas) 为您的账号授权。 * 请求参数中： * 通过 `Id` 指定需要更新的代理运行配置。 * 其他参数用于更新配置，可选传入，如果不传值则表示不更新。 ## 注意事项本接口整体 **QPS 限制为 50 次/秒**、单用户 **QPS 限制为 10 次/秒**。超过限制，API 调用会被限流。 ## 请求说明 * 请求方式：POST * 请求地址：https://open.volcengineapi.com?Action=UpdateAgentRunConfig&Version=2023\-08\-01 ## 请求参数下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见 [公共参数](https://www.volcengine.com/docs/6369/67268)。 ### Header |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Content\-Type |String |是 |application/json |请求头信息。 | ### Query |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |UpdateAgentRunConfig |接口名称。当前 API 的名称为 `UpdateAgentRunConfig`。 | |Version |String |是 |2023\-08\-01 |接口版本。当前 API 的版本为 `2023-08-01`。 | ### Body |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Id |Integer |是 |7294\*\*\* |代理运行配置 ID，您可以调用 [ListAgentRunConfig](https://docs.volcengine.com/docs/6394/2553739) 接口获取。 | |AgentType |String |是 |cua |Agent 类型，此场景下仅支持 `cua`。 | |ProjectName |String |否 |project\-a |项目名称，传入后仅更新指定项目的代理运行配置。

注意

若项目名称与代理运行配置不匹配，则不更新任何配置。

| |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 |否 |artifacts |存储桶的用途标识，可修改已有配置的用途类型。可选值如下：

* `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)。 ## 请求示例 ```JSON POST https://open.volcengineapi.com?Action=UpdateAgentRunConfig&Version=2023-08-01 { "Id": 7294***, "AgentType": "cua", "TosBucket": "my-bucket", "TosEndpoint": "tos-s***", "TosRegion": "cn-beijing", "UseCase": "artifacts" } ``` ## 返回示例 ```JSON { "ResponseMetadata": { "RequestId": "20230604110420****100232280022D31", "Action": "UpdateAgentRunConfig", "Version": "2023-08-01", "Service": "ipaas", "Region": "cn-north-1" }, "Result": null } ``` ## 错误码 Computer Use Agent OpenAPI 错误码请参见 [错误码](https://www.volcengine.com/docs/6394/2558652)。

云手机