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

查询评估任务的自定义标签列表 - ListOpsEvaluationTaskCustomLabels

功能介绍

该接口用于查询评估任务的所有自定义标签，返回标签ID、类型、创建时间等详细信息，支持分页查询和筛选，适用于标签管理和查询的场景。

适用场景：

  • 查看评估任务使用的所有分类标记。

  • 分析自定义标签的使用情况和分布特征。

调用方法

请参见如何调用API。

授权信息

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

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts:evaluationTask:listOpsEvaluationTaskCustomLabels

List

evaluationTask *

g:ResourceTag/<tag-key>

-

-

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

task_id

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

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

默认取值：

不涉及。
表2 Query参数

参数

是否必选

参数类型

描述

offset

否

Integer

参数解释：

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

约束限制：

必须为整数，且大小在0到10,000之间。

取值范围：

0-10000。

默认取值：

0。

limit

否

Integer

参数解释：

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

约束限制：

必须为整数，且大小在1到100之间。

取值范围：

1-100。

默认取值：

10。

请求参数

无

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

msg

String

参数解释：

提示信息。

取值范围：

固定为 query succeed。

code

Integer

参数解释：

业务状态码。

取值范围：

固定为 200。

data

Array of OpsTaskCustomLabel objects

参数解释：

自定义标签记录列表。

取值范围：

不涉及。

total

Integer

参数解释：

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

取值范围：

非负整数。
表4 OpsTaskCustomLabel

参数

参数类型

描述

id

String

参数解释：

记录唯一标识（MongoDB ObjectId）。

取值范围：

24位十六进制字符串。

task_id

String

参数解释：

任务ID。

取值范围：

不涉及。

account_id

String

参数解释：

租户账号ID。

取值范围：

不涉及。

tag_id

String

参数解释：

标签ID。

取值范围：

不涉及。

tag_type

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/a67452bf21f819-6f91-4568-9f2f-57ef9562ab7b/custom-labels

响应示例

状态码：200

{
  "msg" : "query succeed",
  "code" : 200,
  "data" : [ {
    "id" : "69a10b01c5f357f3aebe434f",
    "task_id" : "24545415455",
    "account_id" : "6c23f0482eb54863ba41cc42dab176dc",
    "tag_id" : "a64cd819-6f91-4568-9f2f-57ef9562ab7b",
    "tag_type" : "free_text",
    "create_at" : "2026-02-27T03:09:53.799Z",
    "update_at" : "2026-02-27T03:09:53.799Z",
    "is_delete" : false
  }, {
    "id" : "69a10b01c5f357f3aebe4350",
    "task_id" : "24545415455",
    "account_id" : "6c23f0482eb54863ba41cc42dab176dc",
    "tag_id" : "a64cd819-6f91-4568-9f2f-57ef9562ab7b",
    "tag_type" : "free_text",
    "create_at" : "2026-02-27T03:09:53.799Z",
    "update_at" : "2026-02-27T03:09:53.799Z",
    "is_delete" : false
  }, {
    "id" : "69a10afbc5f357f3aebe4316",
    "task_id" : "24545415455",
    "account_id" : "6c23f0482eb54863ba41cc42dab176dc",
    "tag_id" : "a64cd819-6f91-4568-9f2f-57ef9562ab7b",
    "tag_type" : "free_text",
    "create_at" : "2026-02-27T03:09:50.097Z",
    "update_at" : "2026-02-27T03:09:50.097Z",
    "is_delete" : false
  } ],
  "total" : 12
}

状态码

状态码

描述

200

返回任务自定义列表

错误码

请参见错误码。

父主题： 评估任务管理

相关文档