j9九游会登录/ 智果（agentarts）智能体平台/ api参考/ api/ / / 获取评测集条目详情 - showopsdatasetitem
更新时间：2026-07-17 gmt 08:00
查看pdf

获取评测集条目详情 -j9九游会登录

功能介绍

该接口用于精确获取评测集中某一行特定数据条目的完整内容，通过评测集id与条目id的双重定位。

适用场景：

  • 单条样本核对：在对模型评测结果产生疑问时，调取对应原始数据条目的全量信息进行比对。

  • 数据编辑回显：在用户进入单条数据编辑界面前，通过此接口加载该条目的当前配置与字段内容。

调用方法

请参见如何调用api。

授权信息

账号根用户具备所有api的调用权限，如果使用账号下的iam用户调用当前api，该iam用户需具备如下身份策略权限，更多的权限说明请参见。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts:dataset:showopsdatasetitem

read

dataset *

g:resourcetag/

-

-

uri

get /v1/ops/datasets/{dataset_id}/items/{item_id}

表1 路径参数

参数

是否必选

参数类型

描述

dataset_id

是

string

参数解释：

评测集的唯一标识符（id）

约束限制：

由英文、数字、“-”、“_”组成，长度为1到64个字符。

取值范围：

由英文、数字、连字符(-)、下划线(_)组成的1-64位字符串。

默认取值：

无。

item_id

是

string

参数解释：

评测集条目的id。

约束限制：

由英文、数字、“-”、“_”组成，长度为1到64个字符。

取值范围：

1-64位字符。

默认取值：

不涉及。

请求参数

无

响应参数

状态码：200

表2 响应body参数

参数

参数类型

描述

id

string

参数解释：

数据条目的唯一标识符。

取值范围：

通常为符合 mongodb objectid 规范的 24 位十六进制字符串。

turns

array of opsturn objects

参数解释：

包含该条目具体业务内容的轮次数据列表，支持多轮对话格式。

取值范围：

符合opsturn定义的对象数组。

created_at

string

参数解释：

该条目被首次创建的时间。

取值范围：

utc 时间字符串。

updated_at

string

参数解释：

该条目最后一次被修改的时间。

取值范围：

utc 时间字符串。
表3 opsturn

参数

参数类型

描述

fields

mapopsfieldvalue>

参数解释：

该轮次中具体字段的键值对集合。

取值范围：

map 结构，value 参考opsfieldvalue定义。
表4 opsfieldvalue

参数

参数类型

描述

type

string

参数解释：

字段的数据类型。

取值范围：

如 string, integer, float 等。

content_type

string

参数解释：

内容展示类型。

取值范围：

如 text, markdown, image 等。

value

object

参数解释：

字段承载的实际业务数据。

取值范围：

根据type字段确定具体数据类型和格式。

请求示例

查看评测集下某一条具体的数据项

https://api.example.com/v1/ops/datasets/8a77718d-ce32-40f6-aca1-8ef4ffd339fa/items/69db711057456f5c7d422aa9
{
  "id" : "69db711057456f5c7d422aa9",
  "turns" : [ {
    "turn_id" : "4ae0dc64-e969-4bb8-8510-abba3509c511",
    "fields" : [ {
      "id" : "29f1fe93-8327-4077-bcf3-0039cf81dddb",
      "key" : "reference_output",
      "type" : "string",
      "content_type" : "text",
      "value" : "北京",
      "required" : false
    }, {
      "id" : "2470d5c8-28e6-4af6-b2cc-823391de43ed",
      "key" : "input",
      "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

查询成功

{
  "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:48.837z",
  "updated_at" : "2026-04-12t10:16:48.837z"
}

状态码

状态码

描述

200

查询成功

错误码

请参见错误码。

父主题：

相关文档

网站地图