创建智能体优化任务 - CreateOpsAgentTuningTask

agentarts:agentTuningTask:createOpsAgentTuningTask

Write

agentTuningTask *

-

-

-

-

• g:RequestTag/<tag-key>

• g:TagKeys

name

是

String

参数解释：

任务名称，用于标识和区分不同的智能体优化任务。

约束限制：

不涉及

取值范围：

长度2-64个字符，支持中文、字母、数字、中划线及下划线。

默认取值：

无

description

否

String

参数解释：

任务的详细描述，用于记录任务目的或备注信息。

约束限制：

不涉及

取值范围：

长度0-1024个字符。

默认取值：

无

type

是

String

参数解释：

任务类型，用于根据类型筛选任务。

约束限制：

不涉及 。

取值范围：

tool：工具，skill：技能。

默认取值：

无。

agent

是

OpsAgentTuningTaskAgent object

参数解释：

智能体优化任务智能体。

约束限制：

不涉及

取值范围：

不涉及。

默认取值：

无。

tuning_target

是

OpsTuningTarget object

参数解释：

智能体优化任务的对象配置。

约束限制：

不涉及

取值范围：

不涉及。

默认取值：

无。

sample_duration

是

OpsSampleDuration object

参数解释：

采样时间范围配置。

约束限制：

不涉及

取值范围：

不涉及。

默认取值：

无。

sample_strategy

是

OpsSampleStrategy object

参数解释：

采样策略配置。

约束限制：

不涉及

取值范围：

不涉及。

默认取值：

无。

agency_name

是

String

参数解释：

委托名称，赋予服务访问用户资源的权限。

约束限制：

必须是IAM中已创建的有效委托。

取值范围：

合法的委托名称字符串。

默认取值：

无

analysis_task_id

否

String

参数解释：

关联的分析任务ID，获取方法请参考查询分析任务列表。

约束限制：

不涉及

取值范围：

分析任务ID字符串，最小长度0，最大长度32。

默认取值：

无

error_sub_category_name

否

String

参数解释：

错误子分类名称，用于标识优化任务针对的具体错误类型。

约束限制：

不涉及

取值范围：

错误子分类名称字符串，最小长度1，最大长度128。

默认取值：

无

tags

否

Array of OpsTasksTagForTMS objects

参数解释：

资源标签列表，用于资源分类，默认为空数组。

约束限制：

数组长度0-20。

取值范围：

不涉及。

默认取值：

不涉及。

type

是

String

参数解释：

智能体类型。

约束限制：

不涉及

取值范围：

agent：单智能体，workflow：工作流，agentrun：部署在运行时的智能体，third_party：三方接入观测的智能体。

默认取值：

无

id

是

String

参数解释：

智能体ID，对应AgentArts平台中的智能体实例。

可在AgentArts平台“开发中心 > 智能体管理”页面获取ID，注意对应的智能体需要是“已提交”状态。

约束限制：

必须是系统中存在的真实ID。

取值范围：

有效标识符字符串，最小长度0，最大长度64。

默认取值：

无

agent_type

否

String

参数解释：

观测侧智能体资源类型，agentrun/third_party类型的智能体对应观测侧agent/multiagents/workflow，用于数据面按观测侧resource_type查询轨迹。

约束限制：

不涉及

取值范围：

agent：单智能体，multiagents：多智能体，workflow：工作流。

默认取值：

无

tools

否

Array of OpsTool objects

参数解释：

待优化的工具列表，type为tool时必填，默认为空数组。

约束限制：

数组长度0-10。

取值范围：

不涉及。

默认取值：

不涉及。

skills

否

Array of OpsSkill objects

参数解释：

待优化的技能列表，type为skill时必填，数组长度0-10。

约束限制：

不涉及

取值范围：

不涉及。

默认取值：

不涉及。

name

是

String

参数解释：

工具的名称。

约束限制：

不涉及。

取值范围：

长度在1-256个字符。

默认取值：

无。

description

是

String

参数解释：

工具的描述内容。

