Running & Control

2. Running & Control

• Execution & control → Manual vs batch runs, tracking, error recovery.

• Error handling → Schema detection, invalid uploads, error messages.

---

Execution & Control

Execution defines how AI Skills run in a Sheet and how users control that process.

Feature	Details
Manual run	Users can run AI Skills on a single row or a selection of rows at any time.
Batch run	Users can execute AI Skills across all rows in a Sheet. Progress is tracked row by row until completion.
Flexible control	Runs apply either to one row or to the entire Sheet; partial runs are not supported beyond selecting rows manually.
Live progress	While running, a progress indicator shows which rows have completed, failed, or are still processing.
Stop & resume	Users may stop a batch run mid-way. Already completed rows remain, while unprocessed rows can be re-run later.
Editing during run	Columns and rows cannot be edited while a batch run is active. Edits can resume once the run is finished or stopped.
Error rows	Failed rows show an error icon. Errors can be retried individually or after fixing schema/connection issues.

Error Handling

AI Sheets provide clear signals when uploads, schema detection, or AI Skill runs fail.

Scenario	Behavior	Resolution
Invalid CSV schema	Upload fails if the file is not in CSV format or exceeds supported size/row count.	Reformat the file as CSV, reduce its size, or split into multiple uploads.
Mismatched fields	Columns that cannot be mapped default to Text type.	Manually update the column type after creation.
Row execution error	Failed rows display an error icon in the AI Skill column.	Double-click the icon to view the error. Retry the row after fixing the issue.
Connection missing	AI Skill fails if it requires an integration that isn’t connected.	Connect the required integration in Settings → Integrations.
Permission denied	Action blocked if the user does not have edit/run permissions.	Request elevated access or have an admin re-run the skill.
Timeout or partial run	Long-running batch runs may timeout. Completed rows remain; pending rows fail.	Re-run failed rows individually or restart the batch run.