# Tenant Scope 與資料隔離

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

#### Tenant Scope 說明

- 使用**租戶 Key** 時，系統僅允許存取該 API Key 所建立（所屬）的資源。

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

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

#### 受影響的資源類型

Tenant Scope 會套用於以下資源：

- File（檔案）

- Fileset（知識版本），以及知識版本與檔案的關聯

- Prompt（提示詞）

- Report Template（報告模板，Beta）

- Report（報告，Beta）

- Chat Completions ／ 資料參考搜尋 ／ 問答集生成等功能所引用的上述資源

#### 存取規則

| 使用情境 | 行為 |
| --- | --- |
| 租戶 Key 查詢檔案、知識版本、提示詞列表 | 僅回傳該租戶的資源 |
| 租戶 Key 取得單一檔案 ／ Fileset ／ Prompt | 只能取得該租戶可見的資源 |
| 租戶 Key 指定其他租戶的資源 ID | 系統拒絕存取，視同該資源不存在，回傳對應的「找不到資源」錯誤 |
| 租戶 Key 呼叫 API Key 管理 API | 系統拒絕存取（`AUTH_002`） |
| Master Key 呼叫 PrivAI API | 可跨租戶檢視所有資料 |

#### 資源歸屬原則

- 使用租戶 Key 建立的資源（例如上傳檔案、新增知識版本、新增提示詞），會自動歸屬於該租戶 Key。

- 使用 Master Key 建立的資源不屬於任何租戶，僅 Master Key 可存取。

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

相關說明詳見「API 串接 & API 列表」章節。
