Canvas

The Inspector

The step configuration panel: fields and hints, conditional sections, error handling per step, and the Test tab that proves a step on real data.

Click any node and the Inspector opens on the right — the step's whole configuration in one panel.

The Inspector on an AI agent step: fields, hints, groups Fields carry inline hints; related fields group into sections; some appear only when relevant.

Config fields

Each step type declares its own fields — an If has one expression, a webhook has its method and response mode, an agent has its task, prompt, and schema. Three behaviors worth knowing:

  • Hints — the gray line under a field is the contract, not decoration ("a path to a list that already exists in the upstream output"). When a build misbehaves, re-read the hint.
  • Conditional fields — some fields appear only when relevant (the poll interval only under respond-mode choices that poll; the sort key only for reshape's sort task).
  • Templates — most text fields accept {{ payload.field }} / {{ steps.id.output.field }}. Expression fields (if/switch/loop) use payload["field"] brackets instead — the hint always says which dialect the field speaks.

Error handling

Every step has an on error panel: stop the run (default), continue — which adds an error output port you can wire a fallback path to — or retry, then continue. The error port shows up on the node the moment a routing strategy is chosen.

The Test tab

The Inspector's second tab runs just this step:

  • Run now executes the step against its upstream steps' pinned outputs and pins the result — downstream tests then use it. This is the chain the AI's verify loop uses too.
  • Trigger steps open their sample window instead (the webhook URL to curl, the form to submit, the upload drop) so the pin holds a real sample.
  • Steps that send externally (web request writes, app operations) offer a preview — the exact request that would be sent, without sending it.

The pinned output is what {{ payload.* }} autocompletes and path lookups are computed from — test early and the rest of the build gets smarter.

FAQ

Why is a field ignored? Check its hint — some fields only apply with a connection bound (the agent's model picker) or under a particular mode.

Where do I see what this step outputs? Test it once, then the Test tab shows the pinned output; every step's docs page also states the shape.

Where to go next