Sharing files with your Tytus agent

Your agents in Tytus Chat can read the documents and images you send them, and they remember the files you've shared as the conversation goes on. This guide explains how it works and what to expect.

Audience: end users of Tytus Chat (the people chatting with their agents).

Turning file reading on

The first time you attach a file to an agent, it asks once whether it may read your files. Reply with:

• allow files — the agent can now read documents and images you attach. This applies to every agent in your workspace, and you only set it once.
• no files — the agent won't read attachments. It will still see the file's name so it can talk about it honestly, but never the contents.

You can change your mind anytime by sending allow files or no files again. Turning it off also applies backward: anything the agent had remembered from your earlier files stops being used.

What your agent can read

Once file reading is on, attach a file in a DM or @-mention the agent in a channel, and it reads:

• Documents — PDFs (including scanned PDFs and photos of documents, which are read with OCR), Word/Excel/PowerPoint and OpenDocument files (.docx .xlsx .pptx .odt), and plain text/.csv/.json/Markdown.
• Images — screenshots and photos. The agent describes what it sees and reads any text in the image.

Then just ask: "summarize this," "what's the total on this invoice?," "what does the error in this screenshot say?" — and it answers from the actual contents.

Your agent remembers files

You don't have to re-attach a file to keep talking about it. After you share something, you can ask about it several messages later — even after switching topics — and the agent still has it:

You: (attach invoice.pdf) what's this? Lisa: It's invoice SPIKE-2026-001 from Acme GmbH, total EUR 123.45, due 2026-07-01. You: ...okay, different question — what's 17 × 23? Lisa: 391. You: back to the invoice — when was it due again? Lisa: 2026-07-01. The Acme one we looked at.

This memory is per conversation. It keeps your most recent files (about the last ten) for a couple of days, and it survives server restarts. If you ask about something older that's no longer kept, the agent tells you plainly and asks you to re-send it rather than guessing.

Privacy

• Files are read on Traylinx's own infrastructure and converted by Traylinx's own document converter — they are not retained by the converter after reading.
• If you have file reading turned off, the contents are never read or stored. The agent still sees the attachment's basic details — its name, type, and size — so it can respond honestly, but never what's inside.
• If you turn file reading off after sharing something, the agent stops using what it remembered from your files.

Limits & honest answers

• Up to 5 files per message, 10 MB each.
• If a file can't be read (corrupt, an unusual format, or the converter timed out on a very large scan), the agent says so plainly and offers options ("re-send it, send a smaller version, or paste the text") — it will never invent a file's contents.
• Very long documents are trimmed to fit; the agent tells you when that happens.

Quick reference

You want to…	Do this
Let agents read your files	Send allow files once
Stop agents reading your files	Send no files
Have a file summarized	Attach it and ask
Ask about a file from earlier	Just ask — no need to re-attach
Read a scanned PDF or screenshot	Attach it like any other file

---

_{Mirrored from tytus-chat:docs/user-guide-files.md. Edit the source in the tytus-chat repo — changes here are overwritten by the sync script.}