获取评估任务的洞察结果 - ShowOpsEvaluationTaskInsights
功能介绍
该接口用于获取评估任务的洞察结果，返回任务综合指标评分、高频异常分布及对应的链路诊断结果与修复策略的文本内容。
适用场景：
调用方法
请参见如何调用API。
授权信息
账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。
| 授权项 | 访问级别 | 资源类型（*为必须） | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| agentarts:evaluationTask:showOpsEvaluationTaskInsights | Read | evaluationTask * | g:ResourceTag/<tag-key> | - | - |
URI
GET /v1/ops/evaluation-tasks/{task_id}/insights
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| task_id | 是 | String | 参数解释： 评估任务的唯一标识符（ID）。该参数嵌入在API路径中，用于定位需要操作的具体任务实例。 约束限制： 长度为0到100个字符的字符串。 取值范围： 不涉及。 默认取值： 不涉及。 |
请求参数
无
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| user_feedback | TaskSummaryUserFeedback object | 用户的反馈的可选项以及点赞点踩的状态。 |
| summary | TaskSummary object | 评估任务的总结报告。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| check_option | Array of TaskSummaryCheckOptionItem objects | 用户反馈时的可选项。 |
| status | String | 点赞点踩状态,GOOD点赞，BAD点踩，NONE表示无反馈。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| label | String | 反馈选项描述，答案不准确/内容有害/回答内容太长/其他。 |
| value | String | 反馈选项值，answer_incorrection/answer_harmful/answer_too_long/others |
状态码：400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释： 系统定义的标准化错误代码。 取值范围： 业务异常编码字符串。 |
| error_msg | String | 参数解释： 对错误的详细描述，包含异常原因或解决建议。 约束限制： 字符串类型，最小长度为2，最大长度为512。 取值范围： 字符长度2-512，任意文本内容。 |
状态码：500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释： 系统定义的标准化错误代码。 取值范围： 业务异常编码字符串。 |
| error_msg | String | 参数解释： 对错误的详细描述，包含异常原因或解决建议。 约束限制： 字符串类型，最小长度为2，最大长度为512。 取值范围： 字符长度2-512，任意文本内容。 |
请求示例
获取评估任务的洞察结果。
GET https://*.com/agentarts/v1/ops/evaluation-tasks/d499c3a8-791f-4eac-a542-01979fc41f28/insights
{
"user_feedback" : {
"check_option" : [ {
"label" : "答案不准确",
"value" : "answer_incorrection"
}, {
"label" : "内容有害",
"value" : "answer_harmful"
} ],
"status" : "GOOD/BAD/NONE"
},
"summary" : {
"overview" : "",
"content" : ""
}
} 响应示例
状态码：200
获取任务详情
{
"user_feedback" : {
"check_option" : [ {
"label" : "答案不准确",
"value" : "answer_incorrection"
}, {
"label" : "内容有害",
"value" : "answer_harmful"
} ],
"status" : "GOOD/BAD/NONE"
},
"summary" : {
"overview" : "",
"content" : ""
}
} 状态码：400
参数错误
{
"error_code" : "AgentArts.03400003",
"error_msg" : "评估对象不存在"
} 状态码：500
系统错误
{
"error_code" : "AgentArts.03500001",
"error_msg" : "查询过程出错"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 获取任务详情 |
| 400 | 参数错误 |
| 500 | 系统错误 |
错误码
请参见错误码。
