获取指定链路评估任务的详细信息，包括名称、评估模型配置，起止时间等信息。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| paillmtrace:GetOnlineEvalTask | get | *OnlineEvaluation acs:paillmtrace:{#regionId}:{#accountId}:onlineevaluation/{#OnlineEvaluationId} |
| 无 |
请求语法
GET /api/v1/PAILLMTrace/onlineevaltasks/{TaskId} HTTP/1.1
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| TaskId | string | 是 | 任务 ID。 | e111d41dd22ca6cf4bc1e3fcad7a142af93 |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "6F352A02-9C0D-54A7-B57C-663CF71D5714",
"Code": "InvalidInputParams",
"Message": "task id is empty",
"Task": {
"Id": "0839a02d-aa24-4174-90bb-7a773885934d",
"Name": "my-eval-task-1",
"AliyunUid": 1195531608511111,
"UserId": 222222222222222200,
"AppName": "my-llm-app",
"Filters": [
{
"Key": "ServiceId\nServiceName\nInput\nOutput\nStatus\nTraceType\nSpanType\nTraceName\nSpanName",
"Operator": "=\nStartsWith\nContains",
"Value": "foo"
}
],
"GmtCreateTime": "2024-07-31 08:30:00",
"GmtStartTime": "2024-08-02",
"GmtEndTime": "2024-08-10 13:20:00",
"GmtLastSamplingWindowStartTime": "2024-08-10 13:11:00",
"GmtLastSamplingWindowEndTime": "2024-08-10 13:14:00",
"SamplingFrequencyMinutes": 3,
"SamplingRatio": 70,
"Description": "这个任务做了这些事。",
"Status": "CREATED\nRUNNING\nFINISHED\nUSER_CANCELED",
"RecordCount": 999,
"EvalResults": [
{
"task_id": 11111,
"result_type": "HasValidEvalResult",
"record_count": 8,
"faithfulness": 0.5,
"correctness": 0.5,
"ndcg": null,
"mrr": null,
"hit_rate": null,
"precision": null
},
{
"task_id": 11111,
"result_type": "FailedToExtractQCA",
"record_count": 3,
"faithfulness": 0,
"correctness": 0,
"ndcg": null,
"mrr": null,
"hit_rate": null,
"precision": null
}
],
"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
}
}
}错误码
访问错误中心查看更多错误码。