文档首页/ 智果（AgentArts）智能体平台/ API参考/ API/ 评估/ 评测集管理/ 修改评测集 - UpdateOpsDataset
更新时间：2026-09-02 GMT+08:00
查看PDF
分享

修改评测集 - UpdateOpsDataset

功能介绍

该接口用于更新现有评测集的名称和业务描述等信息，旨在确保资产信息的准确性与时效性，且操作不涉及对Schema字段定义的变更。

适用场景：

  • 描述完善：在评测集创建后，补充更详细的业务背景、用途说明或标注说明。

  • 名称更改：根据业务需求变更或内部命名规范调整，修改评测集的显示名称。

调用方法

请参见如何调用API。

授权信息

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

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts:dataset:updateOpsDataset

Write

dataset *

g:ResourceTag/<tag-key>

-

-

-

  • g:RequestTag/<tag-key>

  • g:TagKeys

URI

PUT /v1/ops/datasets/{dataset_id}

表1 路径参数

参数

是否必选

参数类型

描述

dataset_id

是

String

参数解释：

评测集的唯一标识符（ID）。可通过调用创建评测集接口获取，或通过查询评测集列表接口获取。

约束限制：

不涉及。

取值范围：

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

默认取值：

无。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

name

是

String

参数解释：

待更新的评测集显示名称。

约束限制：

不涉及。

取值范围：

中英文、数字、下划线（_）、中划线（-）组成的1~255个字符的字符串。

默认取值：

不涉及。

description

否

String

参数解释：

待更新的评测集用途或内容详细描述。

约束限制：

不涉及。

取值范围：

任意字符组成的0~200个字符的字符串。

默认取值：

不涉及。

schemas

否

Array of OpsCreateSchemaRequest objects

参数解释：

定义评测集结构的一组字段配置列表。列表元素为OpsCreateSchemaRequest对象，参考OpsCreateSchemaRequest结构定义。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

tags

否

Array of OpsTmsTag objects

参数解释：

更新评测集时绑定的TMS标签列表，传入则全量替换。列表元素为OpsTmsTag对象，参考OpsTmsTag结构定义。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表3 OpsCreateSchemaRequest

参数

是否必选

参数类型

描述

name

是

String

参数解释：

评测集字段的唯一标识符。

约束限制：

不涉及。

取值范围：

由英文字母、数字和下划线组成，且以字母开头，长度为1~50个字符。

默认取值：

不涉及。

type

是

String

参数解释：

字段的数据存储与校验类型。

约束限制：

必填；必须在预定义的枚举值中选择。

取值范围：

  • String：字符串类型

  • Integer：整数类型

  • Float：浮点数类型

  • Boolean：布尔值类型

默认取值：

不涉及。

is_required

否

Boolean

参数解释：

标识该字段在写入数据时是否必填。

约束限制：

不涉及。

取值范围：

  • true：必填

  • false：可选

默认取值：

false。

description

否

String

参数解释：

该字段的具体业务含义说明。

约束限制：

不涉及。

取值范围：

由任意字符组成，长度为1~200个字符。

默认取值：

不涉及。
表4 OpsTmsTag

参数

是否必选

参数类型

描述

key

否

String

参数解释：

标签键名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

value

否

String

参数解释：

标签值，存储该标签键对应的具体内容。

约束限制：

不涉及。

取值范围：

长度0-256个字符。

默认取值：

不涉及。

响应参数

状态码：200

表5 响应Body参数

参数

参数类型

描述

id

String

参数解释：

评测集的全局唯一标识符。

取值范围：

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

请求示例

修改指定评测集的显示名称和业务描述信息。

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

{
  "name" : "用户问答评测集_已优化",
  "description" : "该评测集已完成 2024 年春季的语料去重与逻辑纠偏，主要用于 RAG 场景下的问答性能评测。",
  "tags" : [ {
    "key" : "env",
    "value" : "prod"
  }, {
    "key" : "team",
    "value" : "ai-platform"
  } ]
}

响应示例

状态码：200

修改成功

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

状态码

状态码

描述

200

修改成功

错误码

请参见错误码。

父主题： 评测集管理

相关文档