Files

How agents work with files in their session.

Reading desk uploads

Files you uploaded to the agent's desk (see Files) are visible to the agent by name. The agent has tools for listing the desk and reading specific files. Reference them in chat:

"Open revenue.csv and chart Q4 by region."

Reading chat attachments

Attach a file to a single message — the agent sees it for that turn. Useful for one-off images and quick context.

Writing files back

Agents can produce files: spreadsheets, PDFs, markdown reports, slide decks. They show up as attachments on the agent's reply with a download button.

Examples:

  • "Build me an xlsx with the team's burn-down" — agent runs code, attaches the file.
  • "Summarize this meeting note as a PDF" — agent generates the PDF, attaches it.

What gets persisted

  • Desk files: persistent until you delete them.
  • Chat attachments: live with the message in the session.
  • Files the agent generates: live with the message; download to keep.

Tip

Ask for the format you want explicitly — "give it to me as a CSV" beats "give me the data". Agents pick the format from your wording.