The attachment feature supercharges your Enrichment Agent with extra context that would be impossible, or just too inconvenient, to include in your prompt. Think of it as moving from asking the agent to "guess" based on general knowledge to asking it to "apply" your specific business knowledge.

What attachments are good for

• Product mapping: provide a master list of SKUs, EANs, and official product names, fabrics, colors along with reference images. The agent sees a product and "looks up" the correct nomenclature.
• Taxonomy mapping: expose a tree of dependencies between metaproperties in an agent-friendly way. For example: if Country is The Netherlands, then City must be Amsterdam, Den Haag, or Rotterdam.

Six tips to get the most out of attachments

1. Provide extra context, not redundant data. The agent automatically retrieves your metaproperty options when metaproperties are referenced with the / operator, so don't duplicate them. Focus on supplemental, task-relevant information.
2. Bridge the gap between the model and your company. Provide company-specific, proprietary knowledge that doesn't exist in the agent's training data.
3. Define headers for tabular data. When providing CSVs or spreadsheets, make sure the first row is a header. Column names establish a clear data schema for the agent.
4. Minimize noise. Avoid uploading extensive documents, such as 50-page PDFs, when only a small portion is relevant. Isolate and provide only the pages or sections the task actually needs.
5. Choose formats wisely. The agent can process any image or document format supported for assets, but data-centric, flat formats such as JSON, CSV, and Markdown are the most efficient. More intricate formats like .xlsx are preferable only when the task requires interpreting visual data, such as color-coded spreadsheet mappings.
6. Update your attachment anytime. Upload the updated file as a new version of the existing asset. The agent uses the new version on the next run.

Attachment limits

• Up to 19 assets per agent (max. 4 documents).
• File size: 3.75 MB per image, 4.5 MB per document.
• Total size of all attachments: max 20 MB. You cannot maximize both the asset count and the individual file sizes. The absolute total across all attachments combined must remain under 20 MB.
• Supported filetypes: images and documents. Exception: agents processing video can't work with .XLSX attachments but can with .CSV.

Related Articles

Enrichment Agent: Automate Asset Metadata

How to Write a Good Prompt

Tips for Measuring the Value of Your AI Agents

Updated July 27, 2026 11:09