Versioning & promotion
By the end of this page you will understand how AI Agent versions work, and how to create, duplicate, and discard drafts safely.
Prerequisites
- An AI Agent you’ve configured and tested (Test the agent).
- Admin or Developer role.
How versioning works
Every AI Agent has versions, each in one of four states:
| State | Meaning |
|---|---|
| DRAFT | Work in progress; safe to edit. |
| READY | Prepared for promotion. |
| PRODUCTION | The live version serving traffic. |
| DEPRECATED | Retired. |
When you click Save, your changes are written to a draft version. If you were viewing a PRODUCTION or READY version, Save creates a new draft from it — so production keeps running unchanged while you edit. The editor automatically opens the draft when one exists.
The header always shows the current version and its state (for example, v2 • DRAFT), plus a Prod: badge when a production version exists.
The Versions panel
Open the Versions panel
In the header, click Versions (it shows a count). A panel lists every version with its number, state badge, last-updated time, changelog, and a “Currently editing” marker on the active one.
Switch versions
Click any version to load it in the editor.
Unsaved changes are discarded when you switch versions. Save first.
Create, duplicate, and discard
- Create New Version — at the bottom of the Versions panel, creates a fresh version to work in.
- Duplicate as New Version — in the overflow ⋮ menu, copies the current configuration into a new version (changelog “Duplicated from v…”).
- Discard Draft — in the overflow menu (only when a DRAFT exists alongside a production version), permanently deletes the draft and reverts to production.
Discard Draft cannot be undone. It deletes the draft version and reverts to the production version. A confirmation dialog spells out which versions are affected.
From draft to production
Editing happens on a draft; making it live is publishing. Save and test your draft, then promote it — see Publish.
Common issues
- My edits went into a new version — That’s expected: editing a production/ready version creates a draft so production is never modified in place.
- Lost changes after switching versions — Unsaved changes are discarded on switch. Always save first.
- Can’t find Discard Draft — It only appears on a DRAFT when a production version exists to revert to.