Member Credits Quota Management

Set personal Credits spending caps for each member to effectively manage organizational budget allocation

Organization administrators can set a personal Credits spending cap (Quota) and validity period for each member, making costs during events or specific projects transparent and controllable.

Only available for organizations using the Credits billing system. If your organization has not yet switched to the Credits system, this feature will not be displayed. See Credits Billing System for details.

Core Concept

A Quota is a spending ceiling, not a pre-funded sub-wallet.

The organization's Credits wallet remains the sole funding pool. A Quota only limits how many Credits a specific member can consume from the organization wallet. Distributing a Quota does not affect the organization balance, and Quota expiration does not affect the balance either — there is no concept of "returning" Credits.

Use Cases

• An enterprise hosts an event and grants external users platform access, needing to control per-person spending caps

• Different departments set different personal quotas based on their budgets

• Limit a specific account's usage during a validity period, with automatic enforcement after expiration

---

Administrator Operations

Accessing the Quota Allocation Page

1. Click Organization Settings from the left menu

2. Click Credits

3. Switch to the Quota Allocation tab

The page displays the quota status for all members, including summary cards (All Members, Allocated Quotas, Expired, Unassigned) and progress bars.

Distribute Quota

1. Click the Distribute Quota button in the upper right corner

2. Search for the target member by name or email in the search box

3. Enter the Credits cap (spending ceiling)

4. Set the validity period (you can set an expiration date or choose permanent)

5. Click Confirm to complete the distribution

Each member can only have one active quota at a time. For members who already have an active quota, use "Edit" to adjust it directly, or disable the current quota before distributing a new one.

Edit Quota

For members with an active quota, click Edit on their row to adjust:

• Increase the Credits cap: Takes effect immediately

• Decrease the Credits cap: Cannot be set lower than the member's current consumption; the system will display an error message

Disable Quota

For active members, click Disable → confirmation dialog → after confirming, the member's quota is immediately invalidated.

The effect of disabling depends on the "Quota Required" toggle:

• Toggle is ON: The member will be unable to use AI features and needs a new quota distributed or the toggle turned off

• Toggle is OFF: The member returns to unrestricted status, with consumption directly drawn from the organization wallet

"Quota Required" Toggle

Each member row has a Quota Required toggle on the right side:

Toggle State	Description
ON	The member must have an active quota to use AI; without a quota (expired / disabled / unassigned), access is fully blocked
OFF	The member is not restricted by quota; consumption is drawn directly from the organization wallet

When distributing a quota, the system automatically turns ON "Quota Required."

When turning OFF the toggle, if the member has an active quota, the system will simultaneously disable that quota to avoid conflicting states. A confirmation dialog explaining the impact will be displayed before each switch — please review before proceeding.

---

Members Checking Their Own Quota

Members can view their personal Credits usage from their Profile:

1. Click the account avatar in the upper right corner

2. Click Personal Settings

3. Switch to the Credit Quota tab

Members of non-Credits billing organizations will not see the "Credit Quota" tab in their Profile.

The page displays different content based on the member's quota status:

Status	Display Content
Has active quota	Progress bar (used / total cap), remaining Credits, expiration countdown
Quota required but none available (expired / disabled)	Red alert: "You need a quota to use AI services. Currently no quota is assigned, or your quota has expired. Please contact your administrator to distribute a new quota."
Quota not required	Gray notice: "You currently have no personal quota limit. Consumption is drawn directly from the organization wallet — no need to worry about personal quota caps."

The progress bar color changes based on usage ratio (green for low usage, approaching red for high usage) to remind members to monitor their remaining balance.

---

Notes

Applicable Scope

Personal quota enforcement only applies to the following entry points:

• Operations through the MaiAgent admin dashboard

• API Key calls to the /completions/ endpoint

• Knowledge Base uploads and document processing

WebChat channels are not subject to personal quota limits. Messages sent through the embedded WebChat widget on websites consume the organization wallet directly, regardless of whether the visitor is logged in.

Fail-Open Mechanism

To prevent service interruptions caused by quota boundary calculation issues, the system uses a Fail-Open strategy:

When the remaining quota is > 0 at the time of checking, the current request is allowed through; consumption is recorded only after the AI completes its response. If the consumption exceeds the cap, the next request will be blocked. This ensures users never experience a billing failure at the same time as receiving an AI response.