agent-framework/dotnet/samples/02-agents/AgentProviders/Agent_With_AzureAIProject/README.md

New Foundry Agents

This sample demonstrates how to create an agent using the new Foundry Agents experience.

Classic vs New Foundry Agents

Below is a comparison between the classic and new Foundry Agents approaches:

Migration Guide

Prerequisites

Before you begin, ensure you have the following prerequisites:

• .NET 10 SDK or later
• Microsoft Foundry service endpoint and deployment configured
• Azure CLI installed and authenticated (for Azure credential authentication)

Note: This demo uses Azure CLI credentials for authentication. Make sure you're logged in with az login and have access to the Microsoft Foundry resource. For more information, see the Azure CLI documentation.

Set the following environment variables:

$env:AZURE_AI_PROJECT_ENDPOINT="https://your-foundry-service.services.ai.azure.com/api/projects/your-foundry-project" # Replace with your Microsoft Foundry resource endpoint
$env:AZURE_AI_MODEL_DEPLOYMENT_NAME="gpt-5.4-mini"  # Optional, defaults to gpt-5.4-mini