Connect an Agent as a Subagent (Beta)
Add an agent as a connected subagent to your orchestrator agent. Your orchestrator agent can coordinate efforts among connected subagents, such as delegating tasks and synthesizing results.
Required Editions
Note Multi-Agent Orchestration for Agentforce is a beta service that is subject to the Beta
Services Terms at Agreements - Salesforce.com or a written Unified Pilot Agreement if
executed by Customer. Use of this beta service is at the Customer's sole discretion.
| Available in: Lightning Experience |
| Available in: Enterprise, Performance, Unlimited, and Developer Editions. Required add-on licenses vary by agent type. |
| User Permissions Needed | |
|---|---|
| To add a connected subagent to an orchestrator agent | Manage AI Agents AND the required permissions for your agent type |
Note For customers who didn't participate in the Multi-Agent Orchestration for
Agentforce (Pilot) program, before using an agent with Multi-Agent Orchestration for
Agentforce (Beta):
- If the agent was built using the new Agent Builder, create and activate a new version of it.
- If the agent was built using the legacy Agentforce Builder, upgrade it to the new Agent Builder. See Upgrade an Agent from the Legacy Builder to the New Builder.
To make changes to your agent, it must be in a draft state. To change a committed agent, create a new draft.
- From the Agents list in the Agentforce Studio app, open the agent to which you want to add a connected subagent. This agent serves as the orchestrator agent that coordinates connected subagents.
- From the Explorer panel, click +.
- Select Connect Agent as Subagent (Beta).
- Select one or more available agents that you want your agent to connect to. Select only active agents. Only agents from supported agent types are available. See “Considerations and Limitations (Beta)” in Multi-Agent Orchestration (Beta).
-
Click Add to Agent. Newly connected subagents appear in the Explorer
panel.
If you see Problems with input variables, expand the list and determine whether you want to set or remove each input variable. Change to Script view to make your changes (for example, to delete the
INPUTSblock). Be sure to fix all errors. - Save your work.
-
Configure the description for each connected subagent that you just added. Changes to the
description affected only the connected subagent, within the context of your orchestrator
agent. Changes don’t apply to the underlying reference agent on which the connected subagent is
based.
- In the Explorer, select a connected subagent you want to configure. Accept the defaults or customize settings within the context of your orchestrator agent.
- Configure Basic Information. Specify a descriptive label that’s unique within your orchestrator agent. Provide specific instructions on how to use this connected subagent to complete actions. Customize instructions to this orchestrator agent and use case. If you use the Agent Router for subagent classification, the orchestrator agent uses these details to determine when to route a conversation to the connected subagent, based on the user's question or request.
- Configure Inputs, which represent the context variables that you pass into the connected subagent. For each input, customize the variable description for this orchestrator agent and use case, or accept the default. To configure variable mappings, use the Script view.
- Configure Additional Settings. Change the loading text that’s shown to the user when the orchestrator agent routes the conversation to the connected subagent. This overrides any loading text specified in the underlying reference agent, including loading text for actions.
- If you use the Agent Router, you must add the connected subagent. Go to specify any logic or instructions for routing conversations to the connected subagent. In Canvas view, manually add the connected subagent under Actions Available for Reasoning. Expand Select action, select Connected Subagents, and select the one you added, and save your work. Then access it under Instructions by using the @ symbol.
-
To add determinism to your Agent Router with connected subagents, don’t use the
Transition option. Instead, use other options, such as
If/Else (Conditional). In this case, specify
invokeunder the If condition, type @, expand Actions under Resource Types, then scroll to select the connected subagent you want to invoke. - Save your work.
Did this article solve your issue?
Let us know so we can improve!

