> 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/others/credits/credit-quota-scenarios.md).

# 三種額度怎麼算：情境範例與常見問題

成員額度、角色額度、對話平台額度三種額度怎麼算、怎麼分辨，以「業務部」實際數字一步步帶您看懂，並整理最常被問到的問題。

「額度分配」頁籤有三種額度：<mark style="color:blue;">**成員額度**</mark>、<mark style="color:blue;">**角色額度**</mark>、<mark style="color:blue;">**對話平台額度**</mark>。這一頁用一個實際例子，說明三種額度各自怎麼計算、畫面上的數字代表什麼，以及最容易搞混的「角色額度」與「從角色批次分發」差在哪裡。

{% hint style="info" %}
**先講結論**

* **三種額度各自記帳、同時生效**：同一筆消費會記進每一本適用的帳，任何一本用完，下一次 AI 請求就會被擋下。
* **錢只扣一次**：不論記進幾本帳，實際 Credits 只從組織錢包扣一次。額度是「消費上限」，不是另外撥出去的錢包。
* **角色額度是全角色「共用」一池**；**從角色批次分發是幫角色裡「每個人各發一份」個人額度**，兩者是不同功能。
  {% endhint %}

## 三種額度一覽 <a href="#quota-types-overview" id="quota-types-overview"></a>

進入 <mark style="color:blue;">**組織設定**</mark> → <mark style="color:blue;">**Credits**</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-b5776797d962c17a76fd1d2ff896a5e3f4367973%2Fquota-01-credits-quota-entry.png?alt=media" alt="額度分配頁籤的三個子頁籤"><figcaption><p>額度分配頁籤：成員額度、角色額度、對話平台額度三個子頁籤</p></figcaption></figure>

|               | 成員額度                                                | 角色額度              | 對話平台額度                  |
| ------------- | --------------------------------------------------- | ----------------- | ----------------------- |
| **一列代表**      | 一位成員                                                | 一個 MaiAgent 角色    | 一個對話平台（Web Chat、LINE 等） |
| **額度怎麼用**     | 每人**各自**一份                                          | 角色內所有成員**共用**一份   | 該對話平台所有訪客對話**共用**一份     |
| **「使用量」欄的數字** | 這位成員自己用了多少                                          | 角色內**所有成員加總**用了多少 | 這個對話平台加總用了多少            |
| **用完時誰被擋**    | 只有這位成員                                              | 角色內**所有**成員       | 這個對話平台的 AI 回覆           |
| **建立方式**      | 逐一分發，或 <mark style="color:blue;">**從角色批次分發**</mark> | 在角色額度子頁籤逐一分發      | 在對話平台額度子頁籤逐一分發          |

## 最容易搞混：「角色額度」與「從角色批次分發」 <a href="#role-quota-vs-batch-by-role" id="role-quota-vs-batch-by-role"></a>

兩者名稱裡都有「角色」，但做的事完全不同：

|                 | 從角色批次分發                                                                                           | 角色額度                                                                                           |
| --------------- | ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| **位置**          | <mark style="color:blue;">**成員額度**</mark> 子頁籤右上角的 <mark style="color:blue;">**從角色批次分發**</mark> 按鈕 | <mark style="color:blue;">**角色額度**</mark> 子頁籤右上角的 <mark style="color:blue;">**分發額度**</mark> 按鈕 |
| **建立的是什麼**      | **個人額度**：系統拿角色當名單，幫角色內**每位成員各建立一筆**相同金額的成員額度                                                      | **角色額度**：整個角色**只有一筆**額度，全員共用                                                                   |
| **填 2,000 的意思** | 每人各有 2,000                                                                                        | 全角色加起來 2,000                                                                                   |
| **結果出現在哪**      | <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-29dca249cd77bc6035b363a2a016cd31241a0cc1%2Fcredit-quota-guide-batch-by-role.png?alt=media" alt="從角色批次分發額度視窗，提示將為業務部中的 5 位成員分發額度"><figcaption><p>成員額度 → 從角色批次分發：視窗提示「將為『業務部』中的 5 位成員分發額度」，代表會建立 5 筆個人額度</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-2d11408acca99e0df523d567bfe863ea20c1caec%2Fcredit-quota-guide-role-assign.png?alt=media" alt="分發角色額度視窗"><figcaption><p>角色額度 → 分發額度：只為「業務部」建立一筆全員共用的額度</p></figcaption></figure>

## 情境範例：業務部 5 個人，兩種額度一起用 <a href="#sales-team-scenario" id="sales-team-scenario"></a>

