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

# メンバー Credits クレジット管理

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

{% hint style="info" %}
**Credits 課金制度を採用している組織でのみ利用可能です。** お使いの組織がまだ Credits 制度に切り替えていない場合、この機能は表示されません。詳しくは [Credits 課金制度](/maiagent-user-guide/maiagent-user-guide-ja/org/credits.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="/files/FoQR5hjAongv2Go13ZrS" 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> をクリックして配布を完了します

<figure><img src="/files/Ahgsniusy6I88N9F3LHx" alt="Credit クォータを配布するウィンドウ"><figcaption><p>Credits 上限と有効期限を入力して配布を確認します</p></figcaption></figure>

{% hint style="info" %}
各メンバーは同一時点で 1 件の有効なクォータしか持てません。すでに有効なクォータを持つメンバーについては、「編集」を使って直接調整するか、いったん停止してから再度配布してください。
{% 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="#quota-required-toggle" id="quota-required-toggle"></a>

各メンバー一覧の右側には、**クォータが必要**の切り替えスイッチがあります。

| スイッチの状態 | 説明                                                               |
| ------- | ---------------------------------------------------------------- |
| **オン**  | メンバーは有効なクォータがなければ AI を利用できません。クォータがない場合（期限切れ／停止／未配分）は完全にブロックされます |
| **オフ**  | メンバーはクォータの制限を受けず、消費は直接組織ウォレットから引かれます                             |

{% hint style="warning" %}
**クォータを配布する際**、システムは自動的に「クォータが必要」を**オンにします**。

**スイッチをオフにする際**、メンバーが有効なクォータを持っている場合、矛盾した状態を避けるため、システムはそのクォータを**同時に停止します**。切り替えの前には必ず影響範囲を説明する確認ウィンドウが表示されますので、確認してから操作してください。
{% endhint %}

***

## メンバーによる個人クォータの確認 <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="/files/CING69baAD1oS0Ljinbb" 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" %}
**WebChat 通路は個人クォータの制限を受けません。** 埋め込みウェブページの WebChat 対話ボックスから送信されたメッセージは、訪問者がログインしているかどうかにかかわらず、一律に直接組織ウォレットから消費されます。
{% 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/org/credits/member-credit-quota.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.