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

# メンバーの Credits 上限管理

メンバーごとに個人の Credits 消費上限（クォータ）を設定します。メンバーは MaiGPT の「利用状況とクォータ」で自分の残りクォータを確認できます。

組織管理者は、メンバーごとに**個人の Credits 消費上限（クォータ）と有効期限**を設定できます。これにより、イベント期間中や特定プロジェクトの利用コストを一目で把握し、コントロールできます。

{% hint style="info" %}
**Credits 課金制度を採用している組織でのみ利用できます。** お使いの組織がまだ Credits 制度に切り替えていない場合、この機能は表示されません。詳しくは [Credits 課金制度](/maiagent-user-guide/ja/others/credits.md) をご覧ください。メンバークォータに加えて、対話プラットフォーム別にコストを管理することもできます。詳しくは [対話プラットフォーム Credits クォータ管理](/maiagent-user-guide/ja/others/credits/inbox-credit-quota.md) をご覧ください。
{% endhint %}

## 基本コンセプト <a href="#core-concept" id="core-concept"></a>

**クォータは消費の上限（天井）であり、事前にチャージするサブウォレットではありません。**

組織の Credits ウォレットは引き続き唯一の資金プールであり、クォータは特定のメンバーが組織ウォレットから最大でどれだけの Credits を消費できるかを制限するだけです。クォータを配布しても組織の残高には影響せず、クォータの有効期限が切れても残高には影響しません。「返却」という概念もありません。

