> ## Documentation Index > Fetch the complete documentation index at: https://docs.box.com/llms.txt > Use this file to discover all available pages before exploring further. # Understanding Box AI Usage: Daily Quotas and AI Units An AI Unit is a standardized metric used to measure the consumption of chargeable Box AI features. AI Units simplify capacity planning by condensing complex technical details, such as token counts (text read by the AI) and model latency, into a single, easy-to-understand value. Whether an action consumes AI Units depends on the action and the mode of use (user-driven vs. automated/at-scale). ## AI Units included Upgrading your Box subscription tier unlocks advanced foundational reasoning, orchestration capabilities, and larger baseline AI Unit allocations. | **Box Plan** | **Included AI Units per month** | **Features** | | - | - | - | | **Business** | Available for purchase | Standard single-file Box AI Q\&A and content generation. | | **Business Plus** | Available for purchase | Standard single-file Box AI Q\&A and content generation. | | **Enterprise** | 1,000 | Box Hubs integration. | | **Enterprise Plus** | 2,000 | Integrated **Box Agent** (UI-driven, multi-step task execution),and Multi-file Box AI Q\&A. | | **Enterprise Advanced** | 20,000 | **Box Agent in Pro Mode** (advanced reasoning/extended contexts), **Box AI Studio** (Custom Agent creation), and **Box Extract** (Custom Extract Agents, Standard Extract Agent, Enhanced Extract Agent). | | **Box Shield Pro (Add-on)** | N/A (Included) | Agentic **AI Classification Agent** and **AI Threat Analysis Agent** to automate context-driven content security at scale. | **Key Capacity Considerations:** * **Entitlements:** AI Units are allocated for a defined entitlement period (e.g. monthly) and are comprised of your base plan allotment plus any additional units purchased via a service order. * **No Rollover:** Unused AI Units expire at the end of each entitlement period and do not roll over to the next period. * **Aggregated Use:** If you utilize multiple chargeable AI features (e.g., Q\&A AI API and Text Gen AI API), your unit consumption is aggregated against your enterprise-level entitlement pool. ## Included vs. Chargeable Features To manage your budget effectively, it is critical to understand what triggers an AI Unit charge. Chargeability is determined by the feature and mode of access (Box Web App UI vs API). ### Features included in your plan In plan interactions do not deduct from your monthly AI Unit pool: * **Box Agent (Standard Mode):** Standard interactive end-user prompts within the UI. * **Box Agent (Pro Mode):** Exclusive to Enterprise Advanced. When enabled, the agent utilizes advanced reasoning capabilities for complex tasks like strategic analysis or coding. Note: Responses may take longer due to increased processing, but it remains included in your plan when run interactively by a user in the Web App. The Box Agent via API is chargeable, however. * **Custom Agents (Standard Mode):** Tailored agents used within the Web App, provided they are not configured in Expanded Mode. * **Box Apps and Search:** Built-in platform conversational search capabilities. * **Box Shield Pro & Auto-Classification:** Includes native security classifications, the **AI Classification Agent**, and the **AI Threat Analysis Agent**. These automated protections run in the background at zero AI Unit cost. AI Units do not apply to free Box AI features, such as Box Agent in Standard Mode (not Expanded Mode). Actions using the Box Agent or custom agent in Standard Mode do not count toward AI Units. > [!NOTE] > > While these features do not consume your monthly AI Unit allocation, Box enforces a [daily Box Agent quota](#daily-box-agent-quota) on in-plan features to maintain performance stability. ### Model Context Protocol (MCP) Partners Integrations For third-party platform integrations connected via the MCP framework, capacity metering is split by call type and feature category: * **Only AI Usage Consumes AI Units:** Traditional platform transactions (such as file fetches, folder navigation, or standard structural metadata requests) triggered by an MCP app do not affect your AI pool. * **AI-Powered Data Extraction is Always Chargeable:** Any AI-powered data extraction task orchestrated by an MCP tool is executed via API and consumes AI Units under standard data extraction rules. * **AI Q\&A and Text Generation Metering:** * **Current State:** Because MCP integrations function as API-driven developer access, all Q\&A and text generation tasks orchestrated through the Box MCP server consume AI Units. (Note: Standard interactive use of Box AI directly within the native Box Web App UI remains included in your plan). * **Future State:** The metering framework will transition to differentiate between Published MCP Apps (from the public marketplace) and Custom-Built MCP Apps, altering how unit deductions are calculated. ### Chargeable Features (Consumes AI Units) AI Units are consumed when actions are performed at scale, are automated, are not directly managed user-driven, or leverage advanced enterprise configurations: * **Box AI APIs:** Any access via the Q\&A AI API or Text Gen AI API. * **Box Automate Workflows:** Any agent execution integrated into an automated Box workflow process. * **Expanded Mode Agents:** An optional configuration in Box AI Studio for Box or Custom Agents that removes standard query restrictions, allowing the agent to process massive, content-heavy datasets. * **Box Extract Agents:** Box Extract leverages the Standard and Enhanced Extract Agents to automatically extract structured data from files and save it as Box metadata, consuming AI Units. Use the Standard Extract Agent for high-volume, structured or semi-structured documents with 50 pages or fewer and fewer than 20 extraction fields, or use the Enhanced Extract Agent for complex, large, multimodal documents with 50 pages or more and more than 20 extraction fields. Custom Extract Agents support metadata templates, selected fields, field-level AI instructions, and up to 10 source folders, with the ability to automatically extract from subfolders as well. Custom Extract Agent creation and configuration, as well as the Standard and Enhanced Extract Agents, are available on Enterprise Advanced plans, while Extract Agent APIs are available on Business plans and above. Box Extract does not count against the daily Box Agent quota but uses the organization's shared AI Unit allocation. * **AI-Generated Metadata Templates:** Using Box AI to generate a new metadata template. See [Using Box Extract](https://docs.box.com/en/box-extract/using-box-extract.md#create-a-custom-extract-agent) to learn more. * **Confidence Levels:** Showing how confident the Box Extract Agent is with every extracted metadata value incurs an additional cost in the form of AI Unit consumption. Confidence levels are toggled off by default and can be enabled when building Custom Extract Agents or through admin settings for the autofill capability in Box Preview. * **Bounding Boxes:** Highlighting the data source of an extracted metadata value on the original file incurs an additional cost in the form of AI Unit consumption. Bounding boxes are toggled off by default and can be enabled when building Custom Extract Agents or through admin settings for the autofill capability in Box Preview. > [!NOTE] > > **Admin Console model labeling and Auto selection:** Within the Admin Console and Box AI Studio, models are explicitly labeled as **Standard** or **Premium** to remove any guesswork. When building or configuring a custom agent, selecting the **Auto** model configuration defaults to a **Standard model tier** to optimize performance speed and unit cost-efficiency. Choosing a **Premium** model increases the rate of AI Unit consumption, but only when paired with one of the chargeable features listed above. ## Monitoring AI Unit usage Only Account Admins have visibility into AI Unit consumption. To view current consumption against your monthly entitlement: 1. Go to the **Admin Console**. 2. Select **Home** > **AI Insights** to open the [AI Insights dashboard](https://docs.box.com/en/box-admin-tools/reporting-and-insights/ai-insights.md). 3. Locate the **AI Units** card. > [!NOTE] > > To access historical data, Admins can now download the historical AI units consumption report with an ability to filter by date, user and AI Capability from the Reports page in the **Admin Console**. > [!NOTE] > > **Important Tracking Discrepancies to Note:** > > * **Data Lag:** The AI Unit Insights card operates with an approximate 2-hour data lag. It does not track consumption in absolute real-time. > * **AI Studio Dashboard Window:** The "Monthly Queries" chart within the AI Studio dashboard reflects a rolling 30-day window, whereas your official AI Unit allocation resets strictly on the first day of the calendar month. > * **User-Level Auditing:** Admins can download detailed User Activity Reports to break down unit spend by individual user or specific agent. (Data is available retroactively to January 1, 2026). ## Reaching AI Units Quota Box notifies admins at the following consumption thresholds: ### On track to exceed entitlement * **What happens:** The admin sees a purple warning banner in the Admin Console. * **Recommended action:** Contact your Box account manager to purchase an expansion block before operations are interrupted. ### At full entitlement: * **What happens:** Paid/chargeable AI features are blocked until the next entitlement period or until additional units are purchased. Free/included in plan Web App features remain fully functional. * **Admin view:** A persistent red warning banner appears in the Admin Console, and an automated email notification is sent. * **User view:** Users receive an error message ("AI unit entitlement has been reached") if they attempt to trigger a blocked feature. > [!NOTE] > > **Minor overages:** You may occasionally notice that your final monthly usage slightly exceeds your allotment (e.g., 20,320 / 20,000). This occurs due to the 2-hour processing lag and internal business rules designed to let active, in-flight requests finish rather than breaking an active user's session mid-task. New requests are blocked immediately following. ## Daily Box Agent quota The daily Box Agent quota applies to included usage for the Box Agent and custom agents not in Expanded Mode, and resets automatically each day at midnight in the user's local timezone. These quotas are set globally, allocated on a per-user basis, and are not shared across users in the organization. ### How Box Agent usage varies by type of work Box Agent supports a wide range of enterprise workflows, from quickly finding information to performing complex analysis across large volumes of content. The amount of daily quota used depends on the complexity of the task, the content being analyzed, and the level of reasoning required. | **Level of work** | **Example enterprise use cases** | **Estimated daily quota usage\*** | | :- | :- | :- | | **Everyday questions and content tasks** — Find information, summarize content, and answer questions about specific files or topics | **Contract intelligence:** Identify key obligations, dates, and agreed-upon terms across business documents. **Vendor management:** Find renewal terms and termination clauses across vendor agreements. **Document understanding:** Answer questions about policies, contracts, and project documents. | Enterprise Plus: \~1–6% Enterprise Advanced: \~0.5–3% | | **Analysis and insights** — Connect information across multiple documents to identify patterns, compare information, and support decisions | **RFP response generator:** Cross-reference an incoming security questionnaire against Trust documentation and draft response statements. **Customer insights:** Analyze customer feedback to identify top themes and emerging product opportunities. **Business intelligence:** Identify patterns across incident reports, contracts, and business documents. | Enterprise Plus: \~4–10% Enterprise Advanced: \~2–5% | | **Complex research and large-scale analysis** — Analyze large volumes of content, perform multi-step tasks, and generate comprehensive outputs | **M\&A due diligence:** Extract change-of-control clauses, termination periods, and liability caps across agreements. **Executive pre-read synthesizer:** Analyze quarterly earnings materials to identify guidance metrics, risks, and strategic initiatives. **Compliance analysis:** Review regulatory filings, policies, and contracts to identify potential risks. | Enterprise Plus: \~8–20% Enterprise Advanced: \~4–10% | > [!NOTE] > > These percentages are planning estimates and are subject to change. Actual daily quota usage varies based on the complexity of the request, the amount of content analyzed, and the level of reasoning required. ### After a user's daily Box Agent quota is used When a user reaches their daily quota while working with the Box Agent, they are automatically transitioned to **Box Agent Lite** across all surfaces (Box AI Home, Box Documents, Box Notes, and Box Hubs). * Box Agent Lite is a simplified Box AI experience where you can continue asking for insights on your files. * Box Agent Lite remains the AI experience until the quota resets automatically and the user returns to the full Box Agent. * You can continue getting insights on your content across AI Home, Documents, Notes, and Hubs. ### AI experiences not affected by the daily quota The following AI capabilities do not use a user's daily Box Agent quota because they consume your organization's AI Unit allotment instead: * Custom agents running in Expanded Mode * Box Automate * Box Extract * Box AI APIs * MCP Server AI workflows * CLI AI workflows ### Expanded Mode and the daily quota Agents in Expanded Mode are not subject to a user's daily Box Agent quota. Queries consume your organization's shared AI Unit allotment and remain available while AI Units are available. ### Recommended action If your users regularly reach their daily Box Agent quota, consider one of the following: * Use custom agents with Expanded Mode for higher-volume AI workflows. * Use Box Automate for repetitive or background AI tasks. * Contact your Box administrator or Box account team to discuss the best option for your organization. ## AI Unit consumption For information on how AI Units are consumed across Box AI APIs, agents, and Automate workflows, reference the [Box AI Units consumption table](https://cloud.app.box.com/file/1758172906969?v=box-ai-units-consumption-table). | **Important:** Any agent run within an Automate workflow is charged against your AI Unit allocation. | | - | ## Chargeability & Exhaustion Matrix To manage your budget effectively, it is critical to look at both the feature name and how it is being executed. The table below outlines the definitive chargeability status and the expected operational behavior if your organization exhausts its monthly AI Unit allocation. | Feature | Box Web App UI Chargeability Status | Box Web App UI Status When Exhausted | API Chargeability Status | API Status when Exhausted | | :- | :- | :- | :- | :- | | **Box Agent (Standard Mode)** | Nonchargeable | Available (if included in plan) | Chargeable | 🚫 Blocked | | **Box Agent (Pro Mode)** *(Enterprise Advanced)* | Nonchargeable | Available (if included in plan) | Chargeable | 🚫 Blocked | | **Custom Agents (Standard Mode)** | Nonchargeable | Available (if included in plan) | Chargeable | 🚫 Blocked | | **Expanded Mode Agents** | Chargeable | **🚫** Blocked | Chargeable | 🚫 Blocked | | **Box Extract (Custom, Standard, or Enhanced Extract Agents)** | Chargeable | 🚫 Blocked | Chargeable | 🚫 Blocked | | **Box Apps & Conversational Search** | Nonchargeable | Available (if included in plan) | *N/A* | | | **Box Shield Pro** *(AI Protections)* | Nonchargeable | Available (if included in plan) | Nonchargeable | Available (if included in plan) | ## Best practices for efficient AI Unit management * **Choose models intentionally:** Use Standard models (or select the **Auto** setting) for routine tasks, bulk processing, and basic summarization to optimize cost-efficiency. Reserve Premium models for complex reasoning, multi-step tasks, and long-document analysis. * **Configure Custom Agents smartly:** Prevent unexpected drawdowns by setting a maximum query length cap, disabling agents that are not actively used, and restricting agent folder scope (fewer scanned files equals fewer AI Units consumed). * **Monitor proactively:** Review the **AI Units** card on the [AI Insights](https://docs.box.com/en/box-admin-tools/reporting-and-insights/ai-insights.md) dashboard weekly. Identify heavy users through the **Top AI Users** chart on the [AI Insights](https://docs.box.com/en/box-admin-tools/reporting-and-insights/ai-insights.md) dashboard or in the [AI Units report](https://docs.box.com/en/box-admin-tools/reporting-and-insights/ai-units-report.md). ## How the entitlement resets * **Calendar reset:** Entitlements reset at the start of each entitlement period. Unused units do not carry over. * **Mid-period purchases:** If you purchase additional AI Units mid-period, access to blocked features is restored shortly after the purchase is processed. These add-on units will carry over through the end of your contract order date. * **To purchase more:** Contact your Box account manager or reach out directly to the sales team at [sales@box.com](mailto:sales@box.com) for baseline pricing tiers and subscription blocks. ## Box AI Units FAQs > [accordion] Do unused AI Units roll over to the next period? > > No. AI Units operate on a "use it or lose it" basis and reset on the first day of each entitlement period (e.g. monthly). > [accordion] Why does my AI Studio dashboard say I have exceeded my queries if my entitlement period just restarted? > > The AI Studio dashboard displaying **Monthly Queries** tracks usage on a rolling 30-day window, which functions independently of your strict entitlement period (e.g. calendar month). > [accordion] Do AI Units apply to Box AI for documents and notes in the user interface? > > No. Standard document interactions, standard Custom Agents, and Pro Mode within the Box Web App UI are user-driven and are included in the plan. AI Units are primarily consumed by API calls, Automate workflows, Expanded Mode configurations, and Box Extract Agents. > [accordion] Is Box Agent Pro Mode available on all plans? > > No. Box Agent in Pro Mode (and access to Box AI Studio for Custom Agents) requires an upgrade to the **Enterprise Advanced** tier. > [accordion] Are the AI features in Box Shield Pro chargeable against my AI Unit pool? > > No. The background AI tools included with Box Shield Pro (like the AI Classification Agent and AI Threat Analysis Agent) are native security features covered by the Shield Pro license and do not deplete your monthly AI Units. > [accordion] How do I know if my custom agent is using a Standard or Premium model? > > Box explicitly labels all model options in the Box AI Studio configuration dropdown as either Standard or Premium. If you select **Auto**, the agent dynamically defaults to a Standard model tier to protect your unit allocation. > [accordion] Why did our organization manage to spend over our rigid quota? > > Box employs a \~2-hour data processing lag and chooses not to terminate in-flight active processes mid-query to avoid data corruption. Once those active sessions conclude, new chargeable requests are blocked. > [accordion] Does the daily quota apply to all AI experiences? > > No. The following do not count toward a user's daily Box Agent quota because they use your organization's shared AI Units instead: > > * Custom agents running in Expanded Mode > * Box Automate workflows > * Box Extract > * AI workflows accessed through the Box AI APIs, MCP Server, or CLI > [accordion] Is Expanded Mode unlimited? > > Expanded Mode is not subject to a user's daily Box Agent quota. Instead, queries consume your organization's shared AI Units and are limited by your organization's available AI Unit allocation. > [accordion] What should I do if I see the error "AI unit entitlement has been reached"? > > Contact your organization's Box Administrator. The administrator can contact Box Sales to purchase an immediate allotment block or coordinate internal workflows until the entitlement resets. > [accordion] Can I keep using AI after hitting my daily Box Agent quota? > > Yes. AI remains available in Notes, Documents, Hubs and AI Home. After reaching the daily Box Agent quota, AI requests continue through the standard AI experience until the user's daily quota resets. If Expanded Mode is available, users can also use a custom agent running in Expanded Mode.