文档首页/ 智能体开发平台 AgentArts/ API参考/ API/ 评估/ 评测集管理/ 获取评测集版本详情 - ShowOpsDatasetVersion
更新时间:2026-04-15 GMT+08:00
分享

获取评测集版本详情 - ShowOpsDatasetVersion

功能介绍

该接口用于通过指定版本ID检索特定历史版本的完整元数据,包含发布时的Schema结构快照、数据规模统计及版本属性。

适用场景:

  • 历史版本对比:核对已发布评测集在特定时间点的字段定义、数据规模和配置参数。

  • 变更差异分析:获取特定版本的结构化快照,以便与当前草稿态或其他历史版本进行元数据维度的对比。

URI

GET /v1/ops/datasets/{dataset_id}/versions/{version_id}

表1 路径参数

参数

是否必选

参数类型

描述

dataset_id

String

参数解释:

评测集的ID。

约束限制:

由英文、数字、“-”、“_”组成,长度为1到64个字符。

取值范围:

1-64位字符。

默认取值:

不涉及。

version_id

String

参数解释:

评测集版本的唯一标识符(ID)。该参数在路径中指定,用于定位评测集下特定的版本记录。

约束限制:

固定长度为 36 个字符。

取值范围:

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

默认取值:

不涉及。

请求参数

表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

参数解释:

版本的内部唯一标识符。

取值范围:

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

version

String

参数解释:

发布的版本显示名称。

取值范围:

自定义字符串。

version_num

Integer

参数解释:

系统生成的递增版本序号。

取值范围:

0到2147483647。

description

String

参数解释:

该版本的详细备注说明。

取值范围:

任意字符串。

item_count

Integer

参数解释:

该版本快照中包含的数据条目总数。

取值范围:

0到2147483647。

schema_snapshot

Array of OpsSchemaInfo objects

参数解释:

发布该版本时的数据结构定义快照。

取值范围:

OpsSchemaInfo 对象列表。

created_at

String

参数解释:

版本的正式发布时间。

取值范围:

UTC 时间字符串。

表4 OpsSchemaInfo

参数

参数类型

描述

id

String

参数解释:

字段的唯一标识符。

取值范围:

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

name

String

参数解释:

字段的键名(Key),用于在数据条目中作为属性名。

取值范围:

建议符合变量命名规范的字符串。

type

String

参数解释:

字段的数据类型,定义数据的存储和解析方式。

取值范围:

支持String, Integer, Float, Boolean, Object, Array系列以及Trajectory。

description

String

参数解释:

对该字段业务含义或用途的详细文字说明。

取值范围:

任意字符串。

is_required

Boolean

参数解释:

标识该字段在数据条目中是否为必须存在的必填项。

取值范围:

  • true:必填

  • false:选填

请求示例

查询指定版本ID检索特定历史版本评测集详情

GET https://*.com/agentarts/v1/ops/datasets/dcacda233/versions/acadcacda233




响应示例

状态码:200

查询成功

{
  "id" : "550e8400-e29b-41d4-a716-446655440001",
  "version" : "v1",
  "version_num" : 1,
  "description" : "初始版本",
  "item_count" : 100,
  "schema_snapshot" : [ {
    "id" : "550e8400-e29b-41d4-a716-446655440000",
    "name" : "input",
    "type" : "String",
    "description" : "用户输入内容",
    "is_required" : true
  } ],
  "created_at" : "2024-01-15T10:30:00Z"
}

状态码

状态码

描述

200

查询成功

错误码

请参见错误码

相关文档