# 获取评估任务的洞察结果 - ShowOpsEvaluationTaskInsights #### 功能介绍 该接口用于获取评估任务的洞察结果，返回任务综合指标评分、高频异常分布及对应的链路诊断结果与修复策略的文本内容。 适用场景： - 获取任务维度的多维量化评分结果，用于衡量并对比被评估对象的综合基准表现。 - 定位导致评估失败或评分偏低的关键错误节点，获取基于错误链路的自动化修复策略，降低研发人员排查异常与修复耗时。 #### 调用方法 请参见[如何调用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:showOpsEvaluationTaskInsights | Read | evaluationTask \* | g:ResourceTag/\ | - | - | #### URI GET /v1/ops/evaluation-tasks/{task_id}/insights 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | task_id | 是 | String | **参数解释：** 评估任务的唯一标识符（ID）。该参数嵌入在API路径中，用于定位需要操作的具体任务实例。可通过调用创建评估任务接口获取，或通过查询评估任务列表接口获取。 **约束限制：** 长度为1\~100个字符的字符串。 **取值范围：** 只能由英文字母、数字及「-」组成，长度为1\~100个字符。 **默认取值：** 不涉及。 | #### 请求参数 无 #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | user_feedback | [OpsTaskSummaryUserFeedback] object | **参数解释：** 评估总结中用户对评估结果的反馈信息，包含点赞点踩状态及反馈选项。 **取值范围：** 不涉及。 | | summary | [OpsTaskSummary] object | **参数解释：** 评估任务的总结信息，包含评估总结的整体描述和正文内容。 **取值范围：** 不涉及。 | 表3OpsTaskSummaryUserFeedback | 参数 | 参数类型 | 描述 | |:---|:---|:---| | check_option | Array of [OpsTaskSummaryCheckOptionItem] objects | **参数解释：** 用户反馈时可选的反馈选项列表，数组内每个元素为OpsTaskSummaryCheckOptionItem对象，包含反馈选项描述和反馈选项值。 **取值范围：** 不涉及。 | | status | String | **参数解释：** 用户对评估总结的反馈状态。 **取值范围：** - GOOD：点赞 - BAD：点踩 - NONE：无反馈 | 表4OpsTaskSummaryCheckOptionItem | 参数 | 参数类型 | 描述 | |:---|:---|:---| | label | String | **参数解释：** 用户反馈选项的中文描述。 **取值范围：** - 答案不准确：反馈评估结果答案不准确 - 内容有害：反馈评估结果内容有害 - 回答内容太长：反馈评估结果回答内容过长 - 其他：其他反馈原因 | | value | String | **参数解释：** 用户反馈选项的英文标识值。 **取值范围：** - answer_incorrection：答案不准确 - answer_harmful：内容有害 - answer_too_long：回答内容太长 - others：其他 | 表5OpsTaskSummary | 参数 | 参数类型 | 描述 | |:---|:---|:---| | overview | String | **参数解释：** 评估总结整体描述内容。 **取值范围：** 不涉及。 | | content | 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 | **参数解释：** 对子错误的详细描述。 **取值范围：** 任意文本内容。 | **状态码：500** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 系统定义的标准化错误代码。 **取值范围：** 业务异常编码字符串。 | | error_msg | String | **参数解释：** 对错误的详细描述，包含异常原因或解决建议。 **取值范围：** 字符长度2-512，任意文本内容。 | | encoded_authorization_message | String | **参数解释：** 编码后的授权信息，用于客户端解析权限问题。 **取值范围：** Base64编码的字符串。 | | details | Array of [OpsErrorDetail] objects | **参数解释：** 错误详情列表，包含多个子错误的详细信息。 **取值范围：** 不涉及。 | | request_id | String | **参数解释：** 请求的唯一标识符，用于问题排查和链路追踪。 **取值范围：** 符合通用唯一识别码(UUID)标准的字符串。 | 表9OpsErrorDetail | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 子错误的标准化错误代码。 **取值范围：** 业务异常编码字符串。 | | error_msg | String | **参数解释：** 对子错误的详细描述。 **取值范围：** 任意文本内容。 | #### 请求示例 获取评估任务的洞察结果。 ``` GET https://api.example.com/v1/ops/evaluation-tasks/d499c3a8-791f-4eac-a542-01979fc41f28/insights { "user_feedback" : { "check_option" : [ { "label" : "答案不准确", "value" : "answer_incorrection" }, { "label" : "内容有害", "value" : "answer_harmful" } ], "status" : "BAD" }, "summary" : { "overview" : "", "content" : "" } } ``` #### 响应示例 **状态码：200** 获取任务详情 ``` { "user_feedback" : { "check_option" : [ { "label" : "答案不准确", "value" : "answer_incorrection" }, { "label" : "内容有害", "value" : "answer_harmful" } ], "status" : "GOOD" }, "summary" : { "overview" : "", "content" : "" } } ``` **状态码：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)。