# 知識版本物件

| 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 狀態，內容列表：<br />  • `draft`：尚未 commit 的知識版本。<br />  • `queued`：已提交 commit 指令，等待被系統轉換當中。<br />  • `processing`：系統轉換中。<br />  • `completed`：已完成 Fileset 版本。<br />  • `failed`：Fileset 提交失敗（沒有任何檔案成功）。<br />  • `partial_failed`：部分檔案轉換失敗。<br />  • `cancelled`：Fileset 的提交被取消。 |
| created_at | 知識版本建立的時間 |
| committed_at | 知識版本最近一次提交的時間；尚未 commit 時為 null |
| updated_at | 知識版本更新的時間 |
| file_counts | 請參考「[檔案統計物件](https://privstation-docs.apmic.ai/latest/privai-400/檔案統計物件.md)」章節 |

**補充說明：**

1. `metadata.embedding_model`、`metadata.parsing_mode` 為系統欄位，由系統依 commit 參數帶出。

1. 各狀態之間的轉換與可執行的操作，詳見「File Parse State、Fileset File State 與 Fileset State 的差異」章節。

1. commit 失敗的原因不會出現在知識版本物件中；請透過 Commit 時設定的 `webhook_url` 取得 `failed_files`，或以「取得單一知識版本的檔案列表」API 查看各檔案的 `state` 與 `metadata.fail_detail`。
