組織與成員管理

組織、角色、成員三層結構，以及角色裡裝的三樣東西：功能權限、建立權限、資源綁定。第一次設定組織前先讀這頁。

什麼是組織與成員管理？

MaiAgent 的組織與成員管理，就像替公司開一間「數位辦公室」：先把公司建成一個組織，在裡面設部門（角色），決定每個部門能用什麼，再把同仁加進對應的部門。

這套設計基於 RBAC（Role-Based Access Control，角色權限控制）：權限設在角色上，不設在人身上。

簡單理解：

RBAC 是「先設定職位，再把人加進職位」。你先定義「客服專員」能做哪些事，再把張先生、李小姐加進這個角色，他們就自動擁有客服專員的所有權限，不用逐一設定。

---

三層結構：組織 → 角色 → 成員

一個組織裡有多個角色，成員加入角色就拿到那個角色的權限與資源

層級	對應到公司	說明
組織	你的公司	最上層的管理單位。成員、角色、Agent、知識庫都屬於某一個組織，組織之間完全隔離。
角色	部門或職位	權限與資源的容器。一個成員可以同時隸屬多個角色，權限取聯集。
成員	員工	組織裡的使用者。自己沒有權限，全部從所隸屬的角色來。

---

一個角色裡裝什麼

很多人用「新增／讀取／修改／刪除」的框架來想權限，但平台不是這樣切的。一個角色裡有三樣東西，三者是「而且」的關係：

要讓成員能建 Agent，功能權限的「AI 助理」與建立權限的「允許新增 AI 助理」都要開

層	決定什麼	在哪裡設定
功能權限	左側選單看得到什麼。只管看不看得到，不分讀寫刪	角色的角色權限分頁。父權限勾了會自動包含底下所有子權限，也可以只勾部分子權限
建立權限	能不能新建 Agent、知識庫、資料庫、對話平台	各資源分配分頁最上方的「允許新增」勾選
資源綁定	看得到哪幾個 Agent、哪幾個知識庫；每一筆各有讀取、編輯、刪除三個開關	角色的分配 AI 助理、分配知識庫等分頁

簡單理解：

功能權限是「看得到哪些房間」，建立權限是「能不能在房間裡蓋新東西」，資源綁定是「房間裡哪幾樣東西你拿得到、改得動」。三把鑰匙都在角色上，人加入角色才拿到。

可以分配給角色的資源

角色編輯頁的分頁列就是可分配的資源：

• AI 助理、知識庫、資料庫、對話平台：各帶讀取／編輯／刪除

• 工具、技能、Agent UI 工具：指定角色可掛在 Agent 上的能力元件

• MaiGPT 使用權限：這個角色能不能用 MaiGPT

• Credit 額度：這個角色的用量上限，詳見 Credits 計費制度

角色編輯頁：上方分頁列是可分配的資源，「允許新增」是建立權限，每列的讀取／編輯／刪除是資源綁定

---

核心概念

角色有三種

類型	誰在裡面	特性
擁有者	組織建立者，或被指派的管理員	略過所有權限檢查，組織內全部資源都看得到、改得動。可以有多位
預設角色	全體成員，自動隸屬	它給什麼權限，全公司就有什麼；它綁了哪個 Agent，全公司就都看得到。建議只留最低權限、不綁任何資源
自訂角色	被指派的成員	依部門或職位建立，可複製，可批次指派

角色列表：擁有者、預設角色與自訂角色，各自顯示權限、成員與綁定的資源數

成員有兩種

類型	權限範圍
擁有者	全部。可以管理組織設定、角色與成員
一般成員	預設角色的權限，加上所有被指派角色的權限

可見性只看角色，不看建立者。 一個 Agent 綁到哪些角色，那些角色的成員就看得到；平台不會因為「這是我建的」就多給權限。要讓 Agent 只有建立者自己看得到，唯一的方法是一人一個角色，做法見 角色權限規劃指南。

---

建議的設定順序

1. 建立組織：組織管理

2. 接上登入方式：要用公司帳號登入就先設 第三方登入（SSO），成員信箱要與 SSO 一致

3. 收斂預設角色：只留最低權限，不綁任何資源

4. 建立角色：依部門或職位建立，勾功能權限與建立權限，見 角色權限管理

5. 分配資源：把 Agent、知識庫等綁到角色，設好讀取／編輯／刪除，見 角色資源存取權限

6. 加入成員並指派角色：成員管理，人多用批次匯入

7. 用一般成員的帳號實測：擁有者略過所有檢查，測不出真實畫面

---

相關頁面

• 組織管理：建立、切換、管理組織

• 角色與權限：角色權限管理、資源存取權限、成員篩選、角色與聯絡人的差異、角色權限規劃指南

• 成員管理：新增、刪除成員，指派角色

• 第三方登入（SSO）、身分同步（LDAP／SCIM）：用公司帳號登入與同步成員

• 公告管理：發布組織公告給全部成員或指定角色、成員