# Batch Run

### What is the Batch Run Interface?

The **Batch Run** Interface is an interface where you can run multiple executions in one go. This interface is particularly useful when you have a list of inputs you want to run your flow on, and you do not want to run them one at a time. This interface is similar to the Chat Assistant, but instead of one input, you can run many all at once using a CSV file.

With the Batch Run Interface, you will be able to:

* Upload a CSV with all the inputs for the executions you want to run
* Run all the executions in the CSV
* Export the results as a CSV file
* Run individual executions if required (go to the input you want and click Run there)

Here are a few quick facts:

* The inputs can be text fields of any length.
* Multiple inputs can be run at once if appearing in the flow (in-0, in-1, etc.).
* Multiple outputs can be generated as well for each execution (out-0, out-1, etc.).
* Inputs can only be text for now.
* Multiple runs are executed in parallel, optimizing the overall latency.

<figure><img src="/files/TbUB1Lpdb4FYHUjQLywg" alt=""><figcaption></figcaption></figure>

### Uploading a CSV

On the to left side of the **"Batch run"** page you will find the button to upload a CSV file with the inputs for the executions you want to run. You can also add inputs manually by clicking on "Add Run".

IMPORTANT: include a header in your CSV with the name of the inputs so that the system can recognize them.

Click on the "Run Batch" button to run all the executions in the CSV.

Once the executions are done, you can also download the results as a CSV file.

### Bulk Upload

If you have a Files Node connected as input, you can expose it as an input to bulk upload a set of files, and do multiple simultaneous runs on you file inputs. To do this:

1. Make sure a Files Node is connected as an input.
2. In the Batch Export interface, expose the input on the right side.
3. You will now see the 'Bulk Upload' option available.
4. Upload a set of files.&#x20;

<figure><img src="/files/HsTJwXiV9jxrPxLqSS0k" alt=""><figcaption></figcaption></figure>

### Chat with Table

The Chat with Table feature lets you have a conversation with an AI assistant about your batch results. Ask questions, summarize outputs, find patterns, or analyze specific runs without leaving the Batch interface.

#### How to use it

1. Run your batch (or load existing results).
2. Open the options menu (top right) and click "Chat with Table".
3. The screen splits: your batch table on the right, a chat assistant on the left.
4. Start asking questions about your results.

<figure><img src="/files/zixbLII78ILcIkS24v7z" alt=""><figcaption></figcaption></figure>

#### Filtering the data sent to the chat

By default, the assistant has access to all runs in your table. If you want to focus on specific rows:

1. Click the checkbox on any row to select it. You can select multiple rows.
2. A banner will appear showing how many runs are selected for chat.
3. Only the selected runs will be sent to the assistant.

To go back to using all runs, simply deselect all rows.

<figure><img src="/files/uxlyzwLf41C1ygPX65RC" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.stackai.com/interface-and-deployment/end-user-interfaces/batch-run.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.