获取评测集条目列表 - ListOpsDatasetItems
功能介绍
该接口用于分页检索指定评测集的具体数据记录,支持查看当前草稿态数据或特定历史发布版本的数据样本。
适用场景:
URI
GET /v1/ops/datasets/{dataset_id}/items
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
dataset_id |
是 |
String |
参数解释: 评测集的ID。 约束限制: 由英文、数字、“-”、“_”组成,长度为1到64个字符。 取值范围: 1-64位字符。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
offset |
否 |
Integer |
参数解释: 分页查询的起始偏移量。用于指定从满足条件的第几条记录开始返回,常与 limit参数配合实现分页功能。 约束限制: 必须为整数,且大小在0到10,000 之间。 取值范围: 0-10000。 默认取值: 0。 |
|
limit |
否 |
Integer |
参数解释: 单次查询返回的最大记录数量。用于控制分页查询时每页显示的数据条数。 约束限制: 必须为整数,且大小在1到100之间。 取值范围: 1-100。 默认取值: 10。 |
|
version_id |
否 |
String |
参数解释: 评测集的版本标识符。用于指定查询特定历史版本下的数据条目。 约束限制: 字符串长度限制为0到100个字符。 取值范围: 有效的版本ID字符串。 默认取值: 若为空,默认指向当前的草稿版本(Draft)。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Content-Type |
是 |
String |
参数解释: 消息体编码格式。用于告知服务端请求体(Body)所采用的主体数据类型,以便服务端正确解析。 约束限制: 不涉及 取值范围: 不涉及 默认取值: application/json |
|
Authorization |
是 |
String |
参数解释: 签名认证信息,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
X-Sdk-Date |
是 |
String |
参数解释: 请求发送的时间,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
items |
Array of OpsItemDetail objects |
参数解释: 当前分页返回的数据条目详细内容列表。 取值范围: 参考OpsItemDetail 结构。 |
|
total |
Long |
参数解释: 评测集中满足查询条件的记录总数。 取值范围: 0到2147483647。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
参数解释: 数据条目的唯一标识符。 取值范围: 通常为符合 MongoDB ObjectID 规范的 24 位十六进制字符串。 |
|
turns |
Array of OpsTurn objects |
参数解释: 包含该条目具体业务内容的轮次数据列表,支持多轮对话格式。 取值范围: 符合OpsTurn定义的对象数组。 |
|
created_at |
String |
参数解释: 该条目被首次创建的时间。 取值范围: UTC 时间字符串。 |
|
updated_at |
String |
参数解释: 该条目最后一次被修改的时间。 取值范围: UTC 时间字符串。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
fields |
Map<String,OpsFieldValue> |
参数解释: 该轮次中具体字段的键值对集合。 取值范围: Map 结构,Value 参考OpsFieldValue定义。 |
请求示例
分页查看评测集 "8a77718d..." 中的数据项,包含具体的输入问题和参考答案。
https://*.com/agentarts/v1/ops/datasets/8a77718d-ce32-40f6-aca1-8ef4ffd339fa/items?offset=0&limit=100
响应示例
状态码:200
查询成功
{
"total" : 1,
"items" : [ {
"id" : "69db711057456f5c7d422aa9",
"turns" : [ {
"fields" : {
"input" : {
"type" : "String",
"content_type" : "text",
"value" : "中国首都是哪里"
},
"reference_output" : {
"type" : "String",
"content_type" : "text",
"value" : "北京"
}
}
} ],
"created_at" : "2026-04-12T10:16:48Z",
"updated_at" : "2026-04-12T10:16:48Z"
} ]
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
查询成功 |
错误码
请参见错误码。