Remove a Subagent from Your Agent
Make sure that your agent continues to deliver helpful and relevant responses by removing subagents you no longer need.
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 remove a subagent from an agent: | Manage AI Agents AND the required permissions for your agent type |
To make changes to your agent, it must be in a draft state. If you want to make changes to a committed agent version, create a draft.
These steps cover how to remove a subagent from an agent in Canvas view, but there are a few ways to remove a subagent in Agentforce Builder.
- Ask Agentforce to remove a subagent for you. You can accept or decline any changes.
- Remove the subagent in Script view.
- From the Agents list in the Agentforce Studio app, open the agent you want to remove a subagent from.
- From the Explorer panel, under Subagents, hover over the subagent you want to remove from your agent.
-
Click
, and then click Delete.
-
Delete any references to the subagent from other subagents, including the Agent Router.
The subagent is automatically removed from the Agent Router's reasoning actions.
- Save your changes.
The subagent and any associated actions are removed from your agent, and any customizations you made to the subagent are deleted. If you added the subagent to your agent from the asset library, an independent copy of that subagent was added to your agent. Removing the subagent from your agent doesn’t delete the subagent from the asset library.

