Chat File Attachments

You can attach files directly to chat messages. The agent receives the file contents alongside your message and can read, analyze, summarize, or act on them — no extra setup required.

Supported File Types

Type	Extensions	What agents can do
Images	`.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`	Describe, analyze, extract text (OCR), reference visuals
PDFs	`.pdf`	Read full text, summarize, extract data, answer questions
Spreadsheets	`.csv`, `.tsv`	Parse rows and columns, run analysis, generate charts
Plain text	`.txt`, `.md`, `.log`	Read and process any text content

Size limit: Individual files must be under 10 MB.

How to Attach a File

Open any chat window (org-level or inside a Space).
Click the paperclip icon in the message composer, or drag a file directly into the chat input.
Select a supported file from your device.
Type your message (e.g., "Summarize this PDF" or "Find the top 5 rows by revenue").
Send — the agent receives both your message and the file.

You can attach one file per message. To send multiple files, send them in separate messages or combine them into a single file before attaching.

What Happens After You Attach

When you send a message with an attachment:

The file is uploaded and validated (type + size check).
The file is written to the agent's workspace so it can be read using the Read tool.
The agent's prompt includes a note about the attached file: its name, type, and where it was placed.
The agent processes the file as part of your request.

Files attached in chat are scoped to the current conversation. They are not permanently stored in the Space filesystem — use the /files panel to upload files you want to keep for long-term agent access.

Example Uses

Analyze a spreadsheet

Attach sales-q1.csv → "Which product category had the highest growth?"

Summarize a document

Attach contract.pdf → "List the key obligations for each party."

Debug a log file

Attach error.log → "What's causing the 500 errors?"

Describe an image

Attach screenshot.png → "What does this UI show and what's wrong with it?"

File System vs Chat Attachments

	Chat Attachment	`/files` Panel Upload
Lifespan	Current conversation only	Persists in the Space filesystem
Agent access	Automatically available in the conversation	Available to agents running in the Space
Use case	One-off analysis or questions	Long-term reference files, shared data

For files that agents need to access repeatedly (e.g., a CRM export an analyst agent reads every week), upload them via the /files panel or use the Write tool inside a conversation to save them to the Space.

Troubleshooting

File is rejected at upload

Check the file type is in the supported list above.
Check the file size is under 10 MB.
If the browser does not detect the file type correctly, try renaming the file to include the correct extension (e.g., data.csv).

Agent says it cannot find the file

The attachment was placed in the agent's workspace at the path shown in the conversation. Ask the agent: "List the files available to you."

Agent misreads a PDF

PDFs with scanned pages (image-only, no embedded text) cannot be read as text. Export a text layer from your PDF tool or convert to .txt first.