Cell types
| Cell kind | Where it appears | Behavior |
|---|---|---|
| Text cell | Text columns | Stores editable input, labels, metadata, expected output, or notes. |
| Computed cell | Prompt, code, assertion, extraction, comparison, helper, composition, and other computed columns | Stores an output and a run status. |
Cell statuses
| Status | Meaning | What to do |
|---|---|---|
QUEUED | Work has been scheduled but has not started. | Wait, or cancel the operation if it was queued by mistake. |
DISPATCHED | Work has been sent to a worker. | Wait, or cancel if needed. |
RUNNING | Work is actively executing. | Wait, inspect progress, or stop the run. |
COMPLETED | The cell has a completed output. | Use the result, score it, or inspect it. |
FAILED | The cell run failed. | Open the cell, inspect the error, fix inputs or config, then rerun. |
STALE | The cell has an old output that no longer matches current inputs or configuration. | Rerun before trusting the result. |
QUEUED, DISPATCHED, and RUNNING are pending statuses.
Stale cells
A computed cell becomes stale when a dependency changes, such as a source value, source mapping, column configuration, rerun output, or composition source. Stale cells are highlighted so you can rerun only the work that needs refreshing.
Run scopes
Run the smallest scope that matches what changed.| Scope | Use when |
|---|---|
| Table or sheet run | You want to refresh the sheet broadly, usually after a large import or configuration change. |
| Column run | One computed column changed and should be recalculated across rows. |
| Row run | One or more rows changed and should be refreshed across computed columns. |
| Selected cell run | You want to rerun a specific set of computed cells. |
| Stale-cell run | You want to refresh only outputs marked stale. |
Run selected rows or cells
Select rows or computed cells to run a smaller slice of work. This is useful when only a subset of inputs changed or when you are debugging a few failing examples.Stop or cancel work
Stop or cancel work when a run was started by mistake, the configuration is wrong, or a long-running column should be interrupted. Cancellation is only useful while cells are queued, dispatched, or running.Inspect cells
Open computed cells to inspect outputs, errors, execution details, or prompt request details. Use failed cells to debug configuration or source data, and use stale cells to decide what needs rerunning before scoring.Update cells through the API
Use the API when a job, script, or external workflow should add rows, edit cells, or queue recalculation.Get cell
Read a specific cell.
Update cell
Update an editable cell value.
Recalculate cell
Queue recalculation for a cell.
Create operation
Queue broader row, column, cell, or stale work.