Agent Mode
Agent Mode turns the panel into a 24/7 render worker. It keeps watching your connected
data for rows whose status column is ready, renders them one at a time,
and writes the result back into the row. Anyone who can edit the sheet can
queue renders.
The agent is not tied to one sheet or one job. Connect the data of several
unrelated projects at once, and one panel on one machine renders all of them,
whichever job a ready row comes from.
One agent, many jobs
Section titled “One agent, many jobs”Connect as many files, worksheets or views as you need: the agent watches every one of them. Each source is a job of its own:
- Its own columns. Every source is read with its own header row, so a soda campaign and a gym’s social clips can use completely different columns in the same agent session.
- Its own project. A
projectcolumn points each row at its.aep. The agent opens the right project for every row it picks up, whatever source it came from. Switching closes the open project without saving, so save your work before starting the agent. - Its own output.
render-settingsandoutput-modulecolumns give each job its own format, for example ProRes for one client and H.264 for another. - Its own team. Whoever can edit a source can queue renders in it. Each team works in its own sheet and never sees the other jobs.
For example, two worksheets connected to the same agent:
Tint soda ads
| project | comp | output | flavor | status |
|---|---|---|---|---|
D:\Tint\ads.aep |
Ad-9x16 | tint/orange_es | Blood Orange | ready |
Gym class promos
| project | comp | output | coach | status |
|---|---|---|---|---|
D:\Gym\promo.aep |
Promo-1x1 | gym/spin_mon | Ana | ready |
The agent renders both rows, each in its own project, and writes complete
back into each sheet.
Output Path, Footage Path and the template dropdowns are shared by
every source. Give each job its own subfolder in the
output value (tint/..., gym/...) to
keep the renders apart, and use full paths or
links in footage cells when jobs keep their
footage in different places.
All connected sources are of one type: local files, Google Sheets or Airtable. Google Sheets connects up to 10 worksheets.
Running the agent
Section titled “Running the agent”- Connect your data sources: one or many files, worksheets or views.
- Set the Output Path and template dropdowns as for a normal render.
- Click Run Agent.

Sources higher in the panel’s connection list come first, and within a
source, rows are taken from top to bottom. A source further down is only
served once no source above it has a ready row, so put your most urgent job
at the top of the list. The status bar shows a countdown to the next check
for new rows.
Click Stop Agent to stop. A render already in progress finishes first and its row is written back; until then the button reads Stopping….
After Effects must stay open with the panel running: the agent runs inside your panel, on your machine.
Status write-back
Section titled “Status write-back”status value |
Meaning |
|---|---|
ready |
You (or your team) set this. The agent will pick the row up. |
rendering... |
Written by the agent when it starts the row. |
complete |
Written on success. |
sent to watchfolder |
Written on success when watchfolder mode is on. |
error: <message> |
Written on failure, with the reason. |
In the example above, two rows were marked ready. Afterwards the file reads:
| output | flavor | status |
|---|---|---|
| tint_concord-grape_en | Concord Grape | complete |
| tint_blood-orange_es | Blood Orange | complete |
| tint_blue-raspberry_de | Blue Raspberry |
- The
statuscolumn must exist; sources without it are skipped. - Spaces around the word are ignored (
readycounts), but capitals are not:Readyis not picked up. - Each row is marked before it starts, so it renders once. To render it again,
set it back to
ready. - A failed row gets
error: ...and is not retried until you set it back toready. The agent keeps watching for other rows. - With Google Sheets and Airtable, everyone looking at the sheet sees the status change live.
- With delivery information
turned on, the agent also fills in each row’s
br-columns. - If a status cannot be written (for example, a read-only file), the status bar says so and the agent skips that row until you restart it.
Each source has a few specifics: Local Files (keep the file closed in other editors), Airtable (field types and a self-maintaining queue view). With Airtable, status lines name a record instead of a row number; see Airtable row numbering.