> 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/model-access.md).

# 模型調用權限

組織擁有者可自助管理組織內可使用的 AI 模型清單，控制成員與 AI 助理能調用哪些模型

組織擁有者可以在「模型調用權限」頁面，自助開啟或關閉組織內可使用的 AI 模型。關閉的模型不會出現在任何模型選單中，成員與 AI 助理都無法調用，方便企業統一控管模型使用範圍（例如僅允許特定廠商、特定部署型態的模型，或排除高成本模型）。

## 使用情境：統一團隊可選的模型 <a href="#model-governance-scenario" id="model-governance-scenario"></a>

IT 團隊完成模型評測後，希望所有部門只選用通過驗證的模型。組織擁有者可先搜尋目標模型、查看是否有助理正在使用，再決定開啟或關閉；若要停用使用中的模型，應先替受影響的助理改選其他可用模型。

## 運作架構：開通與啟用是兩件事 <a href="#two-layer-model" id="two-layer-model"></a>

模型能否在組織內使用，取決於兩個層次：

| 層次           | 由誰控制     | 說明                                                                        |
| ------------ | -------- | ------------------------------------------------------------------------- |
| **開通（授權範圍）** | MaiAgent | MaiAgent 依合約與方案為組織開通可使用的模型清單，這是組織可自助管理的「天花板」。未開通的模型無法自行啟用，如需使用請洽 MaiAgent |
| **啟用（自助管理）** | 組織擁有者    | 在已開通的範圍內，組織擁有者可隨時在此頁面自行開啟或關閉模型，變更立即生效                                     |

{% hint style="info" %}
模型因此分為三種狀態：**已啟用**、**已開通未啟用**、**未開通**。「未開通」代表 MaiAgent 尚未為此組織開通該模型的使用權限，無法自行啟用，如需使用請洽 MaiAgent。
{% endhint %}

## 進入頁面 <a href="#how-to-enter" id="how-to-enter"></a>

### 1. 開啟組織設定 <a href="#open-org-settings" id="open-org-settings"></a>

從左側選單點擊 <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-f1cf937d3cba62777020f1f601290c217e0a3a22%2Fmodel-access-01-menu-entry.png?alt=media" alt="左側選單：組織設定 → 模型調用權限"><figcaption><p>左側選單入口：組織設定 → 模型調用權限</p></figcaption></figure>

### 2. 檢視頁面總覽 <a href="#page-overview" id="page-overview"></a>

進入後，頁面會列出平台目錄中的所有模型，依 <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-4cb9982bcdf0ec7b537425609db720657dd29de3%2Fmodel-access-overview.png?alt=media" alt="模型調用權限頁面：以 GPT-5.6 搜尋結果為例，查看開關與正在使用的助理數量"><figcaption><p>模型調用權限頁面：以 GPT-5.6 搜尋結果為例，查看開關與正在使用的助理數量</p></figcaption></figure>

{% hint style="warning" %}
組織擁有者預設可進入此頁面。其他角色必須先取得「模型調用權限」選單權限，才能進入並檢視；只有組織擁有者可以變更開關。
{% endhint %}

## 頁面元件說明 <a href="#page-elements" id="page-elements"></a>

從上到下，頁面包含以下區塊：

| 區塊       | 說明                                                                                                     |
| -------- | ------------------------------------------------------------------------------------------------------ |
| **頁首說明** | 頁面頂部的說明文字，簡述此頁面的用途與影響範圍                                                                                |
| **進度條**  | 顯示「已啟用 / 目錄總數」，一眼掌握目前組織啟用了多少模型                                                                         |
| **狀態統計** | 顯示「已啟用 N / 已開通未啟用 N / 未開通 N」三組數字，對應下方模型清單的三種狀態                                                         |
| **搜尋框**  | 可搜尋名稱 / Gateway ID / 廠商，模型多時快速定位                                                                       |
| **篩選**   | <mark style="color:blue;">**雲端 N**</mark> / <mark style="color:blue;">**地端 N**</mark> 篩選標籤，只看特定部署型態的模型 |
| **模型分區** | 清單依 <mark style="color:blue;">**雲端模型**</mark> 與 <mark style="color:blue;">**地端模型**</mark> 分成兩區         |
| **模型列**  | 每列顯示模型名稱、廠商與狀態；已開通的模型有切換開關，未開通的模型顯示鎖頭圖示；正被 AI 助理使用的模型會顯示「目前有 N 個助理正在使用」提示                              |

