Workspace

Hakila 以 Organization 與 Workspace 組織資源。Gateway API Key、用量與 BYOK 金鑰通常掛在 Workspace 底下。

階層（概念）

Organization
├── Members（登入帳號；組織角色：管理員／一般使用者）
├── Units（組織單位樹，可選；可設層級預算；可由 SCIM Groups 同步）
├── People（目錄人員，可掛 Unit、可設人員預算；≠ 登入帳號；可由 SCIM Users 同步）
├── 模型允許清單（可選；未設定＝平台已啟用模型全開）
└── Workspace
    ├── Members（Admin / Member）
    ├── API Keys（隸屬 Workspace；可選綁 Unit／Person；可設金鑰預算與模型清單）
    ├── Provider Keys（BYOK / BYBO）
    └── Request Logs（用量）

只有組織管理員（組織建立者或組織角色為管理員的成員）可以進入組織管理；工作區的 Admin 角色不會自動成為組織管理員。人員、單位與角色在 Console「組織人員管理」維護，也可用 SCIM 自動佈建從 Entra ID、Okta 等身分提供者同步。

組織方案

每個組織都有一個方案，決定組織管理可用的功能。註冊後自動建立的 Personal 組織與之後新建的組織都是 Business 方案；需要完整組織管理時，組織管理員可在 Console「組織管理 → 方案設定」比較各方案並送出升級申請。升級目前僅開放公司行號、政府機關或組織，申請時須填寫公司或單位名稱、聯絡人姓名、手機與公司電話（統一編號選填）；負責人員以電話聯繫確認後，會為組織開通 Enterprise。組織只能申請升級；降級或改為其他方案請聯繫平台人員處理。

方案未開放的功能，對應的 Admin API 回 403，code 為 plan_feature_unavailable。從 Enterprise 改回 Business 時，已設定的內容會保留並繼續生效，但無法再修改；SCIM Token 會停止接受請求；完整紀錄 Prompt / Response 會直接關閉，之後再升級也需重新開啟。

操作紀錄

Console 與 SCIM 的每一次寫入操作（新增、修改、刪除、執行，例如建立 API Key、調整模型允許清單、SCIM 同步人員）都會留下紀錄：操作者、時間、來源 IP、User-Agent、請求內容與結果（成功或失敗）。紀錄只增不改，金鑰、密碼、Secret、Token 等欄位寫入前即遮蔽為 ***。

登入類事件也會記錄在操作紀錄（分類為「登入」）：密碼登入、第三方帳號登入、註冊與登出，登入失敗時會註明原因（密碼錯誤、帳號已鎖定、帳號已停用、來源 IP 不在允許清單）。登入紀錄只保存 Email 與登入方式，不含密碼。API 呼叫不在此列，請看工作區的 Logs。

所有方案的組織都會記錄；Enterprise 方案的組織管理員可在「組織管理 → 操作紀錄」查詢組織與所屬工作區的紀錄，包含平台人員對該組織的操作（例如變更方案），以及目前組織成員的登入紀錄。方案升級後即可查到升級前的紀錄。

組織／單位／人員預算由組織管理頁設定；API Key 僅在各工作區的 API Keys 頁建立與管理。Gateway 執行時會檢查：組織儲值餘額（硬閘門）→ 金鑰預算 → 人員／單位預算 → 組織預算。模型則另套用平台目錄 ∩ 組織 ∩ 金鑰允許清單。

對 API 呼叫的意義

• 你持有的 API Key 已綁定特定 Workspace；組織歸屬經由 Workspace 解析
• GET /v1/models 與實際可呼叫的模型，依該組織與金鑰的允許清單而異
• 請求的用量與花費會記在該 Key / Workspace 脈絡，並累計至所屬組織
• BYOK 可依 Workspace 覆寫上游金鑰

Admin vs Gateway

本文件站聚焦 Gateway；Admin 操作細節之後可另開產品手冊。