某科技製造公司的業務部有 5 位成員，平常用 MaiGPT 擬報價信、整理客戶規格需求。管理員想做到兩件事：

1. **每個人最多用 2,000 Credits**，避免單一同仁用太兇
2. **整個業務部合計最多 5,000 Credits**，守住部門預算

所以管理員做了兩個設定：

{% stepper %}
{% step %}

### 幫每個人發個人額度 <a href="#scenario-step-member-quota" id="scenario-step-member-quota"></a>

在 <mark style="color:blue;">**成員額度**</mark> 子頁籤點 <mark style="color:blue;">**從角色批次分發**</mark>，選擇「業務部」，額度上限填 2,000，按 <mark style="color:blue;">**儲存**</mark>。畫面顯示「批次分發完成：成功 5 位，跳過 0 位，失敗 0 位」，代表 5 位成員各拿到一份 2,000 的個人額度。
{% endstep %}

{% step %}

### 幫業務部設部門預算 <a href="#scenario-step-role-quota" id="scenario-step-role-quota"></a>

切換到 <mark style="color:blue;">**角色額度**</mark> 子頁籤，點 <mark style="color:blue;">**分發額度**</mark>，選擇角色「業務部」，額度上限填 5,000，按 <mark style="color:blue;">**儲存**</mark>。
{% endstep %}
{% endstepper %}

接著，業務部其中一位成員用 MaiGPT 擬了一封報價說明信，這次消耗 570.65 Credits。

### 在角色額度子頁籤看到的數字 <a href="#scenario-role-tab" id="scenario-role-tab"></a>

<mark style="color:blue;">**角色額度**</mark> 子頁籤中，「業務部」這一列的使用量是 **570.65 / 5,000.00**：分子是業務部**全體成員加總**的用量，分母是全部門共用的上限。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-3775617867db1bf891817c6f6e861105cd3cbf98%2Fcredit-quota-guide-role-tab-usage.png?alt=media" alt="角色額度子頁籤：業務部使用量 570.65 / 5,000.00"><figcaption><p>角色額度：業務部一列，使用量是全體成員加總（570.65 / 5,000.00）</p></figcaption></figure>

### 在成員額度子頁籤看到的數字 <a href="#scenario-member-tab" id="scenario-member-tab"></a>

<mark style="color:blue;">**成員額度**</mark> 子頁籤中，業務部每位成員都各有一列、各自的分母 2,000：實際使用的那位成員是 **570.65 / 2,000.00**，其他人仍是 **0.00 / 2,000.00**。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-e7dd921752ef35978bda6a493a6a74f1365e0a29%2Fcredit-quota-guide-member-tab-usage.png?alt=media" alt="成員額度子頁籤：每位成員各自的 2,000 額度"><figcaption><p>成員額度：每人各一列、各自計算；同一筆 570.65 只出現在實際使用的成員那一列</p></figcaption></figure>

### 這筆 570.65 被記了幾次、扣了幾次 <a href="#scenario-how-recorded" id="scenario-how-recorded"></a>

| 帳本        | 記帳結果              | 剩餘       |
| --------- | ----------------- | -------- |
| 這位成員的個人額度 | 570.65 / 2,000    | 1,429.35 |
| 業務部的角色額度  | 570.65 / 5,000    | 4,429.35 |
| 組織錢包      | **實際扣 570.65 一次** | —        |

同一筆消費**記在兩本帳上**，但錢**只扣一次**。這也是為什麼各帳本的用量加總，可能大於組織實際消耗。

### 接下來可能發生的兩種情況 <a href="#scenario-what-next" id="scenario-what-next"></a>

* **某位同仁自己用滿 2,000**：只有他會被擋下（他的個人額度用完了），其他同仁不受影響，業務部預算也還有剩。
* **業務部合計用滿 5,000**：即使有同仁個人額度還剩很多（例如才用 300 / 2,000），**整個業務部所有成員都會被擋下**，因為部門共用的那本帳已經用完（嵌入網頁的 Web Chat、LINE 等對外對話平台不受影響）。

換句話說：**每次使用都要「個人帳」和「部門帳」都還有剩，才會放行。**

### 成員自己也看得到兩種額度 <a href="#scenario-member-view" id="scenario-member-view"></a>

成員點右上角帳號頭像 → <mark style="color:blue;">**個人設定**</mark> → <mark style="color:blue;">**Credit 額度**</mark>，上方的 <mark style="color:blue;">**我的 Credit 額度**</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-769b8cfc5d458cf2979e19ad7d4554ed13785072%2Fcredit-quota-guide-profile-both.png?alt=media" alt="個人設定的 Credit 額度頁：我的 Credit 額度與我的角色額度"><figcaption><p>成員視角：上方是個人額度（570.65 / 2,000.00），下方是業務部的角色額度（570.65 / 5,000.00）</p></figcaption></figure>

