File attachments
Attach files to chat messages for immediate, in-context analysis.
You can attach files directly to a chat message for immediate analysis. The agent reads the attached files and uses their content to answer your question or perform the requested task.
How to attach files
- Drag and drop files into the chat input, or click and select Add files.
- Write your message and send.
You can attach multiple files in a single message. For spreadsheets with multiple sheets, the agent can read and reference individual sheets.
Supported file types
| Type | Formats | Max file size |
|---|---|---|
| Spreadsheets | Excel (.xlsx, .xls), .csv, .tsv | 50 MB |
| Documents | PDF (.pdf) | 50 MB |
| Documents | Word (.docx) | 20 MB |
| Text and data | .txt, .md, .json | 100 MB |
Large files are automatically truncated to fit the agent's context window. You'll see an indicator when a file has been truncated.
How attachments work
When you attach a file, the agent extracts its content and includes it directly in your message. This gives the agent full access to the file when responding.
The agent can refer back to attached files in follow-up messages within the same conversation. You don't need to reattach a file to ask further questions about it. In longer conversations, the agent prioritizes recent attachments over older ones to stay within its context window.
Attachments are scoped to the chat where you send them. They are not added to the project's knowledge base and are not available in other chats. If you need a file available across multiple conversations, upload it as a project file instead.
Preview attached files
Click an attachment card in the chat input or conversation to open a preview of the extracted content. The preview shows exactly what the agent sees when processing the file.
For spreadsheets with multiple sheets, the preview includes tabs to navigate between sheets.
Best practices
The agent reads the full content of every attached file. The more focused the input, the sharper the analysis: irrelevant content takes up space in the agent's context window and can dilute its attention on what matters.
Keep files focused
Before attaching a file, consider trimming it to the data relevant to your question. For example, if you only need Q4 data from a full-year report, extract that section into a separate file. This helps the agent concentrate on the right information and produce more accurate results.
Working with spreadsheets
The agent extracts all sheets from a spreadsheet automatically. If only certain sheets are relevant to your question, reference the specific sheet in your message so the agent knows where to focus.
When creating a bill of materials in Agent mode, reference the sheet that contains your product data:
Based on the "Raw Materials" sheet in the attached file, create a bill of materials for 1000 units of wool sweaters produced in India.Summarize the key findings from the attached sustainability audit report.Attachments vs. project files
| File attachments | Project files | |
|---|---|---|
| Scope | Only the chat the file is attach to. | All chats in a project. |
| Retrieval | By attaching the file to the chat. | Automatically retrieved based on your message content. @-mention specific files to prioritize them for retrieval. |
| Context | Available in follow-up messages. The agent prioritizes recent attachments in longer conversations | Indexed and retrieved fresh for each message from the project files. |
| Best for | One-off analysis in a specific chat. | Recurring reference data organized by project. |