> 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/member-credit-quota.md).

# 成員 Credits 額度管理

為每位成員設定個人 Credits 消費上限（額度）；成員可在 MaiGPT「用量與額度」查看自己的剩餘額度。

組織管理員可為每位成員設定**個人 Credits 消費上限（Quota）與有效期限**，讓活動期間或特定專案的使用成本一目了然、可控可管。

{% hint style="info" %}
**僅適用於 Credits 計費制度的組織。** 若您的組織尚未切換至 Credits 制度，此功能不會顯示。詳見 [Credits 計費制度](/others/credits.md)。除成員額度外，也可依對話平台控管成本，見 [對話平台 Credits 額度管理](/others/credits/inbox-credit-quota.md)。
{% endhint %}

## 核心概念 <a href="#core-concept" id="core-concept"></a>

**額度（Quota）是消費天花板，不是預支子錢包。**

組織的 Credits 錢包仍是唯一資金池，Quota 只限制某位成員最多能從組織錢包消費多少 Credits。分發 Quota 不影響組織餘額，Quota 過期也不影響餘額，沒有「退回」概念。

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

* 企業舉辦活動，開通外部用戶使用平台，需控制每人消費上限
* 各部門按預算分別設定不同的個人額度
* 限制特定帳號在有效期間的用量，到期後自動管控

***

## 管理員操作 <a href="#admin-operations" id="admin-operations"></a>

### 進入額度分配頁面 <a href="#enter-quota-tab" id="enter-quota-tab"></a>

1. 從左側選單點擊 <mark style="color:blue;">**組織設定**</mark>
2. 點擊 <mark style="color:blue;">**Credits**</mark>
3. 切換至 <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-17de094b0b88064e1930eb9edda4a29ebe441112%2Fquota-tab-overview.png?alt=media" alt="額度分配頁面總覽"><figcaption><p>額度分配頁籤：統計卡片與成員列表</p></figcaption></figure>

### 分發額度 <a href="#assign-quota" id="assign-quota"></a>

1. 點擊右上角 <mark style="color:blue;">**分發額度**</mark> 按鈕
2. 在搜尋框輸入成員的姓名或 Email 找到目標成員
3. 填入 **Credits 上限**（消費天花板）
4. 選擇**有效期限**（可設定到期日或選擇永久）與**重置週期**
5. 點擊 <mark style="color:blue;">**確認**</mark> 完成分發

{% hint style="info" %}
每位成員同一時間只能有一筆有效額度。已有有效額度的成員，請直接使用「編輯」調整，或先停用後再重新分發。
{% endhint %}

### 新成員預設額度 <a href="#new-member-default-quota" id="new-member-default-quota"></a>

成員加入後到管理員手動分發額度之間，若沒有任何限制，新成員可以直接消耗組織錢包。設定一次 <mark style="color:blue;">**新成員預設額度**</mark>，之後**不論從哪個入口加入**（Email 邀請、邀請連結、直接新增、批次匯入、LDAP／SCIM 等目錄同步、SSO 首次登入），新成員在加入當下就會自動拿到一份個人額度。

{% stepper %}
{% step %}
在 <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-77b06df36662b06966bbc1361304f54f9b5f4015%2Fcredits-default-member-quota-overview.png?alt=media" alt="成員額度子頁籤頂端的新成員預設額度橫幅與工具列按鈕"><figcaption><p>成員額度子頁籤：頂端橫幅顯示目前設定，「新成員預設額度」按鈕在「提醒設定」左側</p></figcaption></figure>
{% endstep %}

{% step %}
開啟 <mark style="color:blue;">**啟用新成員預設額度**</mark>，填入 **額度上限**，選擇 **有效期間**（<mark style="color:blue;">**永久有效**</mark> 或 <mark style="color:blue;">**加入後 N 天到期**</mark>，N 為 1–3650 的整數）與 **重置週期**（不重置／每日／每週／每月）；備註預設為「組織預設（新成員自動分發）」

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-1a25e2f6093877ee64a55ff594daf67985713847%2Fcredits-default-new-member-quota-modal-on.png?alt=media" alt="新成員預設額度視窗：啟用開關、額度上限、有效期間、重置週期"><figcaption><p>開啟「啟用新成員預設額度」後展開額度上限、有效期間、重置週期與備註</p></figcaption></figure>
{% endstep %}

