# 获取评测集条目列表 - ListOpsDatasetItems #### 功能介绍 该接口用于分页检索指定评测集的具体数据记录，支持查看当前草稿态数据或特定历史发布版本的数据样本。 适用场景： - 内容预览：在评测集详情页分页展示具体的数据行，供用户直观核查数据质量。 - 版本溯源：通过指定版本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:listOpsDatasetItems | List | dataset \* | g:ResourceTag/\ | - | - | #### URI GET /v1/ops/datasets/{dataset_id}/items 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | dataset_id | 是 | String | **参数解释：** 评测集的唯一标识符（ID）。可通过调用创建评测集接口获取，或通过查询评测集列表接口获取。 **约束限制：** 不涉及。 **取值范围：** 由英文、数字、连字符(-)、下划线(_)组成的1\~64个字符串。 **默认取值：** 无。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | version_id | 否 | String | **参数解释：** 评测集的版本标识符（ID），用于指定查询特定历史版本下的数据条目。 **约束限制：** 不涉及。 **取值范围：** 由英文、数字、连字符(-)、下划线(_)组成的0\~100个字符的字符串。 **默认取值：** 若为空，默认指向当前的草稿版本（Draft）。 | | offset | 否 | Integer | **参数解释：** 分页查询的起始偏移量。用于指定从满足条件的第几条记录开始返回，常与 limit参数配合实现分页功能。 **约束限制：** 与limit参数配合使用实现分页查询。 **取值范围：** 0\~10000。 **默认取值：** 0。 | | limit | 否 | Integer | **参数解释：** 单次查询返回的最大记录数量。用于控制分页查询时每页显示的数据条数。 **约束限制：** 与offset参数配合使用实现分页查询。 **取值范围：** 1-100。 **默认取值：** 10。 | | is_published | 否 | Boolean | **参数解释：** 查询评测集是否发布。 **约束限制：** 不涉及。 **取值范围：** - true：已发布 - false：未发布 **默认取值：** false。 | #### 请求参数 无 #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | items | Array of [OpsItemDetail] objects | **参数解释：** 当前分页返回的数据条目详细内容列表。列表元素为OpsItemDetail对象，参考OpsItemDetail结构定义。 | | total | Long | **参数解释：** 评测集中满足查询条件的记录总数。 **取值范围：** 由数字组成， 0\~2147483647。 | 表4OpsItemDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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。 **取值范围：** 不涉及。 | 表5OpsTurn | 参数 | 参数类型 | 描述 | |:---|:---|:---| | fields | Map\ | **参数解释：** 该轮次中具体字段的键值对集合。Key为字段名称（String类型），Value为字段值（OpsFieldValue类型，参考OpsFieldValue定义）。 | 表6OpsFieldValue | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 字段值的唯一标识。 **取值范围：** 不涉及。 | | key | String | **参数解释：** 字段名。 **取值范围：** 不涉及。 | | type | String | **参数解释：** 字段的数据类型。 **取值范围：** 不涉及。 | | content_type | String | **参数解释：** 内容展示类型。 **取值范围：** 不涉及。 | | value | Object | **参数解释：** 字段承载的实际业务数据，具体数据类型和格式根据type字段确定。 | | required | Boolean | **参数解释：** 字段是否必填标识。 **取值范围：** - true：必填字段 - false：选填字段 | #### 请求示例 分页查看评测集 "8a77718d..." 中的数据项，包含具体的输入问题和参考答案。 ``` GET https://api.example.com/v1/ops/datasets/8a77718d-ce32-40f6-aca1-8ef4ffd339fa/items?offset=0&limit=100 ``` #### 响应示例 **状态码：200** 查询成功 ``` { "total" : 1, "items" : [ { "id" : "69db711057456f5c7d422aa9", "turns" : [ { "fields" : { "input" : { "key" : "input", "type" : "String", "content_type" : "text", "value" : "中国首都是哪里" }, "reference_output" : { "key" : "reference_output", "type" : "String", "content_type" : "text", "value" : "北京" } } } ], "created_at" : "2026-04-12T10:16:48Z", "updated_at" : "2026-04-12T10:16:48Z" } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 查询成功 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。