Skip to main content

Agent Bulk Work

Use Bulk Work to run one of your agent’s endpoints across many inputs at once. Whether you're generating summaries, classifying data, or testing prompt variations. This tool lets you scale without writing scripts or calling the API manually.

Why Bulk Work matters

It’s perfect for processing structured inputs like contact lists, user queries, or product data without needing a developer.

Open Bulk Work

  1. Go to Agents
  2. Open the deployed agent you want to use
  3. Find the Tasks tab on the Settings tab in the left sidebar
  4. Go the Agent Skilll section
  5. Click the Bulk Work button on your target Agent SKill
Open Bulk Work screen in the Agents section

Click the Bulk Work button under your chosen agent skill to open the Bulk Work table.

You’ll land in a table where you can add data manually or upload a CSV.

Bulk Work screen showing data added and ready to run

After adding a row manually or uploading a CSV with headers matching the agent skill, the data appears in the Bulk Work table ready for processing.

Add Input Data

You have two ways to supply data:

Option 1: Enter rows manually

  • Click Add Row
  • Fill in values for each required input
  • Add more rows as needed

This is helpful for quick tests or small batches.

Option 2: Upload a CSV file

  • Click Upload CSV
  • Your header row must exactly match the endpoint input names
Header row must match input fields

If the CSV column names don’t match the required inputs exactly, your upload will fail. Double-check spelling and casing.

Bulk Work run in progress after adding data

After uploading a CSV or manually adding rows with headers matching your endpoint, the Bulk Work run will begin processing.

Example Format

Remember, the header rows must match the input fields exactly.

querymax_results
digital marketing trends 20235
AI developments healthcare10
sustainable energy innovations7

Once uploaded, rows will auto-populate into the interface.

Run the Tasks

You can choose to:

  • Click Run on a single row
  • Click Run in Bulk to execute all rows at once

Your agent will process each row and display results inline.

Review the Results

Once complete:

  • Output fields will show directly in the table
  • You can inspect individual results in place
  • Use the Logs Explorer for deeper insight or debugging

CSV Input Reference

Your inputs must match the fields required by the endpoint.

Field NameTypeDescription
querystringThe task prompt or instruction
max_resultsnumberOptional. Limits how many results to return

What to Try Next