Agent
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.
How to use file system
- 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.
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.
Runtime path
The file browser shows the shared folder for the agent's runtime. Some runtimes expose this as
/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.