### 搜尋與篩選 <a href="#search-and-filter" id="search-and-filter"></a>

模型目錄通常有數十個模型，建議善用搜尋與篩選快速定位：

* **搜尋**：在搜尋框輸入模型名稱、Gateway ID 或廠商名稱，清單會即時過濾
* **篩選部署型態**：點擊 <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-82c95278fc799f989030f89628ec4d9db9582944%2Fmodel-access-02-search-filter.png?alt=media" alt="搜尋框與雲端 / 地端篩選"><figcaption><p>以搜尋框過濾模型，或用雲端 / 地端標籤篩選部署型態</p></figcaption></figure>

## 三種模型狀態 <a href="#model-status" id="model-status"></a>

| 狀態         | 畫面呈現       | 誰能改變           | 說明                                      |
| ---------- | ---------- | -------------- | --------------------------------------- |
| **已啟用**    | 開關為開啟      | 組織擁有者可隨時關閉     | 組織內可正常選用此模型：出現在 AI 助理的模型選單中，API 也可指定調用  |
| **已開通未啟用** | 開關為關閉      | 組織擁有者可隨時開啟     | MaiAgent 已開通此模型，但組織目前選擇不使用；不會出現在任何模型選單中 |
| **未開通**    | 顯示鎖頭圖示，無開關 | 需洽 MaiAgent 開通 | 不在 MaiAgent 為此組織開通的授權範圍內，組織無法自行啟用       |

### 未開通模型的鎖頭說明 <a href="#locked-model" id="locked-model"></a>

點擊「未開通」模型的鎖頭時，會顯示說明視窗：「『（模型名稱）』尚未由 MaiAgent 為此組織開通權限，無法自行啟用。如需使用請洽 MaiAgent。」

## 啟用與停用模型 <a href="#toggle-models" id="toggle-models"></a>

直接切換模型列上的開關即可，**變更會立即生效並儲存**（沒有另外的儲存按鈕）。成功後系統會顯示「已更新模型調用權限」。

更新後，所有 AI 助理、對話與 API 呼叫都會以此清單為準：

* **被停用的模型會直接從模型下拉選單中消失**（而非顯示為不可選），成員建立或編輯 AI 助理時看不到該模型

### 停用「使用中」的模型 <a href="#disable-in-use-model" id="disable-in-use-model"></a>

若某模型正被 AI 助理使用，模型列上會顯示「目前有 N 個助理正在使用」。此時關閉開關，系統會跳出「確認套用變更」二次確認視窗：

> 「（模型名稱）」正被 N 個助理使用，停用後這些助理將無法使用此模型。仍要停用嗎？

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-02cdb904dd53c544278858380c2a0e9639b556b3%2Fmodel-access-04-disable-confirm.png?alt=media" alt="停用使用中模型的二次確認視窗"><figcaption><p>停用使用中的模型時，系統會列出受影響的助理數量並要求確認</p></figcaption></figure>

#### 停用後會發生什麼事 <a href="#disable-effects" id="disable-effects"></a>

停用一個「使用中」的模型後，影響會依序展開：

1. **模型選單**：該模型立即從所有模型下拉選單中消失，成員無法再為任何 AI 助理選用它
2. **已綁定的 AI 助理**：這些助理的模型設定**不會被自動更換**，助理會停在「綁著一個不能用的模型」的狀態
3. **恢復方式**：為受影響的助理改選其他可用模型，或重新開啟此模型的開關

