On this page

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 Skill section  
5. Click the **Bulk Work** button on your target Agent Skill

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.

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.

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.

| query | max_results |
| --- | --- |
| digital marketing trends 2023 | 5 |
| AI developments healthcare | 10 |
| sustainable energy innovations | 7 |

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 Name | Type | Description |
| --- | --- | --- |
| `query` | string | The task prompt or instruction |
| `max_results` | number | Optional. Limits how many results to return |

## What to Try Next

- [Set Work Schedules](/content/docs/agent-deployments/agent-work-schedules/index.html)
- [Chat with Your Agent](/content/docs/agent-collaboration/chat-with-agent/index.html)
- [Deploy an Agent](/content/docs/agent-deployments/overview/index.html)