Schema
StepExample
One attached example file on a step. Examples are resolved at cycle launch — the runtime fetches the file's extracted preview (filename, page_count, first chunk) and injects it into the LLM prompt or step input bag depending on role. ``input_hint`` is meant to bias chunking / structure inference; ``reference`` is documentation the step can cite; ``schema_sample`` is a representative input the agent should accept in production.
| Field | Type | Description |
|---|---|---|
file_idrequired | string (uuid) | platform.file_uploads.file_id reference |
filenamerequired | string | Cached filename for UI |
size | integer | null | Cached file size in bytes |
role | "input_hint" | "reference" | "schema_sample" | Why this example is attached to the step.input_hintreferenceschema_sample |
tags | string[] | Per-attachment tags (e.g. 'coutts', 'valuation-report', 'fy25'). |
notes | string | null | Free-text notes from the step author. |