# 统计每个任务的评估器得分分布 - ShowOpsEvaluationTaskChartsScoreDistribution #### 功能介绍 该接口用于获取评估任务中各评估器的得分分布情况，统计不同分数区间的样本数量，适用于评估结果可视化分析的场景。 适用场景： - 查看评估得分的分布特征和集中趋势。 - 识别评估结果中高分和低分样本的比例。 - 分析评估模型的评分一致性和区分度。 #### 调用方法 请参见[如何调用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:showOpsEvaluationTaskChartsScoreDistribution | Read | evaluationTask \* | g:ResourceTag/\ | - | - | #### URI GET /v1/ops/evaluation-tasks/{task_id}/charts/score-distribution 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | task_id | 是 | String | **参数解释：** 评估任务的唯一标识符ID。该参数用于告知后端服务需要针对哪一个具体的评估任务。可通过调用创建评估任务接口获取，或通过查询评估任务列表接口获取。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字组成，长度为1\~100个字符。 **默认取值：** 不涉及。 | #### 请求参数 无 #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | data | [OpsScoreDistributionData] object | **参数解释：** 响应数据主体，包含各评估器的得分分布信息。 **取值范围：** 不涉及。 | 表3OpsScoreDistributionData | 参数 | 参数类型 | 描述 | |:---|:---|:---| | evaluator_distribution_info | Array of [OpsEvaluatorScoreDistribution] objects | **参数解释：** 各评估器的得分分布信息列表。数组内的元素为OpsEvaluatorScoreDistribution对象，表示单个评估器的得分分布信息。 **取值范围：** 不涉及。 | 表4OpsEvaluatorScoreDistribution | 参数 | 参数类型 | 描述 | |:---|:---|:---| | evaluator_id | String | **参数解释：** 评估器的唯一标识符ID。 **取值范围：** UUID格式的字符串。 | | evaluator_name | String | **参数解释：** 评估器的显示名称。 **取值范围：** 1-100字符。 | | distribution | Array of [OpsScoreCountItem] objects | **参数解释：** 该评估器的得分分布列表，包含各分数及其对应的样本数量。数组内的元素为OpsScoreCountItem对象，表示单个得分及其对应的样本数量。 **取值范围：** 不涉及。 | 表5OpsScoreCountItem | 参数 | 参数类型 | 描述 | |:---|:---|:---| | score | String | **参数解释：** 评估得分值，保留两位小数。 **取值范围：** 0.00-1.00之间的字符串。 | | count | Integer | **参数解释：** 该得分对应的样本数量。 **取值范围：** 大于等于0的整数。 | **状态码：404** 表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/a67452bf21f819-6f91-4568-9f2f-57ef9562ab7b/charts/score-distribution ``` #### 响应示例 **状态码：200** 返回评估任务中各评估器的得分分布情况 ``` { "data" : { "evaluator_distribution_info" : [ { "distribution" : [ { "count" : 1, "score" : "0.20" }, { "count" : 1, "score" : "0.30" } ], "evaluator_id" : "98527a44-52c5-4ce0-a918-8968081606b4", "evaluator_name" : "正确性" } ] } } ``` **状态码：404** 任务不存在 ``` { "error_code" : "AgentArts.10004001", "error_msg" : "任务不存在" } ``` **状态码：500** 内部服务错误 ``` { "error_code" : "AgentArts.10005001", "error_msg" : "内部服务错误" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 返回评估任务中各评估器的得分分布情况 | | 404 | 任务不存在 | | 500 | 内部服务错误 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。