The Compare versions view (/app/assistants/{id}/diff) renders two flow revisions side by side on read-only canvases and colour-codes every node by its change status. Open it from Move → Versions whenever two or more versions exist — a 'Compare versions' button appears in the header.
Colour coding
| Colour | Meaning |
|---|---|
| Green | Added — the node exists only in the newer version |
| Red | Removed — the node exists only in the older version |
| Amber | Changed — the node is present in both but at least one tracked field differs |
| Default | Unchanged — identical in both versions |
Version picker
Two dropdowns at the top of the page let you choose any From version (baseline) and any To version (comparison). Versions are listed with their number, publish status, and timestamp. You can compare any two revisions — they do not have to be adjacent or published.
Summary bar
- Nodes added / removed / changed / unchanged counts.
- Edges added / removed counts.
- A 'No changes detected' banner when the two versions are structurally identical.
Changed-node detail
Hovering an amber (changed) node shows a tooltip listing every field that differs, with both the old and new value. Tracked fields include: type, label, name, intent, message, slot, service, knowledge base, set variable, set value, subflow, condition, code, and metadata. Position changes are deliberately excluded — moving a node on the canvas is not a semantic change.
Compliance & change control
Enterprise (banking / healthcare) deployments use the diff view as a change-control artifact. The Published timestamp on each version appears in the picker header so reviewers can tie a visual diff to a specific release date. The underlying API endpoint (GET /agents/{id}/flow/diff) returns the same data in JSON for programmatic integration with change-management systems.
The diff is purely structural — it compares the flow payload, not conversation logs or analytics. Publish a new version before comparing to capture the latest state of the canvas.
Limitations
- Read-only canvases — you cannot edit nodes directly in the diff view.
- Both versions must belong to the same assistant.
- The canvases are independent — they do not scroll-sync.