Lab "Develop a multi-agent solution with Microsoft Agent Framework" - Incompatible with Current Azure AI Foundry API: https://microsoftlearning.github.io/mslearn-ai-agents/Instructions/05-agent-orchestration.html

Question

The lab instructions for "Develop a multi-agent solution with Microsoft Agent Framework" (05-agent-orchestration) are incompatible with the current Azure AI Foundry platform and SDK versions.

Issue Details:

1. Primary Error:

      azure.core.exceptions.ResourceNotFoundError: (404) Resource not found
      
   

   • Occurs when attempting to run agents through the

          AzureAIAgentClient
     

     from

          agent-framework-azure-ai
     

   • The client cannot locate the Azure AI project despite correct credentials and endpoint configuration
2. Root Cause:
   • The lab instructions reference an outdated Azure AI Foundry project endpoint structure
   • Microsoft has transitioned from "Azure AI Foundry project endpoints" to "Azure AI Model Inference endpoints (preview)"
   • The

          AzureAIAgentClient
     

     initialization in the lab no longer works with current Azure AI Foundry projects
3. Steps to Reproduce:
   • Follow the lab instructions exactly as written
   • Configure

          .env
     

     with the current Azure AI Foundry project endpoint which has now been updated to Azure AI model inference endpoint (preview)
   • Run

          python agents.py
     

   • Result: 404 ResourceNotFoundError when agents attempt to initialize

Expected Behavior: The lab should successfully create three agents (summarizer, classifier, action) and orchestrate them sequentially to process customer feedback.

Actual Behavior: The script fails with a 404 error during agent creation, preventing any agent orchestration from occurring.

Requested Actions:

Update Lab Instructions: Provide current, working code examples that are compatible with the latest Azure AI Foundry API and SDK versions

1. Update SDK Documentation: Clarify the correct initialization methods for

      AzureAIAgentClient
   

   with current Azure AI Foundry projects Provide Migration Guide: Document how to migrate from the old endpoint structure to the new Azure AI Model Inference endpoints Test Lab: Validate that all lab steps work end-to-end with current SDK versions before publishing

Additional Notes:

The lab appears to be in active development, as evidenced by beta SDK versions

• Consider adding version compatibility notes to the lab prerequisites
• The error message (404) could be more descriptive to help students troubleshoot endpoint configuration issues

Answer 1

Hi Heeyaichen Konsam

I am facing a different error at my side.

"AzureAIAgentClient does not have attribute create_agent"

Could you please create an issue in GitHub itself.

https://github.com/MicrosoftLearning/mslearn-ai-agents/issues

Attached updated documentation from Foundry Classic/New for reference

1. Foundry Classic Agent creation
2. Foundry new Agent Creation

Thank you