更新时间：2026-09-02 GMT+08:00

创建评测集 - CreateOpsDataset

功能介绍

该接口用于创建结构化评测集，支持定义评测集的字段，为Agent的评估任务提供标准化的数据来源。

调用方法

授权信息

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

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
agentarts:dataset:createOpsDataset	Write	dataset *	-	-	-

URI

POST /v1/ops/datasets

请求参数

表1 请求Body参数
参数	是否必选	参数类型	描述
name	是	String	参数解释：评测集的名称。约束限制：字符串长度2-50字符，租户内唯一。取值范围：支持中英文、数字、下划线（_）、中划线（-）和空格，长度2-50字符，但不允许以空格开头或结尾。默认取值：不涉及。
description	否	String	参数解释：评测集的用途及业务背景描述。约束限制：不涉及。取值范围：由任意字符组成，长度为0~200个字符。默认取值：不涉及。
schemas	否	Array of OpsCreateSchemaRequest objects	参数解释：定义评测集结构的一组字段配置列表。数组元素为OpsCreateSchemaRequest对象，参考OpsCreateSchemaRequest结构定义。默认为空列表。约束限制：列表元素数量上限为50个。取值范围：不涉及。默认取值：空列表。
tags	否	Array of OpsTmsTag objects	参数解释：创建评测集时绑定的TMS标签列表。约束限制：数组长度0到50。取值范围：不涉及。默认取值：空列表。

表2 OpsCreateSchemaRequest
参数	是否必选	参数类型	描述
name	是	String	参数解释：评测集字段的唯一标识符。约束限制：不涉及。取值范围：由英文字母、数字和下划线组成，且以字母开头，长度为1~50个字符。默认取值：不涉及。
type	是	String	参数解释：字段的数据存储与校验类型。约束限制：必填；必须在预定义的枚举值中选择。取值范围： String：字符串类型 Integer：整数类型 Float：浮点数类型 Boolean：布尔值类型默认取值：不涉及。
is_required	否	Boolean	参数解释：标识该字段在写入数据时是否必填。约束限制：不涉及。取值范围： true：必填 false：可选默认取值： false。
description	否	String	参数解释：该字段的具体业务含义说明。约束限制：不涉及。取值范围：由任意字符组成，长度为1~200个字符。默认取值：不涉及。

表3 OpsTmsTag
参数	是否必选	参数类型	描述
key	否	String	参数解释：标签键名称。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
value	否	String	参数解释：标签值，存储该标签键对应的具体内容。约束限制：不涉及。取值范围：长度0-256个字符。默认取值：不涉及。

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
id	String	参数解释：创建成功后系统生成的评测集唯一标识符，可用于后续的查询、更新或删除操作。取值范围：符合通用唯一识别码(UUID)标准的字符串。

请求示例

创建一个结构化评测集，并定义包含用户输入字段的 Schema。

POST https://api.example.com/v1/ops/datasets

{
  "name" : "用户问答评测集",
  "description" : "用于评测问答系统的评测集",
  "schemas" : [ {
    "name" : "user_input",
    "type" : "String",
    "is_required" : true,
    "description" : "用户输入的问题"
  } ],
  "tags" : [ {
    "key" : "env",
    "value" : "prod"
  }, {
    "key" : "team",
    "value" : "ai-platform"
  } ]
}

响应示例

状态码：200

创建成功

{
  "id" : "550e8400-e29b-41d4-a716-446655440002"
}

状态码

状态码	描述
200	创建成功

错误码

请参见错误码。

父主题： 评测集管理