Run Agents from Sheets

Profound Sheets lets you run Agent workflows across large sets of inputs simultaneously. Rather than triggering Agents one input at a time, Sheets lets you process hundreds or thousands of inputs in parallel.

Sheets_Gif.gif

Adding an Agent to a Sheet

To add an Agent to a Sheet:

  1. Click + Add Column in the top right of the Sheet header.

  2. From the column type menu, select Agent.

  3. Select which Agent you want to run.

Screen Shot 2026-04-03 at 12.30.29 PM.png

The Agent column appears in the Sheet grid alongside your other columns. Each row in that column displays a Run button, indicating the Agent is ready to process that row's input when triggered.


Run Agent from Sheet

Single run

To run an Agent on a single row, click the Run button within that row's Agent column cell. The Agent processes that row's input and returns its output directly in the cell once complete.

Screen Shot 2026-04-03 at 12.00.59 PM.png

The cell status updates to show it's running, then displays a green Completed indicator when finished. Single runs are useful for testing your Agent setup on a specific input before committing to a full column run.

Screen Shot 2026-04-03 at 12.01.25 PM.png

Bulk Run

To run the Agent across all rows at once, click Run at the top of the Agent column header. This triggers the Agent for every row with input data in the Sheet simultaneously, processing all inputs in parallel.

Monitor progress as individual cells update their status in real time, moving from Run to a running state, then to Completed as the Agent finishes.

run_agents.gif

Agents only run when the necessary inputs are present. For example, if you have 100 rows but only 13 contain the necessary inputs, the Agent runs for those 13 rows only.


Handle Outputs

Once an Agent run is complete, its output appears directly in the Agent column cell for that row. Add a separate Text or Long text column alongside the Agent column to capture, label, or annotate those outputs.

To use Agent outputs downstream, reference that column's values as inputs in other columns or workflows.