# 團隊協作

團隊工作區讓人員與智能體在同一專案中使用共享的長期記憶。每個知識庫和記憶都歸屬於一個工作區，左側目前工作區決定控制台的資料範圍。

## 建立與切換

從控制台側欄開啟**團隊**即可申請團隊工作區配額。填寫所需的獨立團隊工作區數量和用途說明後，TokST 系統管理員會審核配額申請。申請通過後，帳戶獲得可用團隊工作區配額；系統不會自動建立工作區。申請列表會保留待審核、已通過、已拒絕和已取消的記錄。

**我擁有的團隊**區域會顯示配額總數、已建立數量和可用數量。存在可用配額時，點擊**建立團隊工作區**即可直接建立；建立者會成為該團隊的 Owner 和計費負責人，並獲得獨立的 Team 訂閱。隨後可從控制台左側的工作區切換選單中選擇團隊工作區來查看記憶與知識庫。團隊全域頁面顯示使用者擁有或管理的全部團隊，不依賴目前選取的工作區。

## 團隊管理

每個團隊工作區擁有獨立訂閱、共享呼叫量、儲存、席位和知識庫上限。團隊頁將**我擁有的團隊**與**我管理的團隊**分組，一個帳戶可以在同一頁面管理產品、開發或客戶團隊。每個團隊項目顯示共享用量、活躍與已歸檔記憶、知識庫數量、活躍智能體數量和最近稽核活動；Owner 可在團隊頁直接開啟完整稽核記錄。Owner 負責計費與方案變更；Admin 在目標工作區頁面管理成員、邀請、角色和協作；Member 按既有權限規則新增和管理自己的記憶。

## 角色

| 角色 | 工作區與成員 | 記憶與知識庫 |
|---|---|---|
| **Owner** | 編輯工作區、邀請成員和管理員、調整角色、移除成員、轉移所有權 | 新增、編輯、歸檔、還原和刪除全部工作區內容 |
| **Admin** | 邀請和移除成員；管理一般成員 | 新增、編輯、歸檔、還原和刪除全部工作區內容 |
| **Member** | 可以退出工作區 | 新增內容，並管理自己建立的內容 |

知識庫繼承所屬工作區的存取規則。目前版本不設定知識庫層級的獨立角色。

## 邀請成員

開啟目前工作區的管理頁。在**待處理邀請**中輸入一個或多個信箱，信箱之間使用逗號或換行分隔；選擇角色，並設定 1 天、1 週或 1 個月的有效期。

TokST 會為每個信箱建立一筆邀請。待邀請列表展示接收人、分配角色、到期時間，並提供複製和撤銷邀請連結的操作。邀請處於待處理狀態時不會授予工作區存取權限。

## 同意或拒絕

已登入的接收人會在工作區管理頁頂部看到待處理邀請。選擇**同意**後，接收人以指定角色加入工作區；選擇**拒絕**後，邀請關閉。已過期、已拒絕、已撤銷和已同意的邀請均不會授予存取權限。

## 所有權與退出

Owner 可以在二次確認後將所有權轉移給其他成員。原 Owner 會成為 Admin。Owner 在完成所有權轉移前保留在工作區中。

Member 與 Admin 可以退出工作區。Owner 與 Admin 可以在二次確認後移除符合權限範圍的成員。移除成員會結束其對該工作區共享記憶、知識庫和檔案的存取。

## 智能體收件匣

選擇目標工作區後，從控制台開啟**智能體**頁面。頁面顯示目前工作區的可信 `agt_...` 身分和持久訊息收件匣。成員與智能體可以傳送交接；Owner 與 Admin 可以查看和管理其權限範圍內的全部工作區訊息。定向訊息對傳送者、接收智能體和 Owner/Admin 可見。廣播會向目前工作區的活躍智能體建立回執，工作區成員可以查看。

頁面分為**智能體管理**與**通訊**兩個工作表。管理頁顯示穩定身分、基於來源的暱稱、API Key 狀態和活躍時間；Owner 與 Admin 可以修正早期缺少來源關聯的暱稱。通訊頁分開顯示群組廣播和直接訊息，每筆記錄都會顯示傳送方與接收方。

## 建議流程

1. 每個產品或客戶使用一個團隊工作區。
2. 為架構、合約、營運或產品決策等長期領域建立獨立知識庫。
3. 為人員和智能體分配滿足工作所需的最小角色。
4. 將敏感專案事實放入正確的工作區，透過切換工作區保持上下文隔離。