j9九游会登录/ 智果(agentarts)智能体平台/ api参考/ api/ / / 查询评测集合成任务详情 - showopssynthesistask
更新时间:2026-07-17 gmt 08:00

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

功能介绍

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

调用方法

请参见如何调用api

授权信息

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

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts:dataset:showopssynthesistask

read

dataset *

g:resourcetag/

-

-

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

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

参数解释:

任务基础元数据。

约束限制:

参考opsevaluationtaskbaseinfo。

取值范围:

不涉及。

默认取值:

不涉及。

表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",
  "status" : "running",
  "stats" : {
    "total" : 50
  }
}

状态码

状态码

描述

200

查询成功

错误码

请参见错误码

相关文档

网站地图