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

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

功能介绍

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

synthesis_id

String

参数解释:

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

约束限制:

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

取值范围:

1-64位字符。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json

Authorization

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

X-Sdk-Date

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

id

String

参数解释:

合成任务的唯一标识符。

取值范围:

由系统生成的任务ID。

name

String

参数解释:

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

取值范围:

任意字符串。

scenario_type

String

参数解释:

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

取值范围:

如seed_data等。

scenario_name

String

参数解释:

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

取值范围:

如 "基于种子数据泛化"。

scenario_description

String

参数解释:

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

取值范围:

自定义场景描述。

status

String

参数解释:

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

取值范围:

pending(等待执行),running(正在运行),completed(已完成),failed(执行失败),stopped(已人工停止)。

stats

EvaluationOpsSynethsisStats object

参数解释:

任务执行的统计数据快照。

取值范围:

参考EvaluationOpsSynethsisStats定义。

usage

EvaluationOpsTokenUsage object

参数解释:

本次合成任务消耗的模型Token资源统计。

取值范围:

参考EvaluationOpsTokenUsage定义。

model_config

EvaluationOpsModelConfig object

参数解释:

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

取值范围:

参考EvaluationOpsModelConfig定义。

seed_data

EvaluationOpsSeedDataConfig object

参数解释:

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

取值范围:

参考EvaluationOpsSeedDataConfig定义。

schemas

Array of EvaluationOpsSynthesisSchema objects

参数解释:

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

取值范围:

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

base_info

EvaluationOpsTaskBaseInfo object

参数解释:

任务的基础管理元数据。

取值范围:

参考EvaluationOpsTaskBaseInfo定义。

表4 EvaluationOpsSynethsisStats

参数

参数类型

描述

total

Integer

参数解释:

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

约束限制:

0-500之间的整数。

取值范围:

0-500。

默认取值:

0。

progress

Integer

参数解释:

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

约束限制:

0-100之间的整数。

取值范围:

0-100。

默认取值:

0。

success

Integer

参数解释:

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

约束限制:

0-500之间的整数。

取值范围:

0-500。

默认取值:

0。

failed

Integer

参数解释:

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

约束限制:

0-500之间的整数。

取值范围:

0-500。

默认取值:

0。

running

Integer

参数解释:

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

约束限制:

0-500之间的整数。

取值范围:

0-500。

默认取值:

0。

pending

Integer

参数解释:

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

约束限制:

0-500之间的整数。

取值范围:

0-500。

默认取值:

0。

表5 EvaluationOpsTokenUsage

参数

参数类型

描述

prompt_tokens

Long

参数解释:

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

约束限制:

长整型数值。

取值范围:

0-9,999,999,999。

默认取值:

0。

completion_tokens

Long

参数解释:

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

约束限制:

长整型数值。

取值范围:

0-9,999,999,999。

默认取值:

0。

total_tokens

Long

参数解释:

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

约束限制:

计算公式为 prompt_tokens + completion_tokens。

取值范围:

0-9,999,999,999。

默认取值:

0。

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

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

默认取值:

不涉及。

表8 EvaluationOpsSynthesisSchema

参数

参数类型

描述

name

String

参数解释:

合成字段的名称。

约束限制:

长度 1-100字符。

取值范围:

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

默认取值:

不涉及。

description

String

参数解释:

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

约束限制:

0-400字符。

取值范围:

任意字符串。

默认取值:

不涉及。

synthesis_requirement

String

参数解释:

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

约束限制:

0-4000 字符。

取值范围:

详细的指令说明。

默认取值:

不涉及。

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

默认取值:

不涉及。

表10 UserInfoObj

参数

参数类型

描述

name

String

参数解释:

用户的显示名称。

约束限制:

0-1200个字符。

取值范围:

任意字符串。

默认取值:

不涉及。

user_id

String

参数解释:

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

约束限制:

0-1200个字符。

取值范围:

不涉及

默认取值:

不涉及。

请求示例

请求查询评测集合成任务详情

GET https://*.com/agentarts/v1/ops/datasets-synthesis/a67452bf21f819-6f91-4568-9f2f-57ef9562ab7

响应示例

状态码:200

查询成功

{
  "id" : "task_uuid",
  "status" : "running",
  "stats" : {
    "total" : 50
  }
}

状态码

状态码

描述

200

查询成功

错误码

请参见错误码

相关文档