[ ABORT TO HUD ]
SEQ. 1
SEQ. 2
SEQ. 3
SEQ. 4

azure-ai-projects SDK Overview

💻 The Foundry SDK 8 min 70 BASE XP⌨ HANDS-ON LAB

One SDK to Rule Them All

The azure-ai-projects SDK (v2.x) is the definitively unified entry point for all Foundry capabilities. As of early 2026, the legacy azure-ai-agents dependency was completely removed, unifying agents, inference, evaluations, and memory natively under the AIProjectClient.

Installation

LanguagePackageInstall Command
Pythonazure-ai-projectspip install azure-ai-projects>=2.0.0
.NETAzure.AI.Projectsdotnet add package Azure.AI.Projects
JavaScript@azure/ai-projectsnpm install @azure/ai-projects

Key SDK Capabilities

  • Model Inference - Chat completions, embeddings via OpenAI-compatible interface
  • Agent Management - Create, configure, and run AI agents natively
  • Evaluation - Run quality and safety evaluations programmatically
  • Connections - Access linked Azure resources (AI Search, Storage)
🆕 NEW (May 2026): The Foundry Agent Service SDK has been updated to v2.2.0, introducing Preview Skills (reusable agent capability bundles), Toolboxes (unified MCP-based tool management), and MCP endpoint support for connecting agents directly to remote Model Context Protocol servers.
🚧 Important Lifecycle Notice: The legacy AzureML SDK v1 is scheduled for End-of-Life (EOL) on June 30, 2026. All active projects must migrate to the v2 SDK (azure-ai-projects) to maintain support.
⌨ HANDS-ON LABInstall the Foundry SDK Stack
⭐ +150 XP

Set up the Python SDK pair every Foundry project needs: azure-ai-projects for the client, azure-identity for keyless auth.

1Install both azure-ai-projects and azure-identity with pip.
2Log in with the Azure CLI so DefaultAzureCredential can authenticate your code without keys.
lab-sandbox — simulated environment
INFINITY LAB SANDBOX v2.6 — simulated shell
Type the command for the current objective. Helpers: "hint", "solution", "clear".
$
OBJECTIVE 1 / 2 — type "hint" if stuck
FOUNDRY VERIFICATION
QUERY 1 // 2
What is the unified SDK package name for Azure AI Foundry that replaced azure-ai-agents?
azure-openai
azure-ai-projects
azure-cognitive-services
microsoft-foundry