Skip to main content
Asteroid agents can work with files in multiple ways, enabling them to download files from websites, read various file types, and upload files to web applications. These capabilities are available through specialized tools in the AI Agent node. Files can also be downloaded via the API.

File Downloads

Automatically download files from websites during browser automation

File Reading

Read and process images, PDFs, CSVs, and other file types

File Uploads

Upload files to web forms and applications

API Access

Programmatically manage files through the Asteroid Odyssey SDK

​
File Downloads

Your agents can download files from websites during browser automation sessions. Downloaded files are stored in the execution context and can be accessed through the agents tools.
Downloaded files appear in the Files section at the top right of the screen

​
File Reading

Asteroid agents can read and process various file types.

​
Supported File Types

  • Images (PNG, JPEG)
  • PDFs
  • Text Files (TXT, MD)
  • CSVs

​
File Uploads

Agents can upload files to web applications using the Upload File tool, which supports:
  • Local file uploads
  • Previously downloaded files (using downloads/filename format)

​
API Access

File upload and downloads are also available programmatically through the Asteroid Odyssey SDK:

​
Upload Files

// Upload files to an execution
const result = await uploadExecutionFiles(client, executionId, files);
console.log(result.file_ids);

​
Download Files

import { AsteroidClient, getExecutionFiles, downloadExecutionFile } from 'asteroid-odyssey';

const client = AsteroidClient('YOUR_API_KEY');

// Get list of execution files
const files = await getExecutionFiles(client, executionId);

// Download specific files
for (const file of files) {
  const savedPath = await downloadExecutionFile(client, file, './downloads/');
  console.log(`Downloaded ${file.fileName} to ${savedPath}`);
}

​
Use Cases

File handling capabilities enable powerful automation workflows:
  • Document Processing: Automatically download and analyze reports, invoices, or forms
  • Data Extraction: Process CSV files, spreadsheets, and structured data
  • Image Analysis: Download and analyze screenshots, charts, or visual content
  • Form Automation: Upload documents, images, or files to web applications
  • Content Management: Handle file uploads for content creation workflows
⌘I