# 角色權限管理

### 角色概念

**角色**(Role)是組織內的功能單位，可自由設定成員組成：

* 角色分配到的成員可來自組織內的任何成員
* 一個成員可以同時繼承多個角色，實現靈活的權限管理
* 每個角色擁有獨立的權限設定，方便不同情境的需求

{% hint style="info" %}
**簡單理解：**

角色就像公司的「部門」或「職位」，例如：客服部、行銷部、主管。您先定義每個部門可以做什麼，再把員工加入對應的部門。
{% endhint %}

***

### 角色類型說明

MaiAgent 平台的角色分為三種類型：

#### 擁有者角色 (Owner Role)

\*\*定義：\*\*組織創建者自動獲得的最高權限角色

{% hint style="info" %}
**簡單理解：**

就像公司的「總經理」或「系統管理員」，可以管理所有事情、查看所有資料，沒有任何限制。
{% endhint %}

**特點：**

* 擁有所有資源的完整存取權限，無需額外分配
* 可以管理組織內的所有設定，包括角色、成員、權限
* 組織可以有多位擁有者
* 可以將擁有者角色分配給其他成員，或從成員中移除

{% hint style="warning" %}
擁有者角色擁有最高權限，請謹慎指派。建議僅由真正需要管理整個系統的人員擔任。
{% endhint %}

#### 預設角色 (Default Role)

\*\*定義：\*\*所有組織成員自動擁有的基礎角色，讓成員在尚未被分配其他角色前就有基本權限可使用

{% hint style="info" %}
**簡單理解：**

就像公司的「員工證」，每個人一進公司就自動擁有。確保新進員工不用等待設定就能使用基本功能。
{% endhint %}

**特點：**

* 所有組織成員都會自動獲得預設角色的權限
* 提供最基本的平台存取權限（如問答功能）
* 無法透過 Excel 批次分配
* 管理員可以自訂預設角色的權限範圍
* 無法手動分配成員（系統自動分配給所有成員）

{% hint style="warning" %}
**建議設定：**

預設角色應該只給「最低限度」的權限，避免新成員誤操作。其他權限透過「自訂角色」分配。
{% endhint %}

#### 自訂角色 (Custom Role)

\*\*定義：\*\*由管理員手動或批次分配給特定成員的角色

{% hint style="info" %}
**簡單理解：**

就像公司的各個「部門」或「職位」（客服部、行銷部、主管等），根據工作需求給予不同權限。
{% endhint %}

**特點：**

* 需要管理員主動進行分配
* 可針對不同職責設定不同權限組合
* 支援批次分配，方便大量成員管理
* 分配後成員立即獲得對應權限

**權限計算方式：**

```
成員最終權限 = 預設角色權限 + 所有自訂角色權限
```

**範例說明：**

* 成員 A 被分配到「客服部」角色 → 獲得問答權限 + 對話權限
* 成員 A 又被分配到「測試團隊」角色 → 再加上 AgentOps 權限
* 最終成員 A 擁有：預設權限 + 客服部權限 + 測試團隊權限

