创建分析任务 - CreateOpsAnalysisTask

agentarts:analysisTask:createOpsAnalysisTask

Write

analysisTask *

-

-

-

-

• g:RequestTag/<tag-key>

• g:TagKeys

name

是

String

参数解释：

任务名称，用于标识和区分不同的分析任务。

约束限制：

不涉及

取值范围：

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

默认取值：

无

description

否

String

参数解释：

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

约束限制：

不涉及

取值范围：

长度0-1024个字符。

默认取值：

无

agent

是

OpsAnalysisTaskAgent object

参数解释：

分析任务智能体。

约束限制：

不涉及

取值范围：

不涉及。

默认取值：

无。

execution_strategy

是

OpsExecutionStrategy object

参数解释：

执行策略配置。

约束限制：

不涉及

取值范围：

不涉及。

默认取值：

无。

sample_strategy

是

OpsSampleStrategy object

参数解释：

采样策略配置。

约束限制：

不涉及

取值范围：

不涉及。

默认取值：

无。

agency_name

是

String

参数解释：

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

约束限制：

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

取值范围：

合法的委托名称字符串。

默认取值：

无

tags

否

Array of OpsTasksTagForTMS objects

参数解释：

资源标签列表，用于资源分类。

约束限制：

不涉及

取值范围：

数组长度0-20。

默认取值：

空数组

type

是

String

参数解释：

智能体类型。

约束限制：

不涉及

取值范围：

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

默认取值：

无

id

是

String

参数解释：

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

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

约束限制：

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

取值范围：

有效标识符字符串。

默认取值：

无

start_time

是

Long

参数解释：

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

约束限制：

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

取值范围：

13位毫秒级时间戳。

默认取值：

无。

end_time

是

Long

参数解释：

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

约束限制：

无。

取值范围：

13位毫秒级时间戳。

默认取值：

无。

repeat

是

Boolean

参数解释：

是否重复执行。

约束限制：

无。

取值范围：

true或者false。

默认取值：

false。

repeat_type

否

String

参数解释：

重复周期类型。

约束限制：

无。

取值范围：

daily：天重复，weekly：周重复。

默认取值：

无。

repeat_interval

否

Integer

参数解释：

重复周期。

约束限制：

无。

取值范围：

1到6之间的数字。

默认取值：

无。

day_of_week

否

Integer

参数解释：

周重复时，每周几执行。

约束限制：

仅 repeat_type=weekly 时必填且非 null；repeat_type=daily 时必须为 null（或不传该字段）。无语义即 null。

取值范围：

1到7之间的数字，分别代表周一到周日；daily 场景为 null。

默认取值：

无。

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为其他值时无意义。

取值范围：

默认取值：

无。

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-1024个字符。

agent

OpsAnalysisTaskAgent object

参数解释：

分析任务智能体。

取值范围：

不涉及。

agency_name

String

参数解释：

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

取值范围：

合法的委托名称字符串。

status

String

参数解释：

任务状态。

取值范围：

draft：草稿态，scheduled：待运行，running：运行中，paused：已暂停，completed：已完成，fail：失败，stopping：停止中，stopped：已停止。

created_at

Long

参数解释：

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

取值范围：

13位毫秒级时间戳。

updated_at

Long

参数解释：

更新时间（单位：毫秒）

取值范围：

13位毫秒级时间戳。

next_fire_time

Long

参数解释：

计划下次执行时间。对于待运行、运行中的周期任务，显示下一个task instance时间。对于其他状态的周期任务为null。对待运行的单次任务显示计划运行时间。无后续调度时为 null。

取值范围：

13位毫秒级时间戳或 null。

tags

Array of OpsTasksTagForTMS objects

参数解释：

资源标签列表，用于资源分类。

取值范围：

数组长度0-20。

progress

OpsTaskProgress object

参数解释：

当前分析任务的进度

取值范围：

不涉及

execution_strategy

OpsExecutionStrategy object

参数解释： 执行策略配置。 取值范围： 不涉及。

status_count

OpsAnalysisTaskInstanceStatusCount object

参数解释： 各个状态下的分析任务task-instance总数 取值范围： 不涉及

sample_strategy

OpsSampleStrategy object

参数解释：

采样策略配置。

取值范围：

不涉及。

failures

Array of OpsFailureCategory objects

参数解释：

故障列表。

取值范围：

长度为0-100的数组。

input_tokens

Long

参数解释： 输入的 Token 数。

取值范围： 无。任务未执行过时为 null。

output_tokens

Long

参数解释： 模型输出的 Token 数。

取值范围：

取值范围： 无。任务未执行过时为 null。

total_session_count

Integer

参数解释： 分析覆盖的session总数。

取值范围： 无。

type

String

参数解释：

智能体类型。

取值范围：

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

id

String

参数解释：

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

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

取值范围：

有效标识符字符串。

key

String

参数解释：

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

取值范围：

最大长度128个unicode字符。

value

String

参数解释：

标签值，具体的分类值。

取值范围：

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

total

Integer

参数解释：

对于周期任务，表示总计计划执行的次数。

对于运行中的单次任务，值为计划要分析的trace条数。

对还未开始运行的单次任务，值为null。

取值范围： null或0-5000

progressed

Integer

参数解释：

对于周期任务，表示已经处理的次数。

对于运行中的单次任务，值为已经分析的trace条数。

对还未开始运行的单次任务，值为0。

取值范围： 0-5000

progress_rate

Integer

参数解释：

进度百分比

取值范围：

0-100

start_time

Long

参数解释：

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

取值范围：

13位毫秒级时间戳。

end_time

Long

参数解释：

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

取值范围：

13位毫秒级时间戳。

repeat

Boolean

参数解释：

是否重复执行。

取值范围：

true或者false。

repeat_type

String

参数解释：

重复周期类型。

取值范围：

daily：天重复，weekly：周重复。

repeat_interval

Integer

参数解释：

重复周期。

取值范围：

1到6之间的数字。

day_of_week

Integer

参数解释：

周重复时，每周几执行。

取值范围：

1到7之间的数字，分别代表周一到周日；daily 场景为 null。

scheduled

Integer

参数解释： 待运行task_instance个数。 取值范围： 0-30的整数。

running

Integer

参数解释： 运行中task_instance个数。 取值范围： 0-30的整数。

skipped

Integer

参数解释： 跳过task_instance个数。 取值范围： 0-30的整数。

success

Integer

参数解释： 成功完成task_instance个数。 取值范围： 0-30的整数。

fail

Integer

参数解释： 运行失败task_instance个数。 取值范围： 0-30的整数。

stopped

Integer

参数解释： 已停止task_instance个数。 取值范围： 0-30的整数。

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

参数解释：

标签名。

取值范围：

value

AnyType

参数解释：

筛选的值。

取值范围：

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

• 数字：整数或浮点数。

• 布尔：true或false。

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

error_category_name

String

参数解释：

故障类别名称。

取值范围：

长度1-128个字符。

affected_session_count

Integer

参数解释：

故障影响的会话个数。

取值范围：

大小为0到10000。

sub_categories

Array of OpsFailureSubCategory objects

参数解释：

子故障类别列表。

取值范围：

长度0-100的数组。

error_sub_category_name

String

参数解释：

故障类别名称。

取值范围：

长度1-128个字符。

affected_session_count

Integer

参数解释：

故障影响的会话个数。

取值范围：

大小为0到10000。

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

服务器错误。