文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 评估/ 评测集管理/ 查询评测集合成任务详情 - ShowOpsSynthesisTask
更新时间:2026-06-16 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(已人工停止)。

stats

EvaluationOpsSynthesisStats object

参数解释:

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

取值范围:

参考EvaluationOpsSynthesisStats定义。

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定义。

表3 EvaluationOpsSynthesisStats

参数

参数类型

描述

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 EvaluationOpsTokenUsage

参数

参数类型

描述

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 EvaluationOpsModelConfig

参数

参数类型

描述

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 EvaluationOpsSeedDataConfig

参数

参数类型

描述

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 EvaluationOpsSynthesisSchema

参数

参数类型

描述

id

String

参数解释:

合成字段的id。

取值范围:

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

name

String

参数解释:

合成字段的名称。

取值范围:

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

description

String

参数解释:

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

取值范围:

任意字符串。

synthesis_requirement

String

参数解释:

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

取值范围:

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

表8 EvaluationOpsTaskBaseInfo

参数

参数类型

描述

created_at

String

参数解释:

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

取值范围:

日期时间字符串。

start_at

String

参数解释:

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

取值范围:

日期时间字符串。

updated_at

String

参数解释:

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

取值范围:

日期时间字符串。

completed_at

String

参数解释:

任务执行完毕(无论成败)的时间。

取值范围:

日期时间字符串。

duration_seconds

Long

参数解释:

任务的有效运行总时长(秒)。

取值范围:

非负整数。

created_by

UserInfoObj object

参数解释:

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

取值范围:

参考UserInfoObj。

started_by

UserInfoObj object

参数解释:

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

取值范围:

参考UserInfoObj。

表9 UserInfoObj

参数

参数类型

描述

name

String

参数解释:

用户的显示名称。

取值范围:

任意字符串。

user_id

String

参数解释:

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

取值范围:

不涉及

请求示例

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

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

响应示例

状态码:200

查询成功

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

状态码

状态码

描述

200

查询成功

错误码

请参见错误码

相关文档