Create multiple versions of an agent to seamlessly iterate on your agent’s design. Create a version to experiment with different instructions, subagents, or actions and preserve your current configuration. Or create a version to save as a backup, so you can revert quickly.
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 create an agent version: | Manage AI Agents AND the required permissions for your agent type |
You can only create a draft from a committed agent version. When you create a draft, the new version is editable until you commit it. Only one version of an agent can be active at a time.
When you create a draft from a committed agent version, its assets are cloned so that every agent and agent version has its own assets. These assets include:
- System messages
- Subagents, including standard subagents, custom subagents, and customizations you've made to standard subagents
- Actions, including standard agent actions, custom agent actions, and customizations you’ve made to standard agent actions
- Variables, output mappings, and input assignments
Versioning of subagents and actions isn’t supported. Changes you make to a custom subagent or action apply to only the agent and version to which they’re assigned.
- From the Agents page of the Agentforce Studio app, open the agent you want to use to create a draft.
- If there are multiple versions of your agent, from the header in Agentforce Builder, select the agent version you want to create a draft from.
-
Click New Draft.
If you don’t see the New Draft button, your agent version is in a draft state. To create a new draft, commit the current agent version, and then create a draft. Keep in mind that when you commit an agent version, you can no longer make changes to it, but you can edit the new version you create from it.
Your draft version opens in Agentforce Builder. The new version inherits the name of the agent you created it from and is appended with the next sequential number (for example, if you clone My Agent - 3, your new version is named My Agent - 4).