# 获取评测集条目详情 - ShowOpsDatasetItem #### 功能介绍 该接口用于精确获取评测集中某一行特定数据条目的完整内容，通过评测集ID与条目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:showOpsDatasetItem | Read | dataset \* | g:ResourceTag/\ | - | - | #### URI GET /v1/ops/datasets/{dataset_id}/items/{item_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | dataset_id | 是 | String | **参数解释：** 评测集的唯一标识符（ID）。可通过调用创建评测集接口获取，或通过查询评测集列表接口获取。 **约束限制：** 不涉及。 **取值范围：** 由英文、数字、连字符(-)、下划线(_)组成的1\~64个字符串。 **默认取值：** 无。 | | item_id | 是 | String | **参数解释：** 评测集条目的ID。可通过调用批量添加评测集条目接口获取，或通过查询评测集条目列表接口获取。 **约束限制：** 由英文、数字、"-"、"*"组成，长度为1到64个字符。 **取值范围：** 由英文、数字、连字符(-)、下划线(*)组成的1-64位字符串。 **默认取值：** 不涉及。 | #### 请求参数 无 #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 字段值的唯一标识。 **取值范围：** 不涉及。 | | turns | Array of [OpsTurn] objects | **参数解释：** 包含该条目具体业务内容的轮次数据列表，支持多轮对话格式，列表元素为OpsTurn对象，参考OpsTurn结构定义。 | | created_at | String | **参数解释：** 该条目被首次创建的时间。时间格式为yyyy-MM-ddTHH:mm:ssZ，示例：2024-01-01T12:00:00Z。 **取值范围：** 不涉及。 | | updated_at | String | **参数解释：** 该条目最后一次被修改的时间。时间格式为yyyy-MM-ddTHH:mm:ssZ，示例：2024-01-01T12:00:00Z。 **取值范围：** 不涉及。 | 表3OpsTurn | 参数 | 参数类型 | 描述 | |:---|:---|:---| | fields | Map\ | **参数解释：** 该轮次中具体字段的键值对集合。Key为字段名称（String类型），Value为字段值（OpsFieldValue类型，参考OpsFieldValue定义）。 | 表4OpsFieldValue | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 字段值的唯一标识。 **取值范围：** 不涉及。 | | key | String | **参数解释：** 字段名。 **取值范围：** 不涉及。 | | type | String | **参数解释：** 字段的数据类型。 **取值范围：** 不涉及。 | | content_type | String | **参数解释：** 内容展示类型。 **取值范围：** 不涉及。 | | value | Object | **参数解释：** 字段承载的实际业务数据，具体数据类型和格式根据type字段确定。 | | required | Boolean | **参数解释：** 字段是否必填标识。 **取值范围：** - true：必填字段 - false：选填字段 | #### 请求示例 查看评测集下某一条具体的数据项 ``` GET https://api.example.com/v1/ops/datasets/8a77718d-ce32-40f6-aca1-8ef4ffd339fa/items/69db711057456f5c7d422aa9 ``` #### 响应示例 **状态码：200** 查询成功 ``` { "id" : "69db711057456f5c7d422aa9", "turns" : [ { "fields" : { "input" : { "id" : "field_001", "key" : "input", "type" : "String", "content_type" : "text", "value" : "中国首都是哪里", "required" : true }, "reference_output" : { "id" : "field_002", "key" : "reference_output", "type" : "String", "content_type" : "text", "value" : "北京", "required" : false } } } ], "created_at" : "2026-04-12T10:16:48.837Z", "updated_at" : "2026-04-12T10:16:48.837Z" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 查询成功 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。