文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 评估/ 评测集管理/ 查询评测集合成任务详情 - ShowOpsSynthesisTask
更新时间:2026-07-24 GMT+08:00
分享

查询评测集合成任务详情 - ShowOpsSynthesisTask

功能介绍

该接口用于通过任务ID检索特定评测集合成任务的完整信息,涵盖任务配置快照、实时执行状态及生成统计。

调用方法

请参见如何调用API

授权信息

账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts:dataset:showOpsSynthesisTask

Read

dataset *

g:ResourceTag/<tag-key>

-

-

URI

GET /v1/ops/datasets-synthesis/{synthesis_id}

表1 路径参数

参数

是否必选

参数类型

描述

synthesis_id

String

参数解释:

合成任务的唯一标识符(ID),该参数用于在路径中指定特定的合成任务,以便执行查询、停止或删除等操作。

约束限制:

字符串长度限制为1到64个字符。通常采用标准 UUID格式。

取值范围:

1-64位字符。

默认取值:

不涉及。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

id

String

参数解释:

合成任务的唯一标识符。

name

String

参数解释:

用户为合成任务定义的描述性名称。

scenario_type

String

参数解释:

合成任务所属的技术场景分类标识。

scenario_name

String

参数解释:

合成场景的友好展示名称。

scenario_description

String

参数解释:

该合成任务具体业务逻辑或目标的详细说明。

status

String

参数解释:

合成任务当前的生命周期运行状态。

取值范围:

字符长度1-100,pending(等待执行),running(正在运行),completed(已完成),failed(执行失败),stopped(已人工停止),success(成功),partial_success(部分成功)。

stats

OpsEvaluationSynthesisStats object

参数解释:

数据合成任务的运行明细统计对象。

取值范围:

不涉及。

usage

OpsEvaluationTokenUsage object

参数解释:

大模型调用产生的Token资源消耗统计对象。

取值范围:

不涉及。

model_config

OpsEvaluationModelConfig object

参数解释:

任务发起时所采用的模型参数配置。

取值范围:

参考OpsEvaluationModelConfig定义。

seed_data

OpsEvaluationSeedDataConfig object

参数解释:

任务依赖的种子数据配置信息。

取值范围:

参考OpsEvaluationSeedDataConfig定义。

schemas

Array of OpsEvaluationSynthesisSchema objects

参数解释:

合成数据所遵循的字段结构定义(Schema)列表。

取值范围:

包含字段名称、类型、描述等元数据的对象数组。

base_info

OpsEvaluationTaskBaseInfo object

参数解释:

任务基础元数据。

取值范围:

不涉及。

表3 OpsEvaluationSynthesisStats

参数

参数类型

描述

total

Integer

参数解释:

任务计划生成的总样本条数。

取值范围:

0-500。

progress

Integer

参数解释:

当前任务执行的百分比进度。

取值范围:

0-100。

success

Integer

参数解释:

当前已成功生成的样本总数。

取值范围:

0-500。

failed

Integer

参数解释:

在合成过程中失败的样本总数。

取值范围:

0-500。

running

Integer

参数解释:

当前正处于活跃生成阶段的样本条数。

取值范围:

0-500。

pending

Integer

参数解释:

尚未开始执行、在队列中等待的样本条数。

取值范围:

0-500。

表4 OpsEvaluationTokenUsage

参数

参数类型

描述

prompt_tokens

Long

参数解释:

输入提示词所消耗的Token数量。

取值范围:

0-9,999,999,999。

completion_tokens

Long

参数解释:

模型生成内容所消耗的Token数量。

取值范围:

0-9,999,999,999。

total_tokens

Long

参数解释:

本次任务产生的Token消耗总量。

取值范围:

0-9,999,999,999。

表5 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。

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

表7 OpsEvaluationSynthesisSchema

参数

参数类型

描述

id

String

参数解释:

合成字段的id。

取值范围:

由字母、数字、下划线组成。

name

String

参数解释:

合成字段的名称。

取值范围:

长度1-100字符,由字母、数字、下划线组成。

description

String

参数解释:

合成字段的业务含义描述。

取值范围:

任意字符串。

synthesis_requirement

String

参数解释:

合成要求,用于指导LLM生成该字段的思考路径。

取值范围:

0-4000字符,详细的指令说明。

表8 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。

表9 OpsUserInfoObj

参数

参数类型

描述

name

String

参数解释:

用户的显示名称。

取值范围:

任意字符串。

user_id

String

参数解释:

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

取值范围:

不涉及

请求示例

查询评测集合成任务详情

GET https://api.example.com/v1/ops/datasets-synthesis/a67452bf21f819-6f91-4568-9f2f-57ef9562ab71

响应示例

状态码:200

查询成功

{
  "id" : "task_uuid",
  "name" : "task_uuid",
  "scenario_type" : "seed_data",
  "scenario_name" : "基于种子数据泛化",
  "scenario_description" : "基于现有100条React问答,生成50条更复杂的面试题",
  "status" : "running",
  "stats" : {
    "total" : 50,
    "progress" : 65,
    "success" : 33,
    "failed" : 2,
    "running" : 5,
    "pending" : 10
  },
  "usage" : {
    "prompt_tokens" : 12500,
    "completion_tokens" : 8450,
    "total_tokens" : 20950
  },
  "model_config" : {
    "model_id" : "1749615103",
    "model_name" : "豆包·1.6·自动深度思考",
    "temperature" : 0.1,
    "max_tokens" : 4096,
    "top_p" : 0.7,
    "frequency_penalty" : 0.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"
  },
  "schemas" : [ {
    "id" : "c3c2571d-a8b0-4447-8b79-a67cac076768",
    "name" : "input",
    "description" : "作为输入投递给评测对象",
    "synthesis_requirement" : "生成技术深度适中、具有实践意义的React问题。"
  }, {
    "id" : "c3c2571d-a8b0-4447-8b79-a67cac076769",
    "name" : "input1",
    "description" : "作为输入投递给评测对象",
    "synthesis_requirement" : "生成技术深度适中、具有实践意义的React问题。"
  } ],
  "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"
    }
  }
}

状态码

状态码

描述

200

查询成功

错误码

请参见错误码

相关文档