> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/org/roles/maigpt-role-permissions.md).

# MaiGPT 角色使用權限

為不同角色設定可用的 MaiGPT 模型、工具、技能、連接器與內建功能。

組織管理員可以依角色限制 MaiGPT 可用的模型、工具、技能、連接器與內建功能。成員同時擁有多個角色時，系統會合併各角色提供的權限；只要其中一個角色允許，成員就能使用。所有成員都會自動擁有預設角色，因此預設角色的設定也會一起合併計算，詳見[合併規則與預設角色](#merge-rules)。

{% hint style="info" %}
擁有者不受角色使用範圍限制。以下設定適用於預設角色與自訂角色。
{% endhint %}

## 使用情境 <a href="#scenario" id="scenario"></a>

資訊主管想讓客服角色只使用公司核准的模型。他進入該角色的 MaiGPT 使用權限，在「可用模型」取消「全部」並勾選核准的模型；卡片隨即顯示「部分」與勾選數量，畫面提示更新成功。工具、技能與連接器仍維持各自的「全部」設定，不會因模型範圍變更而一起縮小。

## 設定角色的 MaiGPT 使用範圍 <a href="#configure-scope" id="configure-scope"></a>

{% stepper %}
{% step %}

### 1. 開啟角色權限 <a href="#open-role-permissions" id="open-role-permissions"></a>

前往<mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">組織概覽</mark>，在「管理」區選擇<mark style="color:blue;">編輯角色權限</mark>。
{% endstep %}

{% step %}

### 2. 選擇角色 <a href="#choose-role" id="choose-role"></a>

在角色清單找到預設角色或自訂角色，選擇右側的<mark style="color:blue;">編輯</mark>，再開啟<mark style="color:blue;">分配MaiGPT使用權限</mark>頁籤。
{% endstep %}

{% step %}

### 3. 設定可用範圍 <a href="#set-available-scope" id="set-available-scope"></a>

在「可用範圍」分別設定<mark style="color:blue;">可用模型</mark>、<mark style="color:blue;">工具</mark>、<mark style="color:blue;">技能</mark>與<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-84b3e5ddfa1ba53be75b55c1591eec205e7af5cf%2Fmaigpt-role-scope-overview.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-90f50a8d54f35895d2596939d50120557c4b9d2e%2Fmaigpt-role-model-none.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-e3cb74069c81259c668c473925737d43ab08c228%2Fmaigpt-role-model-partial.png?alt=media" alt="可用模型勾選一個項目後，卡片顯示「部分 1/48」"><figcaption><p>勾選模型後，卡片顯示「部分」及勾選數量；數量會隨組織可用模型變動</p></figcaption></figure>

{% hint style="warning" %}
若「可用模型」顯示「無」，畫面會提醒「此角色將沒有模型可選，無法在 MaiGPT 對話」，但仍允許保留此設定。請確認該角色成員是否需要在 MaiGPT 對話。
{% endhint %}
{% endstep %}

{% step %}

### 4. 設定內建功能 <a href="#set-built-in-features" id="set-built-in-features"></a>

在「功能」區開啟或關閉以下能力：

* <mark style="color:blue;">Code Interpreter</mark>：執行程式並產生圖表、試算表或文件。
* <mark style="color:blue;">知識庫 RAG</mark>：使用組織知識庫回答並附上來源。
* <mark style="color:blue;">Deep Research</mark>：拆解問題並多輪搜尋網路資料。它使用自己的網路搜尋，不受官方搜尋工具是否開放影響。
* <mark style="color:blue;">Browser Tool</mark>：操作瀏覽器、開啟頁面、與網頁元素互動及擷取畫面。

變更會自動儲存，不需要另外按「儲存」。看到更新成功提示後即可離開頁面；若儲存失敗，畫面會顯示是哪一項未更新，並恢復成上次成功儲存的狀態。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-a98fb627bb61dc4e93ebffb9b022cc16b413af85%2Fmaigpt-role-features.png?alt=media" alt="分配 MaiGPT 使用權限頁面中的四個功能開關"><figcaption><p>在角色設定中管理 MaiGPT 內建功能</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## 合併規則與預設角色 <a href="#merge-rules" id="merge-rules"></a>

成員最終可用的範圍＝預設角色＋成員所屬各自訂角色的合併結果。每個類別（可用模型、工具、技能、連接器）分開計算：

* 任一角色在該類別勾選「全部」，成員即可使用該類別所有可用項目，其他角色的限縮不會生效。
* 所有角色都取消「全部」時，成員可使用各角色勾選項目的合併清單。
* 所有角色都取消「全部」且都沒有勾選任何項目時，成員才沒有該類別可用。

所有成員都會自動擁有<mark style="color:blue;">預設角色</mark>，而預設角色的每個類別預設為「全部」。因此只把自訂角色的「可用模型」設為「無」，成員仍可透過預設角色使用全部模型。

### 讓成員在 MaiGPT 沒有模型可用 <a href="#deny-all-models" id="deny-all-models"></a>

若要讓某些成員在 MaiGPT 沒有任何模型可用，需要同時完成：

1. 在成員所屬的自訂角色，取消「可用模型」的「全部」，並且不勾選任何模型。
2. 在<mark style="color:blue;">預設角色</mark>也取消「可用模型」的「全部」，改為不勾選，或只勾選要開放給所有成員的模型。
3. 需要使用模型的成員，另外指派勾選了對應模型的自訂角色。

{% hint style="warning" %}
預設角色會套用到組織內所有成員。調整預設角色的「可用模型」前，請先確認其他成員需要的模型已由自訂角色提供，避免其他成員也無法在 MaiGPT 對話。工具、技能與連接器的限制方式相同。
{% endhint %}

## 成員會看到什麼 <a href="#member-experience" id="member-experience"></a>

角色設定生效後，MaiGPT 只顯示成員可用的模型、工具、技能與功能入口。知識庫檢索或 Code Interpreter 原本可用、但被角色停用時，右側面板會說明該功能尚未開放給此角色。

連接器已由組織啟用、但尚未開放給成員角色時，成員不會看到授權按鈕，可以改送出開放申請。若成員先前已完成授權，仍可解除連結以移除不再使用的授權。

{% hint style="warning" %}
調整權限後，已開始的對話若使用了不再允許的模型，系統會嘗試切換到角色可用的模型。請提醒成員確認模型名稱後再繼續對話。
{% endhint %}

## 相關說明 <a href="#related-guides" id="related-guides"></a>

* [角色權限管理](/org/roles/role-permission.md)
* [MaiGPT 連接器](/work/maigpt/connectors.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/org/roles/maigpt-role-permissions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.