File system
File system is the agent's shared folder. Upload files here when the agent needs documents, examples, datasets, scripts, or other durable artifacts across its tasks.
- 01Open the agent's File system area.
- 02Upload files, or drag files into the file browser.
- 03Open text files to preview their contents.
- 04Download files when you need to inspect or reuse an artifact locally.
What file system is for
- Input files: PDFs, CSVs, spreadsheets, transcripts, images, and other task material.
- Reference files: Templates, examples, schemas, source documents, and approved samples.
- Working artifacts: Files the agent creates, edits, or reuses across tasks.
Add files
Upload files from the File system page. Files stay available to the agent across tasks, so use this area for material the agent should be able to find again later. You can upload multiple files at once or drop files directly onto the browser.
Shared files support uploads up to 25 MiB and downloads up to 50 MiB per file. These limits apply in the agent's File system and to Shared/... in a task's Files tab.
Inspect files
Use the file tree to browse folders, refresh the listing, preview common text files, and download any file. Non-text files download instead of opening in the preview pane.
Downloads from the shared File system contain the current contents, including the agent's edits.
/workspace; Brainbase handles the backend path for you in the UI.Best practices
- Use descriptive filenames so the agent can identify the right file.
- Keep canonical instructions in Instructions or Playbooks; use files for artifacts and examples.
- Remove stale files that could cause the agent to use outdated context.
- Store credentials in Secrets, not uploaded files.
- Upload small, focused files when possible so the agent can inspect them efficiently.