Connect a Microsoft Foundry agent to Copilot Studio

You can connect a Microsoft Foundry agent to Copilot Studio as an external agent, but there are two prerequisites that matter before the connection works reliably.

  1. Access to the agent created in Microsoft Foundry portal.
  2. Setting up the connection to the Project endpoint in Microsoft Foundry

Prerequisites

Before you add the agent in Copilot Studio, make sure you have the following:

  1. A Microsoft Foundry project with an existing agent.
  2. The project endpoint from Foundry.
  3. The agent ID needed by Copilot Studio.

Microsoft Learn documents the requirement here:

If you are already hitting the 400 error, I covered the fix separately in Fix 400 error while using Microsoft Foundry to Copilot Studio.

Step 1: Open Agents in Copilot Studio

In Copilot Studio, open your main agent and select Add an agent.

Add Foundry Agent

Choose Microsoft Foundry as the external agent type.

Step 2: Review the agent details you need

Copilot Studio needs the Foundry connection and the target agent details. Keep the Foundry project endpoint and the target agent information ready before creating the connection.

Step 3: Copy the Foundry project endpoint

In Microsoft Foundry, copy the project endpoint. It should look similar to this:

https://<resource-name>.services.ai.azure.com/api/projects/<project-name>

Use the project endpoint exactly as shown in Foundry.

Foundry Project Endpoint

Step 4: Create a new Foundry connection in Copilot Studio

Back in Copilot Studio, create a new connection when prompted.

Create New Connection

Paste the Foundry project endpoint into the connection dialog. Ensure to append a / at the end of the endpoint, otherwise it won’t work with 400 error or other errors.

Paste Project Endpoint

After the connection is created:

  1. Select the connection.
  2. Enter a name and description for the external agent inside Copilot Studio.
  3. Enter the target agent ID from Microsoft Foundry.
  4. Save the agent.

Agent Details

Step 5: Test the connected agent

Once the Foundry agent is added, test it from Copilot Studio.

If the connection is configured correctly, Copilot Studio can call the Foundry agent and use its description to decide when to invoke it.

test connected agent

Summary

To connect a Foundry agent to Copilot Studio:

  1. Create or identify the Foundry agent.
  2. Copy the Foundry project endpoint.
  3. Create the Microsoft Foundry connection in Copilot Studio.
  4. Enter the target agent details.
  5. Test