對話平台 Credits 額度管理

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

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

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

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

三層額度如何搭配

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

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

三層的疊加規則：

• 任一層用完就擋：一次消費會同時檢查適用的每一層額度（連同組織錢包餘額），只要其中任何一層在檢查時已無剩餘額度，該次 AI 請求就會被擋下

• 扣款只扣一次：額度是消費上限的「刻度」，不是獨立的錢包。無論同時套用幾層額度，實際 Credits 只從組織錢包扣一次，不會重複扣款

• 對話平台訪客不檢查成員額度：LINE 等外部對話平台的訪客不是組織成員，其對話只檢查組織錢包與對話平台額度這兩層

角色額度與成員額度的操作說明，見成員 Credits 額度管理。同一筆消費如何同時記在多層、畫面上的數字代表什麼，見三種額度怎麼算：情境範例與常見問題。

使用情境

• 金融／銀行業——各對話平台預算分開控管：官網 Web Chat 供民眾詢問信用卡與貸款方案，LINE 官方帳號主打理財會員經營，兩個對話平台的行銷預算分屬不同部門。分別為兩個對話平台設定各自的季度額度上限，哪個對話平台用了多少一目瞭然，超支也不會互相影響。

• 服務／零售／飯店業——活動期間官網限額：週年慶檔期在活動頁嵌入專屬 Web Chat 回答檔期優惠與訂位問題。分發額度時將生效時間設為檔期開始、到期時間設為檔期結束，並在備註標記活動名稱；活動結束後額度自動到期，不必手動關閉。

• 教育機構——招生對話平台與系所預算並用：招生季開設報名諮詢 LINE 對話平台並設定季度額度，控管對外諮詢成本；校內使用則搭配角色額度，以各系所的 MaiAgent 角色為單位分配預算，對話平台與系所兩層各自控管。

• 科技／電子製造業——對外支援與內部使用分流：對外技術支援 Web Chat 設定每月額度，避免大量規格詢價灌爆成本；內部工程師的使用則走成員額度控管，兩層互不干擾。

管理員操作

進入對話平台額度頁面

1. 從左側選單點擊 組織設定 → Credits

2. 切換至 額度分配 頁籤，頁面上方有三個子頁籤：成員額度、角色額度、對話平台額度

組織設定 → Credits → 額度分配：三個子頁籤（成員額度／角色額度／對話平台額度）

1. 選擇 對話平台額度 子頁籤

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

額度分配 → 對話平台額度：統計卡片、搜尋與分發額度按鈕

分發額度

1. 點擊 分發額度 按鈕，在「分發對話平台額度」視窗中選擇對話平台

2. 填入額度上限、生效時間與到期時間（留空表示永久有效），選擇重置週期，並可加上備註（例如：活動期間額度）

3. 確認送出

分發對話平台額度：選擇對話平台後填入額度上限、生效與到期時間

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

「重置週期」可選不重置、每日、每週或每月。到了下一個週期，系統會在台北時間 00:00 將已用量歸零、額度回滿，額度上限與到期時間不變。詳細週期說明見設定重置週期。

「需要額度」開關

每個對話平台列上有 需要額度 開關：

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

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

切換「需要額度」開關時的確認視窗

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

額度用完時訪客會看到什麼

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

• Agent 暫停回覆，訪客會收到提示訊息。系統預設為：「很抱歉，此對話平台的 Credit 額度已達上限，AI 助理暫停回覆。您的訊息已收到，將由專人盡快回覆。」

• 訪客訊息仍會正常進入收件匣，人工客服接手回覆不受影響

提示訊息可自訂：進入該對話平台的 對話平台設定 → 互動設定，在 預設提示訊息 欄位輸入額度用完時回覆給使用者的文字，並可依語系覆寫（未設定額度時也可先儲存備用）。

對話平台設定 → 互動設定：「預設提示訊息」可自訂額度用完時的回覆文字

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

在對話平台設定中查看額度

進入單一對話平台的設定頁，左側選單的 額度 頁籤可查看該平台的已使用額度、剩餘額度、額度狀態與到期時間（唯讀）；具 Credit 管理權限的成員可點擊 前往管理 開啟 Credits 管理頁，再切換至「額度分配」。

對話平台設定 → 額度：該平台額度狀態的唯讀檢視

常見問題

Q：額度用完時，客戶端會看到什麼？

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

Q：人工客服會受影響嗎？

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

Q：為什麼「已使用額度」有時會略超過上限？

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

Q：對話平台額度和組織錢包有什麼差別？

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

權限說明

• 分發、編輯、停用對話平台額度需要 Credit 管理權限（與成員額度相同），而非對話平台管理權限——額度屬於財務控管，權限刻意與對話平台設定分開

• 對話平台設定頁中的「額度」唯讀頁籤，具對話平台管理權限即可查看