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

錯誤代碼說明-知識版本管理類

API 回應中的錯誤代碼​

以下錯誤代碼會出現在同步 API 回應中,回應格式見 例外狀況處理。Fileset 各狀態的意義請見 File Parse State、Fileset File State 與 Fileset State 的差異。

Error CodeHTTP StatusScenarioError MessageInherent Payload
FILESET_001404指定的 Fileset 不存在、已被刪除,或不屬於目前的 API KeyFileset not found.部分端點(如 /v1/qa/generate)會附帶 "fileset_id": uuid
FILESET_002409建立或複製 Fileset 時指定的 id 已存在Fileset ID already exists.
FILESET_003409Commit 時 Fileset 狀態為 queued、processing 或 completed;或上一次 Commit 的背景流程仍在執行Fileset cannot commit. Fileset is in {state} state."state": string
FILESET_004409更新 Fileset 時狀態為 queued、processing 或 completed,且 file_ids 與現有檔案不同(這些狀態下仍可只更新 name 與 metadata)Fileset cannot update."state": string
FILESET_005400Commit 或產生問答集時,Fileset 內沒有任何檔案Fileset must contain at least one file./v1/qa/generate 會附帶 "fileset_id": uuid
FILESET_006409Chat Completions 或資料參考搜尋指定的 Fileset 狀態不是 completed 或 partial_failed,無法用於檢索Cannot use fileset."state": string, "fileset_id": uuid
FILESET_007409更新或 Commit 時,Fileset 已被其他請求同時修改(版本衝突)Version conflict: The resource has been modified by another request.
FILESET_009409取消 Commit 時 Fileset 狀態不是 queued、processing 或 cancelled(例如 draft、completed、failed、partial_failed),或 Commit 已在取消請求送達前結束。對已是 cancelled 的 Fileset 重複取消會直接成功,不會回傳此錯誤Fileset cannot be cancelled."state": string
FILESET_011400Commit 時 Fileset 中有檔案的 filetype 不在支援清單中Unsupported file type: {filetype}"filetype": string
FILESET_021409刪除 Fileset 時狀態為 queued 或 processingFileset cannot be deleted. Fileset is in {state} state."state": string
FILESET_022409對已取消的 Fileset 重新 Commit 時,上一次 Commit 的取消清理尚未完成;請稍候再試Fileset commit is still being cancelled. Please wait for the cancellation to finish before committing again.

FILESET_008(Contains non-exist files)已不存在於 4.0.0,「file_ids 中有不存在的檔案」請改看 FILE_009(見「錯誤代碼說明-檔案管理類」)。

背景流程與保留錯誤代碼​

以下錯誤代碼仍定義於 4.0.0,但不會出現在同步 API 回應中。背景流程失敗時,錯誤會以「錯誤類型名稱」記錄在檔案的 metadata.fail_detail[].error_type(見「例外狀況處理」章節),下表提供對照。

Error Codeerror_typeHTTP StatusError Message說明
FILESET_018NoChunkError500No chunks found in the file splitting result.Commit 背景流程中,檔案切塊後沒有產生任何 chunk
FILESET_020TableRowTooLongError400Table row is longer than max chunk size, cannot be split into chunks.Commit 背景流程中,表格單列內容超過 chunk 長度上限,無法切塊
FILESET_010LockFilesetFailedError409Fileset cannot be locked.舊版 Commit 流程使用,4.0.0 不會產生;僅可能出現在歷史紀錄中
FILESET_012FileNotParsedYetError400File is not parsed yet.同上
FILESET_013FileMissingChunksMetadataError400File is missing chunks metadata.同上
FILESET_014FileMissingChunksURLError400File is missing chunks URL.同上
FILESET_015FileMissingEmbeddingsCacheError400File is missing embeddings cache.同上
FILESET_016FileMissingUsedQualityError400File is missing used quality.同上
FILESET_017ConflictFileNotFoundInFilesetError404Conflict file not found in fileset.同上
FILESET_019NotAllFilesCompletedError500Not all files are completed for fileset {fileset_id}: {processed}/{total} processed同上