# 更新评估任务洞察结果的用户反馈 - UpdateOpsEvaluationTaskInsights #### 功能介绍 该接口用于更新用户对于洞察内容的反馈。 适用场景：用户反馈建议。 #### 调用方法 请参见[如何调用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:updateOpsEvaluationTaskInsights | Write | evaluationTask \* | g:ResourceTag/\ | - | - | #### URI PUT /v1/ops/evaluation-tasks/{task_id}/insights 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | task_id | 是 | String | **参数解释：** 评估任务的唯一标识符（ID）。该参数嵌入在API路径中，用于定位需要操作的具体任务实例。可通过调用创建评估任务接口获取，或通过查询评估任务列表接口获取。 **约束限制：** 长度为0\~100个字符的字符串。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | check_option | 否 | Array of strings | **参数解释：** 用户选定的选项的变量名列表。数组中每个元素为选项的变量名。 **约束限制：** 数组元素个数为0\~100个。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | other_content | 否 | String | **参数解释：** 用户反馈内容。 **约束限制：** 不涉及。 **取值范围：** 任意字符，长度为0\~2000个字符。 **默认取值：** 不涉及。 | | status | 否 | String | **参数解释：** 点赞点踩状态。 **约束限制：** 不涉及。 **取值范围：** - GOOD：点赞 - BAD：点踩 - NONE：无反馈 **默认取值：** 不涉及。 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | data | String | **参数解释：** 执行成功无错误时返回该内容，通常设置为空即可。 **取值范围：** 不涉及。 | **状态码：400** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 系统定义的标准化错误代码。 **取值范围：** 业务异常编码字符串。 | | error_msg | String | **参数解释：** 对错误的详细描述，包含异常原因或解决建议。 **取值范围：** 字符长度2-512，任意文本内容。 | | encoded_authorization_message | String | **参数解释：** 编码后的授权信息，用于客户端解析权限问题。 **取值范围：** Base64编码的字符串。 | | details | Array of [OpsErrorDetail] objects | **参数解释：** 错误详情列表，包含多个子错误的详细信息。 **取值范围：** 不涉及。 | | request_id | String | **参数解释：** 请求的唯一标识符，用于问题排查和链路追踪。 **取值范围：** 符合通用唯一识别码(UUID)标准的字符串。 | 表5OpsErrorDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 子错误的标准化错误代码。 **取值范围：** 业务异常编码字符串。 | | error_msg | String | **参数解释：** 对子错误的详细描述。 **取值范围：** 任意文本内容。 | **状态码：500** 表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 | **参数解释：** 对子错误的详细描述。 **取值范围：** 任意文本内容。 | #### 请求示例 修改用户反馈 ``` PUT https://api.example.com/v1/ops/evaluation-tasks/d499c3a8-791f-4eac-a542-01979fc41f28/insights { "check_option" : [ "answer_incorrection", "other" ], "other_content" : "有用", "status" : "GOOD" } ``` #### 响应示例 **状态码：200** 获取任务详情 ``` { "data" : "" } ``` **状态码：400** 参数错误 ``` { "error_code" : "AgentArts.03400003", "error_msg" : "评估对象不存在" } ``` **状态码：500** 系统错误 ``` { "error_code" : "AgentArts.03500001", "error_msg" : "查询过程出错" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 获取任务详情 | | 400 | 参数错误 | | 500 | 系统错误 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。