---
schema_version: "1"
id: 1922bcf53f3fd111fb393943c6bf8fcb25f2b30c024902d6973239a62b63c1e6
title: Versioning and Editing Agents
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/agent_versions_lifecycle.md
canonical_url: https://help.salesforce.com/s/articleView?id=ai.agent_versions_lifecycle.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 411951a83b0388db09509390ef57fca95f84d8a88313b7bbf49703bb06750aed
description: Learn about the different states of agents as you create and iterate on your agents, including editable states and how to version your agent.
products:
  - Agentforce
  - Cross Cloud
release: "264"
---
# Versioning and Editing Agents

Learn about the different states of agents as you create and iterate on your agents, including editable states and how to version your agent.

### 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>

1\. Create an agent

When you create a new agent or a new agent version, you create an editable draft of your agent.

2\. Modify your agent and test your changes

As you build your agent, you make changes and save them as you go. Every time you save your changes, you’re saving changes to the current agent version, and you can continue editing it.

At this point, your agent is in a draft state. You’re in the process of making lots of changes or one or more major changes, so you want to be able to make and test your changes quickly.

In the Preview panel, simulate your agent’s behavior with mock data or live test your agent’s behavior with real data in your org. Previewing your agent gives you a detailed, step-by-step trace of your agent's interactions and processes. You can also dive deeper with detailed tracing and debugging, so you can make informed, precise fixes.

When your agent is in a draft state, you can’t activate it.

3\. Commit and activate your agent

When you’re satisfied with your agent’s design and performance, it’s time to commit your agent. Then when you’re ready, [activate your agent](https://help.salesforce.com/s/articleView?id=ai.copilot_setup_activate_deactivate.htm&release=264.0.0&type=5) for your customers or employees.

If you’re familiar with Git, committing an agent version is similar to committing a change. Committing an agent version saves a snapshot of your agent version to metadata. This makes it available to activate.

After you commit an agent version, you can no longer make changes to that agent version.

4\. Create a draft to version your agent and continue editing

To iterate on your agent after you’ve committed a version, [create a draft](https://help.salesforce.com/s/articleView?id=ai.agent_versions_draft.htm&release=264.0.0&type=5 "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."). Creating a draft creates a new, editable version of your agent. Your draft can be edited until you commit it.

As you iterate on an agent, it’s common to create many agent versions. In Agentforce Builder, you can switch between versions from the dropdown menu in the header.

- **[Commit an 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.
- **[Create a New Version of an Agent](https://help.salesforce.com/s/articleView?id=ai.agent_versions_draft.htm&release=264.0.0&type=5)**  
    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.
- **[Compare Agent Versions](https://help.salesforce.com/s/articleView?id=ai.agent_versions_compare.htm&release=264.0.0&type=5)**  
    Compare multiple versions of an agent and copy improvements from one agent version to another. You can accept or decline changes individually or all at once.
- **[Delete an Agent or Agent Version](https://help.salesforce.com/s/articleView?id=ai.agent_versions_delete.htm&release=264.0.0&type=5)**  
    Delete an agent or agent version to remove it entirely from Agentforce Builder. You can’t recover the agent after its deleted.