Manage Agent Versions in the Legacy Builder

Create multiple versions of an agent to make and test changes without taking the active version out of production. Or create a version to save as a backup, so you can quickly revert to a previous version. When you create a new version of an agent, Salesforce creates independent copies  of the agent's subagents, actions, and other assets. Every agent and agent version has its own assets, and assets aren't shared.

Required Editions

Available in: Lightning Experience
Available in: Enterprise, Performance, Unlimited, and Developer Editions. Required add-on licenses vary by agent type.
User Permissions Needed
To manage versions of AI agents: Manage AI Agents AND the required permissions for your agent type

You can create up to 20 versions of an agent. Only one version of an agent can be active at a time. If you’ve reached the limit, delete older versions before cloning new ones.

If cloning fails, check that you’re not at the 20-version limit, that you’ve saved all changes, and that you have the correct permissions.

When you clone a version of an agent, its assets are also cloned, so that every agent and agent version has its own assets. These assets include:

Versioning of standard and custom subagents and actions isn’t currently supported. Changes you make to a custom subagent or action apply to only the agent and version to which they’re assigned.

Each new agent version, including the agent version's assets, is an independent copy of the version you cloned.

  1. From the Agentforce Agents Setup page, in the list of agents, expand the agent row to see its versions. Click the dropdown for the agent you want to clone or delete.
  2. To create an agent version, from the right dropdown for the version you want to duplicate, select Clone Version. To delete an agent version, select Delete.

You can quickly switch between agent versions in Agentforce Builder and on the Details page for your agent.