文档首页/ 智果（AgentArts）智能体平台/ API参考/ API/ 评估/ 评估任务管理/ 统计每个任务的评估器得分分布 - ShowOpsEvaluationTaskChartsScoreDistribution
更新时间：2026-07-22 GMT+08:00
查看PDF
分享

统计每个任务的评估器得分分布 - ShowOpsEvaluationTaskChartsScoreDistribution

功能介绍

该接口用于获取评估任务中各评估器的得分分布情况，统计不同分数区间的样本数量，适用于评估结果可视化分析的场景。

适用场景：

- 查看评估得分的分布特征和集中趋势。

- 识别评估结果中高分和低分样本的比例。

- 分析评估模型的评分一致性和区分度。

调用方法

请参见如何调用API。

授权信息

账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts:evaluationTask:showOpsEvaluationTaskChartsScoreDistribution

Read

evaluationTask *

g:ResourceTag/<tag-key>

-

-

URI

GET /v1/ops/evaluation-tasks/{task_id}/charts/score-distribution

表1 路径参数

参数

是否必选

参数类型

描述

task_id

是

String

参数解释：

评估任务的唯一标识符ID。该参数用于告知后端服务需要针对哪一个具体的评估任务。

约束限制：

字符串长度为0-100。

取值范围：

0-100字符。

默认取值：

不涉及。

请求参数

无

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

data

OpsScoreDistributionData object

参数解释：

响应数据主体，包含各评估器的得分分布信息。

取值范围：

不涉及。
表3 OpsScoreDistributionData

参数

参数类型

描述

evaluator_distrution_info

Array of OpsEvaluatorScoreDistribution objects

参数解释：

各评估器的得分分布信息列表。

取值范围：

不涉及。
表4 OpsEvaluatorScoreDistribution

参数

参数类型

描述

evaluator_id

String

参数解释：

评估器的唯一标识符ID。

取值范围：

UUID格式的字符串。

evaluator_name

String

参数解释：

评估器的显示名称。

取值范围：

1-100字符。

distrution

Array of OpsScoreCountItem objects

参数解释：

该评估器的得分分布列表，包含各分数及其对应的样本数量。

取值范围：

不涉及。
表5 OpsScoreCountItem

参数

参数类型

描述

score

String

参数解释：

评估得分值，保留两位小数。

取值范围：

0.00-1.00之间的字符串。

count

Integer

参数解释：

该得分对应的样本数量。

取值范围：

大于等于0的整数。

状态码：404

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

系统定义的标准化错误代码。

取值范围：

业务异常编码字符串。

error_msg

String

参数解释：

对错误的详细描述，包含异常原因或解决建议。

取值范围：

字符长度2-512，任意文本内容。

状态码：500

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

系统定义的标准化错误代码。

取值范围：

业务异常编码字符串。

error_msg

String

参数解释：

对错误的详细描述，包含异常原因或解决建议。

取值范围：

字符长度2-512，任意文本内容。

请求示例

请求获取评估任务中各评估器的得分分布情况

GET https://api.example.com/v1/ops/evaluation-tasks/a67452bf21f819-6f91-4568-9f2f-57ef9562ab7b/charts/score-distribution

响应示例

状态码：200

返回评估任务中各评估器的得分分布情况

{
  "data" : {
    "evaluator_distrution_info" : [ {
      "distrution" : [ {
        "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

内部服务错误

错误码

请参见错误码。

父主题： 评估任务管理

相关文档