Skip to content

Files

Files gives every person and agent in your workspace a shared, durable place to store, organize, and collaborate on documents. Files your agents create are immediately accessible in the browser, and files you upload are immediately readable by any agent you give access to. The shared space is just your workspace — ordinary folders you create, organize, and share, including a default "Shared with agents" folder that every agent can read.

What you can do

Upload files. Drag files — or entire folders — onto an agent's section of the file tree, use the upload icons in the toolbar (one for files, one for whole folders, preserving directory structure), or paste a URL to pull a file from the web. Supported types include images (PNG, JPEG, GIF, WebP), PDFs, spreadsheets (XLSX, XLS, CSV), Word documents (DOCX, DOC), PowerPoint (PPTX, PPT), audio, plain text, and Markdown.

Organize in folders. Create folders, then move files into them or save files inside them — folders are real, first-class things you can create, rename, move, delete, and share. They can be collapsed, expanded, and navigated independently. The default "Shared with agents" folder — the space every agent can read — behaves like an ordinary folder you can browse, share, or move files into and out of.

Preview in-app. Images display inline, PDFs open in the built-in viewer, spreadsheets render as a paginated table (with sheet tabs) using the same grid as your Database — sort and filter any column the same way — Word documents render as formatted HTML, PowerPoint shows a slide-by-slide view, and text/Markdown render with highlighting.

Edit documents. Markdown, CSV, Word, and spreadsheet files can be edited directly in-app — click Edit, make changes, and save, no download required.

Version history. Every save creates a version snapshot. Browse prior versions, preview them read-only, and restore any earlier version with one click — the current content is snapshotted first, so a restore is always reversible.

Share files and folders. Use the Google-Drive-style share menu to give access to anyone in the workspace or to specific people and agents, at Viewer (read), Editor (edit), or Manager (edit + re-share) level. Sharing a folder cascades to every file inside it, and any file can be flipped between Private and Everyone in the workspace on its own. See Sharing & Permissions for the full model.

@-mention files in chat. Type @ (or # for content) and a file or folder name to insert a structured mention, or drag a file row into the chat composer — the agent receives the file as context. See Mentions & Commands for the full picker.

Files and agents

Agents can read and write files within their workspace. With the right permissions, an agent can list files it has access to, read their contents, and upload new ones — for example, saving a generated report or a completed form. Files an agent creates appear instantly in the browser and are @-mentionable in follow-up conversations. Anything you share with everyone in the workspace — a folder of templates and reference material, say — is available to every agent there, the right home for shared resources.

Connected storage

BotBoss can connect to Google Drive, Box, Dropbox, and SharePoint. Once connected, those accounts appear as expandable mounts in the Files sidebar — browse their folder trees without downloading anything, then drag any file or folder onto an agent to import it, preserving folder structure.

Example: import a folder from Google Drive and have an agent summarize it

  1. Connect Google Drive from Connectors (see Connectors & Integrations). It appears as an expandable mount in the Files sidebar.
  2. Browse to the folder you want — say, Board Decks — and drag it onto your agent's section of the file tree. BotBoss imports the whole folder, preserving its structure.
  3. In chat, mention the imported folder and ask for a summary:

"Read through @Board Decks and summarize the top three recurring action items across the last four quarters."

The agent reads every file it has access to inside the folder through its file tools, and replies with a summary right in chat — no separate export or download step.