Skip to main content
Box AI is available across the Box web application, including AI Home, Preview, Hubs, and Notes, giving users consistent access to document analysis and content generation. At the center is AI Home, a workspace accessible from the left navigation bar. AI Home offers a comprehensive session history, a central prompt library, and the ability to aggregate context from files, folders, and Hubs — making it ideal for complex, multi-source queries. You can seamlessly aggregate context by dragging files directly into a session, using @ mentions, or browsing Box to add files, folders, and entire Hubs as sources. This workspace is designed for complex multi-source queries, giving you the flexibility to select from an agent gallery to tailor the AI’s expertise to your specific business needs.
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
This AI agent experience is shared across the following platforms: See each of the specific uses for the platforms above.
Box AI home page with What can I help you with? search field and Summarize, Research, Analyze, Create, and Plan buttons.

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.
Selecting an option gives you template prompts to use as is or modify for your use case.

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.
Pro toggle switch turned on with briefcase icon.
Pro Mode can also be used with AI Studio created agents by selecting which mode you want your agent to operate in. Note: users will be unable to toggle to another mode different than what was selected during agent creation.

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
For best results, use @ mentions in your prompt in reference to files that have been added to sources, providing specific instructions to the agent on how to use attached files and folders. Sources can include audio and video files, such as meeting recordings or training videos. For supported formats and limits, see Querying audio and video files with Box AI.

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.
Save all uploaded/generated files to menu with This session and Pick a custom folder options.

Agent and model selection

Choosing your own model is available only for Enterprise Advanced tier customers.
The Box AI Agent is selected by default when using AI Home. If you have another agent you would prefer to use, either made by your admin or another model, you can change the agent to tailor your use case. To switch agents or models:
  1. Select Agent next to the sources button.
  2. From the list, select from available provider models and custom agents.
  3. Begin prompting the selected agent.
A custom agent can have Pro Mode enabled by default based on its settings. The list of available agents depends on what your Admin has enabled for your organization.
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. 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.
To search the web:
  1. Open AI Home from the left navigation.
  2. 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.”
  3. Press Enter.
  4. If the Box Agent asks whether to search the web, confirm to continue.
To keep the Box Agent from using the web for a question, say so in your prompt. For example: “Answer using only my Box content.”

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.”
When you add sources, the Box Agent searches them first. If both your Box content and the web contain an answer, the Box Agent uses your Box content. To focus a search, name a website or domain in your prompt. For example: “Search example.com for the latest product recall notices.” The Box Agent prioritizes the sites you name but can still use other sources. To guide searches toward specific websites for a group of users, admins can create a custom agent in Box AI Studio with instructions that name those sites. For more information, see Creating and configuring agents.

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.
When your admin turns on Advanced Document Intelligence in the Admin Console under Box Agent, you can use it to analyze and create the following file types:
  • .pptx
  • .pdf
  • .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.”
Use redline in documents by specifying the redline details in the prompt:
  • “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.”
When you ask the Box Agent to change an attached file, for example by adding a redline, it saves the result as a new version of that file. The earlier version stays in the file’s version history. Create multiple documents with a single prompt:
  • “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.”
To save new files to a specific folder, attach the folder to your request or @-mention it in your prompt. If you only name the folder in your prompt, the Box Agent doesn’t save to it, and the files stay in the session 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.
For information on enabling Box AI as admin, visit Configuring Box AI.

Box AI Principles

To view Box’s policies and practices surrounding using AI, visit The Box AI Principles page and Box AI: Acceptable Use Policy & Guiding Principles.
Last modified on November 20, 2026