Share via


Connect to an existing Copilot Studio agent

To connect your main agent to another Copilot Studio agent, the other agent must be:

To connect an existing agent to your agent:

  1. Go to the Agents page for your main agent and select Add an agent.

  2. Under Connect to an external agent, select Copilot Studio from the available agent types.

    Screenshot showing selecting add Copilot Studio agent option

  3. Select the desired agent from the list of available Copilot Studio agents. The agent's name, instructions, and description appear.

  4. Adjust the description (if needed) to make it more contextual for the main agent. Make the description more specific if you have other tools or agents where the descriptions might overlap. We recommend you update the description to ensure Copilot Studio can understand when to invoke the second agent. To learn more, see writing effective metadata.

  5. If you want to prevent conversation history from being passed to this agent when another agent calls it, clear the Pass conversation history to this agent box. This method limits the information being passed to the agent to just the explicit task that the main agent wants the other agent to complete.

Note

If you make changes to a connected agent, be sure to publish those changes. Your main agent can only use the latest version of a connected agent after that agent is published. Also, keep in mind that once an agent is connected, you control its description locally. Any updates to the connected agent's description doesn't automatically sync with your main agent. You must update the local description manually if you want to reflect those changes or make any other changes.

Make a Copilot Studio agent available for other agents to connect to

By default, any agent can connect another agent in the same environment.

  1. Go to the Settings page for your agent.

  2. Turn on Let other agents connect to and use this one if it isn't.

If you want to prevent other agents from connecting to this agent, turn off this option.