> 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/maiagent-user-guide/ja/others/credits/inbox-credit-quota.md).

# 会話プラットフォームの Credits 上限管理

各インボックスに Credits の利用上限を設定し、公式サイトや LINE などの AI 利用コストを管理します

管理者は[メンバークォータ](https://docs.maiagent.ai/maiagent-user-guide/ja/others/credits/member-credit-quota.md)に加え、\*\*各インボックス（Inbox）\*\*に Credits の利用上限と有効期間を設定できます。たとえば、公式サイトの Web Chat に毎月一定のキャンペーン予算がある場合や、LINE インボックスのコストを個別に管理する場合に、それぞれのインボックスにクォータを設定できます。

{% hint style="info" %}
**Credits 課金方式を利用している組織のみが対象です。** インボックスクォータはメンバークォータと同様に、**利用上限であり、個別のウォレットではありません**。実際の支払いは引き続き組織ウォレットから行われ、クォータはそのインボックスで利用できる最大量だけを制限します。

メンバー、ロール、インボックスのクォータは**それぞれ独立し、同時に適用されます**。適用されるいずれかのクォータを使い切ると、次の AI リクエストがブロックされます。最後に許可された利用は上限を超える場合があります。詳細は後述の Fail-Open の説明をご覧ください。3 つの階層の役割については、[3 つのクォータ階層の組み合わせ](#quota-layers)をご覧ください。
{% endhint %}

## 3 つのクォータ階層の組み合わせ <a href="#quota-layers" id="quota-layers"></a>

Credits のクォータ管理には 3 つの階層があり、「クォータ割り当て」タブ内の 3 つのサブタブに対応しています。混同しやすい点ですが、3 つの階層は**管理対象が異なります**。必要に応じて個別に使用することも、組み合わせることもできます。

| 階層             | 管理対象                                 | クォータを使い切った際にブロックされる対象 | 対応するサブタブ   |
| -------------- | ------------------------------------ | --------------------- | ---------- |
| **メンバークォータ**   | 個々のメンバー（管理画面での操作、API Key による呼び出しなど）  | そのメンバー                | メンバークォータ   |
| **ロールクォータ**    | 特定の MaiAgent ロールに属するすべてのメンバー         | そのロールに属するメンバー         | ロールクォータ    |
| **インボックスクォータ** | 単一のインボックス（Web Chat、LINE など）での訪問者との会話 | そのインボックスでのすべての訪問者との会話 | インボックスクォータ |

3 つの階層を組み合わせる際のルールは次のとおりです。

* **いずれかの階層で使い切るとブロックされます**：利用のたびに、適用されるすべてのクォータと組織ウォレットの残高を確認します。確認時にいずれかの階層で残りのクォータがなければ、その AI リクエストはブロックされます
* **支払いは 1 回だけです**：クォータは利用上限を測る指標であり、独立したウォレットではありません。同時に何階層のクォータが適用されても、実際の Credits は**組織ウォレットから 1 回だけ差し引かれ**、重複して請求されることはありません
* **インボックスの訪問者にはメンバークォータを確認しません**：LINE などの外部インボックスの訪問者は組織メンバーではありません。その会話では、組織ウォレットとインボックスクォータの 2 つだけを確認します

ロールクォータとメンバークォータの操作については、[メンバーの Credits クォータ管理](https://docs.maiagent.ai/maiagent-user-guide/ja/others/credits/member-credit-quota.md)をご覧ください。1 回の利用が複数の階層にどのように計上されるか、画面上の数値が何を表すかについては、[3 種類のクォータの計算方法：シナリオとよくある質問](https://docs.maiagent.ai/maiagent-user-guide/ja/others/credits/credit-quota-scenarios.md)をご覧ください。

## 利用シーン <a href="#use-cases" id="use-cases"></a>

* **金融・銀行業：インボックスごとに予算を管理します**：公式サイトの Web Chat ではクレジットカードやローンに関する一般の問い合わせに対応し、LINE 公式アカウントでは資産運用サービスの会員対応を行います。2 つのインボックスのマーケティング予算は別々の部門が管理しています。それぞれに四半期のクォータ上限を設定すれば、各インボックスの利用量が明確になり、一方の予算超過が他方に影響することもありません。
* **サービス・小売・ホテル業：キャンペーン期間中の公式サイトに上限を設けます**：周年記念キャンペーンのページに専用の Web Chat を埋め込み、特典や予約に関する質問に回答します。クォータの割り当て時に、有効開始日時をキャンペーン開始時、終了日時をキャンペーン終了時に設定し、備考にキャンペーン名を記入します。キャンペーン終了後にクォータが自動で期限切れになるため、手動で無効にする必要はありません。
* **教育機関：入学相談用インボックスと学部・学科の予算を併用します**：入学募集期間に出願相談用の LINE インボックスを開設し、四半期のクォータを設定して学外からの問い合わせ対応コストを管理します。学内利用では[ロールクォータ](https://docs.maiagent.ai/maiagent-user-guide/ja/others/credits/member-credit-quota.md#role-quota)を併用し、各学部・学科の MaiAgent ロール単位で予算を割り当て、インボックスと学部・学科の 2 つの範囲を個別に管理します。
* **テクノロジー・電子機器製造業：外部サポートと社内利用を分けます**：外部向け技術サポートの Web Chat に月次クォータを設定し、大量の仕様や見積もりの問い合わせによるコスト増加を防ぎます。社内エンジニアの利用はメンバークォータで管理し、2 つの範囲が互いに干渉しないようにします。

## 管理者の操作 <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> の 3 つのサブタブがあります

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-b5776797d962c17a76fd1d2ff896a5e3f4367973%2Fquota-01-credits-quota-entry.png?alt=media" alt="Credits のクォータ割り当てタブへの入口"><figcaption><p>組織設定 → Credits → クォータ割り当て：3 つのサブタブ（メンバークォータ／ロールクォータ／インボックスクォータ）</p></figcaption></figure>

3. <mark style="color:blue;">**インボックスクォータ**</mark> サブタブを選択します

ページには集計カード（すべてのインボックス、割り当て済み、期限切れ／無効、未割り当て）と、各インボックスのクォータ一覧が表示されます。インボックス名、ID、Agent 名で検索できます。予定の期限より前に無効にされたクォータは <mark style="color:blue;">**無効**</mark>、有効期限に達して失効したクォータは <mark style="color:blue;">**期限切れ**</mark> と表示されます。集計カードの <mark style="color:blue;">**期限切れ／無効**</mark> は両者の合計です。ロールクォータのサブタブも同じ表示方式です。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-8eb99994b153f9fa752ad96a48e0ff7d8a7da740%2Fcredit-quota-inbox-tab.png?alt=media" alt="インボックスクォータのサブタブ：集計カードに期限切れ／無効があり、クリックするとクォータが無効のインボックス 1 件に絞り込まれます"><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://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-1b697c398ff794f23c020bfa77b9511092343aed%2Fquota-02-inbox-assign-modal.png?alt=media" alt="インボックスクォータの割り当てダイアログ"><figcaption><p>インボックスクォータの割り当て：インボックスを選択し、クォータ上限、有効開始日時、有効期限を入力します</p></figcaption></figure>

{% hint style="info" %}
各インボックスで同時に有効にできるクォータは 1 件だけです。すでに有効なクォータがある場合は「編集」で調整してください。上限の引き上げは即時に反映されます。引き下げる場合は、使用済みの量を下回る値にはできません。
{% endhint %}

「リセット周期」は、リセットしない、毎日、毎週、毎月から選択できます。次の周期になると、台北時間 00:00 に使用量がゼロにリセットされ、クォータが全量に戻ります。クォータ上限と有効期限は変わりません。周期の詳細は[リセット周期の設定](https://docs.maiagent.ai/maiagent-user-guide/ja/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://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-61de335a8c31548af20bfb7468aaa1a815b23ae3%2Fquota-03-inbox-require-confirm.png?alt=media" alt="クォータを必須にする際の確認ダイアログ"><figcaption><p>「クォータが必要」スイッチを切り替える際の確認ダイアログです</p></figcaption></figure>

{% hint style="warning" %}
クォータを無効にする際に「クォータが必要」がオンのままの場合、このインボックスの AI 応答は、新しいクォータを割り当てるか制限を解除するまで一時停止されます。
{% endhint %}

### MaiGPT の組織全体の利用上限 <a href="#maigpt-org-quota" id="maigpt-org-quota"></a>

インボックスクォータ一覧の最上部には **MaiGPT** の行があります。その <mark style="color:blue;">**チャネル**</mark> 列には、通常のインボックスの「Web」「内部」「API」などのチャネルラベルではなく、<mark style="color:blue;">**MaiGPT**</mark> ラベルが表示されます（独自ブランドの環境では、その環境のアシスタント名が表示されます）。この行のクォータは単一のインボックスの訪問者向けではなく、**組織全メンバーによる MaiGPT 利用の共通上限**です。

> **利用シーン**：情報システム部門の責任者が、月末に Credits の予算超過が判明することを防ぐため、全社の MaiGPT 利用に月次上限を設けたいと考えています。<mark style="color:blue;">**インボックスクォータ**</mark> を開き、最上部の MaiGPT 行で <mark style="color:blue;">**クォータを割り当て**</mark> をクリックします。ダイアログには組織全メンバーでこのクォータを共有する旨の説明が表示されます。クォータ上限を入力し、リセット周期を毎月に設定して保存します。以後、全社員の MaiGPT 利用量がこのクォータに累積され、毎月ゼロにリセットされます。

保存すると、MaiGPT 行の <mark style="color:blue;">**クォータが必要**</mark> スイッチもオンになり、クォータの状態は <mark style="color:blue;">**有効**</mark> と表示されます。使用量の列には使用済み量と残りのクォータが表示され、次回リセットの列には次にゼロに戻る日時と周期が表示されます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-e56fea2c9ecde87641e88a6bf32e6374fc5aeb17%2Fcredit-quota-inbox-maigpt-row.png?alt=media" alt="インボックスクォータ一覧：最上部の MaiGPT 行のチャネル列には MaiGPT ラベルが表示され、毎月リセットのクォータが割り当てられて有効になっています。他のインボックスには音声、API、内部などのチャネルラベルが表示されます"><figcaption><p>MaiGPT 行のチャネル列には MaiGPT ラベルが表示され、クォータを割り当てると状態が有効になります</p></figcaption></figure>

割り当て、無効化、制限解除の操作は通常のインボックスと同じです。画面に表示される説明文が異なります。

| 操作                                                                                                        | 画面の説明                                                                                                           |
| --------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| クォータの割り当て（MaiGPT 行の <mark style="color:blue;">**クォータを割り当て**</mark> をクリックするか、割り当てダイアログで MaiGPT を選択します）     | 「このクォータは、組織全メンバーの MaiGPT 利用で共有されます（Classic と Work の両方を含みます）。使い切ると組織全体で MaiGPT が一時停止されます。他の機能には影響しません。」          |
| クォータの無効化（MaiGPT 行の <mark style="color:blue;">**無効にする**</mark> をクリックします。確認ダイアログのタイトルは「インボックスクォータを無効にする」です） | 「無効にすると、MaiGPT の組織上限は直ちに失効します。「クォータが必要」がオンのままの場合、新しいクォータを割り当てるか制限を解除するまで、組織全体で MaiGPT が一時停止されます。無効にしてもよろしいですか？」 |
| 「クォータが必要」をオフにします（確認ダイアログのタイトルは「クォータ制限を解除」です）                                                              | 「解除後、MaiGPT の利用にはこの組織上限が適用されなくなり、組織ウォレットを直接使用します。有効なクォータがある場合は、そのクォータも無効になります。」                                 |

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-19f3034121a7a89fcba7ba83b5a768df155844c9%2Fcredit-quota-inbox-maigpt-assign-hint.png?alt=media" alt="インボックスクォータの割り当てダイアログ：MaiGPT が選択され、その下に組織全メンバーでクォータを共有する説明が表示されています。リセット周期は毎月です"><figcaption><p>MaiGPT を選択すると、割り当てダイアログに組織全体でクォータを共有する旨の説明が表示されます</p></figcaption></figure>

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-9c79d9ea24ea4a2ffe5c175fe4cb585c50d90c6c%2Fcredit-quota-inbox-maigpt-disable-confirm.png?alt=media" alt="インボックスクォータの無効化確認ダイアログ：無効化により MaiGPT の組織上限が直ちに失効し、クォータが必要のままなら組織全体で MaiGPT が一時停止される旨が説明されています"><figcaption><p>MaiGPT 行のクォータを無効にする際の確認ダイアログです</p></figcaption></figure>

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-b0d4ce1cc2022490f1cbdb398a704a1b59d9373f%2Fcredit-quota-inbox-maigpt-lift-confirm.png?alt=media" alt="クォータ制限の解除確認ダイアログ：解除後、MaiGPT の利用は組織ウォレットを直接使用する旨が説明されています"><figcaption><p>MaiGPT 行の「クォータが必要」をオフにする際の確認ダイアログです</p></figcaption></figure>

{% hint style="warning" %}
この MaiGPT クォータを使い切った場合、または「クォータが必要」がオンで有効なクォータがない場合、**組織全体**で MaiGPT の AI 応答を利用できなくなります。他の機能には影響しません。メンバーが質問すると、クォータを使い切った場合は「クォータが不足しています。組織管理者にお問い合わせください。」、有効なクォータがない場合は「有効なクォータがありません。組織管理者にお問い合わせください。」という固定メッセージが表示されます。この 2 つのメッセージには、後述の「デフォルトメッセージ」のカスタム文面は適用されません。
{% 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://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%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://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%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/maiagent-user-guide/ja/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.