约束限制：

不涉及。

取值范围：

长度在1-10000个字符。

默认取值：

无。

name

是

String

参数解释：

技能的名称。

约束限制：

不涉及。

取值范围：

长度在1-256个字符。

默认取值：

无。

description

是

String

参数解释：

技能的描述内容。

约束限制：

不涉及。

取值范围：

长度在0-1024个字符。

默认取值：

无。

content

是

String

参数解释：

技能的SKILL.md文件内容。

约束限制：

不涉及。

取值范围：

长度在1-10000个字符。

默认取值：

无。

start_time

否

Long

参数解释：

开始时间（单位：毫秒数）

约束限制：

不超过当前时间的前31天。

取值范围：

13位毫秒级时间戳，最小值0，最大值9223372036854775807。

默认取值：

无。

end_time

否

Long

参数解释：

结束时间（单位：毫秒数）

约束限制：

不超过当前时间。

取值范围：

13位毫秒级时间戳，最小值0，最大值9223372036854775807。

默认取值：

无。

sample_ratio

否

Integer

参数解释：

数据采样率。

约束限制：

不涉及

取值范围：

数值在1到100之间。

默认取值：

100。

max_sample_count

否

Integer

参数解释：

最大数据采样个数。

约束限制：

不涉及

取值范围：

数值在1到500之间。

默认取值：

100。

filters

否

Array of OpsSampleFilter objects

参数解释：

数据采样的筛选条件。

约束限制：

不涉及

取值范围：

数组长度0-5。

默认取值：

空数组。

filter_sign

否

String

参数解释：

连接标识，用于标明查询语句中条件之间且或者或的关系。

约束限制：

不涉及

取值范围：

and，or

默认取值：

and

field

是

String

参数解释：

过滤名，指定要过滤的字段名称。

约束限制：

不涉及

取值范围：

Duration,Label,Input,Output

默认取值：

无。

operator

是

String

参数解释：

操作符。

约束限制：

对不同的field类型，支持不同的操作符。

Duration：greater_than：大于等于，less_than：小于等于

Input：like：包含，not_like：不包含

Output：like：包含，not_like：不包含

Label：greater_than：大于等于，less_than：小于等于，like：包含，not_like：不包含，in：属于，not_in：不属于

取值范围：

like：包含，not_like：不包含，equals：等于，empty：为空，not_empty：不为空，greater_than：大于等于，less_than：小于等于，in：属于，not_in：不属于

默认取值：

无。

label_name

否

String

参数解释：

标签名。

约束限制：

当field为Label时必填。field为其他值时无意义。

取值范围：

标签名字符串，最小长度1，最大长度64。

默认取值：

无。

value

否

AnyType

参数解释：

筛选的值。

约束限制：

值类型取决于操作符字段（operator）：

字符串(string)、数字(number)、布尔(boolean)或字符串数组(array)。

greater_than，less_than：数字(number)

like，not_like：字符串(string)

equals：数字(number) 或 字符串(string)

empty，not_empty：不传递该字段

in，not_in：字符串数组(array)

取值范围：

• 字符串：长度0-64个字符。

• 数字：整数或浮点数。

• 布尔：true或false。

• 数组：长度0-20，每个元素长度0-64个字符的字符串。

默认取值：

无。

key

是

String

参数解释：

标签键，标识资源的分类维度。

约束限制：

不能为空或者空字符串，不能为空格，校验和使用之前先trim前后半角空格。最大长度128个unicode字符。

取值范围：

最大长度128个unicode字符。

默认取值：

无

value

是

String

参数解释：

标签值，具体的分类值。

约束限制：

不校验字符集范围。

取值范围：

不校验字符集范围。每个值最大长度255个unicode字符。

默认取值：

无

id

String

参数解释：

智能体优化任务ID。

取值范围：

UUID格式字符串。

name

String

参数解释：

任务名称。

取值范围：

长度1-64个字符的字符串。

description

String

参数解释：

任务描述。

取值范围：

