Connect to a Microsoft Foundry agent (preview)

[This article is prerelease documentation and is subject to change.]

You can connect a Microsoft Foundry Agent to your custom agent, allowing it to call this agent to respond to a user or a trigger.

Prerequisites

Before you connect a Microsoft Foundry agent to Copilot Studio, the Foundry agent must have the Activity protocol endpoint enabled. A newly created Foundry agent exposes only the Responses and A2A protocol endpoints by default. If the Activity endpoint isn't enabled, the connection to Copilot Studio fails at runtime with a 400 error. Learn more in Enable incoming A2A on a Foundry agent.

You can currently enable the Activity endpoint only programmatically, by using the REST API or the Python SDK. There's no option to enable it from the Microsoft Foundry portal. Learn more about the enablement procedure in Configure and share your agent.

After you enable the Activity endpoint, the Foundry portal's Endpoints section for the agent continues to show only Responses and A2A. This UI omission is expected and doesn't mean the change failed. The connection to Copilot Studio works after the update is applied.

Connect to a Microsoft Foundry agent

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

2. Under Connect to an external agent, select Microsoft Foundry from the available agent types.

3. Select the desired connection from the list of available connections or create a new connection between Microsoft Foundry and your Copilot Studio agent. To create a new connection, you need to provide the Foundry project endpoint URL.

   Note

   When connecting to Microsoft Foundry agents from Copilot Studio, you can only connect to agents created in the new Microsoft Foundry portal. Connecting to an agent created in the previous portal leads to an error indicating 404 - Version not found.

4. Once your connection is created, select Next.

5. Enter an appropriate Name and Description for your SDK agent. The description should describe the purpose of your Microsoft Foundry agent, allowing your main agent to understand when it should be used. For more information, see writing effective metadata.

6. Enter the Agent Id for the Microsoft Foundry agent you want to connect to.

7. Adjust the description (if needed) to make it more contextual for the main agent. For example, make the description more specific if you have other tools or agents where the descriptions might overlap. Update the description to ensure Copilot Studio can understand when to invoke this agent.

8. Select Add Agent.

9. Once your agent is created, you can test your agent immediately. If you need to adjust the Agent Id later, you can do so from the details page, by selecting your agent from the Agents list.