工作區
工作區是知識庫的頂層容器。工作區提供了組織邊界——您可以擁有個人工作區、團隊工作區,以及為不同客戶或專案設定單獨的工作區。
概念
| 屬性 | 描述 |
|---|---|
| 名稱 | 人類可讀的標籤(例如:"Personal"、"Engineering Team") |
| 類型 | 個人(單一使用者)或團隊(多使用者) |
| 知識庫 | 該工作區內的所有知識庫 |
| 成員 | 具有存取權限的使用者(僅限團隊工作區) |
tokst workspace create --name "Engineering Team"
預設工作區
註冊時,TokST 會建立一個名為"Personal"(或您的帳戶名稱)的預設工作區。這是您的目前工作區,直到您建立或切換到另一個工作區。
建立個人工作區
tokst workspace create --name "客戶研究"
此指令預設建立個人工作區,數量上限遵循個人方案。
團隊工作區
團隊工作區會與團隊方案一併開通。成員透過邀請加入,並共同使用該團隊工作區的席位、呼叫、儲存和知識庫額度。工作區開通後類型固定。
列出工作區
tokst workspace list
顯示您有權存取的所有工作區,並標記已儲存的目前工作區。待處理的團隊邀請也會在這裡顯示對應的接受和拒絕命令;tokst workspace inbox 可直接查看同一收件匣。
切換工作區
tokst workspace switch <workspace-id>
切換工作區會更改可用的知識庫。選擇會儲存在本機,後續的 tokst atlas init 會在該工作區建立知識庫。接受待處理邀請後,才能切換到其工作區。
智能體協作
從控制台側欄開啟智能體頁面。頁面始終跟隨側欄目前工作區,僅顯示該工作區的可信智能體與持久交接。API Key 首次以可信智能體方式請求時會建立穩定的 agt_... 身分碼。
頁面支援複製身分碼、查看金鑰狀態和最後活躍時間、向一個或多個智能體定向交接,以及向所有活躍智能體廣播。收件匣透過即時更新顯示訊息,具有權限的工作區成員可以確認或關閉回執。
刪除工作區
您可以透過 REST API 或遠端 MCP 伺服器刪除工作區:
curl -X DELETE https://api.tokst.com/v1/workspaces/<workspace-id> \
-H "Authorization: Bearer $TOKST_API_KEY"
遠端 MCP 用戶端也可以使用 workspaceId 呼叫 tokst_workspace_delete。刪除前必須先移除工作區內的所有知識庫;仍有知識庫時,API 回傳 409 Conflict。CLI 目前未提供工作區刪除指令。
個人與團隊工作區
| 方面 | 個人 | 團隊 |
|---|---|---|
| 成員 | 單一使用者 | 多使用者 |
| 知識庫 | 使用者建立 | 成員共享 |
| 可見性 | 僅您可見 | 所有成員可見 |
| 用途 | 個人筆記、實驗 | 專案知識、團隊文件 |
團隊工作區使用基於角色的存取控制。邀請成員前,請閱讀團隊協作說明。
最佳實踐
- 使用工作區進行隔離 — 個人實驗屬於個人工作區,團隊知識屬於團隊工作區
- 清晰命名工作區 — "Personal"、"Team Engineering"、"Client A" 一目了然
- 每個團隊一個工作區 — 不要為同一群體建立重疊的工作區