# 修改评测集 - UpdateOpsDataset #### 功能介绍 该接口用于更新现有评测集的名称和业务描述等信息，旨在确保资产信息的准确性与时效性，且操作不涉及对Schema字段定义的变更。 适用场景： - 描述完善：在评测集创建后，补充更详细的业务背景、用途说明或标注说明。 - 名称更改：根据业务需求变更或内部命名规范调整，修改评测集的显示名称。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。 #### 授权信息 账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-agentarts/Permission.html)。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | agentarts:dataset:updateOpsDataset | Write | dataset \* | g:ResourceTag/\ | - | - | | agentarts:dataset:updateOpsDataset | Write | - | - g:RequestTag/\ - 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结构定义。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | 表3OpsCreateSchemaRequest | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 是 | String | **参数解释：** 评测集字段的唯一标识符。 **约束限制：** 不涉及。 **取值范围：** 由英文字母、数字和下划线组成，且以字母开头，长度为1\~50个字符。 **默认取值：** 不涉及。 | | type | 是 | String | **参数解释：** 字段的数据存储与校验类型。 **约束限制：** 必填；必须在预定义的枚举值中选择。 **取值范围：** - String：字符串类型 - Integer：整数类型 - Float：浮点数类型 - Boolean：布尔值类型 **默认取值：** 不涉及。 | | is_required | 否 | Boolean | **参数解释：** 标识该字段在写入数据时是否必填。 **约束限制：** 不涉及。 **取值范围：** - true：必填 - false：可选 **默认取值：** false。 | | description | 否 | String | **参数解释：** 该字段的具体业务含义说明。 **约束限制：** 不涉及。 **取值范围：** 由任意字符组成，长度为1\~200个字符。 **默认取值：** 不涉及。 | 表4OpsTmsTag | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | 修改成功 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。