{% step %}
視需要開啟 <mark style="color:blue;">**未分發額度前禁止消耗**</mark>（在視窗最下方，需往下捲動）：沒有拿到額度的新成員，在管理員手動分發前不能消耗 Credits。這個開關與預設額度開關各自獨立，可以只開其中一個

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-f000d4fede4b30190f6c35720383876b8d6f223a%2Fcredits-default-new-member-quota-modal-require.png?alt=media" alt="新成員預設額度視窗下方的未分發額度前禁止消耗開關"><figcaption><p>視窗最下方的「未分發額度前禁止消耗」開關</p></figcaption></figure>
{% endstep %}

{% step %}
點 <mark style="color:blue;">**確認**</mark>，畫面顯示「設定已更新」，頁籤頂端的橫幅會顯示目前的設定摘要，例如「新成員預設額度已啟用：500 Credits · 加入後 30 天到期 · 重置週期：每月」；有開「未分發額度前禁止消耗」時，橫幅末尾會加上「新成員未分發額度前不能消耗」。未啟用時橫幅顯示「新成員預設額度未啟用」
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
額度上限、有效期間等數值只有在 <mark style="color:blue;">**啟用新成員預設額度**</mark> 為開啟時按 <mark style="color:blue;">**確認**</mark> 才會儲存。開關關閉時按確認，只會儲存「未啟用」與「未分發額度前禁止消耗」的狀態，視窗中修改的數值不會保留；要先備好數值，請在啟用的同時一起儲存。
{% endhint %}

