查看评估任务详情 - ShowOpsEvaluationTask
功能介绍
该接口用于获取评估任务的详细信息,包括任务配置、状态、统计结果等完整信息,适用于任务详情查看的场景。
适用场景:
调用方法
请参见如何调用API。
授权信息
账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。
| 授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| agentarts:evaluationTask:showOpsEvaluationTask | Read | evaluationTask * | g:ResourceTag/<tag-key> | - | - |
URI
GET /v1/ops/evaluation-tasks/{task_id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| task_id | 是 | String | 参数解释: 评估任务的唯一标识符(ID)。该参数嵌入在API路径中,用于定位需要操作的具体任务实例。可通过调用创建评估任务接口获取,或通过查询评估任务列表接口获取。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,长度为1~100个字符。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| name | 否 | String | 参数解释: 评估任务的名称。作为查询参数使用时,支持精确匹配和模糊匹配。 约束限制: 不涉及。 取值范围: 只能由中文字符、英文字母、数字及「_」、「-」组成,长度为1~120个字符。 默认取值: 不涉及。 |
请求参数
无
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| data | data object | 参数解释: 响应数据,包含评估任务摘要信息、各评估器平均得分、同名任务列表及Token用量统计等。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| task | OpsEvaluationTaskSummary object | 参数解释 评估任务摘要信息,用于列表展示。 |
| avg_score | Map<String,String> | 各评估器的平均得分(键为评估器ID,值为平均得分字符串)。 |
| fuzz_name | Array of strings | 同名任务列表(通过 name 参数模糊查询时的同名任务名称)。 |
| usage | usage object | 参数解释: Token 用量统计。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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调用超时时间等。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| key | String | 参数解释: 标签键名称。 取值范围: 不涉及。 |
| value | String | 参数解释: 标签值,存储该标签键对应的具体内容。 取值范围: 由任意字符组成,长度为0~256个字符。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 | 参数解释: 是否生成评估总结报告。 取值范围: |
请求示例
获取指定评估任务的详细配置、当前执行状态以及已完成部分的统计结果。
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 | 获取任务详情 |
错误码
请参见错误码。