查询智能体优化任务指标列表

功能介绍

本接口用于拉取智能体优化任务训练过程中产生的核心评估指标数据，通常按迭代步数（Step/Epoch）时序返回。

适用场景：

在任务结束后，查看详细的训练指标数据，用于生成实验报告或对比不同超参数配置的训练效果。

URI

GET /v1/ops/model-tuning-tasks/{task_id}/metrics

表1 路径参数
参数	是否必选	参数类型	描述
task_id	是	String	参数解释：智能体优化任务ID，标识任务的唯一标识符。获取方法请参考查询智能体优化任务列表。约束限制：不涉及取值范围： 32位ID字符串。默认取值：无

表2 Query参数
参数	是否必选	参数类型	描述
offset	否	Integer	参数解释：索引位置偏移量，用于指定从第几条记录开始返回，单位：条（记录数）。约束限制：不涉及取值范围：大于等于0的整数。默认取值： 0
limit	否	Integer	参数解释：每页查询的记录数，单位：条。约束限制：不涉及取值范围： 1到100的正整数。默认取值：无

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
Content-Type	是	String	参数解释：消息体编码格式。用于告知服务端请求体（Body）所采用的主体数据类型，以便服务端正确解析。约束限制：不涉及取值范围： application/json 默认取值： application/json
Authorization	是	String	参数解释：签名认证信息，当使用AK/SK方式认证时，使用SDK对请求进行签名的过程中会自动填充该字段。约束限制：不涉及取值范围：不涉及默认取值：不涉及
X-Sdk-Date	是	String	参数解释：请求发送的时间，当使用AK/SK方式认证时，使用SDK对请求进行签名的过程中会自动填充该字段。约束限制：不涉及取值范围：不涉及默认取值：不涉及

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
total	Integer	参数解释：满足条件的指标记录总数，用于计算分页总页数。取值范围：大于等于0的整数。
metrics	Array of OpsTuningStepMetric objects	参数解释：当前分页下的训练指标详情列表。取值范围：符合OpsTuningStepMetric定义的对象数组。

表5 OpsTuningStepMetric
参数	参数类型	描述
step	Integer	参数解释：训练迭代步数，单位：step。取值范围：大于等于0的整数。
reward_value	Double	参数解释：在该步数下计算得出的奖励值，反映模型生成结果的质量。取值范围：浮点数。
time_consume	Double	参数解释：该步数的耗时时长，单位：分钟。取值范围：大于等于0的浮点数。
response_length	Double	参数解释：模型在该步数生成的平均响应长度。取值范围：大于等于0的浮点数。

状态码：400

表6 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：机器可读的错误代码。取值范围：系统错误码字符串。
error_msg	String	参数解释：人类可读的错误消息。取值范围：详细错误说明字符串。

状态码：404

表7 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：机器可读的错误代码。取值范围：系统错误码字符串。
error_msg	String	参数解释：人类可读的错误消息。取值范围：详细错误说明字符串。

状态码：500

表8 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：机器可读的错误代码。取值范围：系统错误码字符串。
error_msg	String	参数解释：人类可读的错误消息。取值范围：详细错误说明字符串。

请求示例

用于拉取训练过程中产生的核心评估指标数据。

GET https://*.com/v1/ops/model-tuning-tasks/57ae91cf2f504899921a50d1c75f0547/metrics?offset=0&limit=10

Content-Type:application/json
X-Sdk-Date:20240416T095341Z
Authorization:SDK-HMAC-SHA256 Access=****************, SignedHeaders=content-type;host;x-sdk-date, Signature=****************

响应示例

状态码：200

{
  "total" : 3,
  "metrics" : [ {
    "step" : 100,
    "reward_value" : 0.523,
    "time_consume" : 12.5,
    "response_length" : 128
  }, {
    "step" : 200,
    "reward_value" : 0.687,
    "time_consume" : 12.3,
    "response_length" : 142
  }, {
    "step" : 300,
    "reward_value" : 0.742,
    "time_consume" : 12.8,
    "response_length" : 150
  } ]
}

状态码

状态码	描述
200	参数解释：调优过程指标结果。取值范围：无
400	参数解释：无效的请求参数。取值范围：无
404	参数解释：模型优化任务未找到。取值范围：无
500	参数解释：内部服务器错误。取值范围：无