查找符合条件的链路评估任务。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| paillmtrace:ListOnlineEvalTasks | list | *OnlineEvaluation acs:paillmtrace:{#regionId}:{#accountId}:onlineevaluation/* |
| 无 |
请求语法
GET /api/v1/PAILLMTrace/onlineevaltasks HTTP/1.1
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| MinTime | string | 否 | 搜索时间范围的 UTC 开始时间 | 2025-04-05 13:24:25 2025-04-05 |
| MaxTime | string | 否 | 搜索时间范围的 UTC 截止时间 | 2025-04-07 13:24:25 2025-04-07 |
| PageNumber | integer | 否 | 当前页数。取值范围：大于 0 的整数。默认值：1。 | 1 |
| PageSize | integer | 否 | 分页大小，默认为 10，最大为 50。 | 50 |
| AppName | string | 否 | 用户应用在链路数据里记录的名称。完全匹配。 | my-foo-llm-app-1.0 |
| Status | string | 否 | 任务状态。完全匹配。 | CREATED RUNNING FINISHED USER_CANCELED |
| Keyword | string | 否 | 搜索关键字。会在任务名称、任务 id、任务描述这些字段上模糊匹配。 | foo |
| SamplingMethod | string | 否 | 任务数据采样方式。窗口或者概率。精确匹配。 | Window Ratio |
| SortBy | string | 否 | 用于排序返回结果的字段，目前支持 TaskId, CreateTime，TaskName，和 Status。不填则默认用 CreateTime | CreateTime Status TaskId TaskName |
| SortOrder | string | 否 | 返回结果的排序方向。取值范围：ASC（升序）、DESC（降序）。不填则默认用 DESC。 | ASC DESC |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "6F352A02-9C0D-54A7-B57C-663CF71D5714",
"Code": "InvalidInputParams",
"Message": "page number should be greater than 0",
"TotalCount": 22,
"Tasks": [
{
"Id": "9f50cd72efcf36535152ee811a911115",
"Name": "my-foo-evaluation-task",
"AliyunUid": 1512522691911111,
"UserId": 2222222222,
"AppName": "my-llm-app",
"Filters": [
{
"Key": "ServiceId\nServiceName\nInput\nOutput\nStatus\nTraceType\nSpanType\nTraceName\nSpanName",
"Operator": "=\nStartsWith\nContains",
"Value": "foo"
}
],
"GmtCreateTime": "2025-04-07 13:24:35",
"GmtStartTime": "2025-04-08 13:24:35",
"GmtEndTime": "2025-04-09 13:24:35",
"SamplingFrequencyMinutes": 12,
"SamplingRatio": 50,
"Description": "评估任务",
"Status": "CREATED\nRUNNING\nFINISHED\nUSER_CANCELED",
"EvaluationConfig": {
"Context": {
"JsonPathInSpan": "attributes.retrieval.documents[*].document.content",
"SpanName": "retrieve",
"JsonPathInSpanValue": "message/value"
},
"Answer": {
"JsonPathInSpan": "attributes.output.value",
"SpanName": "query",
"JsonPathInSpanValue": "message/value"
},
"Query": {
"JsonPathInSpan": "attributes.input.value",
"SpanName": "query",
"JsonPathInSpanValue": "message/value"
}
},
"ModelConfig": {
"Temperature": 0.1,
"ApiKey": "lRQ6ny2BP1g73fsgf9O+Hr4DEedezQ",
"Endpoint": "https://aiservice.cn-hangzhou.aliyuncs.com/v1",
"UseFunctionCall": true,
"TopP": 0.9,
"Name": "pai-judge\nthemis\nqwen\ngpt",
"IsSelfHost": true
},
"RecordCount": 11,
"EvalResults": [
{
"task_id": "00000",
"result_type": "HasValidEvalResult",
"record_count": 8,
"faithfulness": 0.5,
"correctness": 0.5,
"ndcg": null,
"mrr": null,
"hit_rate": null,
"precision": null
},
{
"task_id": "00000",
"result_type": "FailedToExtractQCA",
"record_count": 3,
"faithfulness": 0,
"correctness": 0,
"ndcg": null,
"mrr": null,
"hit_rate": null,
"precision": null
}
]
}
]
}错误码
访问错误中心查看更多错误码。