Versioning & promotion
By the end of this page you will understand how to create versions of your Task Agent, compare changes between versions, and promote a version to production.
Prerequisites
- A Task Agent with a working graph (Test the agent).
- Admin or Developer role.
How versioning works
Every Task Agent starts at v1 in DRAFT status. When you’re satisfied with a version, you promote it to PRODUCTION. To make further changes safely, you create a new version — this copies the current graph into a new draft while production traffic continues on the previous version.
The version lifecycle:
v1 DRAFT → v1 PRODUCTION → v2 DRAFT → v2 PRODUCTION → ...The current version and its status are always visible in the Agent Builder toolbar (e.g., “v1 • PRODUCTION”).
Viewing versions
Open the Versions panel
In the Agent Builder toolbar, click the Versions button (shows the count, e.g., “Versions (1)”). A side panel opens on the right showing all versions.
Each version entry displays:
- Version number (e.g., “Version 1”)
- Status badge (DRAFT or PRODUCTION)
- Timestamp (creation date and time)
- Currently editing indicator (if this is your active version)
Switch between versions
Click any version in the list to load it on the canvas. This lets you view or edit that version’s graph.
Creating a new version
Click Create New Version
At the bottom of the Versions panel, click Create New Version. A new version is created as a copy of the currently selected version.
Edit the new version
The canvas now shows the new version in DRAFT status. Make your changes — add nodes, modify configurations, update prompts — without affecting the production version.
Production traffic continues to use the promoted version while you edit the draft. Your changes are isolated until you explicitly promote.
Save your changes
Click Save to persist your edits to the draft version.
Promoting a version
Promotion moves a DRAFT version to PRODUCTION status, making it the active version for all traffic.
Ensure the version is saved and tested
Before promoting, save all changes and run a test execution to verify correctness.
Click Publish
In the toolbar, click the Publish button (only enabled when the agent is saved). Confirm the promotion in the dialog.
The version status changes from DRAFT to PRODUCTION, and the toolbar updates to show the new status.
Promotion is immediate. The previous production version becomes inactive. If issues arise, you can create a new version from the previous one and promote it (see Rollback below).
Rolling back
There is no dedicated “rollback” button. To revert to a previous version:
- Open the Versions panel.
- Select the previous production version.
- Click Create New Version (this copies the old graph into a new draft).
- Promote the new draft to production.
This gives you a full audit trail — every version is preserved and you can always trace what changed.
Common issues
- “Save changes before publishing” — The Publish button is disabled when there are unsaved changes. Click Save first.
- “Cannot edit production version” — Create a new version to make changes. Production versions are immutable once promoted.
- Lost changes after switching versions — Unsaved changes are discarded when you switch versions. Always save before switching.