Skip to main content

Versioning

Versioning lets you save named snapshots of an agent’s configuration and choose which one is live. A single agent can have many versions, but only Published versions are available to users and integrations.

Statuses & terms​

  • Published — Visible in Interact (Playground) and available through APIs/embeds/integrations; older versions can be (re)published to roll back.
  • Latest — The currently editable saved copy; may or may not be Published. You can also mark an older version as Latest (a new copy is created).
  • Others — All remaining versions; usable in Preview only unless made Latest/Published.

Creating & naming versions​

Use Publish (top-right) → Create Version or Publish to open the version drawer and enter Version name and optional Description. The platform assigns an auto-incrementing Version ID (first saved version is 1, then 2, …; newly created agents start at 0).

  • Create Version: saves a named version (not live).
  • Publish: saves a named version and makes it live.
  • Save agent: manual draft save (useful only if autosave fails).

After either Publish or Create Version, you’re redirected to the Versions tab to review/manage versions.

Enable in the UI​

  • Open your agent → Edit.
  • Click Publish (chevron) → choose Publish, Create Version, or Save agent.
  • Fill the drawer (name & description) → Submit.

Versions tab​

See all versions and their metadata (ID, status, name, description, created/published details) and perform actions from the overflow menu. Possible statuses include Blank, Latest, Published, or Latest, Published.

Actions​

Primary:

  • Published → Export
  • Latest (not Published) → Publish
  • Others → Publish

All actions: View config, Preview, Publish, Set as Latest version (creates a duplicate as the new Latest), Rename, Export, Delete. Deleting a Published version requires publishing another version first.

Integration rules​

To “integrate” an agent (API, Embed, A2A, etc.), it must have at least one Published version.

Only Published agents appear in Sub-Agents pickers and in Agent nodes within Tools (including Conversation mode).

Typical workflows​

  • Ship a change: Edit → Publish → name + describe → Submit → version appears as Published.
  • Stage then ship: Edit → Create Version (review/Preview) → Publish when ready.
  • Rollback: In Versions, open the older version’s menu → Publish.
  • Hotfix while keeping current live: Set an older version as Latest (creates a copy) → fix → Publish.

Best practices​

  • Use clear, searchable Version names (e.g., v1.3 – KB update + new tool caps).
  • Add a short Description of what changed and why.
  • Treat Latest as your working copy; use Publish to control what’s live.
  • Export configs for audits or migrations when needed.

Troubleshooting​

  • Version not showing in Sub-Agents/Agent nodes → It isn’t Published yet.
  • Can’t delete a version → You can’t delete the only Published version; publish another first.
  • Wrong version is editing → Mark the desired one Set as Latest version; a new editable copy is created.

This versioning flow gives you safe drafts, auditable releases, and instant rollbacks—while ensuring only the right configuration is visible to users and integrations.