{% hint style="danger" %}
**停用使用中的模型不會自動更換這些助理的模型設定**，已綁定該模型的 AI 助理在收到訊息時將無法回覆。建議依以下順序操作：

1. 先確認模型列上的「目前有 N 個助理正在使用」提示
2. 到 AI 助理設定，為受影響的助理逐一改選其他可用模型
3. 確認沒有助理綁定此模型後，再回到本頁面關閉開關
4. 停用後實際發一則測試訊息，確認線上服務不受影響
   {% endhint %}

## 使用情境 <a href="#use-cases" id="use-cases"></a>

以下是幾種常見的模型控管情境：

* **金融業：僅允許地端模型。** 銀行因法遵與資料落地要求，規定客戶資料不得送往外部雲端服務。組織擁有者用 <mark style="color:blue;">**雲端**</mark> 篩選標籤列出所有雲端模型並逐一停用，只保留 <mark style="color:blue;">**地端模型**</mark> 分區內已開通的模型。之後任何成員建立 AI 助理時，選單中只會出現地端模型，不需逐一宣導也不怕誤選。
* **政府機關：限定特定廠商。** 公部門標案規定僅能使用特定廠商的模型。組織擁有者在搜尋框輸入廠商名稱，將該廠商的模型全數啟用，其餘模型停用，讓平台上的模型選擇範圍與標案規範一致。
* **一般企業：控管高價模型的使用成本。** 採用 Credits 計費的企業發現多數日常客服情境用中階模型即可，少數成員卻習慣選最貴的旗艦模型。組織擁有者停用高單價模型、只保留性價比高的模型，從源頭控制每次對話的 Credits 消耗，不需逐一盯各助理的設定。
* **集團／多部門組織：統一模型治理。** IT 部門完成內部評測後，只啟用通過驗證的模型版本，避免各部門自行選用未經測試的新模型，讓全組織的 AI 助理品質與行為可預期。

## 頁面檢視權限設定 <a href="#page-permission" id="page-permission"></a>

「模型調用權限」頁面預設對組織擁有者顯示。若要讓其他角色的成員也能看到此頁面（僅檢視，仍無法變更設定），可由組織擁有者到 <mark style="color:blue;">**組織概覽**</mark> → <mark style="color:blue;">**編輯角色權限**</mark>，選擇角色後在選單權限中，為該角色勾選 <mark style="color:blue;">**模型調用權限**</mark> 節點。詳見 [角色權限管理](/org/roles/role-permission.md)。

## 常見問題 <a href="#faq" id="faq"></a>

#### Q：為什麼有些模型顯示「未開通」？ <a href="#faq-not-granted" id="faq-not-granted"></a>

「未開通」代表該模型不在 MaiAgent 為此組織開通的授權範圍內。如需使用，請聯繫 MaiAgent，開通後即可在此頁面自行啟用。

#### Q：從未調整過此頁面，組織的模型會受影響嗎？ <a href="#faq-default-behavior" id="faq-default-behavior"></a>

不會。未做任何設定時，組織可使用的模型範圍與過去一致；只有在此頁面主動停用模型後，才會影響選單與調用。

#### Q：不小心停用了使用中的模型，怎麼恢復？ <a href="#faq-restore" id="faq-restore"></a>

回到此頁面重新開啟該模型的開關即可，變更立即生效，已綁定的 AI 助理會恢復正常回覆，不需重新設定助理。

#### Q：一般成員可以看到這個頁面嗎？ <a href="#faq-member-view" id="faq-member-view"></a>

只有擁有「模型調用權限」選單權限的成員可以進入並檢視此頁面；只有組織擁有者可以變更開關。若一般成員的左側選單沒有此頁面，可由組織擁有者透過 [頁面檢視權限設定](#page-permission) 開放。


---

# 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 dynamically by asking a question.

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

```
GET https://docs.maiagent.ai/org/model-access.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
