查询评测集合成任务列表 - ListOpsSynthesisTasks
功能介绍
该接口用于分页查询当前租户下所有已提交的评测集合成异步任务,支持按任务名称、状态等多种过滤条件进行检索,提供任务执行进度。
适用场景:
URI
GET /v1/ops/datasets-synthesis
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
offset |
否 |
Integer |
参数解释: 分页查询的起始偏移量。用于指定从满足条件的第几条记录开始返回,常与 limit参数配合实现分页功能。 约束限制: 必须为整数,且大小在0到10,000 之间。 取值范围: 0-10000。 默认取值: 0。 |
|
limit |
否 |
Integer |
参数解释: 单次查询返回的最大记录数量。用于控制分页查询时每页显示的数据条数。 约束限制: 必须为整数,且大小在1到100之间。 取值范围: 1-100。 默认取值: 10。 |
|
status |
否 |
String |
参数解释: 任务状态过滤条件。用于筛选处于特定生命周期阶段的合成任务。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
|
name |
否 |
String |
参数解释: 任务名称检索字段。支持根据创建任务时自定义的名称进行筛选。 约束限制: 支持模糊匹配,字符串长度限制为0到100个字符。 取值范围: 0到100字符。 默认取值: 不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Content-Type |
是 |
String |
参数解释: 消息体编码格式。用于告知服务端请求体(Body)所采用的主体数据类型,以便服务端正确解析。 约束限制: 不涉及 取值范围: 不涉及 默认取值: application/json |
|
Authorization |
是 |
String |
参数解释: 签名认证信息,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
X-Sdk-Date |
是 |
String |
参数解释: 请求发送的时间,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
syntheses |
Array of EvaluationOpsSynthesisTaskSummary objects |
参数解释: 包含合成任务摘要信息的对象列表。 取值范围: 参考EvaluationOpsSynthesisTaskSummary定义。 |
|
total |
Integer |
参数解释: 符合当前筛选条件的任务总记录数。 取值范围: 0-500。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
参数解释: 合成任务的唯一标识符。 约束限制: 1-64 字符。 取值范围: UUID或系统生成的ID。 默认取值: 不涉及。 |
|
name |
String |
参数解释: 用户为合成任务定义的名称。 约束限制: 1-100字符。 取值范围: 任意字符串。 默认取值: 不涉及。 |
|
scenario_type |
String |
参数解释: 合成任务的技术场景类型。 约束限制: 枚举值。 取值范围: seed_data等。 默认取值: 不涉及。 |
|
scenario_name |
String |
参数解释: 场景的友好展示名称。 约束限制: 1-4000字符。 取值范围: 如 "基于种子数据泛化"。 默认取值: 不涉及。 |
|
scenario_description |
String |
参数解释: 合成任务背景的详细描述。 约束限制: 1-4000字符。 取值范围: 场景背景文本。 默认取值: 不涉及。 |
|
status |
String |
参数解释: 合成任务当前的生命周期状态。 约束限制: 枚举类型。 取值范围: pending, running, completed, failed, stopped。 默认取值: pending。 |
|
progress |
Integer |
参数解释: 当前合成进度百分比。 约束限制: 0-100 整数。 取值范围: 0-100。 默认取值: 0。 |
|
sample_count |
Integer |
参数解释: 预设需要生成的总样本数量。 约束限制: 1-500整数。 取值范围: 1-500。 默认取值: 1。 |
|
generated_count |
Integer |
参数解释: 截至当前已生成的有效样本数。 约束限制: 不大于sample_count。 取值范围: 0-500。 默认取值: 0。 |
|
model_config |
EvaluationOpsModelConfig object |
参数解释: 任务使用的模型配置。 约束限制: 参考EvaluationOpsModelConfig。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
seed_data |
EvaluationOpsSeedDataConfig object |
参数解释: 任务使用的种子数据配置。 约束限制: 参考EvaluationOpsSeedDataConfig。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
base_info |
EvaluationOpsTaskBaseInfo object |
参数解释: 任务基础元数据。 约束限制: 参考EvaluationOpsTaskBaseInfo。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
model_id |
String |
参数解释: 指定调用的大模型唯一标识符。 约束限制: 1-64个字符。 取值范围: 合法的模型ID字符串。 默认取值: 不涉及。 |
|
model_name |
String |
参数解释: 模型的显示名称。 约束限制: 2-100个字符。 取值范围: 任意字符串。 默认取值: 不涉及。 |
|
temperature |
Float |
参数解释: 采样温度参数,用于控制输出的随机性。数值低更聚焦,数值高更具创造性。 约束限制: 浮点数。 取值范围: 0.0到2.0。 默认取值: 0.7。 |
|
max_tokens |
Integer |
参数解释: 单次推理生成的最大Token数量限制。 约束限制: 1-32,000之间的整数。 取值范围: 1-32000。 默认取值: 2000。 |
|
top_p |
Float |
参数解释: 核采样参数。 约束限制: 浮点数。 取值范围: 0.0到1.0。 默认取值: 1.0。 |
|
frequency_penalty |
Float |
参数解释: 频率惩罚系数,降低内容重复倾向。 约束限制: 浮点数。 取值范围: -2.0到2.0。 默认取值: 0。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
type |
String |
参数解释: 种子数据的来源类型。 约束限制: 枚举值。 取值范围: dataset(评测集),file(文件)。 默认取值: 不涉及。 |
|
dataset_id |
String |
参数解释: 种子评测集的唯一ID。 约束限制: 0-64字符。 取值范围: 符合通用唯一识别码(UUID)标准的字符串。 默认取值: 不涉及。 |
|
dataset_name |
String |
参数解释: 种子评测集的展示名称。 约束限制: 0-200字符。 取值范围: 任意字符串。 默认取值: 不涉及。 |
|
dataset_version_id |
String |
参数解释: 种子评测集版本的内部唯一标识符。 约束限制: 0-64字符。 取值范围: 符合通用唯一识别码(UUID)标准的字符串。 默认取值: 不涉及。 |
|
dataset_version |
String |
参数解释: 种子评测集的可读版本号。 约束限制: 0-64字符。 取值范围: 如0.0.1。 默认取值: 不涉及。 |
|
file_name |
String |
参数解释: 作为种子源的临时文件名称。 约束限制: 1-200字符。 取值范围: 文件名。 默认取值: 不涉及。 |
|
obs_tmp_file_id |
String |
参数解释: 种子数据文件在对象存储中的路径。 约束限制: 最大长度10000字符。 取值范围: OBS路径。 默认取值: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
created_at |
String |
参数解释: 任务在系统中创建的时间戳。 约束限制: ISO8601标准。 取值范围: 日期时间字符串。 默认取值: 不涉及。 |
|
start_at |
String |
参数解释: 任务正式开始执行的精确时刻。 约束限制: ISO8601标准。 取值范围: 日期时间字符串。 默认取值: 不涉及。 |
|
updated_at |
String |
参数解释: 任务状态或元数据最后一次变更的时间。 约束限制: ISO8601标准。 取值范围: 日期时间字符串。 默认取值: 不涉及。 |
|
completed_at |
String |
参数解释: 任务执行完毕(无论成败)的时间。 约束限制: ISO8601标准。 取值范围: 日期时间字符串。 默认取值: 不涉及。 |
|
duration_seconds |
Long |
参数解释: 任务的有效运行总时长(秒)。 约束限制: 0到31,536,000 之间的整数。 取值范围: 非负整数。 默认取值: 0。 |
|
created_by |
UserInfoObj object |
参数解释: 创建该任务的用户详细信息。 约束限制: 不涉及。 取值范围: 参考UserInfoObj。 默认取值: 不涉及。 |
|
started_by |
UserInfoObj object |
参数解释: 启动该任务的用户详细信息。 约束限制: 不涉及。 取值范围: 参考UserInfoObj。 默认取值: 不涉及。 |
请求示例
GET https://*.com/agentarts/v1/ops/datasets-synthesis
响应示例
状态码:200
查询成功
{
"syntheses" : [ {
"id" : "task_uuid",
"name" : "task_uuid",
"scenario_type" : "seed_data",
"scenario_name" : "基于种子数据泛化",
"scenario_description" : "基于现有100条React问答,生成50条更复杂的面试题",
"status" : "running",
"progress" : 65,
"sample_count" : 50,
"generated_count" : 33,
"model_config" : {
"model_id" : "1749615103",
"model_name" : "豆包·1.6·自动深度思考",
"temperature" : 0.1,
"max_tokens" : 4096,
"top_p" : 0.7,
"frequency_penalty" : 0
},
"seed_data" : {
"type" : "dataset",
"dataset_id" : "c3c2571d-a8b0-4447-8b79-a67cac076768",
"dataset_name" : "种子评测集名称",
"dataset_version_id" : "c3c2571d-a8b0-4447-8b79-a67cac076768",
"dataset_version" : "0.0.1",
"file_name" : "seed.jsonl",
"obs_tmp_file_id" : "obs:../path/to/seed.jsonl"
},
"base_info" : {
"created_at" : "2026-02-27T03:09:53.799Z",
"start_at" : "2026-02-27T03:09:53.799Z",
"updated_at" : "2026-02-27T03:09:53.799Z",
"completed_at" : "2026-02-27T03:09:53.799Z",
"duration_seconds" : 325,
"created_by" : {
"name" : "op_svc_modelartsversatile_container0",
"user_id" : "6f80301edacc43728bf47b6a6484d512"
},
"started_by" : {
"name" : "op_svc_modelartsversatile_container0",
"user_id" : "6f80301edacc43728bf47b6a6484d512"
}
}
} ],
"total" : 10
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
查询成功 |
错误码
请参见错误码。