| title | Create an agent in Microsoft Foundry |
|---|---|
| description | Steps to create an agent in the Microsoft Foundry portal and add an OpenAPI tool. |
| ms.author | cephalin |
| ms.topic | include |
| ms.date | 12/03/2025 |
| ms.service | azure-app-service |
Note
These steps use the new Foundry portal.
-
In the Foundry portal, in the top right menu, select New Foundry.
-
If this is your first time in the new Foundry portal, select the project name and select Create new project.
-
Give your project a name and select Create.
-
Select Start building, then Create agent.
-
Give your agent a name and select Create. When the agent is ready, you should see the agent playground.
-
In the agent playground, expand Tools and select Add > Custom > OpenAPI tool > Create.
-
Give the tool a name and a description. In the OpenAPI 3.0+ schema box, paste the schema that you copied earlier.
-
Select Create tool.
-
Select Save.
Tip
In this tutorial, the OpenAPI tool is configured to call your app anonymously without authentication. For production scenarios, you should secure the tool with managed identity authentication. For step-by-step instructions, see Secure OpenAPI endpoints for Foundry Agent Service.