---
schema_version: "1"
id: b756f6ab81489696c2591089ca7ca49e49fb497853598fde2ba4c50e353dfaa8
title: Agentforce Agent Migration Guide
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/agent_migrate_parent.md
canonical_url: https://help.salesforce.com/s/articleView?id=ai.agent_migrate_parent.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 2ac21bd6811ce133d4fb2c7f1b24d3232d9d46e4ccf4582932a0761d83f472e0
description: If you’re an Agentforce customer using agents you built in our legacy builder, this guide is for you. It’s a centralized resource for migrating your existing agents from the legacy Agentforce Builder in Salesforce Setup to the new Agentforce Builder in the Agentforce Studio app. It helps you decide if, why, and how to migrate, and it covers the tools and guidance you need to make your migration cost- and time-effective. Use it to go from a prompt-based, sometimes unpredictable agent to a precise, reliable agent that reasons when it has to and just gets things done when it doesn’t.
products:
  - Agentforce
  - Cross Cloud
release: "264"
---
# Agentforce Agent Migration Guide

If you’re an Agentforce customer using agents you built in our legacy builder, this guide is for you. It’s a centralized resource for migrating your existing agents from the legacy Agentforce Builder in Salesforce Setup to the new Agentforce Builder in the Agentforce Studio app. It helps you decide if, why, and how to migrate, and it covers the tools and guidance you need to make your migration cost- and time-effective. Use it to go from a prompt-based, sometimes unpredictable agent to a precise, reliable agent that reasons when it has to and just gets things done when it doesn’t.

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

- **[Decide Whether to Migrate and When](https://help.salesforce.com/s/articleView?id=ai.agent_migrate_decide.htm&release=264.0.0&type=5)**  
    The question isn’t whether to move to the new Agentforce Builder. It’s when to get started and what to bring with you.
- **[Preparing to Migrate](https://help.salesforce.com/s/articleView?id=ai.agent_migrate_prepare.htm&release=264.0.0&type=5)**  
    Before you begin, familiarize yourself with the new Agentforce Builder and Agent Script, learn how the upgraded reasoning engine works, and explore migration tools to choose the approach that works best for you.
- **[Planning and Designing for Agent Script](https://help.salesforce.com/s/articleView?id=ai.agent_migrate_plan_design.htm&release=264.0.0&type=5)**  
    Before migrating, spend time designing your subagent instructions and conversational flow. The level of time and effort varies depending on what tools you plan to use to migrate, the complexity of your agent, and how well your agent performs today. This prep helps you determine what parts of your agent can be migrated directly with no changes and what parts are candidates for redesign. It also prepares you to make deliberate decisions about where to introduce determinism in your new agent, so you can improve your agent strategically instead of reactively.
- **[Implementing Your Migration](https://help.salesforce.com/s/articleView?id=ai.agent_migrate_implement.htm&release=264.0.0&type=5)**  
    With your tools selected and your Agent Script improvement plan in place, it’s time to migrate. Take a staged and iterative approach to make your migration easier to manage, test, and troubleshoot. Get tips for working effectively with testing tools, third-party AI tools, and your team.