Artifacts
Files your agent produces during a run.
An artifact is a file the agent publishes while it works: a generated report, a processed CSV, a rendered diagram. Artifacts attach to the run that produced them, persist after the run finishes, and download cleanly through either the dashboard or the API.
See them on a run
Open any run from the agent's Runs tab, then switch to the Artifacts tab on the run detail page. Every file the run published appears there with its name, size, and a direct download link. Runs that produced no artifacts show an explicit empty state — the tab is always present.
For sessions that span multiple runs, the session view rolls every artifact up in one place so you don't have to click into each run individually.
How an agent publishes one
Publishing is a one-line call from inside the agent's recipe — point at a file path and the platform captures it. There's no setup beyond turning the feature on for the node that should be able to publish, and partial writes never reach the run's artifact store: a file only ships once the publish call returns successfully.
The Recipes guide covers wiring up node behaviour; Sandboxes explains where the agent's working files live during a run.
When to use artifacts vs. run output
The run's response payload is the right place for a structured result the caller needs immediately — a classification, a status, a small JSON blob. Artifacts are the right place for anything you don't want to inline: large files, binary content, reports a human will download later, or outputs that accumulate across a long-running session.
From the API
Every dashboard action has an API equivalent: list artifacts on a run, mint a short-lived download URL, or roll up artifacts across a session. The Runs API reference lists the artifact endpoints with schemas and examples.
Download URLs are time-limited by design — request a fresh one whenever you need access. There's no permanent download endpoint, which keeps artifact access auditable and revocable.
Next
- See the Runs guide for how artifacts fit into the wider run lifecycle.
- The Recipes guide covers how to turn publishing on for a node in your agent.