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

File & Fileset:PrivAI 的核心資料結構

在 PrivAI 中,File 是最基本的知識單位,代表一份上傳的文件,例如 PDF、Word 或文字檔案。
Fileset(知識版本)則是由多個 File 組成的集合,用來定義一個語義相關的知識範圍,供模型進行檢索與回答使用。

資料流程​

  1. 開發者透過 API 上傳檔案,系統將其儲存為一個 File,並給予唯一的 file_id。

  2. 建立一個 Fileset,並將一個或多個 File 加入其中。

  3. Commit 該 Fileset,系統完成解析、切段與向量化後,即成為可查詢的知識版本。

  4. 在進行語意檢索與回答(RAG)時,指定要使用的 fileset_id。

支援上傳的檔案格式詳見「PrivAI 使用限制」章節;Commit 流程詳見「Fileset 知識版本建立流程」章節。

設計邏輯​

項目說明
重用性一個 File 可以被加入多個 Fileset
邏輯分組一個 Fileset 對應一個業務主題、知識場景或使用任務
隔離性RAG 推論時只會檢索所指定 Fileset 的資料,避免資料污染
可追蹤性每個 Fileset 內的檔案各自記錄處理狀態,Fileset 本身也記錄整體建立狀態與 Commit 時間

實務應用範例​

使用情境FileFileset Name
客服知識庫FAQ.txt、使用手冊.pdf、常見問題.xlsxcs-bot-kb
員工制度查詢HR_規章.pdf、福利制度.docxhr-policy
法務查詢與投資人回覆共享使用條款合約.pdf同一份檔案被加入 legal-bot 與 investor-bot 兩個 Fileset