长度0-255个字符的字符串。

type

String

参数解释：

任务类型，用于根据类型筛选任务。

取值范围：

tool：工具，skill：技能。

agent

OpsAgentTuningTaskAgent object

参数解释：

智能体优化任务智能体。

取值范围：

不涉及。

agency_name

String

参数解释：

委托名称，赋予服务访问用户资源的权限。

取值范围：

有效的IAM委托名称字符串。

analysis_task_id

String

参数解释：

分析任务ID，通过分析任务一键优化创建出来的智能体优化任务该字段不为空。

取值范围：

有效分析任务ID。

status

String

参数解释：

任务状态。

取值范围：

draft：草稿态，running：运行中，stopping：停止中，stopped：已停止，success：成功，fail：失败。

fail_reason

String

参数解释：

失败的错误信息。

取值范围：

无。

created_at

Long

参数解释：

创建时间，单位：毫秒（13位时间戳）。

取值范围：

13位毫秒级时间戳，最小值0，最大值9223372036854775807。

updated_at

Long

参数解释：

更新时间（单位：毫秒）。

取值范围：

13位毫秒级时间戳，最小值0，最大值9223372036854775807。

executed_at

Long

参数解释：

执行时间，单位：毫秒（13位时间戳）。

取值范围：

13位毫秒级时间戳，最小值0，最大值9223372036854775807。

end_at

Long

参数解释：

执行结束时间，单位：毫秒（13位时间戳）。

取值范围：

13位毫秒级时间戳，最小值0，最大值9223372036854775807。

executed_time

Integer

参数解释：

运行时长，单位：分钟。

取值范围：

大于等于0的整数（单位：分钟）

tags

Array of OpsTasksTagForTMS objects

参数解释：

资源标签列表，符合OpsTasksTagForTMS定义的对象数组。

取值范围：

不涉及。

tuning_target

OpsTuningTarget object

参数解释：

智能体优化任务的对象配置。

取值范围：

不涉及。

tuning_output

OpsTuningOutput object

参数解释：

智能体优化任务的输出。

取值范围：

不涉及。

sample_duration

OpsSampleDuration object

参数解释：

采样时间范围配置。

取值范围：

不涉及。

sample_strategy

OpsSampleStrategy object

参数解释：

采样策略配置。

取值范围：

不涉及。

input_tokens

Integer

参数解释：

输入的 Token 数。

取值范围：

无。

output_tokens

Integer

参数解释：

模型输出的 Token 数。

取值范围：

无。

type

String

参数解释：

智能体类型。

取值范围：

agent：单智能体，workflow：工作流，agentrun：部署在运行时的智能体，third_party：三方接入观测的智能体。

id

String

参数解释：

智能体ID，对应AgentArts平台中的智能体实例。

可在AgentArts平台“开发中心 > 智能体管理”页面获取ID，注意对应的智能体需要是“已提交”状态。

取值范围：

有效标识符字符串，最小长度0，最大长度64。

agent_type

String

参数解释：

观测侧智能体资源类型，agentrun/third_party类型的智能体对应观测侧agent/multiagents/workflow，用于数据面按观测侧resource_type查询轨迹。

取值范围：

agent：单智能体，multiagents：多智能体，workflow：工作流。

key

String

参数解释：

标签键，标识资源的分类维度。

取值范围：

最大长度128个unicode字符。

value

String

参数解释：

标签值，具体的分类值。

取值范围：

不校验字符集范围。每个值最大长度255个unicode字符。

tools

Array of OpsTool objects

参数解释：

待优化的工具列表，type为tool时必填，默认为空数组。

取值范围：

不涉及。

skills

Array of OpsSkill objects

参数解释：

待优化的技能列表，type为skill时必填，数组长度0-10。

取值范围：

不涉及。

name

String

参数解释：

工具的名称。

取值范围：

长度在1-256个字符。

description

String

参数解释：

工具的描述内容。

取值范围：

长度在1-10000个字符。

name

String

参数解释：

技能的名称。

取值范围：

