文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 智能体优化/ 工具/Skill优化/ 执行智能体优化任务 - ExecuteOpsAgentTuningTask
更新时间:2026-11-09 GMT+08:00
分享

执行智能体优化任务 - ExecuteOpsAgentTuningTask

功能介绍

本接口用于正式触发处于草稿状态的任务,进入实际优化迭代阶段。

调用方法

请参见如何调用API。

授权信息

账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts:agentTuningTask:executeOpsAgentTuningTask

Write

agentTuningTask *

g:ResourceTag/<tag-key>

-

-

URI

POST https://agentarts.region_id.myhuaweicloud.com/v1/ops/agent-tuning-tasks/{agent_tuning_task_id}/execute

表1 路径参数

参数

是否必选

参数类型

描述

agent_tuning_task_id

是

String

参数解释:

智能体优化任务ID,标识任务的唯一标识符。获取方法请参考查询智能体优化任务列表。

约束限制:

不涉及

取值范围:

长度为32的ID字符串,最小长度32,最大长度32。

默认取值:

无

请求参数

无

响应参数

状态码:204

操作成功。

状态码:403

表2 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:机器可读的错误代码。

取值范围:系统错误码字符串。

error_msg

String

参数解释:人类可读的错误消息。

取值范围:详细错误说明字符串。

encoded_authorization_message

String

参数解释:编码后的授权失败信息。

取值范围:字符串。

details

Array of OpsRLCommonError objects

参数解释:依赖的下游服务错误信息列表。

取值范围:包含error_code和error_msg的对象数组。

表3 OpsRLCommonError

参数

参数类型

描述

error_code

String

参数解释:

机器可读的错误代码。

取值范围:

系统错误码字符串。

error_msg

String

参数解释:

人类可读的错误消息。

取值范围:

详细错误说明字符串。

状态码:404

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

机器可读的错误代码。

取值范围:

系统错误码字符串。

error_msg

String

参数解释:

人类可读的错误消息。

取值范围:

详细错误说明字符串。

状态码:409

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

机器可读的错误代码。

取值范围:

系统错误码字符串。

error_msg

String

参数解释:

人类可读的错误消息。

取值范围:

详细错误说明字符串。

状态码:429

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

机器可读的错误代码。

取值范围:

系统错误码字符串。

error_msg

String

参数解释:

人类可读的错误消息。

取值范围:

详细错误说明字符串。

状态码:500

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

机器可读的错误代码。

取值范围:

系统错误码字符串。

error_msg

String

参数解释:

人类可读的错误消息。

取值范围:

详细错误说明字符串。

请求示例

用于正式触发处于草稿状态的任务。

POST /v1/ops/agent-tuning-tasks/57ae91cf2f504899921a50d1c75f0547/execute

响应示例

无

状态码

状态码

描述

204

操作成功。

403

权限不足,拒绝访问。

404

智能体优化任务未找到。

409

智能体优化任务不可执行。

429

请求频率超限。

500

内部服务器错误。

错误码

请参见错误码。

相关文档