文档首页/ 智能体开发平台 AgentArts/ API参考/ API/ 评估/ 评测集管理/ 查询评测集合成任务列表 - ListOpsSynthesisTasks
更新时间:2026-04-15 GMT+08:00
分享

查询评测集合成任务列表 - ListOpsSynthesisTasks

功能介绍

该接口用于分页查询当前租户下所有已提交的评测集合成异步任务,支持按任务名称、状态等多种过滤条件进行检索,提供任务执行进度。

适用场景:

  • 任务进度查看:在发起大规模数据合成后,通过此接口批量获取任务的运行状态(如:进行中、已完成、已失败)。

  • 历史合成记录管理:复盘并管理过往提交的数据生成任务,审计合成任务的执行频率与成功率。

URI

GET /v1/ops/datasets-synthesis

表1 Query参数

参数

是否必选

参数类型

描述

offset

Integer

参数解释:

分页查询的起始偏移量。用于指定从满足条件的第几条记录开始返回,常与 limit参数配合实现分页功能。

约束限制:

必须为整数,且大小在0到10,000 之间。

取值范围:

0-10000。

默认取值:

0。

limit

Integer

参数解释:

单次查询返回的最大记录数量。用于控制分页查询时每页显示的数据条数。

约束限制:

必须为整数,且大小在1到100之间。

取值范围:

1-100。

默认取值:

10。

status

String

参数解释:

任务状态过滤条件。用于筛选处于特定生命周期阶段的合成任务。

约束限制:

不涉及。

取值范围:

  • pending: 等待中

  • running: 运行中

  • completed: 已完成

  • failed: 失败

  • stopped: 已停止

默认取值:

不涉及。

name

String

参数解释:

任务名称检索字段。支持根据创建任务时自定义的名称进行筛选。

约束限制:

支持模糊匹配,字符串长度限制为0到100个字符。

取值范围:

0到100字符。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释:

消息体编码格式。用于告知服务端请求体(Body)所采用的主体数据类型,以便服务端正确解析。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json

Authorization

String

参数解释:

签名认证信息,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

X-Sdk-Date

String

参数解释:

请求发送的时间,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

syntheses

Array of EvaluationOpsSynthesisTaskSummary objects

参数解释:

包含合成任务摘要信息的对象列表。

取值范围:

参考EvaluationOpsSynthesisTaskSummary定义。

total

Integer

参数解释:

符合当前筛选条件的任务总记录数。

取值范围:

0-500。

表4 EvaluationOpsSynthesisTaskSummary

参数

参数类型

描述

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。

取值范围:

不涉及。

默认取值:

不涉及。

表5 EvaluationOpsModelConfig

参数

参数类型

描述

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。

表6 EvaluationOpsSeedDataConfig

参数

参数类型

描述

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路径。

默认取值:

不涉及。

表7 EvaluationOpsTaskBaseInfo

参数

参数类型

描述

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。

默认取值:

不涉及。

表8 UserInfoObj

参数

参数类型

描述

name

String

参数解释:

用户的显示名称。

约束限制:

0-1200个字符。

取值范围:

任意字符串。

默认取值:

不涉及。

user_id

String

参数解释:

用户在账号系统中的唯一身份ID。

约束限制:

0-1200个字符。

取值范围:

不涉及

默认取值:

不涉及。

请求示例

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

查询成功

错误码

请参见错误码

相关文档