SDK v2 Migration & Deadlines — The Foundry SDK
[ ABORT TO HUD ]
SEQ. 1
SEQ. 2
SEQ. 3
SEQ. 4
SDK v2 Migration & Deadlines
Critical Migration Guide
The azure-ai-projects v2.0.0 GA release introduced breaking changes that require attention from all existing Foundry developers.
Breaking Changes Summary
| Change | Before (v1.x) | After (v2.x) |
|---|---|---|
| Agent Package | Separate azure-ai-agents | Removed - agents live in azure-ai-projects |
| Client Init | AIProjectClient.from_connection_string() | Removed — pass endpoint URL + DefaultAzureCredential() |
| Agent Creation | create_agent() + create_and_process_run() | agents.create_version() (PromptAgentDefinition) + openai_client.responses.create() |
| Thread Concept | Threads | Replaced by Conversations |
| Tool Classes | Old names | Suffixed with Tool (GA) or PreviewTool |
| Tracing Spans | Custom names | OpenTelemetry gen_ai.* conventions |
| Protocol | Assistants API | OpenAI Responses API protocol internally |
Critical Retirement Deadlines
| Deadline | What's Retiring | Action Required |
|---|---|---|
| August 26, 2026 (Deprecated May 2025) | azure-ai-inference beta SDK & /models endpoint — RETIRED (410 Gone) | Migrate to the standard openai v1 SDK (/openai/v1/ via project.get_openai_client()) |
| June 30, 2026 | AzureML SDK v1 | Migrate to azure-ai-projects v2 |
| August 26, 2026 | Assistants API | Rewrite agents using Foundry Agent Service |
Migration Checklist
pip uninstall azure-ai-agents # Remove old package pip install "azure-ai-projects>=2.0.0" # Install unified SDK # Update: Threads → Conversations # Update: Tool class names (add Tool/PreviewTool suffix) # Update: KQL dashboards for new gen_ai.* span names
🚧 Important: The
allow_preview boolean on the AIProjectClient constructor replaces previous per-method feature flags. Set it to True to access preview features like Memory Service and MCP Server.⌨ HANDS-ON LABVerify azure-ai-projects SDK Version
⭐ +150 XPEnsure deprecated legacy packages (azure-ai-ml v1) are replaced with the unified v2 azure-ai-projects SDK.
1Check installed azure-ai packages via pip list.
OBJECTIVE 1 / 1 — type "hint" if stuck
FOUNDRY VERIFICATION
QUERY 1 // 2
When does the Assistants API sunset on Azure?
December 2025
May 30, 2026
August 26, 2026
Never