You can select up to 5 Hubs as sources for a single Box AI query. Selecting more than 5 Hubs is not supported and can cause the request to fail. To search across more content, narrow the selection to the 5 most relevant Hubs, or run separate queries.
Box AI Home and across platforms
AI Home provides a full-page workspace accessible from the left navigation. This option offers the most complete feature set:- View and resume previous sessions from session history
- Add sources from Box or from your device
- Select from available agents, including custom agents from Box AI Studio
- Access the prompt library and agent gallery

Working with Box AI
When starting, you can begin working on your content by entering your prompt or request into the text box and pressing Enter. After you submit your request, the Box Agent searches through all content accessible to you through permissions and collaboration settings and provides a response to which you can continue to work on, or clear to begin again. See Working with responses to see more options. If your admin has enabled web search, the Box Agent can also search the web for current, public information. For more information, see Searching the web. To specify how you want to work on your content, you can use the prompts below the text box to:- Summarize content
- Research files
- Analyze patterns
- Create templates, drafts, outlines, etc.
Pro mode
Users can enable Pro Mode by using the toggle in the prompt entry box. When Pro Mode is enabled, the agent uses deeper reasoning for tasks like strategic analysis or complex coding. Responses can take longer to generate as the Box Agent is creating more robust plans and executing tasks using increased reasoning capacity.
Adding sources
If you need to narrow down what exactly the Box Agent uses as reference, you can add sources to your questions by:- Dragging and dropping from your device or external drive
- Dragging from left navigation (Recents or from Collections)
- Upload from your device or external drive
- @ mention to choose a user or content
Working with responses
After submitting the question or request, Box AI generates responses in real time. Following a response, you can ask follow-up questions to gain better insights. These questions help build context and narrow down results. Saving response To save a response, select Copy. It is sent to your clipboard, and you can then paste it elsewhere. You can review past responses and prompts by selecting History in the top left corner of the page, where you can see recent chat logs or view full history. Giving Feedback To give feedback on a response, see Giving Feedback on AI Responses. Clearing Sessions To clear the chat history, select the edit icon in the top right corner of the page. To delete the session, select the trash icon in the far right corner of the page. Doing so permanently deletes the chat history and cannot be undone. Sources and citations To review citations, showing which parts of the source document were referenced when generating the response, hover over the number(s) in the bottom left corner of the response. A small window shows the source text from the document. Creating files When the Box Agent creates files, it saves them in the session. To make the files easier to find, you can move them to a specific folder after they’re created, or choose a different default location for the session from the Save all uploaded/generated files to menu.
Agent and model selection
Choosing your own model is available only for Enterprise Advanced tier customers.
- Select Agent next to the sources button.
- From the list, select from available provider models and custom agents.
- Begin prompting the selected agent.
As part of processing your query, Box can choose the best available model from the list of enabled models; however, the final generated answer always uses the user-selected model.
Searching the web
With web search, the Box Agent can look up current, public information on the web, such as SEC filings, IRS guidance, economic data, news, and regulatory updates, and use it in answers alongside your Box content. Web search is powered by OpenAI, and answers that use web results include links to their sources. The Box Agent generally checks your Box content first. It searches the web only when you ask it to, or when it can’t find an answer in Box and you agree to let it search.Enabling web search
Admins turn on web search for the organization. Web search is off by default. For steps, see Configuring Box AI.Asking the Box Agent to search the web
The Box Agent uses web search in two ways:- You ask for it. Include an instruction such as “search the web” in your prompt.
- The Box Agent offers it. If your Box content doesn’t contain an answer, the Box Agent asks whether you want it to search the web. It searches only after you agree.
- Open AI Home from the left navigation.
- Enter a prompt that asks the Box Agent to search the web. For example:
- “Search the web for the current IRS standard mileage rate.”
- “Find the latest 10-K filing for [company name] and summarize the risk factors.”
- Press Enter.
- If the Box Agent asks whether to search the web, confirm to continue.
Combining Box content with web results
The Box Agent can combine your Box content and web results in a single answer. Add files, folders, or Hubs as sources, then ask the Box Agent to compare them with current information from the web. For example:- “Review the travel receipts in this folder and check current currency conversion rates against our per diem policy.”
- “Compare our cybersecurity policy with the latest CISA advisories.”
Reviewing web sources
Answers that use web search include citations that link to the web pages the Box Agent used. Web content can be outdated or inaccurate, so review the sources before you rely on the answer. When you select a link to an external website, a dialog box asks you to confirm that you want to leave Box.Web search limitations
- Prompts that use web search take longer to answer, because the Box Agent completes an extra search step.
- Prompts that use web search consume more Box AI units than prompts that use only Box content. For more information, see Understanding Box AI usage.
- Naming a website or domain in a prompt doesn’t guarantee that the Box Agent uses only that source.
- Web search returns only publicly accessible web pages. Pages that require a login aren’t included.
- Web search isn’t available if your organization disables OpenAI models.
Box Advanced Document Intelligence
Box Advanced Document Intelligence is available on Enterprise Advanced only and requires Pro Mode.
- .pptx
- .docx
- .xlsx (creation and analysis)
- .csv (analysis)
Example prompts
To get started, you can use the following prompts. Create a Word document from a PDF:- “Create a Word document that is a summary of the attached PDF document and include me as the author and today’s date.”
- “Update this Word document by changing the location of the venue to Redwood City from New York and do this as a Word compliant redline.”
- “Read all of the lines from this attendee list and create a single standard PDF for each of these attendees and store in @NDA list folder.”
Spreadsheet analysis
When you have complex questions about the contents of a spreadsheet, including calculations, aggregations, and trend analysis across rows, columns, and sheets, you can use Box Advanced Document Intelligence to get the right answers. To use this capability, attach the spreadsheet to your query, or have the spreadsheet in a folder or in search results. For example:- “From this spreadsheet, give me the average of the data for 2024.”
Limitations
- Files that the Box Agent saves can be up to 5 MB.
- A request can use up to 200 MB of input files. A file larger than this isn’t processed.
- Very large jobs can run out of processing time before they finish.
Troubleshooting
If you are unable to use Box AI, check the following with your admin:- Has your organization been provisioned for Box AI?
- Is AI Home enabled in your organization?
- If the Pro toggle is missing, check if your organization is on the Enterprise Advanced tier or if the specific agent creator has disabled Pro Mode for that agent.
- If the Box Agent says it can only create text formats, such as Markdown or plain text, and not PDF, Word, PowerPoint, or Excel files, ask your admin to turn on Advanced Document Intelligence.