# 批量添加评估任务的自定义标签值 - BatchAddOpsEvaluationTaskCustomLabelValues #### 功能介绍 该接口用于批量添加评估任务的自定义标签值，支持为多个数据项设置标签值，适用于数据标注和分类管理的场景。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。 #### 授权信息 账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-agentarts/Permission.html)。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | agentarts:evaluationTask:batchAddOpsEvaluationTaskCustomLabelValues | Write | evaluationTask \* | g:ResourceTag/\ | - | - | #### URI POST /v1/ops/evaluation-tasks/{task_id}/custom-labels-values 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | task_id | 是 | String | **参数解释：** 评估任务的唯一标识符（ID）。可通过调用创建评估任务接口获取，或通过查询评估任务列表接口获取。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字组成，长度为1\~100个字符的字符串。 **默认取值：** 不涉及。 | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | records | 否 | Array of [AddOpsEvaluationTaskCustomLabelValuesRequestBody] objects | **参数解释：** 评估任务的自定义标签值记录列表。数组内每个元素为AddOpsEvaluationTaskCustomLabelValuesRequestBody对象，包含tag_id、item_id、annotated_value、tag_type等字段，用于指定需要添加的标签值信息，具体字段定义参见该对象说明。 **约束限制：** 数组长度为1到100。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | 表3AddOpsEvaluationTaskCustomLabelValuesRequestBody | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | tag_id | 是 | String | **参数解释：** 标签的唯一标识符（ID）。可通过查询标签列表接口获取。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字及连字符(-)组成，长度为1\~100个字符的字符串。 **默认取值：** 不涉及。 | | item_id | 是 | String | **参数解释：** 评测集条目的唯一标识符（ID）。可通过查询评测集条目列表接口获取。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字及连字符(-)组成，长度为1\~100个字符的字符串。 **默认取值：** 不涉及。 | | annotated_value | 是 | String | **参数解释：** 具体的标注内容。当tag_type为分类类型时，annotated_value为分类ID（即标签对应的分类选项ID）；当tag_type为布尔类型时，annotated_value为布尔映射值（如"true"或"false"）。 **约束限制：** annotated_value的值与tag_type相关，需根据tag_type的取值确定annotated_value的格式。 **取值范围：** 只能由英文字母、数字组成，长度为1\~100个字符的字符串。 **默认取值：** 不涉及。 | | tag_type | 是 | String | **参数解释：** 标签的类型，用于区分标注值的逻辑处理方式。常见类型包括：free_text（自由文本分类）、boolean（布尔映射）等。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字及下划线(_)组成，长度为1\~100个字符的字符串。 **默认取值：** 不涉及。 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | body | [BatchTagValueMsg] object | **参数解释：** 批量添加评估任务的自定义标签值返回体。 | 表5BatchTagValueMsg | 参数 | 参数类型 | 描述 | |:---|:---|:---| | msg | String | **参数解释：** 操作结果的描述信息或提示信息。 **取值范围：** 不涉及。 | | code | String | **参数解释：** 操作结果的状态码或返回码。 **取值范围：** 不涉及。 | **状态码：400** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 系统定义的标准化错误代码。 **取值范围：** 业务异常编码字符串。 | | error_msg | String | **参数解释：** 对错误的详细描述，包含异常原因或解决建议。 **取值范围：** 字符长度2-512，任意文本内容。 | | encoded_authorization_message | String | **参数解释：** 编码后的授权信息，用于客户端解析权限问题。 **取值范围：** Base64编码的字符串。 | | details | Array of [OpsErrorDetail] objects | **参数解释：** 错误详情列表，包含多个子错误的详细信息。 **取值范围：** 不涉及。 | | request_id | String | **参数解释：** 请求的唯一标识符，用于问题排查和链路追踪。 **取值范围：** 符合通用唯一识别码(UUID)标准的字符串。 | 表7OpsErrorDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 子错误的标准化错误代码。 **取值范围：** 业务异常编码字符串。 | | error_msg | String | **参数解释：** 对子错误的详细描述。 **取值范围：** 任意文本内容。 | #### 请求示例 请求批量添加评估任务的自定义标签值 ``` POST https://api.example.com/v1/ops/evaluation-tasks/a64c3de9-6f91-4568-9f2f-57ef9562ab7b/custom-labels-values { "records" : [ { "tag_id" : "a11164cd819-6f91-4568-9f2f-57ef9562ab7b", "item_id" : "a11164cd819-6f91-4568-9f2f-57ef9562ab7b", "annotated_value" : "123", "tag_type" : "free-text" } ] } ``` #### 响应示例 **状态码：200** 添加成功 ``` { "body" : { "code" : "200", "msg" : "添加成功" } } ``` **状态码：400** 请求错误 ``` { "error_code" : "AgentArts.03400001", "error_msg" : "请求错误" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 添加成功 | | 400 | 请求错误 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。