Skip to main content
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 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 of the admin who ran the report or who set up the report schedule.

​
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 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 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 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.
Last modified on July 13, 2026