Cloudflare’s Agent Lee has been updated to accept file attachments – screenshots, PDFs, and a range of text‑based logs can be dropped onto the chat interface and will be parsed as part of the query. For engineers who spend time digging through error screenshots, HAR captures, or multi‑megabyte logs, the change eliminates the tedious step of transcribing or pasting content, letting the model work with the original artifact.
How Attachments Work
- Select the paperclip icon next to the message box, paste an image, or drag files onto the panel.
- Each file appears as a removable chip above the input field; only the files you keep are sent with the message.
- Supported formats include PNG, JPEG, WebP (up to 3.5 MiB), PDFs (up to 5 MiB), and text‑based files such as
.txt,.log,.json,.har,.csv,.yaml,.yml,.toml,.md, and.xml(up to 100 MiB each). A maximum of four files and 14 MiB total after client‑side trimming can be attached per message.
Operational Limits and Data Handling
File processing happens in the browser before transmission. Text files larger than 1 MiB (2 MiB for JSON, HAR, YAML, TOML, and XML) are trimmed to retain only the first and last lines, reducing payload size while preserving context. HAR files are compacted automatically: request/response bodies and cookies are stripped, and credential headers such as Authorization and Cookie are replaced with [redacted]. PDFs are converted to plain text; scanned PDFs without an OCR‑generated text layer are ignored because no readable text exists.
Attachments are stored with the active conversation. When the conversation view changes, older attachments age out and are removed from storage. Re‑attaching a file brings it back into the active set. The system does not retain files beyond the current view, which limits long‑term exposure but also means that historical context must be re‑uploaded if needed later.
Security Considerations
- Do not attach secrets. Files become part of the stored conversation and may be retained for the duration of the session. Including passwords, API tokens, or other credentials could expose them to unintended parties.
- Redaction of sensitive headers. For HAR files, credential headers are automatically replaced with
[redacted], reducing the risk of leaking authentication data. - PDF text extraction limits. Scanned PDFs without embedded text are not readable, which may lead to incomplete analysis if the only artifact is an image‑only document.
- Beta status. The feature is still in beta; behavior, limits, or data‑usage policies may evolve, so engineers should monitor release notes for changes that could affect compliance or operational tooling.
Related CloudNinjas coverage: hands-on guides.
What This Means For Practitioners
Practitioners should start using attachments for any diagnostic material that is cumbersome to paste – screenshots of UI errors, HAR captures from slow page loads, or lengthy log files. Before attaching, verify that the file does not contain secrets and that the size stays within the documented limits. Expect that very large logs will be trimmed; if the trimmed view omits critical sections, consider splitting the log or uploading a smaller excerpt that captures the relevant context. Because attachments age out, keep a local copy of any file you may need for future reference.
From an operational perspective, the client‑side trimming and HAR compaction reduce bandwidth and storage overhead, but they also mean that the model only sees a subset of the original data. Teams should adjust their debugging workflows to account for this, perhaps by pre‑filtering logs to ensure the most important lines appear at the start or end. Security teams should update guidelines to explicitly forbid attaching credential‑bearing files and to educate users about the redaction behavior for HAR files.
Overall, the attachment capability streamlines the feedback loop between engineers and Agent Lee, turning raw artifacts into actionable AI insights without manual transcription. Monitoring the beta’s evolution and revisiting attachment policies as limits change will help maintain both efficiency and security.
