j9九游会登录/ 智果（agentarts）智能体平台/ api参考/ api/ / / 获取评测集版本详情 - showopsdatasetversion
更新时间：2026-07-17 gmt 08:00
查看pdf

获取评测集版本详情 -j9九游会登录

功能介绍

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

适用场景：

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

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

调用方法

请参见如何调用api。

授权信息

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

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts:dataset:showopsdatasetversion

read

dataset *

g:resourcetag/

-

-

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)标准的字符串。

默认取值：

无。

请求参数

无

响应参数

状态码：200

表2 响应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 时间字符串。
表3 opsschemainfo

参数

参数类型

描述

id

string

参数解释：

字段的唯一标识符。

取值范围：

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

name

string

参数解释：

字段的键名（key），用于在数据条目中作为属性名。

取值范围：

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

type

string

参数解释：

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

取值范围：

  • string: 字符串。

  • integer: 整数。

  • float: 浮点数。

  • boolean: 布尔值。

description

string

参数解释：

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

取值范围：

描述字段的业务含义或用途的文本，最大长度10000字符。

is_required

boolean

参数解释：

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

取值范围：

  • true：必填

  • false：选填

请求示例

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

get https://api.example.com/v1/ops/datasets/dcacda233/versions/5dfb6831-ab0c-4e72-9bdd-8c9790dfd3a9

响应示例

状态码：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

查询成功

错误码

请参见错误码。

父主题：

相关文档

网站地图