长度在1-256个字符。

description

String

参数解释：

技能的描述内容。

取值范围：

长度在0-1024个字符。

content

String

参数解释：

技能的SKILL.md文件内容。

取值范围：

长度在1-10000个字符。

tools

Array of OpsToolOutput objects

参数解释：

优化后的工具列表，数组长度0-10。

取值范围：

不涉及。

skills

Array of OpsSkillOutput objects

参数解释：

优化后的技能列表，type为skill时必填，数组长度0-10。

取值范围：

不涉及。

name

String

参数解释：

工具的名称。

取值范围：

长度在1-256个字符。

description

String

参数解释：

工具的描述内容。

取值范围：

长度在1-10000个字符。

explanation

String

参数解释：

优化的原因。

取值范围：

长度在0-4096个字符。

name

String

参数解释：

技能的名称。

取值范围：

长度在1-256个字符。

description

String

参数解释：

技能的描述内容。

取值范围：

长度在1-1024个字符。

content

String

参数解释：

技能的SKILL.md文件内容。

取值范围：

长度在1-10000个字符。

explanation

String

参数解释：

优化的原因。

取值范围：

长度在0-4096个字符。

start_time

Long

参数解释：

开始时间（单位：毫秒数）

取值范围：

13位毫秒级时间戳，最小值0，最大值9223372036854775807。

end_time

Long

参数解释：

结束时间（单位：毫秒数）

取值范围：

13位毫秒级时间戳，最小值0，最大值9223372036854775807。

sample_ratio

Integer

参数解释：

数据采样率。

取值范围：

数值在1到100之间。

max_sample_count

Integer

参数解释：

最大数据采样个数。

取值范围：

数值在1到500之间。

filters

Array of OpsSampleFilter objects

参数解释：

数据采样的筛选条件。

取值范围：

数组长度0-5。

filter_sign

String

参数解释：

连接标识，用于标明查询语句中条件之间且或者或的关系。

取值范围：

and，or

field

String

参数解释：

过滤名，指定要过滤的字段名称。

取值范围：

Duration,Label,Input,Output

operator

String

参数解释：

操作符。

取值范围：

like：包含，not_like：不包含，equals：等于，empty：为空，not_empty：不为空，greater_than：大于等于，less_than：小于等于，in：属于，not_in：不属于

label_name

String

参数解释：

标签名。

取值范围：

标签名字符串，最小长度1，最大长度64。

value

AnyType

参数解释：

筛选的值。

取值范围：

• 字符串：长度0-64个字符。

• 数字：整数或浮点数。

• 布尔：true或false。

• 数组：长度0-20，每个元素长度0-64个字符的字符串。

error_code

String

参数解释：

机器可读的错误代码。

取值范围：

系统错误码字符串。

error_msg

String

参数解释：

人类可读的错误消息。

取值范围：

详细错误说明字符串。

error_code

String

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

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

error_msg

String

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

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

encoded_authorization_message

String

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

取值范围：字符串。

details

Array of OpsRLCommonError objects

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

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

error_code

String

参数解释：

机器可读的错误代码。

取值范围：

系统错误码字符串。

error_msg

String

参数解释：

人类可读的错误消息。

取值范围：

详细错误说明字符串。

error_code

String

参数解释：

机器可读的错误代码。

取值范围：

系统错误码字符串。

error_msg

String

参数解释：

人类可读的错误消息。

取值范围：

详细错误说明字符串。

error_code

String

参数解释：

机器可读的错误代码。

取值范围：

系统错误码字符串。

error_msg

String

参数解释：

人类可读的错误消息。

取值范围：

详细错误说明字符串。

error_code

String

参数解释：

机器可读的错误代码。

取值范围：

系统错误码字符串。

error_msg

String

参数解释：

人类可读的错误消息。

取值范围：

详细错误说明字符串。

200

智能体优化任务详情。

400

无效的请求体。

403

权限不足，拒绝访问。

409

优化任务已存在。

429

请求频率超限。

500

服务器错误。