API 教程
错误与故障排查
解读 API 失败，保留关联 ID，并诊断没有继续推进的评估。
对每个请求都检查 HTTP 状态和 JSON success字段。需要调查特定失败时，请保留响应中的 code 值。
常见问题
| 现象 | 可能原因 | 检查内容 |
|---|---|---|
| 401 Unauthorized | PAT 缺失、无效、已到期或已撤销 | Authorization 请求头和 PAT 状态 |
| 400 Bad Request | 必要参数缺失或为空 | evaluationId、traceId 和方法对应的响应字段 |
| No prompts found | 评估 ID、类型或状态与请求不匹配 | Request Tutorial 中的值和所选 GET 端点 |
| 评估停留在 Awaiting Trigger | 响应发送到了错误的端点或字段 | BenchDX 的 llmResponse 与 RobustDX 的 advResponse |
| 部分测试用例显示 Error | 待测目标请求或响应处理失败 | Process Details 和模型错误响应 |
按固定顺序诊断
检查传输
记录 HTTP 状态，并确认请求到达正确的 AIDX 基础 URL。
检查身份验证
确认 Bearer 请求头包含当前有效且尚未撤销的 AIDX PAT。
检查评估标识
将
evaluationId与 Request Tutorial 对照，并确认评估类型与端点系列匹配。检查追踪信息和响应字段
返回原始
traceId，BenchDX 使用llmResponse，RobustDX 使用advResponse。检查 Process Details
找到最早失败的追踪记录，读取模型错误响应，并在适当时重试或明确处理。
记录关联 ID
响应中的 code字段用于标识服务器请求，方便诊断。该值会随每次请求变化，不应视为固定的成功代码。