## 利用シーン <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://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%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" %}
各メンバーは同時に 1 件の有効なクォータしか持てません。すでに有効なクォータを持つメンバーについては、「編集」で直接調整するか、いったん停止してから再度配布してください。
{% 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://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%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://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%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://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%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://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%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> をオンにして次の項目を入力すると、この招待の対象者は、組織デフォルトの代わりにこのクォータを受け取ります。同じ招待リンクから参加した各メンバーが、それぞれ 1 件ずつ受け取ります。有効になる時刻も、実際に参加した時刻を起点に計算されます。

| 項目         | 説明                                                            |
| ---------- | ------------------------------------------------------------- |
| **クォータ上限** | 必須                                                            |
| **有効期限**   | 日時を指定します。**空欄の場合は無期限**です。現在より前の日時や、組織のチャージの有効期限より後の日時は指定できません |
| **リセット周期** | リセットしない／毎日／毎週／毎月                                              |
| **備考**     | 任意                                                            |

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%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://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-50c1ae8c579b1fb4572746e719efa4daf3f2185b%2Fcredits-default-invitation-status-join-quota.png?alt=media" alt="招待ステータスタブの参加時のクォータ列"><figcaption><p>招待ステータスタブ：別途クォータを設定した招待にはクォータ上限が表示され、それ以外は「—」が表示されます</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-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> で次の項目を選択できます。

| オプション       | 動作                                                   |
| ----------- | ---------------------------------------------------- |
| **リセットしない** | クォータは 1 回限りの上限となり、使い切ると利用できなくなります                    |
| **毎日**      | 毎日 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://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%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://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-95f46c10837a650eb91ffadcc71aa6bc5d91acc9%2Fmember-quota-batch-confirm.png?alt=media" alt="クォータ制限を維持する場合の一括停止確認ウィンドウ"><figcaption><p>クォータ制限を維持する場合、確認ウィンドウにはクォータを停止するメンバー数が表示されます</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-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" %}
2 つの人数は異なる場合があります。ロール内で、作成済みかつ未停止のクォータを持たないものの、引き続きクォータ制限の対象となっているメンバーは、「クォータを停止」の人数には含まれません。制限の解除を選択した場合、そのメンバーは「クォータ制限を解除」の人数には含まれます。「クォータを停止」の人数には、事前に作成され、まだ有効になっていないクォータも含まれます。
{% 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 のロール単位で一括操作できます。「メンバークォータ」サブタブの右上には、2 つの一括操作ボタンがあります。

**一括配布**：

1. <mark style="color:blue;">**ロールから一括配布**</mark> をクリックし、ウィンドウで対象のロールを選択します
2. クォータの内容を設定します（クォータ上限、有効期限、リセット周期、備考が、そのロールの**全メンバー**に適用され、メンバーごとに個別のクォータが 1 件ずつ作成されます）
3. 確認して送信します。**すでに有効なクォータがあるメンバーは自動的にスキップされ、重複して配布されません**。完了すると、「一括配布完了：成功 N 名、スキップ N 名、失敗 N 名」と表示されます

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%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://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-fe3210b0d909826eea6aebbc3902520a105e5815%2Fquota-08-batch-deactivate-options.png?alt=media" alt="クォータを一括停止する 2 つの方法"><figcaption><p>一括停止：デフォルトではクォータ制限を維持しますが、同時に解除することもできます</p></figcaption></figure>

{% hint style="warning" %}
一括配布を行うと、対象メンバーの「クォータが必要」スイッチも同時にオンになります。一括停止のデフォルトのオプションでは、クォータ制限が維持されます。クォータの停止後にメンバーが組織ウォレットを使用できるようにしたい場合は、「クォータを停止し、クォータ制限を解除する」を選択してください。
{% endhint %}

{% hint style="info" %}
**ロールから一括配布は、ロールクォータではありません。** 一括配布は、ロール内の各メンバーに個人クォータを「それぞれ 1 件ずつ」配布するもので、使用量はメンバーごとに計算されます。ロール全体で 1 つの予算を「共有」したい場合は、下記の[ロールクォータ](#role-quota)を使用してください。両者の違いと数値例については、[3 種類のクォータの計算方法：シナリオ例とよくある質問](/maiagent-user-guide/ja/others/credits/credit-quota-scenarios.md#role-quota-vs-batch-by-role)をご覧ください。
{% endhint %}

### 個人クォータのアラート設定 <a href="#member-quota-alert" id="member-quota-alert"></a>

メンバーのクォータが残りわずかになったときや、まもなく期限切れになるときに、システムが本人へ通知することで、会話の途中でブロックされる前に、管理者へ早めに調整を依頼できるようにします。この設定は組織全体で 1 つを共有し、個人クォータを持つすべてのメンバーに適用されます。

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;">**OK**</mark> を押して保存します

| 項目                                                     | 説明                                                                                                           |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
| <mark style="color:blue;">**個人クォータのアラートを有効にする**</mark> | マスタースイッチです。オフにすると、2 種類のアラートがどちらも停止します                                                                        |
| <mark style="color:blue;">**使用量アラートのしきい値**</mark>      | メンバーの消費量がクォータ上限のこの割合に達したときにアラートを送信します。1～99 の整数を入力でき、デフォルトは 80 です                                             |
| <mark style="color:blue;">**期限前アラート**</mark>           | オンにすると、クォータが <mark style="color:blue;">**期限前の日数**</mark> 以内に期限切れとなる場合にアラートを送信します。日数は 0 より大きい整数で、デフォルトは 7 日です |

アラートは、**アプリ内通知**と **Email** の両方でメンバー本人に送信されます。アプリ内通知は、メンバーの[通知センター](/maiagent-user-guide/ja/start/notifications.md)の「組織のお知らせ」タブに表示され、タイトルは「<mark style="color:blue;">個人クォータがまもなく上限に達します</mark>」または「<mark style="color:blue;">個人クォータがまもなく期限切れになります</mark>」です。内容には使用済み量、上限、残りのクォータが表示され、メンバーに組織管理者への連絡を促します。

{% hint style="info" %}
これは**メンバー個人のクォータ**に対するアラートです。組織ウォレットの残高不足のアラートは、Credits の概要にある「残高アラート」カードで設定します。両者は互いに影響しません。[Credits 課金制度：残高不足アラート](/maiagent-user-guide/ja/others/credits.md#low-balance-alert)をご覧ください。
{% endhint %}

### ロールクォータ <a href="#role-quota" id="role-quota"></a>

上記の「クォータをメンバーごとに配布する」一括操作のほかに、「クォータ配分」タブには <mark style="color:blue;">**ロールクォータ**</mark> サブタブもあります。ここでは、MaiAgent のロール単位で**ロール全体が共有する 1 件のクォータ**を直接設定でき、メンバークォータとは独立した管理レイヤーとして利用できます。

一覧はロール単位で表示され、列には **ロール名、タイプ、クォータが必要、クォータの状態、使用量、有効期限、操作** が含まれます。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%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://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-a5dc7131e63fbbeda941959537ac1ce53f2b5e9b%2Fquota-06-role-assign-modal.png?alt=media" alt="ロールクォータを配布するウィンドウ"><figcaption><p>ロールクォータ → クォータを配布：1 つのロールに共有クォータを設定します</p></figcaption></figure>

各ロールの行にも <mark style="color:blue;">**クォータが必要**</mark> スイッチがあり、[メンバークォータのスイッチ](#quota-required-toggle)と同じ意味を持ちます。オンにすると、そのロールに有効なクォータがなければ、所属メンバーによる AI の利用は許可されません。

{% hint style="warning" %}
ページ上の注意：**各ロールのクォータは個別に累計されます**。メンバーが管理対象の複数ロールに同時に所属している場合、1 回の消費が各ロールの使用量に同時に計上されます。そのため、各ロールの使用量の合計が組織の実際の消費量を上回ることがあります。実際の料金は、組織ウォレットから 1 回だけ差し引かれます。
{% endhint %}

ロールクォータ、メンバークォータ、対話プラットフォームクォータの 3 つのレイヤーの組み合わせについては、[対話プラットフォーム Credits クォータ管理](/maiagent-user-guide/ja/others/credits/inbox-credit-quota.md#quota-layers)をご覧ください。実際の数値で 3 種類のクォータの計算方法を説明した内容については、[3 種類のクォータの計算方法：シナリオ例とよくある質問](/maiagent-user-guide/ja/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://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%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/maiagent-user-guide/ja/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.