Attachments
Hang files on a prompt — text inline, images by path.
Files hang on a prompt in two different ways, because they have to. Text goes into the message; images go onto disk and only their address goes into the message.
The reason is the main model: it does not see images. Vision is a separate service with its own model, which the agent reaches through the analyze_image tool. So an image cannot travel inside the question — but its path can, and the agent decides for itself when to look and what to ask.
Text files
Read in the browser and appended to the question. Nothing is uploaded, nothing is stored, no endpoint is involved. Each file is capped at 12,000 characters and all of them together at 24,000 — content itself allows 32,000, and the question needs room too. A file that got cut is marked as truncated, in the composer and in the prompt.
Why does this fail on the second run?
[attached file] notes.md (text/markdown, 2.3 KB)
--- begin notes.md ---
# Deploy notes
The cache is warmed on boot …
--- end notes.md ---Images
PNG, JPEG, WebP, and GIF go to POST /api/v1/uploads and come back as a path. That path lands in the message, and the agent passes it to analyze_image when it wants to look. Base64 in the prompt would be the obvious shortcut and is a dead end: a 24 KB image already exhausts the 32,000-character limit.
Which error is in this console?
[attached image] console.png (image/png, 245 KB)
Path on this machine: /srv/smeeware/data/uploads/a904…f5.png
Use the analyze_image tool with that path to look at it.Limits
UPLOADS_MAX_FILESint · default 8Files per request.
UPLOADS_MAX_BYTESint · default 20000000Per file, 20 MB by default.
UPLOADS_DIRpath · default data/uploadsWhere the files land.
UPLOADS_ENABLEDbool · default trueOn false the endpoint answers 500 instead of taking files nobody can look at.