Run Playbooks in the Grid
Run a published Playbook across Grid rows and review each Session and Artifact.
Use a Playbook column to run the same published Playbook across rows of structured data. Each run creates a Session, and declared Artifacts stay connected to that Session for review and editing.
How to configure a Playbook column
Open the Grid.
Click + Add Column.
Select the Playbooks tab.
Search for and select a published Playbook.
Map each Playbook Input to a Grid column, static value, or Brand Kit.
Save the column.
If the workspace has no published Playbooks, the Playbooks tab does not have a Playbook to add.
Configuration options
Playbook
The published Playbook that runs for each selected row.
Version
Default follows the current published version. A pinned version keeps using the selected version until you change it.
Input mapping
Connect each Playbook Input to a Grid column, static value, or Brand Kit.
When a new Playbook version changes its Inputs, update the Grid column mappings before running it at scale. Missing required Inputs can make runs fail validation or be skipped.
Run the Playbook
Run the Playbook for one row while testing its Input mappings and output. Once the result is correct, run the Playbook column in bulk across the rows you want to process.
The Grid uses the version and Input mappings configured on the Playbook column. Edits made in a Session apply to that Session's Artifacts, not to the Playbook itself. Open the Playbook editor to change its instructions.
Review Sessions and Artifacts
Each Playbook cell shows its current Session status. Open the cell to review the Session, including:
The Inputs used for the run
The execution log
Every Artifact produced by the Playbook
Human Review status, when the Playbook includes review blocks
You can interrupt a queued or running Session and rerun a terminal Session. When a Session used an older Playbook version, the cell shows a warning so you can rerun it on the current version.
Artifact columns store Playbook Artifacts directly in the Grid. The Grid cell and Session reference the same Artifact, so edits from either location stay in sync.
Example
Run a content refresh Playbook
Add the page URL, target prompt, and any supporting context to separate Grid columns.
Add a Playbook column and select your published content refresh Playbook.
Map the Playbook Inputs to the matching Grid columns and Brand Kit.
Run one row and review its Session and Artifacts.
Correct any Input mappings or update the Playbook instructions.
Run the Playbook column across the remaining rows.
Last updated
Was this helpful?