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

发布评测集版本 -j9九游会登录

功能介绍

该接口用于将当前处于草稿状态的数据内容固化，生成一个不可变的历史快照版本，并分配唯一版本id以确保数据在后续调用中的可追溯性。

适用场景：

  • 版本固化：在完成评测集条目的增删改等一系列调整后，通过发布版本将当前数据状态锁定。

  • 评测任务关联：为模型评测或训练任务提供一个静态的数据输入源，防止因草稿内容变动导致实验结果不可复现。

调用方法

请参见如何调用api。

授权信息

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

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts:dataset:publishopsdatasetversion

write

dataset *

g:resourcetag/

-

-

uri

post /v1/ops/datasets/{dataset_id}/versions

表1 路径参数

参数

是否必选

参数类型

描述

dataset_id

是

string

参数解释：

评测集的唯一标识符（id）

约束限制：

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

取值范围：

由英文、数字、连字符(-)、下划线(_)组成的1-64位字符串。

默认取值：

无。

请求参数

表2 请求body参数

参数

是否必选

参数类型

描述

version_name

是

string

参数解释：

用户定义的版本标签或编号。

约束限制：

建议长度不超过 100 字符。

取值范围：

字符串，如 "v1.0"、"20240413_test"。

默认取值：

不涉及。

description

否

string

参数解释：

该版本的变更摘要或备注信息。

约束限制：

可选参数；长度0到200字符。

取值范围：

中英文及常见符号。

默认取值：

不涉及。

响应参数

状态码：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: 布尔值。

description

string

参数解释：

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

取值范围：

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

is_required

boolean

参数解释：

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

取值范围：

  • true：必填

  • false：选填

请求示例

发布评测集

post https://api.example.com/v1/ops/datasets/dcacda233/versions
{
  "description" : "修复了数据质量问题，新增100条测试用例",
  "version_name" : "v1.0.0"
}

响应示例

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

发布成功

错误码

请参见错误码。

父主题：

相关文档

网站地图