获取评估任务详情
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
agentloop:GetEvaluationTask |
get |
*EvaluationTask
|
无 | 无 |
请求语法
GET /api/v1/evaluation-task/{agentSpace}/{taskId} HTTP/1.1
路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| agentSpace |
string |
否 |
AgentSpace 名称。 |
prod-agentspace |
| taskId |
string |
否 |
评估任务 ID。 |
eval-task-8b36f2e2b1f94f9c91ce7a4b0f6d9c25 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
当前API无需请求参数
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| agentSpace |
string |
AgentSpace 名称。 |
prod-agentspace |
| channel |
string |
任务来源。 枚举值:
|
default |
| config |
object |
数据源和执行配置。 |
{"project":"agentspace-project","storeName":"logstore-tracing","dataScope":"trace"} |
|
string |
单个配置项的值,键名由具体字段约定决定。 |
trace |
|
| createdAt |
integer |
创建时间,秒级 Unix 时间戳。 |
1782816000 |
| dataFilter |
string |
评估数据筛选条件,后端以 JSON 字符串形式返回。 |
{"query":"serviceName='checkout-service'","maxRecords":10,"samplingRate":100} |
| dataType |
string |
评估对象的数据来源类型。 枚举值:
|
trace |
| description |
string |
评估任务描述。 |
评估线上 Agent 链路任务完成度 |
| evaluators |
array |
评估器配置列表。 |
[{"evaluatorRef":"Builtin.agent_task_completion","resultName":"agent_task_completion","resultType":"score","variableMapping":{"input":"trace.input","output":"trace.output","agent_trajectory":"trace.agent_trajectory"}}] |
| Evaluator |
单个评估器配置对象。 |
{"evaluatorRef":"Builtin.agent_task_completion"} |
|
| regionId |
string |
任务所属地域。 |
cn-hangzhou |
| requestId |
string |
请求 ID。 |
3FE4CD1E-FF41-56BE-B590-7A021D9C1524 |
| runStrategyConfig | RunStrategies |
运行策略结构化配置,解析后的回填策略和持续评估策略。 |
{"backfill":{"enabled":true,"startTime":1782816000000,"endTime":1782902400000},"continuous":{"enabled":true,"intervalUnit":"HOUR","intervalValue":1,"dataDelayMinutes":5}} |
| status |
string |
评估任务状态。 枚举值:
|
Running |
| tags |
object |
任务标签键值对。未设置时为空。 |
{"serviceId":"checkout-service","env":"prod"} |
|
string |
单个任务标签值,键名按业务维度自定义。 |
prod |
|
| taskId |
string |
评估任务 ID。 |
eval-task-8b36f2e2b1f94f9c91ce7a4b0f6d9c25 |
| taskMode |
string |
评估任务模式。 枚举值:
|
batch |
| taskName |
string |
任务名称。 |
trace_task_completion_eval |
| updatedAt |
integer |
最近更新时间,秒级 Unix 时间戳。 |
1782816600 |
镇元最新契约中,查询响应不再返回 runStrategies 原始 JSON 字符串字段,调用方应读取 runStrategyConfig 获取结构化运行策略。
示例
正常返回示例
JSON格式
{
"agentSpace": "prod-agentspace",
"channel": "default",
"config": {
"key": "trace"
},
"createdAt": 1782816000,
"dataFilter": "{\"query\":\"serviceName='checkout-service'\",\"maxRecords\":10,\"samplingRate\":100}",
"dataType": "trace",
"description": "评估线上 Agent 链路任务完成度",
"evaluators": [
{
"evaluatorRef": "Builtin.agent_task_completion",
"name": "agent_task_completion",
"type": "AGENT",
"resultName": "agent_task_completion",
"resultType": "score",
"config": {
"version": "1.0.0"
},
"filters": {
"query": "serviceName='checkout-service'"
},
"variableMapping": {
"key": "trace.input"
},
"variableExtractorMapping": {
"key": {
"originField": "trace.output",
"type": "jsonpath",
"expression": "$.order.expected"
}
}
}
],
"regionId": "cn-hangzhou",
"requestId": "3FE4CD1E-FF41-56BE-B590-7A021D9C1524",
"runStrategyConfig": {
"backfill": {
"enabled": true,
"startTime": 1782816000000,
"endTime": 1782902400000
},
"continuous": {
"enabled": true,
"intervalUnit": "HOUR",
"intervalValue": 1,
"dataDelayMinutes": 5
}
},
"status": "Running",
"tags": {
"key": "prod"
},
"taskId": "eval-task-8b36f2e2b1f94f9c91ce7a4b0f6d9c25",
"taskMode": "batch",
"taskName": "trace_task_completion_eval",
"updatedAt": 1782816600
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。