查询评估任务的自定义标签值 - ListOpsEvaluationTaskCustomLabelValues
功能介绍
该接口用于查询评估任务的自定义标签值，支持按标签ID和项目ID进行过滤查询，适用于标签数据查询和分析的场景。
URI
GET /v1/ops/evaluation-tasks/{task_id}/custom-labels-values
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
task_id |
是 |
String |
参数解释： 评估任务的唯一标识符（ID）。该ID用于在API路径中精确定位需要操作的目标任务。 约束限制： 长度为0到100个字符的字符串。 取值范围： 不涉及。 默认取值： 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
tag_id |
否 |
String |
参数解释： 标签的唯一标识符（ID）。作为查询参数，用于过滤或识别需要关联自定义标签值的特定标签对象。 约束限制： 长度为0到100个字符的字符串。 取值范围： 不涉及。 默认取值： 不涉及。 |
|
item_id |
否 |
String |
参数解释： 评测集条目的唯一标识符（ID）。用于在评估任务中快速检索或指定评测集内的特定数据条目。 约束限制： 长度为0到100个字符的字符串。 取值范围： 不涉及。 默认取值： 不涉及。 |
|
offset |
否 |
Integer |
参数解释： 分页查询的起始偏移量。用于指定从满足条件的第几条记录开始返回，常与 limit参数配合实现分页功能。 约束限制： 必须为整数，且大小在0到10,000 之间。 取值范围： 0-10000。 默认取值： 0。 |
|
limit |
否 |
Integer |
参数解释： 单次查询返回的最大记录数量。用于控制分页查询时每页显示的数据条数。 约束限制： 必须为整数，且大小在1到100之间。 取值范围： 1-100。 默认取值： 10。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Content-Type |
是 |
String |
参数解释： 消息体编码格式。用于告知服务端请求体（Body）所采用的主体数据类型，以便服务端正确解析。 约束限制： 不涉及 取值范围： 不涉及 默认取值： application/json |
|
Authorization |
是 |
String |
参数解释： 签名认证信息，当使用AK/SK方式认证时，使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
|
X-Sdk-Date |
是 |
String |
参数解释： 请求发送的时间，当使用AK/SK方式认证时，使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
响应参数
状态码：200
返回评估任务的自定义标签值
无
请求示例
查询评估任务的自定义标签值
GET https://*.com/agentarts/v1/ops/evaluation-tasks/1769499746650415700514 /custom-labels-values null
响应示例
状态码：200
返回评估任务的自定义标签值
{
"body" : {
"data" : [ {
"id" : "69dd96e28d71a0ed771dca86",
"task_id" : "31f26847-58c0-4966-b3b4-2141d217f433",
"account_id" : "6c23f0482eb54863ba41cc42dab176dc",
"tag_id" : "639a0c3e-28ce-4949-9614-71e46e790ea3",
"tag_type" : "free_text",
"item_id" : "69dc48fe683ed580dd4641c6",
"annotated_value" : "52",
"create_at" : "2026-04-14T01:22:42.192Z",
"update_at" : "2026-04-14T01:22:42.192Z",
"is_delete" : false
}, {
"id" : "69dd96e28d71a0ed771dca87",
"task_id" : "31f26847-58c0-4966-b3b4-2141d217f433",
"account_id" : "6c23f0482eb54863ba41cc42dab176dc",
"tag_id" : "639a0c3e-28ce-4949-9614-71e46e790ea3",
"tag_type" : "free_text",
"item_id" : "69dc48fe683ed580dd4641c4",
"annotated_value" : "52",
"create_at" : "2026-04-14T01:22:42.192Z",
"update_at" : "2026-04-14T01:22:42.192Z",
"is_delete" : false
} ],
"msg" : "query succeed",
"total" : 10
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
返回评估任务的自定义标签值 |
错误码
请参见错误码。
