Workspace
Organization、Workspace 與 Gateway 資源的關係
Hakila 以 Organization 與 Workspace 組織資源。Gateway API Key、用量與 BYOK 金鑰通常掛在 Workspace 底下。
階層(概念)
Organization
├── Units(組織單位樹,可選)
├── People(目錄人員,可掛 Unit;≠ 登入帳號)
└── Workspace
├── Members(Admin / Member)
├── API Keys(可選綁定 Person)
├── Provider Keys(BYOK)
└── Request Logs(用量)單位/人員可設層級預算;API Key 預算不得超過所屬組織(或人員/單位)允許的上限。
對 API 呼叫的意義
- 你持有的 API Key 已綁定特定 Workspace 與 Organization
- 若建立時指定
PersonId,用量可歸在該人員/單位脈絡 - 請求的用量與花費會記在該 Key / Workspace 脈絡
- BYOK 可依 Workspace 覆寫上游金鑰
Admin vs Gateway
| 介面 | 用途 |
|---|---|
Admin UI / api/admin/* | 管理組織、單位、人員、成員、金鑰、預算與統計 |
Gateway /api/v1/* | 應用程式實際呼叫模型 |
本文件站聚焦 Gateway;Admin 操作細節之後可另開產品手冊。