| 規則              | 說明                                                                     |
| --------------- | ---------------------------------------------------------------------- |
| 只影響新成員          | 設定只套用到儲存之後新建立的成員，不溯及既有成員；重新啟用的舊成員不算新成員                                 |
| 有效期間與重置以加入時間為錨點 | 「加入後 N 天到期」與重置週期都從每位成員實際加入的時間起算；到期日超過組織儲值到期時間時，自動截短到儲值到期時間             |
| 已有額度就不重複分發      | 成員加入時若已有有效額度（例如先手動分發），不會被覆蓋                                            |
| 邀請可另設額度         | 邀請時開啟「為這批邀請另設額度」會取代組織預設（不疊加），見[邀請時另設額度](#invitation-quota-override)    |
| 分發失敗不擋加入        | 自動分發失敗時成員仍能加入，成員列會標示 <mark style="color:blue;">**預設分發失敗**</mark>，請手動分發 |

例如一家 200 人的公司開放全員使用 MaiGPT，管理員設定新成員預設額度 500 Credits、每月重置，並開啟 <mark style="color:blue;">**未分發額度前禁止消耗**</mark>。之後不論同事是收到 Email 邀請、點邀請連結，或透過 SSO 第一次登入，加入當下就拿到 500 Credits；不會出現新人在管理員分發前就把組織錢包用掉的情況。

成員列表中，成員名稱下方會以標籤顯示額度來源：<mark style="color:blue;">**組織預設**</mark>、<mark style="color:blue;">**邀請覆寫**</mark>，以及該成員的加入來源。

{% hint style="info" %}
此功能需要 Credit 管理權限；採字數計費的組織不提供。沒有權限的成員看不到按鈕、橫幅與邀請視窗中的額度區塊。
{% endhint %}

#### 邀請時另設額度 <a href="#invitation-quota-override" id="invitation-quota-override"></a>

在 <mark style="color:blue;">**邀請新成員**</mark> 視窗（Email 邀請與邀請連結皆可），<mark style="color:blue;">**選擇角色**</mark> 與 <mark style="color:blue;">**邀請有效期**</mark> 之間有 <mark style="color:blue;">**Credits 額度**</mark> 區塊，預設顯示「加入時套用組織預設：…」（例如「加入時套用組織預設：500 Credits · 加入後 30 天到期 · 重置週期：每月」）或「組織尚未設定新成員預設額度」。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-4dc70854a8966f6a782808f90cc8a987e044f7ad%2Fcredits-default-invite-modal-email.png?alt=media" alt="邀請加入組織視窗中的 Credits 額度區塊"><figcaption><p>「Credits 額度」區塊位於「選擇角色」與「邀請有效期」之間，顯示這批受邀者加入時會套用的組織預設</p></figcaption></figure>

開啟 <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-7f0d46757032c8e381f2ca0a0f19ec3107b942e5%2Fcredits-default-invite-modal-override.png?alt=media" alt="開啟為這批邀請另設額度後展開的額度表單"><figcaption><p>開啟「為這批邀請另設額度」後，填入這批受邀者加入時要拿到的額度</p></figcaption></figure>

{% hint style="info" %}
**另設額度是取代，不是疊加。** 帶另設額度的受邀者只會拿到這一份，不會再加上組織預設；組織沒有設定預設額度時，另設額度一樣生效。若受邀者在另設額度的到期時間之後才加入，或另設額度分發失敗，會改套用組織預設（組織也沒有預設時就不分發）。已送出的邀請不能修改另設額度，要換額度請撤銷後重新邀請，或重新產生邀請連結。
{% endhint %}

成員管理頁（<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> 欄，顯示「1,000 Credits」（邀請另設）、「組織預設」或「—」（兩者皆無），記錄的是建立邀請當下的設定；邀請連結產生後的摘要卡也會多一行「加入時額度」。這一欄不代表成員實際拿到的額度（例如另設額度過期後改套用組織預設），實際額度請看 <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-50c1ae8c579b1fb4572746e719efa4daf3f2185b%2Fcredits-default-invitation-status-join-quota.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-54111c85cc6c47b43fd48a5ff15d2c821e8c5846%2Fcredits-default-invitation-link-join-quota.png?alt=media" alt="邀請連結頁籤的加入時額度欄"><figcaption><p>邀請連結頁籤：套用組織預設的連結顯示「組織預設」</p></figcaption></figure>

例如組織預設額度是每人 500 Credits，但這週要邀請 10 位數據分析師，他們會大量使用長文分析。管理員在 <mark style="color:blue;">**邀請新成員**</mark> 時開啟 <mark style="color:blue;">**為這批邀請另設額度**</mark>、填 3,000 Credits，這 10 人加入後各拿 3,000 Credits；同一時間用一般邀請連結加入的其他同事仍套用 500 Credits 的組織預設。

### 設定重置週期 <a href="#quota-reset-period" id="quota-reset-period"></a>

分發或編輯額度時，可在 <mark style="color:blue;">**重置週期**</mark> 選擇：

| 選項      | 使用方式                             |
| ------- | -------------------------------- |
| **不重置** | 額度為一次性上限，用完即止                    |
| **每日**  | 每天 00:00（台北時間）將已用量歸零、額度回滿        |
| **每週**  | 依畫面顯示的固定星期於 00:00 重置             |
| **每月**  | 依畫面顯示的固定日期於 00:00 重置；遇較短月份改在月底重置 |

設定後，列表的 <mark style="color:blue;">**下次重置**</mark> 會顯示時間與週期。重置只會將已用量歸零，額度上限與到期時間不變。

{% hint style="info" %}
修改額度的每週或每月重置週期時，週期會以變更當日重新計算。送出前請以畫面的「首次重置」時間確認。
{% endhint %}

### 編輯額度 <a href="#edit-quota" id="edit-quota"></a>

對已有有效額度的成員，點擊該行的 <mark style="color:blue;">**編輯**</mark>，可直接調整：

* **上調 Credits 上限**：立即生效
* **下調 Credits 上限**：不可低於該成員已消費量，系統會顯示錯誤提示

### 停用額度 <a href="#disable-quota" id="disable-quota"></a>

對啟用中的成員，點擊 <mark style="color:blue;">**停用**</mark> → 確認視窗 → 確認後該成員額度立即失效。

停用後效果依「需要額度」開關而定：

* **開關為開啟**：成員將無法使用 AI 功能，需重新分發額度或關閉開關
* **開關為關閉**：成員回到無限制狀態，消費直接走組織錢包

### 從角色批次停用額度 <a href="#batch-disable-quota-by-role" id="batch-disable-quota-by-role"></a>

當同一角色的多位成員不再需要個人額度時，管理員可以一次停用這些成員已建立且尚未停用的額度，包含預先建立、尚未生效的額度。送出前，請先決定停用後是否繼續限制成員使用 Credits：

* **僅停用額度，保留額度限制**（預設）：成員在重新取得額度前無法使用 AI 服務。
* **停用額度，並解除額度限制**：成員改用組織錢包，不再受個人額度管控。

{% hint style="warning" %}
解除額度限制後，成員使用 AI 功能會直接消耗組織錢包。若您仍要控管個人用量，請保留預設選項，並在適當時機重新分發額度。
{% endhint %}

#### 操作步驟 <a href="#batch-disable-quota-by-role-steps" id="batch-disable-quota-by-role-steps"></a>

{% stepper %}
{% step %}
在 <mark style="color:blue;">**額度分配**</mark> 頁籤選擇 <mark style="color:blue;">**成員額度**</mark>。
{% endstep %}

{% step %}
點擊 <mark style="color:blue;">**從角色批次停用**</mark>。
{% endstep %}

{% step %}
選擇要處理的角色。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-cb78c1f3105267bd99487a2db0ee7d7fbf2d08ae%2Fmember-quota-batch-role-mode.png?alt=media" alt="從角色批次停用額度的角色與停用方式選擇視窗"><figcaption><p>選擇角色，並決定停用後是否保留額度限制</p></figcaption></figure>
{% endstep %}

{% step %}
在「停用方式」選擇保留或解除額度限制，再點擊 <mark style="color:blue;">**停用**</mark>。
{% endstep %}

{% step %}
檢查確認視窗顯示的影響人數，確認無誤後送出。保留限制時，視窗會顯示將停用額度的人數；解除限制時，會分別顯示將停用額度與將解除限制的人數。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-95f46c10837a650eb91ffadcc71aa6bc5d91acc9%2Fmember-quota-batch-confirm.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-c35c8ed1673f2a330d424e1a7199c7fdf9dd92eb%2Fmember-quota-batch-confirm-remove-restriction.png?alt=media" alt="解除額度限制時的批次停用確認視窗"><figcaption><p>解除額度限制時，確認視窗會分別列出停用額度與解除限制的人數</p></figcaption></figure>
{% endstep %}
{% endstepper %}

#### 使用情境：活動結束後讓團隊恢復共用額度 <a href="#batch-disable-quota-scenario" id="batch-disable-quota-scenario"></a>

小麥公司的管理員曾為「展場支援」角色分發個人額度，以控制活動期間的用量。活動結束後，她進入成員額度頁，選擇從角色批次停用，並改選「停用額度，並解除額度限制」。確認影響人數後送出，符合處理條件的成員額度會停止，額度限制也會解除；之後使用 AI 功能時，會改為消耗組織錢包。

{% hint style="info" %}
批次處理對象是該角色中仍在職、未被刪除，且登入帳號為啟用狀態的成員。已離職、已刪除或登入帳號未啟用的成員不會在這次操作中解除限制；日後復職或重新啟用時，可能仍處於需要額度、但沒有可用額度的狀態。
{% endhint %}

{% hint style="info" %}
兩個人數可能不同：角色中沒有已建立且尚未停用的額度、但仍被額度限制的成員，不會計入「停用額度」人數；選擇解除限制時，他們仍會計入「解除額度限制」人數。「停用額度」人數會包含已預先建立、尚未生效的額度。
{% endhint %}

### 「需要額度」開關 <a href="#quota-required-toggle" id="quota-required-toggle"></a>

每位成員列表右側有一個**需要額度**切換開關：

| 開關狀態   | 說明                                    |
| ------ | ------------------------------------- |
| **開啟** | 成員必須有有效額度才能使用 AI；無額度（過期／停用／未分配）將被完全擋下 |
| **關閉** | 成員不受額度限制，消費直接走組織錢包                    |

{% hint style="warning" %}
**分發額度時**，系統會**自動開啟**「需要額度」。

**關閉開關時**，若成員有有效額度，系統會**同時停用**該額度，避免矛盾狀態。切換前均會顯示確認視窗說明影響範圍，請確認後再操作。
{% endhint %}

### 從角色批次分發／停用 <a href="#batch-by-role" id="batch-by-role"></a>

成員較多時，可以用 MaiAgent 角色為單位批次操作，不必逐一分發。「成員額度」子頁籤右上角提供兩個批次按鈕：

**批次分發**：

1. 點擊 <mark style="color:blue;">**從角色批次分發**</mark>，在視窗中選擇目標角色
2. 設定額度內容（額度上限、有效期限、重置週期與備註會套用到該角色的**全部成員**，每人各一筆獨立額度）
3. 確認送出。**已有啟用中額度的成員會自動跳過，不會重複分發**；完成後顯示「批次分發完成：成功 N 位，跳過 N 位，失敗 N 位」

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-f5a8565125e67f3f0280d85e96bf5ac23ca3f088%2Fquota-07-batch-role-modal.png?alt=media" alt="從角色批次分發視窗"><figcaption><p>從角色批次分發：選擇角色後，額度內容套用到該角色全部成員</p></figcaption></figure>

**批次停用**：點擊 <mark style="color:blue;">**從角色批次停用**</mark> → 選擇角色 → 選擇停用方式 → 確認。請先確認角色涵蓋的成員及停用方式，再送出。

| 停用方式                 | 停用後的成員狀態                         |
| -------------------- | -------------------------------- |
| **僅停用額度，保留額度限制**（預設） | 「需要額度」維持開啟；成員無法使用 AI 服務，直到重新分配額度 |
| **停用額度，並解除額度限制**     | 同時關閉「需要額度」；成員改用組織錢包，不再受個人額度管控    |

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-fe3210b0d909826eea6aebbc3902520a105e5815%2Fquota-08-batch-deactivate-options.png?alt=media" alt="批次停用額度的兩種方式"><figcaption><p>批次停用：預設保留額度限制，也可選擇一併解除限制</p></figcaption></figure>

{% hint style="warning" %}
批次分發會同時將這些成員的「需要額度」開關設為開啟。批次停用的預設選項是保留額度限制；若希望成員停用額度後改用組織錢包，請改選「停用額度，並解除額度限制」。
{% endhint %}

{% hint style="info" %}
**從角色批次分發不是角色額度。** 批次分發是幫角色內每位成員「各發一份」個人額度，每人各自計算；若要讓整個角色「共用」一份預算，請使用下方的[角色額度](#role-quota)。兩者的差別與數字範例，見[三種額度怎麼算：情境範例與常見問題](/others/credits/credit-quota-scenarios.md#role-quota-vs-batch-by-role)。
{% endhint %}

### 個人額度提醒設定 <a href="#member-quota-alert" id="member-quota-alert"></a>

成員的額度快用完或快到期時，系統可以主動提醒成員本人，讓他及早找管理員調整，而不是在對話中途被擋下。這組設定是整個組織共用一份，套用到所有有個人額度的成員。

1. 在 <mark style="color:blue;">**額度分配**</mark> → <mark style="color:blue;">**成員額度**</mark> 子頁籤，點右上角的 <mark style="color:blue;">**提醒設定**</mark>
2. 在 <mark style="color:blue;">**個人額度提醒設定**</mark> 視窗調整下列項目，按 <mark style="color:blue;">**確定**</mark> 儲存

| 項目                                            | 說明                                                                              |
| --------------------------------------------- | ------------------------------------------------------------------------------- |
| <mark style="color:blue;">**啟用個人額度提醒**</mark> | 總開關，關閉後兩種提醒都停止                                                                  |
| <mark style="color:blue;">**用量提醒門檻**</mark>   | 成員消耗達額度上限的這個百分比時發送提醒，可填 1–99 的整數，預設 80                                          |
| <mark style="color:blue;">**到期前提醒**</mark>    | 開啟後，額度將在 <mark style="color:blue;">**到期前天數**</mark> 內到期時發送提醒；天數為大於 0 的整數，預設 7 天 |

提醒會同時透過**站內通知**與 **Email** 送給成員本人：站內通知出現在成員 [通知中心](/start/notifications.md) 的「組織公告」分頁，標題為「<mark style="color:blue;">個人額度即將用罄</mark>」或「<mark style="color:blue;">個人額度即將到期</mark>」，內容會帶出已用量、上限與剩餘額度，並請成員聯絡組織管理員。

{% hint style="info" %}
這是給**成員個人額度**的提醒；組織錢包餘額不足的提醒在 Credits 概覽的「餘額提醒」卡片設定，兩者互不影響，見 [Credits 計費制度：餘額不足提醒](/others/credits.md#low-balance-alert)。
{% endhint %}

### 角色額度 <a href="#role-quota" id="role-quota"></a>

除了上述「把額度逐一發到成員身上」的批次捷徑，「額度分配」頁籤另提供 <mark style="color:blue;">**角色額度**</mark> 子頁籤，可直接以 MaiAgent 角色為單位設定**一筆整個角色共用的額度**，作為與成員額度獨立的管控層級。

列表以角色為單位，欄位包含：**角色名稱、類型、需要額度、額度狀態、使用量、到期時間、操作**。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-c9d9e46a210df5d4a65162eeb959eae332d4b921%2Fcredit-quota-role-tab.png?alt=media" alt="角色額度子頁籤"><figcaption><p>額度分配 → 角色額度：以 MaiAgent 角色為單位的額度管控</p></figcaption></figure>

**分發角色額度**：

1. 點擊 <mark style="color:blue;">**分發額度**</mark> 按鈕，選擇目標角色
2. 設定額度上限、有效期限與重置週期，確認送出

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-a5dc7131e63fbbeda941959537ac1ce53f2b5e9b%2Fquota-06-role-assign-modal.png?alt=media" alt="分發角色額度視窗"><figcaption><p>角色額度 → 分發額度：為單一角色設定共用額度</p></figcaption></figure>

各角色列上同樣有 <mark style="color:blue;">**需要額度**</mark> 開關，語意與[成員額度的開關](#quota-required-toggle)相同：開啟後，該角色必須有有效額度，所屬成員的 AI 消費才會放行。

{% hint style="warning" %}
頁面提示：**各角色額度獨立累計**——成員同時屬於多個受管控角色時，每筆消費會同時計入每個角色帳，因此各角色用量加總可能大於組織實際消耗。實際扣款仍只從組織錢包扣一次。
{% endhint %}

角色額度、成員額度與對話平台額度三層的搭配關係，詳見[對話平台 Credits 額度管理](/others/credits/inbox-credit-quota.md#quota-layers)。以實際數字說明三種額度怎麼計算，見[三種額度怎麼算：情境範例與常見問題](/others/credits/credit-quota-scenarios.md)。

***

## 成員自查個人額度 <a href="#member-self-check" id="member-self-check"></a>

成員可從個人 Profile 查看自己的 Credits 使用狀況：

1. 點擊右上角帳號頭像
2. 點擊 <mark style="color:blue;">**個人設定**</mark>
3. 切換至 <mark style="color:blue;">**Credit 額度**</mark> 頁籤

{% hint style="info" %}
**非 Credits 計費組織**的成員，Profile 中不會顯示「Credit 額度」頁籤。
{% endhint %}

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-d8b8426a6a98e6f14c91d589074d43970064fd2c%2Fprofile-credit-quota.png?alt=media" alt="個人 Credit 額度頁籤"><figcaption><p>個人設定中的 Credit 額度頁籤</p></figcaption></figure>

頁面根據成員的額度狀態顯示不同內容：

| 狀態                  | 顯示內容                                               |
| ------------------- | -------------------------------------------------- |
| **有有效額度**           | 進度條（已用 / 總上限）、剩餘 Credits、到期倒數                      |
| **需要額度但無額度（過期／停用）** | 紅色警示「您需要額度才能使用 AI 服務；目前尚未分配額度，或額度已過期。請聯繫管理員分發新額度。」 |
| **不需要額度**           | 灰色提示「您目前沒有個人額度限制，消費直接使用組織錢包，無需擔心個人額度上限。」           |

進度條顏色會依使用比例變化（低用量綠色、高用量接近紅色），提醒成員留意剩餘量。

***

## 注意事項 <a href="#notes" id="notes"></a>

### 適用範圍 <a href="#applicable-scope" id="applicable-scope"></a>

個人額度管控**僅適用於以下入口**：

* 透過 MaiAgent 管理後台操作
* 透過 API Key 呼叫 `/completions/` 端點
* 知識庫上傳、文件處理

{% hint style="info" %}
**Web Chat 對話平台不受個人額度限制。** 透過嵌入網頁的 Web Chat 對話框發送的訊息，無論訪客是否登入，一律直接消費組織錢包。
{% endhint %}

### Fail-Open 機制 <a href="#fail-open" id="fail-open"></a>

{% hint style="info" %}
為避免因額度邊界計算問題導致服務中斷，系統採用 **Fail-Open** 策略：

當檢查時剩餘額度 > 0，本次請求放行；AI 完成回應後才計入消耗量。若消耗後超過上限，則**下一次**請求才被擋下。這確保使用者不會在「已收到 AI 回應」的同時遭遇扣款失敗。
{% endhint %}


---

# 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/member-credit-quota.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.