# 錯誤代碼說明-問答集生成類

以下錯誤代碼適用於「問答集生成」（`POST /v1/qa/generate`）。回應格式見 [例外狀況處理](https://privstation-docs.apmic.ai/latest/privai-400/例外狀況處理.md)。

| Error Code | HTTP Status | Scenario | Error Message | Inherent Payload |
| --- | --- | --- | --- | --- |
| `QA_001` | 400 | 所有檔案皆未能產生 QA pairs（內容為空或全部失敗），不會建立 QA 檔案 | No QA pairs generated. |  |
| `QA_003` | 400 | `on_oversize` 為 `fail` 且檔案內容超過可處理的長度。會中止整批處理，其他檔案即使已處理成功也不會回傳結果；如需處理大型檔案，請改用 `on_oversize: "split"` | File content size exceeds the maximum limit for QA generation. |  |

### 部分檔案失敗（QA_002）

`QA_002`（Some files failed to generate QA pairs.）**不會**以 `error_code` 的形式出現在回應中。  
當部分檔案產生失敗、但至少有一個檔案成功時，系統仍會建立 QA 檔案，並以 **HTTP 400** 回傳與成功時相同的回應結構，另外帶有：

| Field | Type | Detail |
| --- | --- | --- |
| failed_file_ids | uuid[] | 產生失敗的來源檔案 ID |
| error_message | string | `Some files failed to generate QA pairs. Please refer to the API documentation.` |

```json
{
  "object": "file",
  "id": "8d0c1f0e-2a51-4b7e-9d3a-0c4f5e6a7b8c",
  "filename": "QA_{fileset_id}.xlsx",
  "filetype": "application/x-privai-qa",
  "bytes": 10240,
  "metadata": {
    "source_fileset_id": "{fileset_id}"
  },
  "purpose": "user_data",
  "created_at": "2026-09-30T08:00:00Z",
  "expires_at": null,
  "failed_file_ids": ["2f1c3b7a-5d6e-4f80-9a1b-2c3d4e5f6a7b"],
  "error_message": "Some files failed to generate QA pairs. Please refer to the API documentation."
}
```

請勿只用 HTTP Status 判斷成敗：收到 400 時若回應帶有 `id` 與 `failed_file_ids`，代表 QA 檔案已成功建立，只是部分來源檔案沒有產生 QA pairs。

### 其他相關錯誤代碼

| Error Code | HTTP Status | Scenario |
| --- | --- | --- |
| `FILESET_001` | 404 | 指定的 Fileset 不存在（附帶 `fileset_id`），見「錯誤代碼說明-知識版本管理類」 |
| `FILESET_005` | 400 | Fileset 內沒有任何檔案（附帶 `fileset_id`），見「錯誤代碼說明-知識版本管理類」 |
