--- title: "AI Agent: What is The Box Access Agent and how do you use it?" last_updated: "2026-04-01T12:27:18.020Z" category: "AI Agents" canonical_url: "https://maybeclients.com/h/mash-help-centre/ai-agent-what-is-the-box-access-agent-and-how-do-you-use-it" help_centre: "MaSH! Help Centre" --- # AI Agent: What is The Box Access Agent and how do you use it? ## What This Spud AI Agent Actually Does The Box Access Agent helps teams find, organise, share, and maintain files and folders in Box using clear, auditable actions. It works best when requests include exact file or folder names or a link , the destination location, and the access rules you want applied. The Box Access Agent typically runs in three task states: - Running: it is searching, updating, moving, uploading, or generating links. - Paused: it needs clarification, confirmation, or permission before it can safely proceed. - Completed: it returns links, confirmations, and key metadata for example, last modified date . ## What This Spud AI Agent Does Not Do The Box Access Agent does not: - Guess which file you mean when there are duplicates, unclear names, or multiple “latest” candidates. - Change security beyond what you explicitly request, or bypass Box permissions. - Retrieve local files from your device unless you provide the file and destination folder details. - Invent file contents or metadata if Box cannot be accessed or if permissions block it. ## What Can The Box Access Agent Do? Finding and verifying content - In Box, find the file named {file_name} and send me the link. - Search Box for {keyword} within file contents and list the top matches with links. - In Box, locate the latest version of {document_name} and tell me when it was last modified. - In Box, find all {file_type} files in {folder_name} and return links. - In Box, tell me the size and last modified time for {file_name} and send the link. Folder browsing and visibility - In Box, show me everything in the folder {folder_name} files and subfolders with links. - Show me the most recently modified items in Box under {folder_name} from {date_range}. - In Box, find anything owned by {owner_name} matching {keyword} and send links. Uploading and version control - Upload {local_file_name} to Box folder {destination_folder} and confirm it’s there. - In Box, upload a new version of {file_name} and keep the same share settings. Organising files and folders - Move {file_name} to Box folder {target_folder} and share the updated link. - Rename {old_name} to {new_name} in Box and send the updated link. - Create a Box folder called {new_folder_name} inside {parent_folder_name}. - In Box, create folders {folder_a}, {folder_b}, and {folder_c} under {parent_folder_name}. - In Box, move everything from {source_folder} into {destination_folder} and keep the structure. Sharing and access governance - Share the Box folder {folder_name} with {access_level} access and send the share link. - In Box, generate a share link for {file_name} with access set to {access_level}. - In Box, set the share link for {file_name} to expire on {expiry_date}. Metadata, tagging, and descriptions - In Box, add tags {tag_list} to {file_name} and confirm they’re applied. - Update the description of {file_name} in Box to {short_description}. ## Task Example Walkthroughs Prompt Used “Search Box for Q4 renewal within file contents and list the top matches with links.” Task State Running → Completed or Paused if permissions or scope are unclear Output - A short list of the best matches - Each result with a direct Box link - Context such as file name, folder location, and where available the snippet or match location The Problem This Solves Teams waste time asking around for “the doc that mentions X” and risk sharing the wrong version. What the The Box Access Agent Does - Searches within file contents for {keyword} - Ranks the most relevant hits - Returns links you can use immediately What Comes Back A concise, link-first result set you can forward to stakeholders without rewriting. When the The Box Access Agent Pauses - The keyword is too broad and returns excessive results - You need results restricted to a specific folder, owner, or file type - Your Box permissions do not allow content search in the requested area How to Start Provide {keyword} plus at least one of: {folder_name}, {owner_name}, or the document type you care about. --- Prompt Used “In Box, upload a new version of Brand_Guidelines.pdf and keep the same share settings.” Task State Paused → Running → Completed Output - Confirmation that a new version was uploaded - A link to the file same item, updated version - A note that share settings were preserved The Problem This Solves Version sprawl breaks trust. People keep old links, old PDFs, and inconsistent access rules. ## What the The Box Access Agent Does - Identifies the existing {file_name} in Box - Uploads the replacement as a new version not a new file - Preserves existing share settings so current links and permissions remain consistent What Comes Back A confirmation message plus the file link you can continue using in documentation, emails, and portals. When the The Box Access Agent Pauses - You have not provided the replacement file {local_file_name} or upload source - There are multiple files with the same name and it needs the correct one - You request settings that conflict with existing permissions or governance ## How to Start Share the Box file link preferred or the exact folder path, plus the new file you want uploaded. Governance & Trust Paused Is Not Failure A pause is a safety feature. It prevents accidental data exposure, mis-filed content, or overwriting the wrong document. What Triggers a Pause - Ambiguous file or folder names duplicates, unclear “latest” - Access changes sharing level, external links, expiry dates - Bulk operations moving everything while preserving structure - Missing inputs no destination folder, no upload file, no date range What You See When It Pauses - A clear explanation of what is missing or risky - The exact detail it needs for example, the correct folder link, or confirmation of access level How to Resolve a Pause - Provide a Box link file or folder instead of a name where possible - Confirm scope which folder, which owner, what date range - Confirm access rules viewer/editor, public/company-only, expiry date Why This Matters It keeps your Box workspace consistent, reduces accidental oversharing, and protects teams from “wrong link, wrong version” mistakes. ## How to Start Instructions for using the AI Agent - Start with one clear intent: find, share, upload, move, rename, or report.