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
| Language | Package | Install Command |
|---|
| Python | azure-ai-projects | pip install azure-ai-projects>=2.0.0 |
| .NET | Azure.AI.Projects | dotnet add package Azure.AI.Projects |
| JavaScript | @azure/ai-projects | npm 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.