## 三種額度在哪些地方生效 <a href="#where-quotas-apply" id="where-quotas-apply"></a>

每次 AI 請求，系統會依使用的入口，檢查下表中適用的每一層（也會先檢查組織錢包餘額）。**任何一層已經沒有剩餘，這次請求就會被擋下。**

| 使用入口                 | 成員額度             | 角色額度        | 對話平台額度         |
| -------------------- | ---------------- | ----------- | -------------- |
| MaiGPT               | ✅                | ✅           | —              |
| 在管理後台與 AI 助理對話       | ✅                | ✅           | ✅（若該對話平台有設定額度） |
| 透過 API Key 呼叫        | ✅（API Key 所屬的成員） | ✅（該成員所屬的角色） | ✅（若該對話平台有設定額度） |
| 知識庫上傳、文件處理           | ✅                | ✅           | —              |
| 嵌入網頁的 Web Chat（公開訪客） | —                | —           | ✅              |
| LINE 等外部通訊軟體對話平台     | —                | —           | ✅              |

{% hint style="info" %}
嵌入網頁的 Web Chat 與 LINE 等對話平台的訪客不是組織成員，所以不會計入成員額度或角色額度；要控管這些對話平台的成本，請用[對話平台額度](/others/credits/inbox-credit-quota.md)。
{% endhint %}

## 額度到期或停用之後 <a href="#after-expiry" id="after-expiry"></a>

分發額度時，系統會自動開啟該成員或角色的 <mark style="color:blue;">**需要額度**</mark> 開關。額度到期或被停用後，**開關仍維持開啟**，所以：

| 情況               | 結果                                        |
| ---------------- | ----------------------------------------- |
| 個人額度到期，「需要額度」仍開啟 | 這位成員無法使用 AI 服務，直到重新分發額度或關閉開關              |
| 角色額度到期，「需要額度」仍開啟 | **整個角色的所有成員**都無法使用 AI 服務，直到為角色重新分發額度或關閉開關 |
| 關閉「需要額度」         | 不再檢查這一層，消費改直接走組織錢包（仍受其他層限制）               |

{% hint style="warning" %}
活動或專案結束、不再需要某個角色的部門預算時，請記得到 <mark style="color:blue;">**角色額度**</mark> 子頁籤把該角色的 <mark style="color:blue;">**需要額度**</mark> 關閉（確認視窗標題為「解除額度限制」），否則角色額度到期後，這個角色的成員會全部被暫停使用。
{% endhint %}

## 不同產業怎麼搭配 <a href="#industry-examples" id="industry-examples"></a>

| 產業        | 需求                            | 建議搭配                                   |
| --------- | ----------------------------- | -------------------------------------- |
| 科技／電子製造業  | 業務部擬報價、工程部查規格，各部門預算分開；每人也要有上限 | 各部門設**角色額度**當部門預算，再用**從角色批次分發**給每人個人上限 |
| 金融／銀行業    | 理專每人每月固定用量，每月自動回滿             | 用**從角色批次分發**給理專角色每人個人額度，重置週期選「每月」      |
| 教育機構      | 各系所分配年度預算，系所內老師共用             | 各系所設**角色額度**即可，不必再發個人額度                |
| 醫療／健康產業   | 官網衛教 Web Chat 與院內同仁使用分開控管     | 官網 Web Chat 設**對話平台額度**；院內同仁用**成員額度**  |
| 服務／零售／飯店業 | 週年慶活動期間開放門市人員使用，活動結束自動停       | 用**從角色批次分發**給門市角色，設定到期時間為活動結束日         |

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

#### Q：角色額度設定 100,000，是角色裡每個人都有 100,000 嗎？ <a href="#faq-role-quota-per-member" id="faq-role-quota-per-member"></a>

