j9九游会登录/ 智果（agentarts）智能体平台/ api参考/ api/ / / 获取评估器所有版本信息 - listopsevaluatorversions
更新时间：2026-07-17 gmt 08:00
查看pdf

获取评估器所有版本信息 -j9九游会登录

功能介绍

该接口用于查询指定评估器下所有已发布的历史版本列表，提供各版本的发布时间、逻辑快照及版本状态。

调用方法

请参见如何调用api。

授权信息

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

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts:evaluator:listopsevaluatorversions

list

evaluator *

g:resourcetag/

-

-

uri

get /v1/ops/evaluators/{evaluator_id}/versions

表1 路径参数

参数

是否必选

参数类型

描述

evaluator_id

是

string

参数解释：

评估器的唯一标识符（id）。该参数用于在api路径中定位具体的评估逻辑或评估器实例。

约束限制：

长度为0到10000个字符的字符串。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

无

响应参数

状态码：200

表2 响应body参数

参数

参数类型

描述

versions

array of opslistevaluatorversionsinfo objects

参数解释：

评估器的版本列表，包含该评估器下所有已发布的历史版本及配置详情。

取值范围：

不涉及。
表3 opslistevaluatorversionsinfo

参数

参数类型

描述

evaluator_id

string

参数解释：

评估器的唯一标识符。

取值范围：

不涉及。

version

string

参数解释：

评估器的具体版本号，用于区分不同的逻辑迭代。

取值范围：

不涉及。

description

string

参数解释：

该版本的变更详细说明或备注。

取值范围：

不涉及。

base_info

opsevaluatorbaseinfo object

参数解释：

评估器的基础审计信息，记录创建与更新详情。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

evaluator_content

opsevaluatorcontent object

参数解释：

评估器内容对象，定义评估器的核心配置及输入schema。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表4 opsevaluatorbaseinfo

参数

参数类型

描述

created_at

string

参数解释：

评估器的创建时间。

created_by

evaluationopscreatedby object

参数解释：

记录评估资产创建者详情。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

updated_at

string

参数解释：

评估器的最近一次更新时间。

updated_by

evaluationopsupdatedby object

参数解释：

记录评估资产最近一次变更操作者信息。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表5 evaluationopscreatedby

参数

参数类型

描述

user_id

string

参数解释：

资源创建者的唯一标识符。

name

string

参数解释：

资源创建者的显示名称。

avatar_url

string

参数解释：

创建者的头像链接。
表6 evaluationopsupdatedby

参数

参数类型

描述

user_id

string

参数解释：

最后一次更新资源的用户的id。

name

string

参数解释：

更新者的显示名称。

avatar_url

string

参数解释：

更新者的头像链接。
表7 opsevaluatorcontent

参数

参数类型

描述

prompt_evaluator

opspromptevaluator object

参数解释：

提示词评估器对象，定义基于prompt的评估逻辑及模型配置。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

input_schemas

array of objects

参数解释：

评估器输入参数的schema定义列表。
表8 opspromptevaluator

参数

参数类型

描述

message_list

array of objects

参数解释：

消息列表，包含评估过程中的对话记录或消息对象。

model_config

opsevaluationmodelconfig object

参数解释：

模型配置信息，定义评估时使用的模型参数。

prompt_source_type

integer

参数解释：

提示词（prompt）的来源类型。

prompt_template_key

string

参数解释：

提示词模板的唯一关键字（key）。

prompt_template_name

string

参数解释：

提示词模板的显示名称。
表9 opsevaluationmodelconfig

参数

参数类型

描述

model_id

string

参数解释：

指定调用的大模型唯一标识符，通过模型列表接口获取。

model_name

string

参数解释：

模型的显示名称。

取值范围：

任意字符串。

temperature

float

参数解释：

采样温度参数，用于控制输出的随机性。数值低更聚焦，数值高更具创造性。

取值范围：

0.0到2.0。

max_tokens

integer

参数解释：

单次推理生成的最大token数量限制。

取值范围：

1-32000。

top_p

float

参数解释：

核采样参数。

取值范围：

0.0到1.0。

frequency_penalty

float

参数解释：

频率惩罚系数，降低内容重复倾向。

取值范围：

-2.0到2.0。

请求示例

查询特定评估器下的所有历史版本列表及其配置快照。

get https://api.example.com/v1/ops/evaluators/7590068991923321858/versions

响应示例

状态码：200

获取评估器所有版本信息成功

{
  "versions" : [ {
    "evaluator_id" : "evaluator_id",
    "version" : "v1.2.0",
    "description" : "优化了评估准确率逻辑",
    "base_info" : {
      "created_at" : "2026-04-10t16:58:00z",
      "created_by" : {
        "user_id" : "user_id",
        "name" : "name",
        "avatar_url" : "avatar_url"
      },
      "updated_at" : "2026-04-10t17:30:00z",
      "updated_by" : {
        "user_id" : "user_id",
        "name" : "name",
        "avatar_url" : "https://example.com/avatar.png"
      }
    },
    "evaluator_content" : {
      "prompt_evaluator" : {
        "message_list" : [ ],
        "model_config" : {
          "model_id" : "1749615103",
          "model_name" : "豆包·1.6·自动深度思考",
          "temperature" : 0.1,
          "max_tokens" : 4096,
          "top_p" : 0.7,
          "frequency_penalty" : 0
        },
        "prompt_source_type" : 1,
        "prompt_template_key" : "prompt_template_key",
        "prompt_template_name" : "prompt_template_name"
      },
      "input_schemas" : [ { } ]
    }
  } ]
}

状态码

状态码

描述

200

获取评估器所有版本信息成功

错误码

请参见错误码。

父主题：

相关文档

网站地图