Files and outputs
Blazing Agents separates durable private work from files an application should receive. Attach a Sandbox when an Agent needs a persistent workspace, enable file Tools to operate in it, and publish selected files as Artifacts only when they are ready to leave that workspace.
Choose a file capability
| Capability | Purpose | Owner | Persistence | Visibility | Created by |
|---|---|---|---|---|---|
| Sandbox | Provide durable workspace and compute for file Tools | Tenant; attachable to at most one Agent | Until the Sandbox is deleted | Private execution environment | Tenant through the SDK or REST API |
| File operations | Read, write, edit, search, and run commands in the workspace | Operate on the attached Sandbox | Files remain until changed or the Sandbox is deleted | Private to the Sandbox data plane | Agent Tool calls during a Turn |
| Artifact | Deliver a selected file as an application output | Tenant, Agent, and Session, with Session Attribution | Immutable until deleted; the record is then tombstoned | Downloadable through the authenticated SDK or REST API | Agent through save_artifacts |
A workspace file is not an Artifact. Scratch files remain private even after a successful Turn unless the Agent explicitly publishes them.
From workspace to output
The complete path is:
- Attach a Sandbox to the Agent.
- Enable the Sandbox-backed file Tool group.
- Let the Agent create and revise files in the workspace.
- Ask the Agent to publish selected paths with
save_artifacts. - List and download the resulting Artifacts through the SDK or REST API.
Publication is optional. A coding or analysis workflow can keep durable files for later Turns without creating any Artifacts.
Explore file capabilities
Sandboxes
Give an Agent a durable, isolated workspace for file-backed work.
File operations
Enable built-in Tools for reading, changing, searching, and publishing workspace files.
Artifacts
Publish selected workspace files as immutable application outputs.
Related guides
Reference
- Sandboxes: TypeScript SDK and REST API
- Agent Tool configuration: TypeScript SDK and REST API
- Artifacts: TypeScript SDK and REST API