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

# 對話平台 Credits 額度管理

為每個對話平台設定 Credits 消費上限，控管各對話平台（官網、LINE 等）的 AI 使用成本

除了[成員額度](/others/credits/member-credit-quota.md)，管理員也可以為\*\*每個對話平台（Inbox）\*\*設定 Credits 消費上限與有效期限。例如：官網 Web Chat 每月行銷活動預算固定、LINE 對話平台需獨立控管成本時，可分別為各對話平台設定額度。

{% hint style="info" %}
**僅適用於 Credits 計費制度的組織。** 對話平台額度與成員額度相同，是**消費天花板而非子錢包**：實際扣款仍走組織錢包，額度只限制該對話平台最多能消費多少。

成員額度、角色額度與對話平台額度**各自獨立、同時生效**：任一適用層已用完時，下一次 AI 請求就會被擋下；最後一次放行的消費仍可能超過上限，詳見下方 Fail-Open 說明。三層的分工詳見下方[三層額度如何搭配](#quota-layers)。
{% endhint %}

## 三層額度如何搭配 <a href="#quota-layers" id="quota-layers"></a>

Credits 額度管控共有三個層級，對應「額度分配」頁籤中的三個子頁籤，這也是最容易混淆的地方——三層**控管的對象不同**，可依需求單獨或搭配使用：

| 層級         | 控管對象                          | 額度用完時誰會被擋    | 對應子頁籤  |
| ---------- | ----------------------------- | ------------ | ------ |
| **成員額度**   | 個別成員（管理後台操作、API Key 呼叫等）      | 該名成員         | 成員額度   |
| **角色額度**   | 某個 MaiAgent 角色的全體成員           | 屬於該角色的成員     | 角色額度   |
| **對話平台額度** | 單一對話平台（Web Chat、LINE 等）上的訪客對話 | 該對話平台的所有訪客對話 | 對話平台額度 |

三層的疊加規則：

* **任一層用完就擋**：一次消費會同時檢查適用的每一層額度（連同組織錢包餘額），只要其中任何一層在檢查時已無剩餘額度，該次 AI 請求就會被擋下
* **扣款只扣一次**：額度是消費上限的「刻度」，不是獨立的錢包。無論同時套用幾層額度，實際 Credits **只從組織錢包扣一次**，不會重複扣款
* **對話平台訪客不檢查成員額度**：LINE 等外部對話平台的訪客不是組織成員，其對話只檢查組織錢包與對話平台額度這兩層

角色額度與成員額度的操作說明，見[成員 Credits 額度管理](/others/credits/member-credit-quota.md)。同一筆消費如何同時記在多層、畫面上的數字代表什麼，見[三種額度怎麼算：情境範例與常見問題](/others/credits/credit-quota-scenarios.md)。

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

* **金融／銀行業——各對話平台預算分開控管**：官網 Web Chat 供民眾詢問信用卡與貸款方案，LINE 官方帳號主打理財會員經營，兩個對話平台的行銷預算分屬不同部門。分別為兩個對話平台設定各自的季度額度上限，哪個對話平台用了多少一目瞭然，超支也不會互相影響。
* **服務／零售／飯店業——活動期間官網限額**：週年慶檔期在活動頁嵌入專屬 Web Chat 回答檔期優惠與訂位問題。分發額度時將生效時間設為檔期開始、到期時間設為檔期結束，並在備註標記活動名稱；活動結束後額度自動到期，不必手動關閉。
* **教育機構——招生對話平台與系所預算並用**：招生季開設報名諮詢 LINE 對話平台並設定季度額度，控管對外諮詢成本；校內使用則搭配[角色額度](/others/credits/member-credit-quota.md#role-quota)，以各系所的 MaiAgent 角色為單位分配預算，對話平台與系所兩層各自控管。
* **科技／電子製造業——對外支援與內部使用分流**：對外技術支援 Web Chat 設定每月額度，避免大量規格詢價灌爆成本；內部工程師的使用則走成員額度控管，兩層互不干擾。

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

### 進入對話平台額度頁面 <a href="#enter-inbox-quota-tab" id="enter-inbox-quota-tab"></a>

1. 從左側選單點擊 <mark style="color:blue;">**組織設定**</mark> → <mark style="color:blue;">**Credits**</mark>
2. 切換至 <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-b5776797d962c17a76fd1d2ff896a5e3f4367973%2Fquota-01-credits-quota-entry.png?alt=media" alt="Credits 額度分配頁籤入口"><figcaption><p>組織設定 → Credits → 額度分配：三個子頁籤（成員額度／角色額度／對話平台額度）</p></figcaption></figure>

3. 選擇 <mark style="color:blue;">**對話平台額度**</mark> 子頁籤

頁面顯示統計卡片（全部對話平台、已分配額度、已過期、未分配）與各對話平台的額度列表，可搜尋對話平台名稱、ID 或 Agent 名稱。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-7d130a3dafcbe1884fbd365961c5aa8484754c42%2Fcredit-quota-inbox-tab.png?alt=media" alt="對話平台額度子頁籤"><figcaption><p>額度分配 → 對話平台額度：統計卡片、搜尋與分發額度按鈕</p></figcaption></figure>

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

1. 點擊 <mark style="color:blue;">**分發額度**</mark> 按鈕，在「分發對話平台額度」視窗中選擇對話平台
2. 填入**額度上限**、**生效時間**與**到期時間**（留空表示永久有效），選擇**重置週期**，並可加上備註（例如：活動期間額度）
3. 確認送出

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-1b697c398ff794f23c020bfa77b9511092343aed%2Fquota-02-inbox-assign-modal.png?alt=media" alt="分發對話平台額度視窗"><figcaption><p>分發對話平台額度：選擇對話平台後填入額度上限、生效與到期時間</p></figcaption></figure>

{% hint style="info" %}
每個對話平台同一時間只能有一筆有效額度。已有啟用中額度的對話平台請使用「編輯」調整，上調立即生效、下調不可低於已消費量。
{% endhint %}

「重置週期」可選不重置、每日、每週或每月。到了下一個週期，系統會在台北時間 00:00 將已用量歸零、額度回滿，額度上限與到期時間不變。詳細週期說明見[設定重置週期](/others/credits/member-credit-quota.md#quota-reset-period)。

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

每個對話平台列上有 <mark style="color:blue;">**需要額度**</mark> 開關：

| 開關狀態   | 說明                                         |
| ------ | ------------------------------------------ |
| **開啟** | 此對話平台必須有有效額度才能使用 AI 回覆；若目前無有效額度，AI 回覆將暫停   |
| **關閉** | 解除此對話平台的額度限制，並同時停用既有有效額度；消費仍受組織錢包及其他適用限制管控 |

切換開關時，系統會顯示確認視窗（設為需要額度／解除額度限制）說明影響範圍，確認後才會生效。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-61de335a8c31548af20bfb7468aaa1a815b23ae3%2Fquota-03-inbox-require-confirm.png?alt=media" alt="需要額度確認視窗"><figcaption><p>切換「需要額度」開關時的確認視窗</p></figcaption></figure>

{% hint style="warning" %}
停用額度時：若「需要額度」仍為開啟，此對話平台將暫停 AI 回覆，直到分發新額度或解除限制。
{% endhint %}

## 額度用完時訪客會看到什麼 <a href="#quota-exceeded-behavior" id="quota-exceeded-behavior"></a>

對話平台額度用完（或開啟「需要額度」但無有效額度）時：

* **Agent 暫停回覆**，訪客會收到提示訊息。系統預設為：「很抱歉，此對話平台的 Credit 額度已達上限，AI 助理暫停回覆。您的訊息已收到，將由專人盡快回覆。」
* **訪客訊息仍會正常進入收件匣**，人工客服接手回覆不受影響

提示訊息可自訂：進入該對話平台的 <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-14675fad5509485a7811a39c0a569904b5c9623a%2Fquota-05-interaction-default-message.png?alt=media" alt="預設提示訊息欄位"><figcaption><p>對話平台設定 → 互動設定：「預設提示訊息」可自訂額度用完時的回覆文字</p></figcaption></figure>

{% hint style="info" %}
與成員額度相同，額度檢查採用 **Fail-Open** 策略：若消費時額度恰好不足，該次消費仍會放行（已用額度可能暫時超過上限），下一次消費才會被擋下，確保使用體驗不因額度邊界而中斷。
{% endhint %}

## 在對話平台設定中查看額度 <a href="#view-in-inbox-settings" id="view-in-inbox-settings"></a>

進入單一對話平台的設定頁，左側選單的 <mark style="color:blue;">**額度**</mark> 頁籤可查看該平台的已使用額度、剩餘額度、額度狀態與到期時間（唯讀）；具 Credit 管理權限的成員可點擊 <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-0221c452e29414a76fb53fb207d682e51f6ae4d2%2Fquota-04-inbox-settings-quota-tab.png?alt=media" alt="對話平台設定中的額度頁籤"><figcaption><p>對話平台設定 → 額度：該平台額度狀態的唯讀檢視</p></figcaption></figure>

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

#### Q：額度用完時，客戶端會看到什麼？ <a href="#faq-exceeded-message" id="faq-exceeded-message"></a>

Agent 會暫停回覆，訪客收到提示訊息。未自訂時，系統預設訊息為：「很抱歉，此對話平台的 Credit 額度已達上限，AI 助理暫停回覆。您的訊息已收到，將由專人盡快回覆。」可在互動設定的「預設提示訊息」欄位自訂並依語系覆寫，詳見[上方說明](#quota-exceeded-behavior)。

#### Q：人工客服會受影響嗎？ <a href="#faq-human-agent" id="faq-human-agent"></a>

**不受影響。** 額度只限制 AI 回覆的消費；額度用完後，訪客訊息仍會正常進入收件匣，人工客服可照常接手回覆。

#### Q：為什麼「已使用額度」有時會略超過上限？ <a href="#faq-fail-open" id="faq-fail-open"></a>

這是 **Fail-Open** 機制的正常現象：系統在檢查時只要剩餘額度大於 0 就放行本次請求，AI 完成回應後才計入消耗量。因此最後一次放行的消費可能讓已用額度略超過上限，**下一次**請求才會被擋下。這確保使用者不會在「已收到 AI 回應」的同時遭遇失敗。

#### Q：對話平台額度和組織錢包有什麼差別？ <a href="#faq-quota-vs-wallet" id="faq-quota-vs-wallet"></a>

組織錢包是**唯一的資金池**，額度是**消費天花板**。分發額度不會從錢包移出任何 Credits，額度過期也沒有「退回」的概念。反過來說，若組織錢包餘額不足，即使對話平台額度還有剩，AI 也無法回覆——錢包與各層額度都要有餘裕，消費才會放行。

## 權限說明 <a href="#inbox-quota-permission" id="inbox-quota-permission"></a>

* 分發、編輯、停用對話平台額度需要 **Credit 管理權限**（與成員額度相同），而非對話平台管理權限——額度屬於財務控管，權限刻意與對話平台設定分開
* 對話平台設定頁中的「額度」唯讀頁籤，具對話平台管理權限即可查看


---

# 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/inbox-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.
