- Date Range
- AI Capability
- User Name
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.
Source
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.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)
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.| 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. |
| Custom | Any AI consumption through API-driven or custom-built capabilities. | A developer integration that calls the Box AI API from a custom workflow. |