知識版本物件
| Field | Detail |
|---|---|
| object | 物件類型,固定為 fileset(與 OpenAI 相容而保留) |
| id | 知識版本的唯一鍵,uuid |
| name | 知識版本的名稱 |
| metadata | 使用者自訂的描述資訊,以及下列系統欄位 |
metadata.embedding_model | 知識版本提交時使用的 Embedding Model;尚未 commit 時為 null |
metadata.parsing_mode | 知識版本提交時的解析模式,HQ 或 FAST;尚未 commit 時為 null |
metadata.copy_from | 僅由「複製知識版本」API 建立的 Fileset 才有,記錄來源 Fileset 的 ID |
| state | Fileset 狀態,內容列表: • draft:尚未 commit 的知識版本。• queued:已提交 commit 指令,等待被系統轉換當中。• processing:系統轉換中。• completed:已完成 Fileset 版本。• failed:Fileset 提交失敗(沒有任何檔案成功)。• partial_failed:部分檔案轉換失敗。• cancelled:Fileset 的提交被取消。 |
| created_at | 知識版本建立的時間 |
| committed_at | 知識版本最近一次提交的時間;尚未 commit 時為 null |
| updated_at | 知識版本更新的時間 |
| file_counts | 請參考「檔案統計物件」章節 |
補充說明:
-
metadata.embedding_model、metadata.parsing_mode為系統欄位,由系統依 commit 參數帶出。 -
各狀態之間的轉換與可執行的操作,詳見「File Parse State、Fileset File State 與 Fileset State 的差異」章節。
-
commit 失敗的原因不會出現在知識版本物件中;請透過 Commit 時設定的
webhook_url取得failed_files,或以「取得單一知識版本的檔案列表」API 查看各檔案的state與metadata.fail_detail。