文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 评估/ 评估任务管理/ 查看评估任务详情 - ShowOpsEvaluationTask
更新时间:2026-10-16 GMT+08:00
分享

查看评估任务详情 - ShowOpsEvaluationTask

功能介绍

该接口用于获取评估任务的详细信息,包括任务配置、状态、统计结果等完整信息,适用于任务详情查看的场景。

适用场景:

  • 查看评估任务的完整配置和执行状态。

  • 分析任务运行过程中的性能和结果统计信息。

调用方法

请参见如何调用API。

授权信息

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

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts:evaluationTask:showOpsEvaluationTask

Read

evaluationTask *

g:ResourceTag/<tag-key>

-

-

URI

GET /v1/ops/evaluation-tasks/{task_id}

表1 路径参数

参数

是否必选

参数类型

描述

task_id

是

String

参数解释:

评估任务的唯一标识符(ID)。该参数嵌入在API路径中,用于定位需要操作的具体任务实例。可通过调用创建评估任务接口获取,或通过查询评估任务列表接口获取。

约束限制:

不涉及。

取值范围:

只能由英文字母、数字组成,长度为1~100个字符。

默认取值:

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

name

否

String

参数解释:

评估任务的名称。作为查询参数使用时,支持精确匹配和模糊匹配。

约束限制:

不涉及。

取值范围:

只能由中文字符、英文字母、数字及「_」、「-」组成,长度为1~120个字符。

默认取值:

不涉及。

请求参数

无

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

data

data object

参数解释:

响应数据,包含评估任务摘要信息、各评估器平均得分、同名任务列表及Token用量统计等。

取值范围:

不涉及。

表4 data

参数

参数类型

描述

task

OpsEvaluationTaskSummary object

参数解释

评估任务摘要信息,用于列表展示。

avg_score

Map<String,String>

各评估器的平均得分(键为评估器ID,值为平均得分字符串)。

fuzz_name

Array of strings

同名任务列表(通过 name 参数模糊查询时的同名任务名称)。

usage

usage object

参数解释:

Token 用量统计。

取值范围:

不涉及。

表5 OpsEvaluationTaskSummary

参数

参数类型

描述

id

String

参数解释:

评估任务的唯一标识符。

取值范围:

不涉及。

name

String

参数解释:

评估任务名称。

取值范围:

不涉及。

description

String

参数解释:

评估任务描述。

取值范围:

不涉及。

eval_mode

String

参数解释:

评估模式。

取值范围:

OFFLINE:离线评估模式;ONLINE:在线评估模式。

status

String

参数解释:

任务状态。

取值范围:

PENDING:等待执行;RUNNING:运行中;COMPLETED:已完成;FAILED:执行失败;STOPPED:已停止。

dataset_id

String

参数解释:

关联的评测集ID。

取值范围:

不涉及。

dataset_name

String

参数解释:

关联的评测集名称。

取值范围:

不涉及。

input_source_type

String

参数解释:

输入源类型。

取值范围:

DATASET_STATIC:数据集静态输入;DATASET_DYNAMIC:数据集动态输入;TRACE_STREAM:轨迹流输入。

created_at

String

参数解释:

创建时间,采用ISO 8601时间格式(yyyy-MM-ddTHH:mm:ssZ)。

取值范围:

不涉及。

updated_at

String

参数解释:

更新时间,采用ISO 8601时间格式(yyyy-MM-ddTHH:mm:ssZ)。

取值范围:

不涉及。

tags

Array of OpsTmsTag objects

参数解释

评估任务绑定的TMS标签列表。

取值范围

不涉及。

runtime_config

OpsRuntimeConfig object

参数解释:

任务运行时配置,包含离线任务Agent调用超时时间等。

表6 OpsTmsTag

参数

参数类型

描述

key

String

参数解释:

标签键名称。

取值范围:

不涉及。

value

String

参数解释:

标签值,存储该标签键对应的具体内容。

取值范围:

由任意字符组成,长度为0~256个字符。

表7 OpsRuntimeConfig

参数

参数类型

描述

execution_time

Long

参数解释:

任务的预定执行时间(Unix 时间戳),单位:秒。

取值范围:

单位为秒,0-9999999999999

concurrency

Integer

参数解释:

任务执行的并发数配置。

取值范围:

1-100。

continue_on_exception

Boolean

参数解释:

异常处理策略,是否在遇到非致命异常时继续。

取值范围:

true:遇到异常时继续执行,false:遇到异常时停止执行。

agent_call_timeout_minutes

Integer

参数解释:

离线任务Agent调用超时时间(分钟)。

取值范围:

仅支持5/10/15/20;不传(null)时后端填充配置项默认值。

gen_summary

Boolean

参数解释:

是否生成评估总结报告。

取值范围:

  • true:生成总结报告

  • false:不生成总结报告

表8 usage

参数

参数类型

描述

task_id

String

参数解释:

任务ID。

取值范围:

不涉及。

prompt_tokens

Long

参数解释:

输入 Token 数。

取值范围:

不涉及。

completion_tokens

Long

参数解释:

输出 Token 数。

取值范围:

不涉及。

total_tokens

Long

参数解释:

总 Token 数。

取值范围:

不涉及。

请求示例

获取指定评估任务的详细配置、当前执行状态以及已完成部分的统计结果。

GET https://api.example.com/v1/ops/evaluation-tasks/1769499746650415700514

响应示例

状态码:200

{
  "data" : {
    "task" : {
      "id" : "1769499746650415700514",
      "name" : "hzx-4",
      "description" : "调用workflow测试14",
      "eval_mode" : "OFFLINE",
      "status" : "RUNNING",
      "dataset_id" : "8f245ce1-aac2-47bf-a6cf-4ea8839fb8c9",
      "dataset_name" : "OMGEval评测集",
      "input_source_type" : "DATASET_DYNAMIC",
      "tags" : [ {
        "key" : "env",
        "value" : "prod"
      }, {
        "key" : "team",
        "value" : "ai-platform"
      } ],
      "runtime_config" : {
        "agent_call_timeout_minutes" : 15
      }
    },
    "avg_score" : {
      "98527a44-52c5-4ce0-a918-8968081606b4" : "0.85"
    },
    "fuzz_name" : [ ],
    "usage" : {
      "task_id" : "1769499746650415700514",
      "prompt_tokens" : 1200,
      "completion_tokens" : 800,
      "total_tokens" : 2000
    }
  }
}

状态码

状态码

描述

200

获取任务详情

错误码

请参见错误码。

相关文档