> 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 模型清單，控制成員與 Agent 能調用哪些模型

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

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

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

## 運作架構：開通與啟用是兩件事 <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-919f715b95de337530ff48b1e152ee6f50359ce2%2Fmodel-access-01-menu-entry.png?alt=media" alt="左側選單：組織設定 → 模型調用權限"><figcaption><p>左側選單入口：組織設定 → 模型調用權限</p></figcaption></figure>

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

進入後，頁面會以單一清單列出平台目錄中的所有模型，上方為啟用進度與說明，清單上方的工具列可搜尋及篩選。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-7182ce9ea45c9de48df8d6fac241be7f8ccdf7e3%2Fmodel-access-overview.png?alt=media" alt="模型調用權限頁面：上方為已啟用 / 目錄總數進度條與說明，下方為搜尋框、全部廠商下拉、中國／美國／其他國家與開放權重／閉源篩選按鈕、能力篩選與排序，以及含價格、首字時間、輸出速度、輸入處理速度、上下文長度、最大輸出欄位的模型清單"><figcaption><p>模型調用權限頁面：進度條、說明、工具列與模型清單</p></figcaption></figure>

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

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

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

| 區塊            | 說明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **頁首說明**      | 頁面頂部的說明文字，簡述此頁面的用途與影響範圍                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| **進度條**       | 顯示「已啟用 / 目錄總數」，一眼掌握目前組織啟用了多少模型                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **狀態統計**      | 顯示「已啟用 N / 已開通未啟用 N / 未開通 N」三組數字，對應下方模型清單的三種狀態                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **搜尋框**       | 可搜尋模型名稱、Gateway ID、廠商，或實際提供推論的服務名稱，模型多時快速定位                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **廠商下拉**      | 預設為 <mark style="color:blue;">**全部廠商**</mark>，可切換成單一廠商；沒有標示廠商的模型歸在 <mark style="color:blue;">**其他**</mark>                                                                                                                                                                                                                                                                                                                                                                             |
| **產地篩選**      | <mark style="color:blue;">**中國 N**</mark> / <mark style="color:blue;">**美國 N**</mark> / <mark style="color:blue;">**其他國家 N**</mark> 三個篩選按鈕，數字會隨其他篩選條件變動                                                                                                                                                                                                                                                                                                                                |
| **開放權重／閉源篩選** | <mark style="color:blue;">**開放權重 N**</mark> / <mark style="color:blue;">**閉源 N**</mark> 兩個篩選按鈕，數字會隨目前的搜尋與廠商條件變動                                                                                                                                                                                                                                                                                                                                                                        |
| **能力篩選與排序**   | <mark style="color:blue;">**能力**</mark> 可勾選 <mark style="color:blue;">**工具呼叫**</mark>、<mark style="color:blue;">**看圖**</mark>、<mark style="color:blue;">**思考**</mark>，只列出同時具備所勾能力的模型；<mark style="color:blue;">**排序**</mark> 下拉可依價格、速度或規格欄位排序，見[比較價格、速度與規格](#compare-price-speed-specs)                                                                                                                                                                                                |
| **模型清單**      | 所有模型列在同一份表格中，<mark style="color:blue;">**模型**</mark> 欄固定在左側，其餘欄位在窄螢幕可橫向捲動                                                                                                                                                                                                                                                                                                                                                                                                              |
| **模型列**       | 每列顯示模型名稱、廠商標籤、產地標籤（例如 <mark style="color:blue;">**美國**</mark>、<mark style="color:blue;">**中國**</mark>），開放權重模型另有 <mark style="color:blue;">**開放權重**</mark> 標籤；名稱與其他模型相同時，另有一個灰框的模型 ID 前 8 碼標籤，見[分辨同名模型](#same-name-models)；第二行為 Gateway ID 與實際提供推論的服務（例如 AWS Bedrock、OpenRouter）。名稱旁有能力圖示；右側依序是價格、首字時間、輸出速度、輸入處理速度、上下文長度、最大輸出。已開通的模型有切換開關，未開通的模型顯示 <mark style="color:blue;">**未開通**</mark> 鎖頭按鈕；正被 Agent 使用的模型會顯示「目前有 N 個助理正在使用」提示；即將退役的模型會顯示退役日期與接替模型，見[模型退役與自動搬移](#model-retirement) |

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

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

* **搜尋**：在搜尋框輸入模型名稱、Gateway ID、廠商名稱、實際提供推論的服務名稱（例如輸入「OpenRouter」列出所有經由 OpenRouter 提供的模型），或模型 ID 的開頭，清單會即時過濾
* **篩選廠商**：從 <mark style="color:blue;">**全部廠商**</mark> 下拉選單選擇單一廠商，只顯示該廠商的模型
* **篩選開放權重／閉源**：點擊 <mark style="color:blue;">**開放權重**</mark> 或 <mark style="color:blue;">**閉源**</mark> 按鈕只顯示該類模型，再點一次即取消篩選
* **篩選產地**：點擊 <mark style="color:blue;">**中國**</mark>、<mark style="color:blue;">**美國**</mark> 或 <mark style="color:blue;">**其他國家**</mark> 按鈕只顯示該產地的模型，再點一次即取消篩選；模型名稱旁的藍色小標籤就是它的產地

這些條件會同時生效。例如選擇 Google 後，開放權重與閉源兩個按鈕的數字會變成 Google 旗下開放權重與閉源模型各有幾個；再點 <mark style="color:blue;">**開放權重**</mark>，清單只剩 Google 的開放權重模型。沒有符合條件的模型時，會顯示「找不到符合條件的模型」。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-49e86eb1342aadb44f0dc770aee625af698eef7f%2Fmodel-access-02-search-filter.png?alt=media" alt="廠商下拉選 Google、開放權重按鈕顯示 2 並已選取、閉源按鈕顯示 9，清單列出 Gemma 4 31B 與 Gemma 4 26B A4B 兩個帶開放權重標籤的模型"><figcaption><p>廠商選 Google 並點選「開放權重」，清單只剩 Google 的開放權重模型</p></figcaption></figure>

{% hint style="info" %}
若有模型尚未標示是否為開放權重，這些模型不帶標籤、也不計入任一按鈕的數字，只會在兩個按鈕都未選取時出現在清單中，因此兩個按鈕的數字相加可能小於清單總數。
{% endhint %}

### 分辨同名模型 <a href="#same-name-models" id="same-name-models"></a>

同一個模型可能同時經由不同服務提供（例如 Claude 4.6 Opus 有 AWS Bedrock 與 Google Vertex AI 兩筆），清單裡就會出現兩列名稱一模一樣的模型。這時兩列的標籤區都會多一個灰框標籤，顯示該筆模型 ID 的前 8 碼；名稱沒有重複的模型不顯示這個標籤。標籤以整份模型目錄判斷，搜尋或篩選後只剩一列時仍會顯示。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-2c57acf6c143ea080c3d65360633d1cdc202a8c9%2Fmodel-access-same-name-id-tag.png?alt=media" alt="搜尋 Claude 4.6 Opus 後清單有兩列同名模型，Anthropic 標籤下方分別顯示 d93c60cf 與 23635e4b 兩個 ID 標籤，第二行的 Gateway ID 被截斷"><figcaption><p>兩列同名的 Claude 4.6 Opus，各自顯示模型 ID 前 8 碼</p></figcaption></figure>

例如資訊部只想保留某一筆 Claude 4.6 Opus，但兩列名稱相同、第二行的 Gateway ID 又被截斷，看不出差別。組織擁有者可以這樣找到要調整的那一筆：

1. 在搜尋框輸入模型名稱（例如「Claude 4.6 Opus」），列出所有同名模型，記下要調整那一列的 ID 標籤。
2. 在搜尋框改輸入該 ID 標籤（例如「d93c60cf」），清單只剩這一筆。
3. 確認是要調整的模型後，再切換這一列的開關，見[啟用與停用模型](#toggle-models)。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-d1e8f894700f8731b00880b60f248cf839d07f0c%2Fmodel-access-search-by-id.png?alt=media" alt="搜尋框輸入 d93c60cf 後，清單只剩一列帶 d93c60cf 標籤的 Claude 4.6 Opus"><figcaption><p>輸入 ID 標籤搜尋，只留下那一筆模型</p></figcaption></figure>

{% hint style="info" %}
搜尋只比對模型 ID 的**開頭**，不分大小寫：輸入 ID 標籤的前幾碼（例如「d93c」）也能找到，但輸入 ID 中間的字不會命中。搜尋框的提示文字沒有列出 ID，直接輸入即可。
{% endhint %}

### 開放權重標籤與授權限制 <a href="#open-weight-and-license" id="open-weight-and-license"></a>

模型權重公開、可部署在自有環境的模型，名稱旁會顯示 <mark style="color:blue;">**開放權重**</mark> 標籤，滑鼠移到標籤上會顯示「開放權重，可地端部署」。閉源模型不另加標籤，可用 <mark style="color:blue;">**閉源**</mark> 按鈕篩出。

部分開放權重模型的授權附帶使用限制（例如營收達一定規模的公司商用需另取得授權）。這類模型會在 Gateway ID 那一行下方以橘色小字列出授權限制說明，標籤的提示中也會附上同一段說明。啟用前請先確認組織的使用方式符合授權條件。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-32275f8bfb999dc949ca4b78617be1af47daf3a2%2Fmodel-access-03-open-weight-license.png?alt=media" alt="搜尋 Kimi 後的模型列：Kimi K3 帶 Moonshot AI、中國與開放權重標籤，下方以橘色小字列出 Kimi K3 授權限制"><figcaption><p>開放權重模型列下方的授權限制說明</p></figcaption></figure>

{% hint style="warning" %}
「開放權重」代表模型權重公開、**可以**部署在地端，不代表在 MaiAgent 上調用時就是在地端執行。實際由哪個服務執行推論，請看模型列第二行的服務名稱（例如 OpenRouter、AWS Bedrock）。
{% endhint %}

### 比較價格、速度與規格 <a href="#compare-price-speed-specs" id="compare-price-speed-specs"></a>

每個模型列除了名稱與開關，還會顯示下列資訊，讓您不必另外查文件就能在同一頁比較模型：

| 欄位                                                                                   | 顯示內容                                                                                                                                  | 說明                                                                                                                                                                                          |
| ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">**價格（點／百萬 token）**</mark>                                  | <mark style="color:blue;">**輸入 N**</mark>、<mark style="color:blue;">**輸出 N**</mark>，以及 <mark style="color:blue;">**一次問答約 N 點**</mark> | 與實際扣點使用同一份費率，單位為每 100 萬 tokens 的 Credits；「一次問答」以 4,000 輸入 + 400 輸出 token 估算。滑鼠移到價格上可看到「快取後輸入」價格（重複的資料命中快取時適用）。組織有平台處理費時，價格旁會標 <mark style="color:blue;">**另加 X%**</mark>；沒有定價規則的模型，價格欄顯示「—」 |
| <mark style="color:blue;">**首字時間（TTFT）**</mark>                                      | N 秒                                                                                                                                   | 從送出到出現第一個字的時間；推理模型含思考時間。提示另附「長問題（約 16,000 token）」的首字時間                                                                                                                                      |
| <mark style="color:blue;">**輸出速度**</mark>                                            | N token／秒                                                                                                                             | 開始回答後每秒產出的 token 數；中文約 1 token ≈ 1–1.5 字                                                                                                                                                    |
| <mark style="color:blue;">**輸入處理速度**</mark>                                          | N token／秒                                                                                                                             | 資料越多（例如知識庫檢索後的長問題），首字時間越取決於這個數字                                                                                                                                                             |
| <mark style="color:blue;">**上下文長度**</mark>、<mark style="color:blue;">**最大輸出**</mark> | 例如 200K、64K                                                                                                                           | 模型一次能讀入與一次能產出的 token 上限                                                                                                                                                                     |
| 能力圖示（模型名稱旁）                                                                          | <mark style="color:blue;">**工具呼叫**</mark>、<mark style="color:blue;">**看圖**</mark>、<mark style="color:blue;">**思考**</mark>             | 分別代表支援函式呼叫、可讀取圖片內容、支援思考（推理）模式                                                                                                                                                               |

速度三欄是平台每天對每個啟用中的模型做標準測速、取近 7 天中位數得到的，不使用客戶的實際流量，測速費用也不扣組織的 Credits；某一欄還沒有足夠的近 7 天測速資料時顯示 <mark style="color:blue;">**測量中**</mark>；若近 7 天內有其他測速紀錄，滑鼠移到「測量中」上會看到最近測量時間。

<mark style="color:blue;">**排序**</mark> 下拉可選 <mark style="color:blue;">**預設順序**</mark>、<mark style="color:blue;">**一次問答點數**</mark>、<mark style="color:blue;">**輸入價**</mark>、<mark style="color:blue;">**輸出價**</mark>、<mark style="color:blue;">**首字時間（TTFT）**</mark>、<mark style="color:blue;">**輸出速度**</mark>、<mark style="color:blue;">**輸入處理速度**</mark>、<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-2ad96d79ba0d9117a15bbe94a1af1cab146dc629%2Fmodel-access-compare-columns.png?alt=media" alt="模型清單的價格、首字時間、輸出速度、輸入處理速度等欄位，右上方排序下拉展開列出預設順序、一次問答點數、輸入價、輸出價、首字時間（TTFT）、輸出速度、輸入處理速度"><figcaption><p>同一頁比較價格、速度與規格</p></figcaption></figure>

例如資訊部要替內部知識問答 Agent 選模型，希望回覆快、成本低。管理員勾選 <mark style="color:blue;">**能力**</mark> 的 <mark style="color:blue;">**工具呼叫**</mark>，<mark style="color:blue;">**排序**</mark> 選 <mark style="color:blue;">**一次問答點數**</mark>（由小到大），再比對前幾名的 <mark style="color:blue;">**首字時間（TTFT）**</mark>，挑出點數低、首字時間在 1 秒內的模型啟用，再到 Agent 設定改選它。

{% hint style="info" %}
採字數計費的組織不顯示價格欄，其他欄位照常顯示。平台處理費不含在單價內，實際扣點請以 [Credits 計費制度](/others/credits.md) 與後台「計費方式」為準。
{% endhint %}

### 模型退役與自動搬移 <a href="#model-retirement" id="model-retirement"></a>

原廠停止提供、或平台決定下架的模型，會先在模型列上顯示 <mark style="color:blue;">**YYYY/MM/DD 退役，將由 ○○ 接替**</mark>（沒有接替模型時只顯示退役日期）。退役日當天：

1. 平台會把綁定該模型的 Agent 自動改為接替模型，不需要人工逐一調整；接替模型須在組織內可以使用，組織未啟用接替模型時，該組織的 Agent 不會被搬移
2. 綁定的 Agent 都搬完後，該模型停用，不再出現在任何模型選單中

沒有接替模型時不會自動搬移，請在退役日前到各 Agent 自行改選。

接替模型通常是同廠商、同等級的較新版本，費率可能與原模型不同；請在退役日前到各 Agent 確認接替模型是否符合需求，或自行改選其他模型。若接替模型尚未在組織內啟用，請先在本頁開啟它。

例如某客服團隊的三個 Agent 都用 GPT-6 Sol，管理員在本頁看到該模型列顯示「2026/10/07 退役，將由 GPT-6.1 Sol 接替」。確認 GPT-6.1 Sol 已啟用、費率可以接受後就不需要再動作，退役日當天三個 Agent 會自動改用 GPT-6.1 Sol；若想趁機改用更便宜的模型，則在退役日前自行到各 Agent 改選。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-ce4df5a86d747a06833cd92b3378418b9a04c654%2Fmodel-access-retirement-notice.png?alt=media" alt="搜尋 Claude 4.6 的結果中，一列模型下方以橘色字顯示 2026/10/20 退役，將由 Claude 4.6 Opus 接替"><figcaption><p>即將退役的模型列顯示退役日期與接替模型</p></figcaption></figure>

{% hint style="warning" %}
自動搬移只處理「綁定在 Agent 上的模型」。角色指令、知識庫或應用實例文件中直接寫出的模型名稱不會跟著改，請自行更新。
{% endhint %}

### 中國模型 <a href="#china-models" id="china-models"></a>

組織可以開啟「<mark style="color:blue;">隱藏中國模型</mark>」：開啟後，平台提供的中國模型（例如 DeepSeek、Qwen、Kimi 系列，含日後新上架的）不會出現在本頁與本組織的任何模型選單，Agent、API 與 AI Gateway 也無法使用；關閉後各模型回到原本的開關狀態。這個設定只管平台提供的模型，組織自己在 [AI Gateway](/build/ai-gateway.md) 加入的模型不受影響。

* **新建立的組織**：建立組織時「<mark style="color:blue;">隱藏中國模型</mark>」預設勾選。
* **既有組織**：預設不開啟，可用的模型維持不變；若原本已在本頁關閉所有中國模型，則自動開啟這個設定。
* **開啟前先確認 Agent 的模型**：開啟後，正在使用中國模型的 Agent 不會自動改成其他模型，也無法再呼叫該模型；請先到這些 Agent 改選其他模型再開啟。
* **誰能變更**：只有組織擁有者能變更。其他成員在編輯視窗中看得到這個選項，但無法勾選，滑鼠移上去會提示「僅組織擁有者可變更此設定」。

開啟時，本頁上方會顯示「本組織已隱藏中國模型，可至組織設定變更」。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-c8b593732ff1164026830ba9aeed574a602231a3%2Fmodel-access-hide-china-hint.png?alt=media" alt="模型調用權限頁上方顯示提示：本組織已隱藏中國模型，可至組織設定變更"><figcaption><p>開啟隱藏中國模型時，模型調用權限頁上方的提示</p></figcaption></figure>

#### 開啟或關閉隱藏中國模型 <a href="#toggle-china-models" id="toggle-china-models"></a>

1. 從左側選單點選 <mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">組織概覽</mark>，點組織名稱旁的編輯圖示，開啟 <mark style="color:blue;">編輯組織</mark> 視窗。
2. 勾選 <mark style="color:blue;">隱藏中國模型</mark> 即隱藏中國模型；取消勾選則恢復顯示。選項下方的說明：「開啟後，平台提供的中國模型（含日後新上架的）不會出現在本組織的模型選單，助理、API 與 AI Gateway 也無法使用。組織自建模型不受此設定影響。」

   <figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-5c6f86ac3fccc50ef21d789b77a66ec36b8bbf62%2Forg-hide-china-models.png?alt=media" alt="編輯組織視窗中的隱藏中國模型勾選框與下方說明文字"><figcaption><p>編輯組織視窗的「隱藏中國模型」選項</p></figcaption></figure>
3. 按 <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-21128af792d53e0dbff41912f9cd451beec9f1fd%2Fmodel-access-origin-china-filter.png?alt=media" alt="隱藏中國模型關閉時，選取中國 10 篩選按鈕，清單列出 DeepSeek 與 Qwen 等帶中國標籤的模型與開關"><figcaption><p>關閉隱藏中國模型後，用「中國」篩選找出中國模型</p></figcaption></figure>

例如一家金融業客戶的資安規範要求不得使用中國廠商的模型。組織擁有者確認「<mark style="color:blue;">隱藏中國模型</mark>」已勾選後，管理員在建立 Agent 時的模型選單就不會出現 DeepSeek、Qwen 等模型，也不必逐一到本頁關閉；之後平台新上架的中國模型同樣不會出現。若研發團隊後來想評估開放權重的 Qwen 模型，由擁有者取消勾選後，再到本頁開啟需要的模型即可。

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

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

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

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

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

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

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

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

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

若某模型正被 Agent 使用，模型列上會顯示「目前有 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>停用使用中的模型時，系統會列出受影響的 Agent 數量並要求確認</p></figcaption></figure>

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

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

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

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

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

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

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

* **金融業：只保留日後可自建的開放權重模型。** 銀行規劃未來把 AI 服務搬進自家機房，希望現在就只讓團隊使用權重公開、日後可在地端部署的模型，避免 Agent 綁定到無法自建的閉源模型。組織擁有者點擊 <mark style="color:blue;">**閉源**</mark> 按鈕篩出所有閉源模型並逐一關閉開關；遇到「目前有 N 個助理正在使用」的模型，先為這些 Agent 改選開放權重模型再關閉。接著點擊 <mark style="color:blue;">**開放權重**</mark> 按鈕，檢查保留下來的模型是否有授權限制說明、是否符合銀行的使用方式。之後成員建立 Agent 時，模型選單就不會再出現這些已關閉的閉源模型。
* **政府機關：限定特定廠商。** 公部門標案規定僅能使用特定廠商的模型。組織擁有者在搜尋框輸入廠商名稱，將該廠商的模型全數啟用，其餘模型停用，讓平台上的模型選擇範圍與標案規範一致。
* **一般企業：控管高價模型的使用成本。** 採用 Credits 計費的企業發現多數日常客服情境用中階模型即可，少數成員卻習慣選最貴的旗艦模型。組織擁有者停用高單價模型、只保留性價比高的模型，從源頭控制每次對話的 Credits 消耗，不需逐一盯各 Agent 的設定。
* **集團／多部門組織：統一模型治理。** IT 部門完成內部評測後，只啟用通過驗證的模型版本，避免各部門自行選用未經測試的新模型，讓全組織的 Agent 品質與行為可預期。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-02a7a0a422e5cb9f4159f90d10a090d80e482bc6%2Fmodel-access-05-proprietary-filter.png?alt=media" alt="已選取閉源按鈕（閉源 46），清單列出 Anthropic 等閉源模型與開關，其中 Claude 5 Sonnet 顯示目前有 4 個助理正在使用"><figcaption><p>金融業情境：點擊「閉源」篩出所有閉源模型，逐一決定是否關閉</p></figcaption></figure>

## 頁面檢視權限設定 <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>

此頁的開關不會自行改變；除了在此頁面停用模型，以下兩種情況也會影響選單與調用：新建立的組織預設開啟[隱藏中國模型](#china-models)，即將退役的模型也會在退役日自動搬移，見[模型退役與自動搬移](#model-retirement)。

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

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

#### Q：模型列上寫著「○月○日退役」，我需要做什麼？ <a href="#faq-retirement" id="faq-retirement"></a>

不一定要做事：退役日當天平台會把綁定該模型的 Agent 自動改為提示中的接替模型。若您希望換成別的模型、接替模型尚未在組織內啟用，或提示中沒有接替模型，請在退役日前處理，見[模型退役與自動搬移](#model-retirement)。

#### Q：為什麼清單裡找不到 Qwen、DeepSeek 等模型？ <a href="#faq-china-models" id="faq-china-models"></a>

組織開啟 <mark style="color:blue;">隱藏中國模型</mark> 時，這些模型不會列出也無法調用，頁面上方會顯示「本組織已隱藏中國模型，可至組織設定變更」。需要使用時，請組織擁有者到 <mark style="color:blue;">組織概覽</mark> 的 <mark style="color:blue;">編輯組織</mark> 視窗取消勾選，見[開啟或關閉隱藏中國模型](#toggle-china-models)。

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

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

#### Q：可以只限制某些角色或成員使用特定模型嗎？ <a href="#faq-restrict-by-role" id="faq-restrict-by-role"></a>

這個頁面是組織層級的開關：模型關閉後，組織內所有成員與 Agent 都不能用；開啟後，所有能建立或編輯 Agent 的成員都能在模型選單選到它。Agent 建置端沒有「依角色限制模型」的設定。要依角色限制，目前只有 MaiGPT 做得到：在角色權限的 <mark style="color:blue;">分配 MaiGPT 使用權限</mark> 設定該角色在 MaiGPT 可用的模型，見 [MaiGPT 角色使用權限](/org/roles/maigpt-role-permissions.md#set-available-scope)。


---

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