文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 评估/ 评估器管理/ 获取评估器信息 - ShowOpsEvaluator
更新时间:2026-10-16 GMT+08:00
分享

获取评估器信息 - ShowOpsEvaluator

功能介绍

该接口用于通过指定的评估器ID检索其完整定义信息,包括判分逻辑、参数配置、关联模型及元数据详情,是核对特定评测标准执行细节的核心入口。

调用方法

请参见如何调用API。

授权信息

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

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts:evaluator:showOpsEvaluator

Read

evaluator *

g:ResourceTag/<tag-key>

-

-

URI

GET /v1/ops/evaluators/{evaluator_id}

表1 路径参数

参数

是否必选

参数类型

描述

evaluator_id

是

String

参数解释:

评估器的唯一标识符(ID)。可通过调用创建评估器接口获取,或通过查询评估器列表接口获取。该参数在路径中指定,用于精确定位需要操作或查询的特定评估器资源。

约束限制:

不涉及。

取值范围:

由字母、数字和连字符(-)组成的字符串,长度为1~100个字符。

默认取值:

不涉及。

请求参数

无

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

evaluator

OpsListEvaluatorsInfo object

参数解释:

评估器详细信息对象,引用OpsListEvaluatorsInfo定义。

表3 OpsListEvaluatorsInfo

参数

参数类型

描述

base_info

OpsEvaluatorBaseInfo object

参数解释:

评估器的基础审计信息,引用OpsEvaluatorBaseInfo对象。

evaluator_id

String

参数解释:

评估器的唯一标识符。

取值范围:

不涉及。

account_id

String

参数解释:

评估器所属的租户账号ID。

取值范围:

不涉及。

name

String

参数解释:

评估器的名称,用于界面展示和检索。

取值范围:

不涉及。

description

String

参数解释:

评估器的功能描述或业务用途说明。

取值范围:

不涉及。

evaluator_type

Integer

参数解释:

评估器的类型编码,用于区分不同的逻辑实现(如自定义评估器或系统评估器)。

取值范围:

  • 1:模型评估器

  • 2:代码评估器

  • 3:自适应评估器(自适应评估模式,可根据上下文与历史结果动态调整评判规则)

turn_type

String

参数解释:

评估器的对话轮次类型。

取值范围:

  • single:单轮

  • multi:多轮

latest_version

String

参数解释:

评估器的最新发布的版本号。

取值范围:

不涉及。

current_version

OpsListEvaluatorVersionsInfo object

参数解释:

评估器当前生效的版本信息,引用OpsListEvaluatorVersionsInfo定义。

current_version_id

String

参数解释:

评估器当前生效版本的唯一标识符。

取值范围:

不涉及。

reference_count

Long

参数解释:

该评估器被评估任务引用的次数。

取值范围:

非负整数。

tags

Object

参数解释:

评估器绑定的TMS标签列表。数组元素引用OpsTmsTag对象;内置评估器可能为标签分组对象。

取值范围:

不涉及。

evaluator_content_type

String

参数解释:

评估器的评估内容类型。

取值范围:

  • text:文本

  • trajectory:轨迹

表4 OpsListEvaluatorVersionsInfo

参数

参数类型

描述

version_id

String

参数解释:

版本记录的ID。可通过调用获取评估器版本列表接口获取。

取值范围:

不涉及。

account_id

String

参数解释:

评估器所属的租户账号ID。

取值范围:

不涉及。

evaluator_id

String

参数解释:

评估器的唯一标识符。可通过调用创建评估器接口获取,或通过查询评估器列表接口获取。

取值范围:

不涉及。

version

String

参数解释:

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

取值范围:

不涉及。

turn_type

String

参数解释:

评估器的对话轮次类型。

取值范围:

  • single:单轮

  • multi:多轮

evaluator_type

Integer

参数解释:

评估器的分类类型编码。

取值范围:

  • 1:模型评估器

  • 2:代码评估器

  • 3:自适应评估器(自适应评估模式,可根据上下文与历史结果动态调整评判规则)

evaluator_content_type

String

参数解释:

评估内容类型。

取值范围:

  • text:文本

  • trajectory:轨迹

description

String

参数解释:

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

取值范围:

不涉及。

version_description

String

参数解释:

版本描述。

取值范围:

不涉及。

base_info

OpsEvaluatorBaseInfo object

参数解释:

评估器的基础审计信息,引用OpsEvaluatorBaseInfo对象。

evaluator_content

OpsEvaluatorContent object

参数解释:

评估器内容对象,引用OpsEvaluatorContent对象,定义评估器的核心配置及输入Schema。

reference_count

Long

参数解释:

该版本被评估任务引用的次数。

取值范围:

非负整数。

表5 OpsEvaluatorBaseInfo

参数

参数类型

描述

created_at

String

参数解释:

评估器的创建时间。时间格式为yyyy-MM-ddTHH:mm:ssZ,示例:2024-01-01T12:00:00Z。

取值范围:

不涉及。

created_by

EvaluationOpsCreatedBy object

参数解释:

评估器的创建者信息,引用EvaluationOpsCreatedBy对象。

updated_at

String

参数解释:

评估器的最近一次更新时间。时间格式为yyyy-MM-ddTHH:mm:ssZ,示例:2024-01-01T12:00:00Z。

取值范围:

不涉及。

updated_by

EvaluationOpsUpdatedBy object

参数解释:

评估器的最近一次更新者信息,引用EvaluationOpsUpdatedBy对象。

表6 EvaluationOpsCreatedBy

参数

参数类型

描述

account_id

String

参数解释:

资源创建者所属的租户账号ID。

取值范围:

不涉及。

user_id

String

参数解释:

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

取值范围:

不涉及。

name

String

参数解释:

资源创建者的显示名称。

取值范围:

不涉及。

avatar_url

String

参数解释:

创建者的头像链接。

取值范围:

不涉及。

表7 EvaluationOpsUpdatedBy

参数

参数类型

描述

account_id

String

参数解释:

资源更新者所属的租户账号ID。

取值范围:

不涉及。

user_id

String

参数解释:

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

取值范围:

不涉及。

name

String

参数解释:

更新者的显示名称。

取值范围:

不涉及。

avatar_url

String

参数解释:

更新者的头像链接。

取值范围:

不涉及。

表8 OpsEvaluatorContent

参数

参数类型

描述

prompt_evaluator

OpsPromptEvaluator object

参数解释:

提示词评估器对象,引用OpsPromptEvaluator对象,定义基于Prompt的评估逻辑及模型配置。

input_schemas

Array of input_schemas objects

参数解释:

评估器输入参数的Schema定义列表。数组内每个元素为Object类型,包含输入参数的键名和Schema定义。

表9 OpsPromptEvaluator

参数

参数类型

描述

message_list

Array of objects

参数解释:

消息列表,包含评估过程中的对话记录或消息对象。数组内每个元素为Object类型,包含role(消息角色)、content(消息内容对象)等字段。

model_config

OpsEvaluationModelConfig object

参数解释:

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

prompt_source_type

Integer

参数解释:

提示词(Prompt)的来源类型。

取值范围:

不涉及。

prompt_template_key

String

参数解释:

提示词模板的唯一关键字(Key)。

取值范围:

不涉及。

prompt_template_name

String

参数解释:

提示词模板的显示名称。

取值范围:

不涉及。

表10 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。

表11 input_schemas

参数

参数类型

描述

key

String

参数解释:

输入参数的键名。

取值范围:

不涉及。

json_schema

String

参数解释:

输入参数的JSON Schema定义。

取值范围:

不涉及。

support_content_types

Array of strings

参数解释:

支持的输入内容类型列表。

取值范围:

不涉及。

请求示例

通过评估器ID精确查询其配置详情、版本信息及判定逻辑。

GET https://api.example.com/v1/ops/evaluators/7590068991923321858

响应示例

状态码:200

{
  "evaluator" : {
    "evaluator_id" : "ade111ca-843f-4e20-a9a4-01a9aa22a3f9",
    "account_id" : "6c23f0482eb54863ba41cc42dab176dc",
    "name" : "正确性评估",
    "description" : "评估提交的内容是否正确、准确、真实,并完整覆盖核心要点。",
    "evaluator_type" : 1,
    "turn_type" : "single",
    "evaluator_content_type" : "text",
    "current_version_id" : "1.0.0",
    "latest_version" : "0.0.2",
    "base_info" : {
      "created_at" : "2026-04-10T16:58:00Z",
      "created_by" : {
        "user_id" : "user_id",
        "name" : "name",
        "avatar_url" : "https://example.com/avatar.png"
      },
      "updated_at" : "2026-04-10T17:30:00Z",
      "updated_by" : {
        "user_id" : "user_id",
        "name" : "name",
        "avatar_url" : "https://example.com/avatar.png"
      }
    },
    "current_version" : {
      "version" : "1.0.0",
      "description" : "正确性评估器初始版本",
      "version_description" : "",
      "evaluator_content" : { }
    },
    "reference_count" : 0,
    "tags" : [ {
      "key" : "env",
      "value" : "prod"
    }, {
      "key" : "team",
      "value" : "ai-platform"
    } ]
  }
}

状态码

状态码

描述

200

查询成功

错误码

请参见错误码。

相关文档