> ## 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.

# AI Units Report

<div className="article_labels_list" style={{display: 'none'}} dangerouslySetInnerHTML={{__html: "Overview , Reporting , Admin , Article , Account Administration , Established"}} />

The AI Units report gives Box Enterprise admins a comprehensive, actionable view of chargeable AI usage across their organization. Use it to understand who is consuming chargeable AI units, which AI capabilities are being used, where requests originate, and how consumption maps to cost.

Admins can download the historical AI units consumption report, with the ability to filter by date range, user, and AI capability, from the Reports page in the Admin Console.

Run the AI Units report by selecting **Create Report** from the Reports section in the Admin Console. See [Running Reports](/en/box-admin-tools/reporting-and-insights/running-reports) for the step-by-step process. You must define filters before you can run the report.

You can filter the report by:

* Date Range
* AI Capability
* User Name

The AI Units report is available for Business and Enterprise plans.

The report can also be downloaded from the AI Units Data card on the Insights dashboard. When downloaded from the card, it includes only the current month's unit consumption.

## AI Units report details

* **File format**: comma-separated value (.csv) file
* **Filename format**: `ai_units_run_on_YYYY-MM-DD-HH-MM-SS_Page_#.csv`
* **Folder name format** (each report run is placed in its own folder): `AI Units run on YYYY-MM-DD HH-MM-SS`
* **Filename and folder name time zone**: the local [date and time](/en/box-admin-tools/reporting-and-insights/dates-and-times-in-report-data) of the admin who ran the report or who set up the report [schedule](/en/box-admin-tools/reporting-and-insights/scheduling-reports).

## AI Units report data columns

This section describes the data columns that are generated in AI Units reports.

### Date

The date the AI unit consumption occurred. See [Dates and Times in Report Data](/en/box-admin-tools/reporting-and-insights/dates-and-times-in-report-data) for formatting details.

### User

The full name of the user who consumed the AI units, from the value in the *Name* field in User Account Details.

### User Email

The Box email address of the user who consumed the AI units, from the value in the *Email* field in User Account Details.

### AI Capability

The type of AI capability invoked. Values in this field can be:

* **Q\&A**: User queried Box AI and received a response.
* **Text Generation**: User used Box AI to generate or summarize text.
* **Metadata Extraction**: User used Box AI to extract metadata from content.
* **Enhanced Metadata Extraction**: User used Box AI enhanced metadata extraction for richer, more detailed metadata output.
* **Box Agents**: Includes AI units consumed by Custom and Base agents.

### Product

The application or entry point through which the AI capability was invoked, such as the Box web app, a mobile app, APIs, MCP, or a third-party integration.

### Category

The category of the LLM, defined as standard or premium. Certain capabilities are charged differently depending on the model's category.

### AI Units

The number of AI units consumed. A value of **0** indicates exclusively non-chargeable AI usage (i.e, AI usage with no AI unit consumption), while a value greater than **0** indicates chargeable AI usage. It is possible for a single interaction to use less than one AI Unit, as rows may show values between 0 and 1. Rows with 0 AI units still appear in the report so you have full visibility into AI activity (both chargeable and non-chargeable), but they do not count toward your chargeable usage.

## AI Units report filters

This section describes the filters that you can configure to run AI Units reports.

### Date Range

Select the desired time period of past AI unit consumption. Select from:

* Last Day
* Last Week
* Last Month
* Last Years
* Custom Range (and then select a start and/or end date)

Last day/week/month/year values mean the previous day/week/month/year from the date the report was run.

### AI Capability

Select from:

* All AI Capabilities (default)
* Q\&A
* Text Generation
* Metadata Extraction
* Enhanced Metadata Extraction
* Box Agents

### User Name

Optional. To limit the AI Units report to consumption by specific users, enter the names of managed users. Default is all users.

## Save and share the report

The AI Units report supports saved configurations and viewer subscriptions.

* **Save report filters**: Enable **Save these settings to use in the future** to save the current filter configuration for reuse. See [Saving Report Configurations](/en/box-admin-tools/reporting-and-insights/saving-report-configurations) for details.
* **Invite as viewer**: In the **Invite As Viewer** field, enter one or more user names to subscribe managed users to the report. Subscribed users receive access to the report output each time it is run. See [Subscribing Users to Reports](/en/box-admin-tools/reporting-and-insights/subscribing-users-to-reports) for details.

## Understanding AI capabilities in the report

The AI Capability column maps each row to one of the AI features available in your Box environment. The following table summarizes each capability and typical use cases.

| AI Capability                | Description                                                                     | Example Use Case                                                                        |
| ---------------------------- | ------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| Q\&A                         | Natural-language question answering against file content.                       | An employee asks Box AI a question about a contract clause.                             |
| Text Generation              | AI-generated or AI-summarized text output.                                      | A user generates a summary of a lengthy research document.                              |
| Metadata Extraction          | Extraction of structured metadata fields from files.                            | Automatically tagging invoices with vendor names and amounts.                           |
| Enhanced Metadata Extraction | Richer, multi-field extraction with higher-fidelity output.                     | Extracting detailed line items, dates, and parties from legal agreements.               |
| Box Agents                   | Any AI consumption (chargeable or non-chargeable) through base or custom agents | User creates a custom business agent in AI Studio to generate reports from Box content. |
