Loading
Agentforce and Einstein Generative AI
Table of Contents
Filter by (0)Add
Select Filters

          No results
          No results
          Here are some search tips

          Check the spelling of your keywords.
          Use more general search terms.
          Select fewer filters to broaden your search.

            Search all of Salesforce Help
            Search all of Salesforce Help
            Create a Custom Subagent

            You are here:

            1. Salesforce Help
            2. Docs
            3. Quickstart Your Einstein Generative AI Solution

            Create a Custom Subagent

            You can create a custom subagent from the asset library or from within an agent in Agentforce Builder. When you create a subagent from the asset library, it’s available to add to multiple agents and versions. When you create a subagent from within an agent in Agentforce Builder, it’s available only to that agent.

            Required Editions

            Available in: Lightning Experience
            Available in: Enterprise, Performance, Unlimited, and Developer Editions. Required add-on licenses vary by agent type.
            Note
            Note Beginning in April 2026, agent topics are now called subagents. There are no changes to functionality. During this transition, you may see a mix of the new and previous terms in our documentation.
            User Permissions Needed
            To create a custom subagent: Manage AI Agents AND the required permissions for your agent type

            Create a Custom Subagent in Agentforce Builder

            When you create a subagent from an agent in Agentforce Builder, it’s available only to that agent. Any changes you make apply only to this agent version. To make a subagent available to add to other agents and agent versions, create it in the asset library instead.

            To make changes to your agent, it must be in a draft state. If you want to make changes to a committed agent, create a new draft.

            Note
            Note

            These steps cover how to create a subagent in Canvas view, but there are a few ways to create a subagent in Agentforce Builder.

            • Ask Agentforce to create a subagent for you. Provide the details about the job you want your agent to be able to do, and Agentforce generates a subagent and actions for you. You can accept or decline any changes.
            • Create a subagent in Script view.
            1. From the Agents list in the Agentforce Studio app, open the agent you want to add a subagent to.
            2. From the Explorer panel, hover over Subagents and click Plus sign icon.
            3. Select Create new subagent.
            4. Give the subagent a name, and then click Create and Open.
              Your custom subagent is added to your agent. If you use the Agent Router to control subagent routing and classification, your subagent is added to the Agent Router’s actions available for reasoning.
            5. Edit your description, reasoning instructions, and actions available for reasoning. Make sure to save your changes.
            6. Optionally, add an action to your subagent.
              1. From the Explorer panel, hover over your subagent, and then click Plus sign icon.
              2. Add one or more actions from the asset library, or create a custom action.
                When you add an action from the asset library, always review and customize the action to meet your business needs, including the underlying flow, prompt template, or other reference action.
              3. Reference the action in your subagent's reasoning instructions, actions available for reasoning, or both.
                Your action is automatically added to actions available for reasoning.

            Your subagent is available only in this agent version and isn’t available in the asset library. Any changes you make to the subagent apply only to this agent version and don’t affect other agents. If you change the name of your subagent, manually update any references to the subagent in the Agent Router or any other subagents.

            Create a Custom Subagent from the Asset Library

            Create a custom subagent from the asset library to make your subagent available to multiple agents and versions. Then add it to one or more agents.

            1. From Setup, enter Agentforce Assets, and then select Agentforce Assets.
            2. From the Subagents tab, click New Subagent.
            3. Complete all required fields. You must add at least one subagent instruction. Optionally, to use AI to evaluate your subagent fields and suggest improvements, click Gen AI sparkle icon. Then click Next.
              Currently, subagents created in the asset library follow the style of subagents in the legacy Agentforce Builder. For information about the parts of a subagent and best practices for subagent instructions, see Subagents in the Legacy Builder. The subagent is supported for agents created in either builder and can be customized after you add it to an agent.
            4. Select the actions from the asset library that you want to add to your subagent, and then click Finish.

            Your subagent is available in the asset library. To use your subagent, add it to an agent.

            When you add a subagent to an agent from the asset library, a copy of the subagent is added to your agent, and you can edit this copy. Any changes you make to the subagent apply only to this agent version and don’t affect other agents or the subagent in the asset library.

            Any changes you make to the subagent in the asset library aren’t synced to any copies of the subagent you’ve added to agents. To apply changes made to a subagent in the asset library to an agent, add the updated subagent to the agent.

             
            Loading
            Salesforce Help | Article