Skip to main content
Files is the workspace’s shared file storage: the documents, spreadsheets, exports and images your team works with, plus everything agents and apps produce. Files feed the rest of the platform: they become Data sources and Context sources, and agents and apps read them while they work. Open Files from the navigation rail. The panel beside the file list also lists the workspace’s knowledge bases.

Where files live

The page has three tabs:
On on-prem deployments with workspace storage, an Admin can add a host directory (for example an SMB or NFS share) as a read-only folder on the Workspace tab with External source. Its files can be previewed and downloaded but not changed.

Upload

  • Click Upload to add files to the current folder, or Upload folder to add a whole folder with its structure.
  • Or drag files and folders onto the list (Drop files or folders to upload).
Each file can be up to 100 MiB by default; a deployment administrator can change the limit in the admin settings. An upload with the same name as an existing file replaces it, and the old file is kept in Recently deleted when the workspace keeps a trash. Names cannot be .keep or contain ... Admins, Builders and Operators can upload and change files on the Workspace and Personal tabs. Viewers can browse, preview and download. Nobody uploads to Outputs; agents and apps write there.

Organize

The list shows the first 1,000 files of each tab.

Preview

Select a file to preview it beside the list. Legacy .xls and .ppt, password-protected Office files and other binary files are not previewed; download them instead.

Delete and restore

Delete a file or folder with the trash icon on its row. When the workspace keeps a trash, deleted files, and files replaced by an upload with the same name, go to Recently deleted and stay there for 30 days by default.
1

Open Recently deleted

Click Recently deleted in the toolbar.
2

Restore

Click Restore on the entry. It goes back to where it was; if something now sits at that path, that item moves to Recently deleted in turn.
When the workspace has no trash, the delete dialog says the deletion is permanent.
Agents read files as they are now: files have no versions. To give an agent a stable, versioned set of documents, build a knowledge base from them.

Export an agent’s files

An Admin can download a storage-backed agent’s own files as a ZIP from the agent’s page with Export ZIP. The total export size is capped (1 GiB by default; adjustable by a deployment administrator).

Next

Use files

Turn files into data sources and knowledge, and see how agents and apps read and write them.

Context

Build a versioned knowledge base from your files.