---
schema_version: "1"
id: c86e3d72d38292fcf384444e4e37ad393e34d02a170f69fee1deb4815ba5cfa5
title: Create a New Version of an Agent
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/agent_versions_draft.md
canonical_url: https://help.salesforce.com/s/articleView?id=ai.agent_versions_draft.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: f5675130abf08a83a8f2cf72485da162ffe9b89674ed010180b33ac068072a9f
description: 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.
products:
  - Agentforce
  - Cross Cloud
release: "264"
---
# Create a New Version of an Agent

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

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions. <a href="https://help.salesforce.com/s/articleView?id=ai.agent_setup_explore_types.htm&amp;release=264.0.0&amp;type=5" title="Learn about agent types and default templates for specific clouds and common use cases.">Required add-on licenses vary by agent type.</a></td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d134058e78">User Permissions
              Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d134058e78 ">To create an agent version:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d134058e78 ">Manage AI Agents AND <a href="https://help.salesforce.com/s/articleView?id=ai.agent_setup_explore_types.htm&amp;type=5&amp;language=en_US" target="_blank">the required permissions for your agent
                type</a></td>

          </tr>
        </tbody>
      </table>

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.

1. From the Agents page of the Agentforce Studio app, open the agent you want to use to create a draft.
2. 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.
3. 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](https://help.salesforce.com/s/articleView?id=ai.agent_versions_commit.htm&release=264.0.0&type=5 "Commit an agent version to save a snapshot of your agent and prepare your agent for use outside of Agentforce Builder. Your agent version must be committed to activate it."), 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).