Tenant Scope 與資料隔離

在 PrivAI 中，系統會依據呼叫請求所使用的 API Key，自動判斷可存取的資料範圍（Tenant Scope）。

Tenant Scope 說明

• 使用 租戶Key 時，系統僅允許存取該 API Key 所屬租戶的資源。

• 使用 Master Key 時，系統可跨租戶檢視與管理所有資源。

• 所有受租戶隔離保護的資源，其讀取、查詢、下載、更新與刪除操作，皆會套用相同的範圍限制。

受影響的資源類型

Tenant Scope 會套用於以下資源：

• File

• Fileset

• Prompt

• Chat Completions / Chat References 所引用之資源

存取規則

使用情境	行為
租戶 Key 查詢檔案列表	僅回傳該租戶的檔案
租戶 Key 取得單一檔案 / Fileset / Prompt	只能取得該租戶可見的資源
客戶 API Key 指定其他租戶資源 ID	系統拒絕存取
Master Key 呼叫既有 API	可跨租戶檢視所有資料

舊資料處理原則

在導入多 API Key 機制前已存在的資料，預設僅提供 Master Key 存取。若需讓既有資料納入特定租戶範圍，應由系統管理者另行處理資料歸屬。