文档首页/ 智能体开发平台 AgentArts/ API参考/ API/ 智能体优化/ 智能体优化任务/ 查询智能体优化任务产物列表
更新时间：2026-04-30 GMT+08:00
查看PDF
分享

查询智能体优化任务产物列表

功能介绍

本接口用于检索智能体优化任务成功结束后生成的全部模型产物（Checkpoints/最终模型文件），包含产物的唯一标识、版本号及存储位置。

适用场景：

  • 在训练完成后，浏览所有生成的模型检查点（Checkpoints），根据奖励值和训练步数筛选最优模型版本。
  • 获取指定模型产物的下载地址（OBS路径），以便将优化后的模型部署至推理环境或进行离线评估。
  • 对比不同训练轮次下的产物指标，分析模型在训练过程中的演变情况，确定最佳的发布版本。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

task_id

是

String

参数解释：

智能体优化任务ID，标识任务的唯一标识符。获取方法请参考查询智能体优化任务列表。

约束限制：

不涉及

取值范围：

32位ID字符串。

默认取值：

无
表2 Query参数

参数

是否必选

参数类型

描述

offset

否

Integer

参数解释：

索引位置偏移量，用于指定从第几条记录开始返回，单位：条（记录数）。

约束限制：

不涉及

取值范围：

大于等于0的整数。

默认取值：

0

limit

否

Integer

参数解释：

每页查询的记录数，单位：条。

约束限制：

不涉及

取值范围：

1到100的正整数。

默认取值：

无

name

否

String

参数解释：

产物名称，用于根据产物名称关键词筛选。

约束限制：

选填参数，支持模糊匹配。

取值范围：

合法的产物名称字符串。

默认取值：

无

请求参数

表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的整数。

products

Array of OpsTuningProduct objects

参数解释：

模型产物列表，包含模型产物的详细信息。

取值范围：

符合OpsTuningProduct定义的对象数组。
表5 OpsTuningProduct

参数

参数类型

描述

id

String

参数解释：

产物ID，标识模型产物的唯一ID。

取值范围：

唯一标识符字符串。

name

String

参数解释：

产物名称。

取值范围：

产物名称字符串。

epoch

Integer

参数解释：

训练轮数，生成该产物时模型已完成训练的轮数。

取值范围：

大于等于0的整数。

step

Integer

参数解释：

训练步数，生成该产物时模型已完成训练的步。

取值范围：

大于等于0的整数。

reward_value

Double

参数解释：

奖励值，该产物模型在评估时的得分。

取值范围：

0-1的浮点数。

response_length

Double

参数解释：

平均响应长度，模型生成内容的平均Token数。

取值范围：

大于等于0的整数。

url

String

参数解释：

产物地址（OBS路径）。

取值范围：

不涉及

created_at

Long

参数解释：

创建时间，单位：毫秒（13位时间戳）。

取值范围：

13位毫秒级时间戳。

状态码：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

参数解释：

人类可读的错误消息。

取值范围：

详细错误说明字符串。

请求示例

检索任务成功结束后生成的全部模型产物（Checkpoints/最终模型文件），包含产物的唯一标识、版本号及存储位置。

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

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

响应示例

状态码：200

{
  "total" : 2,
  "products" : [ {
    "id" : "prod-001",
    "name" : "checkpoint_epoch_5_step_1000",
    "epoch" : 5,
    "step" : 1000,
    "reward_value" : 0.876,
    "response_length" : 256,
    "url" : "obs://model-output/task_123/epoch_5/checkpoint-1000.pt",
    "created_at" : 1704153600000
  }, {
    "id" : "prod-002",
    "name" : "final_model",
    "epoch" : 10,
    "step" : 2000,
    "reward_value" : 0.932,
    "response_length" : 312,
    "url" : "obs://model-output/task_123/final_model.bin",
    "created_at" : 1704240000000
  } ]
}

状态码

状态码

描述

200

参数解释：调优产物列表数据。

取值范围：无。

400

参数解释：无效的请求参数。

取值范围：无。

404

参数解释：模型优化任务未找到。

取值范围：无。

500

参数解释：内部服务器错误。

取值范围：无。

错误码

请参见错误码。

父主题： 智能体优化任务

相关文档