文档首页/ 智果（AgentArts）智能体平台/ API参考/ API/ 评估/ 评估任务管理/ 查询评估任务的自定义标签值 - ListOpsEvaluationTaskCustomLabelValues
更新时间：2026-09-24 GMT+08:00
查看PDF
分享

查询评估任务的自定义标签值 - ListOpsEvaluationTaskCustomLabelValues

功能介绍

该接口用于查询评估任务的自定义标签值，支持按标签ID和项目ID进行过滤查询，适用于标签数据查询和分析的场景。

调用方法

请参见如何调用API。

授权信息

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

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts:evaluationTask:listOpsEvaluationTaskCustomLabelValues

List

evaluationTask *

g:ResourceTag/<tag-key>

-

-

URI

GET /v1/ops/evaluation-tasks/{task_id}/custom-labels-values

表1 路径参数

参数

是否必选

参数类型

描述

task_id

是

String

参数解释：

评估任务的唯一标识符（ID）。可通过调用创建评估任务接口获取，或通过查询评估任务列表接口获取。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，长度为1~100个字符的字符串。

默认取值：

不涉及。
表2 Query参数

参数

是否必选

参数类型

描述

tag_id

否

String

参数解释：

标签的唯一标识符（ID）。可通过查询标签列表接口获取。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字及连字符(-)组成，长度为1~100个字符的字符串。

默认取值：

不涉及。

item_id

否

String

参数解释：

评测集条目的唯一标识符（ID）。可通过查询评测集条目列表接口获取。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字及连字符(-)组成，长度为1~100个字符的字符串。

默认取值：

不涉及。

offset

否

Integer

参数解释：

分页查询的起始偏移量。用于指定从满足条件的第几条记录开始返回，常与 limit参数配合实现分页功能。

约束限制：

需与limit参数配合使用实现分页查询功能，不设置时默认从第0条开始返回。

取值范围：

0~10000。

默认取值：

0。

limit

否

Integer

参数解释：

单次查询返回的最大记录数量。用于控制分页查询时每页显示的数据条数。

约束限制：

需与offset参数配合使用实现分页查询功能，不设置时默认每页返回10条记录。

取值范围：

1~100。

默认取值：

10。

请求参数

无

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

msg

String

参数解释：

提示信息。

取值范围：

固定为 query succeed。

code

Integer

参数解释：

业务状态码。

取值范围：

固定为 200。

data

Array of OpsTaskCustomLabelValue objects

参数解释：

自定义标签值记录列表。

取值范围：

不涉及。

total

Integer

参数解释：

满足查询条件的记录总数。

取值范围：

非负整数。
表4 OpsTaskCustomLabelValue

参数

参数类型

描述

id

String

参数解释：

记录唯一标识（MongoDB ObjectId）。

取值范围：

24位十六进制字符串。

task_id

String

参数解释：

任务ID。

取值范围：

不涉及。

account_id

String

参数解释：

租户账号ID。

取值范围：

不涉及。

tag_id

String

参数解释：

标签ID。

取值范围：

不涉及。

tag_type

String

参数解释：

标签类型。

取值范围：

不涉及。

item_id

String

参数解释：

数据集条目ID。

取值范围：

不涉及。

annotated_value

String

参数解释：

标注值（实际记录的标签值内容）。

取值范围：

不涉及。

create_at

String

参数解释：

创建时间。

取值范围：

ISO 8601 时间格式。

update_at

String

参数解释：

更新时间。

取值范围：

ISO 8601 时间格式。

is_delete

Boolean

参数解释：

是否已删除标记。

取值范围：

  • true：已删除

  • false：未删除

请求示例

查询评估任务的自定义标签值

GET https://api.example.com/v1/ops/evaluation-tasks/1769499746650415700514/custom-labels-values

响应示例

状态码：200

{
  "msg" : "query succeed",
  "code" : 200,
  "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
  } ],
  "total" : 10
}

状态码

状态码

描述

200

返回评估任务的自定义标签值

错误码

请参见错误码。

父主题： 评估任务管理

相关文档