Files

Teammates can generate files during runs — CSV reports, JSON exports, code files, and more. Instruct your teammate to write files and download them through the API.

How It Works

  1. Include file output instructions in your task (e.g. "write a CSV report")
  2. The teammate writes files during execution using its built-in file write tool
  3. List and download files via the API after the run completes

Get Generated Files

Generating Files

Tell the teammate what to produce in the task instructions:

List Run Files

After a run completes, list the files it generated:

Download Files

Supported File Types

Agents can write any text-based file format:

TypeExamples
DataCSV, TSV, JSON, JSONL
DocumentsMarkdown, plain text, HTML
CodePython, JavaScript, SQL, YAML
ReportsFormatted text summaries

Tips for File Output

Be specific in your task instructions:

Python

Scheduled File Generation

Combine files with scheduling to produce regular reports:

Python

Attach Files to Runs (Coming Soon)

Direct file upload to provide context for runs (spreadsheets, documents, images) is coming soon. This will let you attach files when creating a run so the teammate can read and process them.

What's Next

  • Runs — run execution and output
  • Scheduling — automate file generation on a recurring schedule
  • Streaming & Events — monitor file generation progress in real-time