文档首页/ 智能体开发平台 AgentArts/ API参考/ API/ 评估/ 评估器管理/ 更新评估器标签 - UpdateOpsEvaluatorTags
更新时间:2026-04-15 GMT+08:00
分享

更新评估器标签 - UpdateOpsEvaluatorTags

功能介绍

该接口用于全量更新指定评估器的标签信息,通过重新定义评估器的分类维度,实现对评测资产的精准分类、快速检索及生命周期归类。

URI

PUT /v1/ops/evaluators/{evaluator_id}/tags

表1 路径参数

参数

是否必选

参数类型

描述

evaluator_id

String

参数解释:

评估器的唯一标识符(ID)。用于在路径中精确定位需要进行标签更新操作的评估器实例。

约束限制:

长度为1到100个字符的字符串。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释:

消息体编码格式。用于告知服务端请求体(Body)所采用的主体数据类型,以便服务端正确解析。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json

Authorization

String

参数解释:

签名认证信息,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

X-Sdk-Date

String

参数解释:

请求发送的时间,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

records

Array of EvaluationOpsResourceTag objects

参数解释:

包含的标签列表。

约束限制:

数组长度为0到200。

取值范围:

参考EvaluationOpsResourceTag定义。

默认取值:

不涉及。

表4 EvaluationOpsResourceTag

参数

是否必选

参数类型

描述

tag_id

String

参数解释:

标签的键,标识类别。

约束限制:

1到256字符。

取值范围:

不涉及。

默认取值:

不涉及。

tag_type

String

参数解释:

标签的值,存储具体内容。

约束限制:

1到512字符。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

创建成功

请求示例

全量更新评估器的标签,用于分类管理和资产审计。

PUT https://*.com/agentarts/v1/ops/evaluators/7590068991923321858/tags

{
  "records" : [ {
    "tag_id" : "key",
    "tag_type" : "value"
  } ]
}

响应示例

状态码:200

创建成功

{
  "body" : {
    "message" : "Tags updated successfully",
    "evaluator_id" : "7590068991923321858",
    "updated_at" : "2024-03-21T16:00:00Z"
  }
}

状态码

状态码

描述

200

创建成功

错误码

请参见错误码

相关文档