Files

Teammates can generate files during runs — CSV reports, JSON exports, markdown summaries, 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

Generate Files

Tell the teammate what to produce in the task instructions:

List and Download Files

Track File Generation via Streaming

Use the streaming events to see when files are being written in real time:

Python

Weekly Report Pipeline

Combine file generation with scheduling for recurring reports that always arrive on time:

Python

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

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
  • See examples/file-report.py for a full pipeline: streaming progress, scheduled generation, and download