Workspace Files (Botonom Drive)
Built-in cloud drive and document workspace for your agents: read, write, preview, delete, and inspect files and tabular spreadsheets.
This guide begins with What Workspace Files does, continues through Agent tools and capabilities, Native Excel & CSV spreadsheet preview, Security and RBAC governance, and finishes with How to use it.
What Workspace Files does
Workspace Files (Botonom Drive) provides your agents with a secure, native filesystem and document library. Rather than relying solely on external cloud storage providers, agents can store research outputs, read corporate PDFs, edit markdown documents, and inspect spreadsheets directly within your workspace.
Every file created by an agent or uploaded by a team member is version-tracked, isolated to your company tenant, and immediately previewable in the web panel and mobile app.
Agent tools and capabilities
Agents interact with the drive through four core actions:
workspace_files__list: Lists files and folders with metadata (size, MIME type, creator, timestamps).workspace_files__read: Reads the full content of text, markdown, CSV, or code files.workspace_files__write: Creates a new file or saves an updated revision with an audit description.workspace_files__delete: Permanently deletes a file. Restricted to administrator roles by default.
Native Excel & CSV spreadsheet preview
When agents generate or inspect spreadsheets (.xlsx, .csv), Botonom parses the table structure server-side without external cloud viewers:
- Tabular data renders in an interactive, scrollable grid with row/column headers.
- Agents can read specific sheets and extract summary numbers without pulling megabytes of raw text into the conversation context.
- Accented Turkish and international characters (UTF-8) are preserved cleanly.
Security and RBAC governance
File operations adhere to strict enterprise access controls:
- Delete Protection: The
workspace_files.deletecapability is blocked by default for standard members, preventing accidental or unauthorized deletion of living business documents. - Multi-Tenant Isolation: Storage paths are cryptographically bounded to your company UUID. An agent can never access or list files from another tenant.
- Audit Trails: Every file creation, modification, and deletion records the user ID or agent ID and a timestamp in the workspace changelog.
How to use it
You can manage files directly from the Botonom Drive screen in your dashboard or talk to your agent naturally:
User: Dünkü toplantı notlarını Drive'a kaydet ve özet bir e-tablo oluştur.
Agent: Notlar 'Toplanti-Notlari-2026-09.md' adıyla kaydedildi. Karar maddelerini içeren Excel tablosu oluşturulup Drive kök dizinine eklendi.
User: Drive'daki son ürün listesini kontrol edip kaç satır olduğunu söyle.
Agent: 'Urunler-2026.xlsx' dosyasını inceledim. Toplam 1,420 satır ve 8 sütun bulunuyor.