# 工作區

**工作區**是知識庫的頂層容器。工作區提供了組織邊界——您可以擁有個人工作區、團隊工作區，以及為不同客戶或專案設定單獨的工作區。

## 概念

| 屬性 | 描述 |
|---|---|
| **名稱** | 人類可讀的標籤（例如："Personal"、"Engineering Team"） |
| **類型** | 個人（單一使用者）或團隊（多使用者） |
| **知識庫** | 該工作區內的所有知識庫 |
| **成員** | 具有存取權限的使用者（僅限團隊工作區） |

```bash
tokst workspace create --name "Engineering Team"
```

## 預設工作區

註冊時，TokST 會建立一個名為"Personal"（或您的帳戶名稱）的**預設工作區**。這是您的目前工作區，直到您建立或切換到另一個工作區。

## 建立個人工作區

```bash
tokst workspace create --name "客戶研究"
```

此指令預設建立個人工作區，數量上限遵循個人方案。

## 團隊工作區

團隊工作區會與團隊方案一併開通。成員透過邀請加入，並共同使用該團隊工作區的席位、呼叫、儲存和知識庫額度。工作區開通後類型固定。

## 列出工作區

```bash
tokst workspace list
```

顯示您有權存取的所有工作區，並標記已儲存的目前工作區。待處理的團隊邀請也會在這裡顯示對應的接受和拒絕命令；`tokst workspace inbox` 可直接查看同一收件匣。

## 切換工作區

```bash
tokst workspace switch <workspace-id>
```

切換工作區會更改可用的知識庫。選擇會儲存在本機，後續的 `tokst atlas init` 會在該工作區建立知識庫。接受待處理邀請後，才能切換到其工作區。

## 智能體協作

從控制台側欄開啟**智能體**頁面。頁面始終跟隨側欄目前工作區，僅顯示該工作區的可信智能體與持久交接。API Key 首次以可信智能體方式請求時會建立穩定的 `agt_...` 身分碼。

頁面支援複製身分碼、查看金鑰狀態和最後活躍時間、向一個或多個智能體定向交接，以及向所有活躍智能體廣播。收件匣透過即時更新顯示訊息，具有權限的工作區成員可以確認或關閉回執。

## 刪除工作區

您可以透過 REST API 或遠端 MCP 伺服器刪除工作區：

```bash
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 目前未提供工作區刪除指令。

## 個人與團隊工作區

| 方面 | 個人 | 團隊 |
|---|---|---|
| **成員** | 單一使用者 | 多使用者 |
| **知識庫** | 使用者建立 | 成員共享 |
| **可見性** | 僅您可見 | 所有成員可見 |
| **用途** | 個人筆記、實驗 | 專案知識、團隊文件 |

團隊工作區使用基於角色的存取控制。邀請成員前，請閱讀[團隊協作說明](/docs/team-collaboration)。

## 最佳實踐

- **使用工作區進行隔離** — 個人實驗屬於個人工作區，團隊知識屬於團隊工作區
- **清晰命名工作區** — "Personal"、"Team Engineering"、"Client A" 一目了然
- **每個團隊一個工作區** — 不要為同一群體建立重疊的工作區