跳至主要内容
版本:PrivStation 4.0.0
Markdown 原文

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

以下錯誤代碼適用於「問答集生成」(POST /v1/qa/generate)。回應格式見 例外狀況處理。

Error CodeHTTP StatusScenarioError MessageInherent Payload
QA_001400所有檔案皆未能產生 QA pairs(內容為空或全部失敗),不會建立 QA 檔案No QA pairs generated.
QA_003400on_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 回傳與成功時相同的回應結構,另外帶有:

FieldTypeDetail
failed_file_idsuuid[]產生失敗的來源檔案 ID
error_messagestringSome files failed to generate QA pairs. Please refer to the API documentation.
{
"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 CodeHTTP StatusScenario
FILESET_001404指定的 Fileset 不存在(附帶 fileset_id),見「錯誤代碼說明-知識版本管理類」
FILESET_005400Fileset 內沒有任何檔案(附帶 fileset_id),見「錯誤代碼說明-知識版本管理類」