What you can upload
Almost anything your agent might need to read:- Brand assets: logos, fonts, color references, image libraries.
- Documents: PDFs, slide decks, spreadsheets, CSVs, Markdown, plain text.
- Folders: drop a whole folder and its structure is kept.
node_modules, .git, __pycache__, .venv, .DS_Store) is skipped for you.
Upload files
1
Open the Files tab
On your business dashboard, click Files in the left rail. The top of the tab is a large drop zone.
2
Add files or a folder
Drag files or folders onto the drop zone, or click Browse files or Or a folder.
3
Wait for the upload to finish
Files upload a few at a time. Each one shows a row with its status, then Uploaded with its size. Larger files take longer.
47 · 213 MB.
Uploading to a path that already exists replaces the previous file.
Attach files in the chat
You can also attach files straight from the chat with your agent. Click + in the message box, paste a file, or drop files anywhere on the chat column, then send your message. You can attach up to 10 files per message. Files attached this way are saved to your business’s files automatically and show up in the Files tab, exactly as if you had uploaded them there. Your agent can use them again later.How your agent uses your files
Your files stay in your business’s file store. Your agent does not copy them all into its workspace: at the start of each turn it gets a short summary of what you have (how many files, the main folders, what is new since its last turn), and it downloads the files it needs when it needs them. So you can ask things like:- “Use the logo in
brand/logo-dark.svgon the new landing page.” - “Summarize the contract in
legal/agreement.pdfand email me the key terms.” - “Clean up
data/leads.csvand load it into our database.”
Files your agent makes
Your website’s code keeps only what the site needs: code, settings, and web images of at most 5 MB. Everything else your agent makes goes to Files: print masters, full-size renders, zip archives, design source files (.psd, .ai, .fig), TIFF images, drafts, datasets, and anything over 5 MB. That keeps your website quick to update and your agent quick to start.
Your agent can also rename, move and delete files to keep them organized. Ask it whenever you want a file removed or your files tidied up.
Files you attach to a message
Files you attach to a chat message are ready for your agent before it reads that message. They are named alongside your message, and the agent reads them before acting on it. You can send files without typing anything: the agent reads them and works out what to do. If your agent is busy when you send, your message and its files wait in line and go out with its next turn. Uploading a file alone does not send anything or interrupt your agent: it only reaches the agent when you press send. If a file you attached is deleted, or cannot be fetched, before your agent starts on your message, the turn stops and the chat names the file it could not attach. Attach it again and resend.When new uploads become visible
Right away. Because your agent looks up your files when it needs them, a file you upload mid-conversation is available on its next look. Just mention it, or attach it to your message.Your agent’s start time does not depend on how many files you store. Only files attached to the message it is answering are fetched before it starts, so a very large attachment can still take a moment.
Download a file
Click a file’s row in the FILES panel to download it. This is handy for checking exactly what your agent received, or for sharing with support if an agent misread something. Downloads are one file at a time; there’s no folder download yet.Delete files
The Files tab has no delete button. To remove a file, ask your agent in the chat: it can delete, rename or move any file for you. Uploading a file to the same path replaces the old one.Limits
These limits apply on every plan, including free. There is no plan gating on file uploads. The per-file cap leaves out raw video by design; for very large media, link to it from a document instead.
Files belong to one business. If several businesses need the same material, upload it to each of them.
Privacy and security
- Your files are stored privately and are never served on a public URL.
- Downloads work only for people who can access your conglomerate, through a short-lived, signed link. When an agent fetches a file on demand it gets the same kind of short-lived link, and only for files belonging to the business it is working on.
- Your agent runs in an isolated sandbox and only ever reaches your business’s files, never another business’s.
- Your business’s agent can add, rename and delete files in your business’s store, and nobody outside your account can.
Troubleshooting
- An upload failed: the row for the file shows the reason and a Try again link. The usual causes are a file over 200 MB (it is refused before upload) or hitting your business’s storage quota.
- Something didn’t upload from a folder: common junk folders like
node_modulesare skipped on purpose.