# 获取评测集详情 - ShowOpsDataset #### 功能介绍 该接口用于根据评测集ID获取其完整的元数据配置，包括字段结构定义、基本属性及关联的历史发布版本列表。 适用场景： - 评测配置校验：在启动评估任务前，开发者通过此接口确认评测集的字段是否符合评估任务输入要求。 - 版本回溯与管理：获取评测集下属的所有版本信息，以便进行版本对比或指定特定版本进行操作。 #### 调用方法 请参见[如何调用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:showOpsDataset | Read | dataset \* | g:ResourceTag/\ | - | - | #### URI GET /v1/ops/datasets/{dataset_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | dataset_id | 是 | String | **参数解释：** 评测集的唯一标识符（ID）。可通过调用批量添加评测集条目接口获取，或通过查询评测集条目列表接口获取。 **约束限制：** 不涉及。 **取值范围：** 由英文字母、数字、连字符(-)及下划线(_)组成的字符串，长度为1\~64个字符。 **默认取值：** 不涉及。 | #### 请求参数 无 #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 评测集的全局唯一标识符。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 评测集的显示名称。 **取值范围：** 不涉及。 | | description | String | **参数解释：** 对该评测集用途或内容的详细文字说明。 **取值范围：** 不涉及。 | | latest_version | String | **参数解释：** 该评测集当前已发布的最新版本号。 **取值范围：** 不涉及。 | | latest_version_id | String | **参数解释：** 最新发布版本对应的唯一标识符ID。 **取值范围：** 不涉及。 | | turn_type | String | **参数解释：** 该评测集turn的类型。 **取值范围：** 不涉及。 | | is_preset | Boolean | **参数解释：** 该评测集是否预置。 **取值范围：** - true：已预置 - false：非预置 | | can_delete | Boolean | **参数解释：** 该评测集是否能删除。 **取值范围：** - true：可删除 - false：不可删除 | | reference_count | Integer | **参数解释：** 评测集被引用次数。 **取值范围：** 0到2147483647。 | | item_count | Integer | **参数解释：** 评测集中包含的总记录条数（ 含未提交的草稿数据）。 **取值范围：** 0到2147483647。 | | change_uncommitted | Boolean | **参数解释：** 标识当前草稿态相对于最新发布版本是否有尚未提交的变更。 **取值范围：** - true：有未提交变更 - false：无变更 | | schemas | Array of [OpsSchemaInfo] objects | **参数解释：** 定义评测集内部数据结构的字段定义列表。列表元素为OpsSchemaInfo对象，参考OpsSchemaInfo结构定义。 | | versions | Array of [OpsVersionInfo] objects | **参数解释：** 评测集的历史发布版本详情列表。列表元素为OpsVersionInfo对象，参考OpsVersionInfo结构定义。 | | base_info | [OpsBaseInfo] object | **参数解释：** 资源的基础元数据信息，参考OpsBaseInfo结构定义。 | | tags | Array of [OpsTmsTag] objects | **参数解释：** 评测集绑定的TMS标签列表。列表元素为OpsTmsTag对象，参考OpsTmsTag结构定义。 | 表3OpsSchemaInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 字段的唯一标识符。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 字段的键名（Key），用于在数据条目中作为属性名。 **取值范围：** 不涉及。 | | type | String | **参数解释：** 字段的数据类型，定义数据的存储和解析方式。 **取值范围：** - String：字符串 - Integer：整数 - Float：浮点数 - Boolean：布尔值 | | description | String | **参数解释：** 对该字段业务含义或用途的详细文字说明。 **取值范围：** 不涉及。 | | is_required | Boolean | **参数解释：** 标识该字段在数据条目中是否为必须存在的必填项。 **取值范围：** - true：必填 - false：选填 | 表4OpsVersionInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 版本的唯一标识符。 **取值范围：** 符合通用唯一识别码(UUID)标准的字符串。 | | version | String | **参数解释：** 用户定义的版本号或标签名。 **取值范围：** 自定义字符串，如v1.0.0等。 | | description | String | **参数解释：** 对该版本变更内容或用途的简要描述。 **取值范围：** 任意字符串。 | | item_count | Integer | **参数解释：** 该版本快照中包含的数据条目总数。 **取值范围：** 0到2147483647。 | | created_at | String | **参数解释：** 版本的发布创建时间。使用UTC+0时间格式，格式为yyyy-MM-ddTHH:mm:ssZ，例如2024-01-01T12:00:00Z。 **取值范围：** 不涉及。 | 表5OpsBaseInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | created_time | String | **参数解释：** 资源的创建时间戳。使用UTC+0时间格式，格式为yyyy-MM-ddTHH:mm:ssZ，示例：2020-09-25T12:05:00Z **取值范围：** 不涉及。 | | updated_time | String | **参数解释：** 资源的最后更新时间戳。使用UTC+0时间格式，格式为yyyy-MM-ddTHH:mm:ssZ，示例：2020-09-25T12:05:00Z **取值范围：** 不涉及。 | | created_by | [OpsEvaluationUserInfo] object | **参数解释：** 资源创建者的简要身份信息，参考OpsEvaluationUserInfo定义。 | | updated_by | [OpsEvaluationUserInfo] object | **参数解释：** 资源最后更新者的简要身份信息，参考OpsEvaluationUserInfo定义。 | 表6OpsEvaluationUserInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 用户在系统中的显示名称。 **取值范围：** 不涉及。 | | user_id | String | **参数解释：** 用户的系统内唯一标识符（ID）。 **取值范围：** 不涉及。 | 表7OpsTmsTag | 参数 | 参数类型 | 描述 | |:---|:---|:---| | key | String | **参数解释：** 标签键名称。 **取值范围：** 不涉及。 | | value | String | **参数解释：** 标签值，存储该标签键对应的具体内容。 **取值范围：** 长度0-256个字符。 | #### 请求示例 通过评测集ID获取完整的元数据配置、Schema 结构以及历史版本列表。 ``` GET https://api.example.com/v1/ops/datasets/097b0720-d6cc-48e0-ad15-5638bb6b1784 ``` #### 响应示例 **状态码：200** 查询成功 ``` { "id" : "097b0720-d6cc-48e0-ad15-5638bb6b1784", "name" : "用户问答评测集", "description" : "用于评测问答系统的基准评测的评测集", "latest_version" : "v1.1.0", "latest_version_id" : "550e8400-e29b-41d4-a716-446655440001", "item_count" : 150, "change_uncommitted" : true, "schemas" : [ { "id" : "550e8400-e29b-41d4-a716-446655440000", "name" : "user_input", "type" : "String", "is_required" : true, "description" : "用户原始输入" }, { "id" : "550e8400-e29b-41d4-a716-446655440005", "name" : "reference_output", "type" : "String", "is_required" : false, "description" : "标准参考答案" } ], "versions" : [ { "id" : "550e8400-e29b-41d4-a716-446655440001", "version" : "v1.0.0", "description" : "初始基准版", "item_count" : 100, "created_at" : "2024-01-10T12:00:00Z" }, { "id" : "550e8400-e29b-41d4-a716-446655440002", "version" : "v1.1.0", "description" : "2024春季增补版", "item_count" : 150, "created_at" : "2024-03-15T09:30:00Z" } ], "base_info" : { "created_time" : "2026-02-27T03:09:53.799Z", "updated_time" : "2026-02-27T03:09:53.799Z", "created_by" : { "name" : "versatile-test", "user_id" : "a8f68bb358d84d3e95087b6c7d373efa" }, "updated_by" : { "name" : "versatile-test", "user_id" : "a8f68bb358d84d3e95087b6c7d373efa" } }, "tags" : [ { "key" : "env", "value" : "prod" }, { "key" : "team", "value" : "ai-platform" } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 查询成功 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。