j9九游会登录/ 智果（agentarts）智能体平台/ api参考/ api/ / / 查询评测集合成任务列表 - listopssynthesistasks
更新时间：2026-07-17 gmt 08:00
查看pdf

查询评测集合成任务列表 -j9九游会登录

功能介绍

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

适用场景：

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

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

调用方法

请参见如何调用api。

授权信息

账号根用户具备所有api的调用权限，如果使用账号下的iam用户调用当前api，该iam用户需具备如下身份策略权限，更多的权限说明请参见。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts:dataset:listopssynthesistasks

list

dataset *

g:resourcetag/

-

-

uri

get /v1/ops/datasets-synthesis

表1 query参数

参数

是否必选

参数类型

描述

status

否

string

参数解释：

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

约束限制：

不涉及。

取值范围：

  • pending: 等待中

  • running: 运行中

  • completed: 已完成

  • failed: 失败

  • stopped: 已停止

默认取值：

不涉及。

name

否

string

参数解释：

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

约束限制：

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

取值范围：

0到100字符。

默认取值：

不涉及。

offset

否

integer

参数解释：

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

约束限制：

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

取值范围：

0-10000。

默认取值：

0。

limit

否

integer

参数解释：

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

约束限制：

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

取值范围：

1-100。

默认取值：

10。

请求参数

无

响应参数

状态码：200

表2 响应body参数

参数

参数类型

描述

syntheses

array of opsevaluationsynthesistasksummary objects

参数解释：

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

取值范围：

参考opsevaluationsynthesistasksummary定义。

total

integer

参数解释：

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

取值范围：

0-500。
表3 opsevaluationsynthesistasksummary

参数

参数类型

描述

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

opsevaluationmodelconfig object

参数解释：

任务使用的模型配置。

约束限制：

参考opsevaluationmodelconfig。

取值范围：

不涉及。

默认取值：

不涉及。

seed_data

opsevaluationseeddataconfig object

参数解释：

任务使用的种子数据配置。

约束限制：

参考opsevaluationseeddataconfig。

取值范围：

不涉及。

默认取值：

不涉及。

base_info

opsevaluationtaskbaseinfo object

参数解释：

任务基础元数据。

约束限制：

参考opsevaluationtaskbaseinfo。

取值范围：

不涉及。

默认取值：

不涉及。
表4 opsevaluationmodelconfig

参数

参数类型

描述

model_id

string

参数解释：

指定调用的大模型唯一标识符，通过模型列表接口获取。

model_name

string

参数解释：

模型的显示名称。

取值范围：

任意字符串。

temperature

float

参数解释：

采样温度参数，用于控制输出的随机性。数值低更聚焦，数值高更具创造性。

取值范围：

0.0到2.0。

max_tokens

integer

参数解释：

单次推理生成的最大token数量限制。

取值范围：

1-32000。

top_p

float

参数解释：

核采样参数。

取值范围：

0.0到1.0。

frequency_penalty

float

参数解释：

频率惩罚系数，降低内容重复倾向。

取值范围：

-2.0到2.0。
表5 opsevaluationseeddataconfig

参数

参数类型

描述

type

string

参数解释：

种子数据的来源类型。

取值范围：

dataset(评测集)，file(文件)。

dataset_id

string

参数解释：

种子评测集的唯一id。

取值范围：

符合通用唯一识别码(uuid)标准的字符串。

dataset_name

string

参数解释：

种子评测集的展示名称。

取值范围：

任意字符串。

dataset_version_id

string

参数解释：

种子评测集版本的内部唯一标识符。

取值范围：

符合通用唯一识别码(uuid)标准的字符串。

dataset_version

string

参数解释：

种子评测集的可读版本号。

取值范围：

如0.0.1。

file_name

string

参数解释：

作为种子源的临时文件名称。

取值范围：

文件名。

obs_tmp_file_id

string

参数解释：

种子数据文件在对象存储中的路径。

取值范围：

obs路径。
表6 opsevaluationtaskbaseinfo

参数

参数类型

描述

created_at

string

参数解释：

任务在系统中创建的时间戳。

取值范围：

日期时间字符串。

start_at

string

参数解释：

任务正式开始执行的精确时刻。

取值范围：

日期时间字符串。

updated_at

string

参数解释：

任务状态或元数据最后一次变更的时间。

取值范围：

日期时间字符串。

completed_at

string

参数解释：

任务执行完毕（无论成败）的时间。

取值范围：

日期时间字符串。

duration_seconds

long

参数解释：

任务的有效运行总时长（秒）。

取值范围：

非负整数。

created_by

opsuserinfoobj object

参数解释：

创建该任务的用户详细信息。

取值范围：

参考opsuserinfoobj。

started_by

opsuserinfoobj object

参数解释：

启动该任务的用户详细信息。

取值范围：

参考opsuserinfoobj。
表7 opsuserinfoobj

参数

参数类型

描述

name

string

参数解释：

用户的显示名称。

取值范围：

任意字符串。

user_id

string

参数解释：

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

取值范围：

不涉及

请求示例

get https://api.example.com/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

查询成功

错误码

请参见错误码。

父主题：

相关文档

网站地图