{% hint style="info" %}
若使用 EIP 登入，角色可自動從企業系統同步，詳見 [第三方登入（SSO）](https://docs.maiagent.ai/org/sso)。
{% endhint %}

***

### 編輯角色權限

在該組織下，您可以透過點選「<mark style="color:blue;">編輯角色權限</mark>」，為該角色的成員設定權限。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-7a975283a62bb8d6a763f021934cf66ac249c164%2F%E6%88%AA%E5%9C%96%202025-04-25%20%E4%B8%AD%E5%8D%8812.34.17.png?alt=media" alt=""><figcaption></figcaption></figure>

在角色權限頁面，您可以：

* <mark style="color:blue;">新增角色</mark>：為組織建立角色角色（例如：行銷部門），新成員加入時，套用角色即可自動取得對應權限
* <mark style="color:blue;">編輯角色</mark>：修改角色名稱、描述或所屬部門等基本資訊
  * <mark style="color:blue;">角色權限</mark>：設定角色可使用的功能模組與操作範圍
  * <mark style="color:blue;">分配成員</mark>：將組織成員加入指定角色，統一管理權限設定
  * <mark style="color:blue;">分配 AI 助理</mark>：分配角色可操作的 AI 助理
  * <mark style="color:blue;">分配知識庫</mark>：分配角色可存取的知識庫
  * <mark style="color:blue;">分配對話平台</mark>：分配角色可使用的對話平台
* <mark style="color:blue;">刪除角色</mark>：移除不再使用的角色，維持組織權限架構整潔
* <mark style="color:blue;">批次功能</mark>：透過 Excel 批次新增成員至組織，或批次為成員分配角色（詳見 [成員管理：批次成員與權限管理](https://docs.maiagent.ai/member#進階操作批次成員與權限管理)）

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-9547cec3921fd6b0d51b50f21d4a7bf09531c0c2%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-09-04%20124330.png?alt=media" alt=""><figcaption><p>角色權限設定示意圖</p></figcaption></figure>

{% hint style="info" %}
**角色設定頁籤說明**

* **擁有者角色**：「分配 AI 助理」「分配知識庫」「分配對話平台」頁籤會被停用，因為擁有者角色自動擁有所有資源的存取權限
* **預設角色**：「分配成員」頁籤會被停用，因為預設角色會自動分配給所有成員
  {% endhint %}

***

### 權限分級

MaiAgent 採用**層級式權限架構**，權限分為**主權限**與**子權限**：

{% hint style="info" %}
**什麼是「層級式權限架構」？**

就像資料夾的結構：

* **主權限** = 主資料夾（例如：「AI 功能」）
* **子權限** = 子資料夾（例如：「AI 助理」、「知識庫」、「爬蟲」）

**實際運作：**

* 勾選主權限會自動包含底下所有子權限
* 也可以只勾選部分子權限，實現更精細的控制
  {% endhint %}

#### 權限結構總覽

<table><thead><tr><th width="180">主權限</th><th width="200">子權限</th><th>說明</th></tr></thead><tbody><tr><td><strong>MaiGPT 權限</strong></td><td>-</td><td>控制是否可使用 MaiGPT 功能</td></tr><tr><td><strong>AI 功能權限</strong></td><td>AI 助理權限</td><td>控制「AI 助理」分頁的查看與操作</td></tr><tr><td>知識庫權限</td><td>控制「知識庫」分頁的查看與操作</td><td></td></tr><tr><td>爬蟲權限</td><td>控制爬蟲功能的使用</td><td></td></tr><tr><td>工具權限</td><td>控制工具管理功能的使用</td><td></td></tr><tr><td><strong>AgentOps 權限</strong></td><td>測試集權限</td><td>控制測試集功能的查看與操作</td></tr><tr><td>自動化測試權限</td><td>控制自動化測試功能的使用</td><td></td></tr><tr><td><strong>客服對話權限</strong></td><td>所有對話權限</td><td>控制「所有對話」分頁的查看與操作</td></tr><tr><td>對話平台權限</td><td>控制「對話平台」分頁的查看與操作</td><td></td></tr><tr><td>聯絡人權限</td><td>控制聯絡人管理功能的使用</td><td></td></tr><tr><td><strong>問答權限</strong></td><td>-</td><td>控制「內部問答」分頁的查看與操作</td></tr><tr><td><strong>開發者權限</strong></td><td>API 呼叫記錄權限</td><td>控制 API 呼叫記錄的查看</td></tr><tr><td><strong>組織權限</strong></td><td>組織概覽權限</td><td>控制組織概覽頁面的查看</td></tr><tr><td>活動日誌權限</td><td>控制活動日誌功能的查看</td><td></td></tr></tbody></table>

{% hint style="info" %}
**權限層級說明**

* 勾選主權限會自動包含該主權限下的所有子權限
* 也可以只勾選部分子權限，實現更精細的權限控制
* 使用者的最終權限為系統預設角色與自訂角色權限的加總結果
  {% endhint %}

#### 權限設定說明

1. 新增角色並分配權限

點選右上角的 「<mark style="color:blue;">新增角色</mark>」，即可輸入新角色的名稱，並勾選該角色可以擁有的權限。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-dad561e86191c3565a4403894f91fe41119d2a0e%2F%E6%88%AA%E5%9C%96%202025-04-25%20%E4%B8%AD%E5%8D%8812.35.29.png?alt=media" alt=""><figcaption></figcaption></figure>

2. 編輯名稱和權限

進入編輯頁面，編輯角色的名稱，並重新勾選該角色可以擁有的權限。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fys4k26vxlVhAeftECxjh%2Fimage.png?alt=media&#x26;token=dbb2b0e1-1b89-4cb9-ac92-7aba048e9663" alt=""><figcaption></figcaption></figure>

您可以根據角色定義，決定組織成員是否能在左側選單中查看或使用相關功能分頁。透過勾選框來啟用/停用各項權限，點擊右下角「<mark style="color:blue;">儲存</mark>」按鈕來套用設定。

<div><figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-0783b87df996b84d88fde0fcbf55926789f81eb5%2Fimage.png?alt=media" alt=""><figcaption><p>左側選單頁面</p></figcaption></figure> <figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-bf24dfee27f455c732ba32d0f28059823e729872%2Fimage.png?alt=media" alt=""><figcaption><p>角色權限設定頁面</p></figcaption></figure></div>

***

### 權限使用情境

假設企業使用 MaiAgent 架設客服系統：

#### 情境一：新進客服專員

只給予「**問答權限**」

* **原因**：因其剛入職，需要快速學習產品知識和公司政策
* **避免問題**：防止客服專員在不熟悉的情況下誤刪客戶對話記錄或修改重要的 AI 助理設定

#### 情境二：資深客服

「問答權限」+「客服對話權限（所有對話）」

* **原因**：經驗豐富，需要協助處理複雜客訴和指導新人
* **避免問題**：仍不給予 AI 功能權限，避免客服人員誤改 AI 助理設定，導致所有客戶收到錯誤回覆

#### 情境三：AI 助理管理員

「AI 功能權限」+「AgentOps 權限」

* **原因**：負責管理和優化 AI 助理的回覆品質
* **避免問題**：不給予客服對話權限，避免接觸客戶隱私資料

***

### 分配成員

您可以將建立好的角色分配給您組織下的成員：

1. 進入分配成員頁面
2. 點選「<mark style="color:blue;">+分配成員</mark>」按鈕

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-b3104a6291189bc44c585c77c3cc8c94797960ff%2F%E6%96%B0%E5%A2%9E%E7%B5%84%E7%B9%94%E6%88%90%E5%93%A1%20(2).png?alt=media" alt=""><figcaption></figcaption></figure>

3. 選擇要加入的成員，點選中央的「<mark style="color:blue;">加入 ></mark>」 按鈕
4. 最後點選右下角的「<mark style="color:blue;">確認</mark>」按鈕完成設定

<div><figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-36547435fc643a09591d13cfa3d9efbe12e28b78%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-09-04%20142922.png?alt=media" alt=""><figcaption><p>選擇要加入的成員</p></figcaption></figure> <figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-08c284c6fca180484427fc56972522a9ed230c69%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-09-04%20143151.png?alt=media" alt=""><figcaption><p>點選加入</p></figcaption></figure> <figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-b8d25203866b826023d42962551ebf6149bc4f3e%2Fimage.png?alt=media" alt=""><figcaption><p>加入完成，點選確認</p></figcaption></figure></div>

剛剛加入的成員就會出現在成員列表中

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-8eedab66df00e193bba1dc59a334947650fe0127%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

加入後，由於成員只有 AI 助理權限，左側選單只會顯示 AI 助理功能選單，其他客服對話、組織設定等功能都不會顯示在左側列表中，當成員進入無權限訪問的功能，會出現無權限說明畫面：

<div><figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-aeeba7c85790addbde803ff76419df613991d6a8%2Fimage.png?alt=media" alt=""><figcaption><p>更新後權限頁面</p></figcaption></figure> <figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-b932395e30752c688534003935d5f76603a04eaf%2Fimage.png?alt=media" alt=""><figcaption><p>無權限說明畫面</p></figcaption></figure></div>

如此一來，該成員就僅能使用 AI 助理功能，無法做其他改動。

{% hint style="info" %}
需要批次為多位成員分配角色？請參閱 [成員管理：批次成員與權限管理](https://docs.maiagent.ai/member#進階操作批次成員與權限管理)。
{% endhint %}

***

### 分配 AI 助理

您可以限制角色能使用的 AI 助理，讓知識庫的資料確實因角色權限分開使用：

1. 進入「<mark style="color:blue;">分配 AI 助理</mark>」頁面
2. 點選「<mark style="color:blue;">+分配 AI 助理</mark>」按鈕

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-9ff2a8eba77bdcdf9c2cda579ef4f524c1096c4e%2F%E6%96%B0%E5%A2%9E%E7%B5%84%E7%B9%94%E6%88%90%E5%93%A1%20(3).png?alt=media" alt=""><figcaption></figcaption></figure>

3. 選擇要加入的 AI 助理，點選中央的「<mark style="color:blue;">加入 ></mark>」按鈕
4. 最後點選右下角的「<mark style="color:blue;">確認</mark>」按鈕完成設定

<div><figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-e74fbf807830171ad39b2f04e86197a19dc9c54a%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-09-04%20145640.png?alt=media" alt=""><figcaption><p>選擇要加入的 AI 助理</p></figcaption></figure> <figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-e26142170b1eab88b4369102e908b8f60589daed%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-09-04%20145705.png?alt=media" alt=""><figcaption><p>點選中央的新增 AI 助理</p></figcaption></figure> <figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-dabf9685dcea42a7f524261060e7d40e0c1b1556%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-09-04%20145716.png?alt=media" alt=""><figcaption><p>加入完成，點選確認</p></figcaption></figure></div>

加入後，剛剛選擇的 AI 助理就會出現在列表中：

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-424c73c0f017d69b29da22fa0d87f2f565cc0bc0%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

完成後，該角色的使用者僅能查看和使用被分配的 AI 助理：

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-0c6c85f1d10a3c86b839f709492fc5083bdf97d3%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
擁有者角色自動擁有所有 AI 助理的存取權限，無需手動分配。
{% endhint %}

***

### 分配知識庫

您可以限制角色能存取的知識庫，確保敏感資料只有特定角色可以存取：

1. 進入「<mark style="color:blue;">分配知識庫</mark>」頁面
2. 點選「<mark style="color:blue;">+分配知識庫</mark>」按鈕

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2FEsXVHavx3azzEKlwx642%2F%E6%88%AA%E5%9C%96%202025-12-10%20%E4%B8%8B%E5%8D%883.28.14.png?alt=media&#x26;token=7b4d321c-74e0-476d-adbc-dae0c7d58a58" alt=""><figcaption></figcaption></figure>

3. 選擇要加入的知識庫，點選中央的「<mark style="color:blue;">加入 ></mark>」按鈕
4. 最後點選右下角的「<mark style="color:blue;">確認</mark>」按鈕完成設定

加入後，剛剛選擇的知識庫就會出現在列表中。

**使用情境：**

* **研發部門**：僅能存取技術文件知識庫
* **業務部門**：僅能存取產品說明與報價知識庫
* **人資部門**：僅能存取員工手冊知識庫

{% hint style="info" %}
擁有者角色自動擁有所有知識庫的存取權限，無需手動分配。
{% endhint %}

***

### 分配對話平台

您可以限制角色能使用的對話平台，讓不同團隊負責不同的客服渠道：

1. 進入「<mark style="color:blue;">分配對話平台</mark>」頁面
2. 點選「<mark style="color:blue;">+分配對話平台</mark>」按鈕

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2FaGPaxmZKCnxHs7uV5EFS%2F%E6%88%AA%E5%9C%96%202025-12-10%20%E4%B8%8B%E5%8D%883.28.49.png?alt=media&#x26;token=6d382ed6-6e97-40ff-83d5-2ae7ed501b08" alt=""><figcaption></figcaption></figure>

3. 選擇要加入的對話平台，點選中央的「<mark style="color:blue;">加入 ></mark>」按鈕
4. 最後點選右下角的「<mark style="color:blue;">確認</mark>」按鈕完成設定

加入後，剛剛選擇的對話平台就會出現在列表中。

**使用情境：**

* **LINE 客服團隊**：僅能存取 LINE 對話平台
* **網站客服團隊**：僅能存取 Web Chat 對話平台
* **VIP 客服團隊**：可存取所有對話平台

{% hint style="info" %}
擁有者角色自動擁有所有對話平台的存取權限，無需手動分配。
{% endhint %}

***

### 預設角色

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-50690b7ae204091c72ebc773e4f37365032afbe9%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

預設角色會在組織建立時自動生成，作為所有使用者的基礎角色，在套用使用者角色內容時若無特別指派，系統將會自動套用預設角色內的所有權限設定。

> 建議將預設角色權限設定為最低的權限層級，以避免其他角色設定被預設角色覆蓋

***

### 權限處理

當使用者同時被分配到多個角色時，MaiAgent 採用以下權限處理邏輯：

#### 權限聯集原則 (Union Principle)

\*\*採用「最大權限」策略：\*\*使用者將獲得所有角色的權限聯集，即擁有最廣泛的操作權限。

{% hint style="info" %}
**簡單理解：**

當一位成員同時屬於多個角色時，將獲得所有角色權限的聯集，而非僅擁有其中一個角色的權限。
{% endhint %}

**範例說明：**

```
成員 B 同時具有以下角色：
├─ 客服角色：問答權限 + 所有對話權限
└─ 行銷角色：AI 功能權限（AI 助理） + 所有對話權限

→ 成員 B 有效權限：問答權限 + 所有對話權限 + AI 助理權限
   （重複的權限不會疊加，僅計算一次）
```

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-0acf4935e240d8735ff6ef35be56b48b883d476c%2Fplayma%20(11).png?alt=media" alt=""><figcaption></figcaption></figure>

#### 權限套用順序

系統按以下順序計算權限：

```
步驟 1：套用「預設角色」權限
        ↓ （自動，所有成員都有）
步驟 2：套用「自訂角色 A」權限
        ↓ （管理員分配）
步驟 3：套用「自訂角色 B」權限
        ↓ （管理員分配）
最終權限 = 步驟 1 + 步驟 2 + 步驟 3
```

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-edd15e090b569de26e3b7557531619ada7b6afb1%2Fplayma%20(5).png?alt=media" alt=""><figcaption></figcaption></figure>

1. **預設角色**（自動分配）
   * 組織建立時自動生成
   * 所有使用者都會自動套用預設角色權限
2. **自定義角色**（依分配順序）
   * 後分配的角色會與既有權限合併
   * 不會覆蓋已有權限，只會新增

{% hint style="warning" %}
**關鍵重點：**

* 後分配的角色「不會覆蓋」既有權限
* 只會「新增」更多權限
* 無法透過分配新角色來「減少」權限

**如果要減少某人的權限，必須：**

1. 從該角色中移除該成員，或
2. 修改角色本身的權限設定
   {% endhint %}

#### 角色聯集示例

**情境說明：**

* 預設角色關聯三個 AI 助理
* 自訂角色僅關聯兩個 AI 助理

<div><figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-f47ba5e92e8929b76d33612db1965dd2e12acc02%2Fimage.png?alt=media" alt=""><figcaption><p>預設角色</p></figcaption></figure> <figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-61026ebb12a7688dcb50445a3a8d66bed58b6817%2Fimage.png?alt=media" alt=""><figcaption><p>自定義角色</p></figcaption></figure></div>

\*\*結果：\*\*就算該使用者已被分配到自定義角色下，仍然會聯集包含預設角色關聯的設定，最終可以使用三個 AI 助理。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-5541e4d6b9d2a5c2b182f708cd5cfb9c4fc39fef%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
這就是為什麼建議將預設角色的權限設為最小，以免影響其他角色的權限控制。
{% endhint %}

#### 權限移除

當使用者從角色中移除時：

* **移除自定義角色**：失去該角色的專屬權限，保留其他角色權限
* **無法移除預設角色**：所有使用者永遠屬於預設角色
* **權限檢查**：系統會重新計算使用者的有效權限

**範例說明：**

```
成員 A 原有權限：問答 + AI 功能 + 客服對話
                ↓
移除「AI 功能開發」角色
                ↓
成員 A 有效權限：問答 + 客服對話
```

***

### 疑難排解

#### 常見問題：使用者看不到預期功能或可以使用超出預期之功能

1. 確認使用者所屬的所有角色，包含預設角色是否開設過多權限
2. 請使用者清除瀏覽器快取並重新登入

#### 權限審查建議

* 定期檢視使用者的角色分配是否合理
* 移除離職成員的所有角色分配

***

### 常見問題

#### Q：如何讓新成員擁有更多權限？

管理員可以透過以下方式為成員分配額外角色：

* **單一成員**：在成員列表中點擊該成員，手動新增角色
* **批次分配**：使用 [成員管理：批次成員與權限管理](https://docs.maiagent.ai/member#進階操作批次成員與權限管理) 功能，透過 Excel 一次為多人分配角色
* **EIP 自動同步**：若使用 EIP 登入，可在 EIP 端設定角色，登入時自動同步（[第三方登入（SSO）](https://docs.maiagent.ai/org/sso)）

#### Q：為什麼預設角色無法透過 Excel 批次分配？

預設角色是所有成員自動擁有的基礎角色，系統會自動指派給每位成員，因此不需要也不允許透過 Excel 進行分配。

#### Q：為什麼擁有者角色無法分配 AI 助理、知識庫、對話平台？

擁有者角色擁有所有資源的完整存取權限，無需額外分配。系統會自動讓擁有者角色存取組織內的所有資源。

#### Q：權限的層級結構是什麼意思？

MaiAgent 的權限採用父子層級結構。例如「AI 功能權限」是主權限，底下包含「AI 助理權限」「知識庫權限」「爬蟲權限」「工具權限」等子權限。勾選主權限會自動包含所有子權限，也可以只勾選部分子權限實現更精細的控制。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.maiagent.ai/org/role-permission.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.