不是。角色額度是**整個角色共用**的 100,000，角色內所有成員的用量加起來達到 100,000 時，角色內每個人都會被擋下。若要每人各有 100,000，請改在 <mark style="color:blue;">**成員額度**</mark> 子頁籤使用 <mark style="color:blue;">**從角色批次分發**</mark>，見[上方比較](#role-quota-vs-batch-by-role)。

#### Q：角色額度列上的「35,000.00 / 100,000.00」是什麼意思？ <a href="#faq-role-usage-meaning" id="faq-role-usage-meaning"></a>

分子 35,000.00 是這個角色**所有成員在額度生效之後的合計用量**，分母 100,000.00 是這個角色共用的上限；下方的「餘」是還能用的量。這不是某一位成員的用量；個人用量請看 <mark style="color:blue;">**成員額度**</mark> 子頁籤。參考[情境範例的角色額度畫面](#scenario-role-tab)。

#### Q：我用「從角色批次分發」後，成員為什麼出現在「已分配額度」、每人各有分子／分母？ <a href="#faq-batch-shows-assigned" id="faq-batch-shows-assigned"></a>

這是正常的。從角色批次分發會幫每位成員各建立一份**個人額度**，所以這些成員會從「未分配」移到 <mark style="color:blue;">**已分配額度**</mark>，使用量欄顯示的是**他自己的用量／他自己的上限**，每人各自累計。這跟角色額度是兩件事，見[情境範例的成員額度畫面](#scenario-member-tab)。

#### Q：怎麼分辨一筆額度是「角色額度」還是「個人額度」？ <a href="#faq-tell-role-from-member" id="faq-tell-role-from-member"></a>

看它在哪個子頁籤：

* 在 <mark style="color:blue;">**角色額度**</mark> 子頁籤、一列一個角色 → 角色額度（全員共用）
* 在 <mark style="color:blue;">**成員額度**</mark> 子頁籤、一列一個人 → 個人額度（每人各自）

個人額度不論是逐一分發還是從角色批次分發建立，效果完全一樣，列表上也不會標示建立方式。成員本人可以到 <mark style="color:blue;">**個人設定**</mark> → <mark style="color:blue;">**Credit 額度**</mark> 同時看到兩種，見[成員視角](#scenario-member-view)。

#### Q：成員額度、角色額度、對話平台額度是分開計算的嗎？ <a href="#faq-calculated-separately" id="faq-calculated-separately"></a>

是，各自記帳、各自有上限，但**同時生效**：

* 同一筆消費會記進每一本適用的帳（例如 MaiGPT 的使用會同時記進個人額度與角色額度）
* 任何一本帳用完，下一次請求就會被擋下
* 實際 Credits 只從組織錢包扣一次

哪些入口會檢查哪幾層，見[三種額度在哪些地方生效](#where-quotas-apply)。

#### Q：有成員的用量明明超過額度上限，為什麼還能繼續用？ <a href="#faq-over-limit-still-works" id="faq-over-limit-still-works"></a>

最常見的原因是**比對到了不同的數字**：

* **對話詳情右側的「Credit 消耗彙總」是整段對話從建立至今的累計**，包含額度設定之前的用量；額度只計算生效之後的用量，兩個數字本來就不會一樣。
* 個人額度要到 <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-2999bef3d412bbfc5f5a9c1009e841a5534dec6a%2Fcredit-quota-guide-conversation-total.png?alt=media" alt="對話詳情右側的 Credit 消耗彙總"><figcaption><p>對話詳情右側的「Credit 消耗彙總」：這段對話所有輪次的累計，不是額度的已用量</p></figcaption></figure>

另外，只要使用當下額度還有剩，這次就會放行，完成後才記帳，所以最後一次使用可能讓已用量略超過上限，**下一次**才會被擋下（詳見[成員 Credits 額度管理](/others/credits/member-credit-quota.md#fail-open)）。

#### Q：一位成員同時屬於兩個有角色額度的角色，會怎麼算？ <a href="#faq-multiple-roles" id="faq-multiple-roles"></a>

他的每一筆消費會**同時記進兩個角色**，任何一個角色的額度用完，他就會被擋下。因此各角色的用量加總可能大於組織實際消耗，實際扣款仍只有一次。

#### Q：想限制每人用量，又想控管部門總預算，該怎麼設？ <a href="#faq-both-limits" id="faq-both-limits"></a>

兩種一起用，就是[業務部情境](#sales-team-scenario)的做法：

1. 在 <mark style="color:blue;">**成員額度**</mark> 子頁籤用 <mark style="color:blue;">**從角色批次分發**</mark> 給每人個人上限
2. 在 <mark style="color:blue;">**角色額度**</mark> 子頁籤為同一個角色設定部門總上限

只想要其中一種時，只設那一種即可。

## 相關頁面 <a href="#related-pages" id="related-pages"></a>

* [成員 Credits 額度管理](/others/credits/member-credit-quota.md)：分發、編輯、停用個人額度，新成員預設額度、提醒設定
* [對話平台 Credits 額度管理](/others/credits/inbox-credit-quota.md)：為 Web Chat、LINE 等對話平台設定額度
* [Credits 計費制度](/others/credits.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/others/credits/credit-quota-scenarios.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.