fix: Feature/upgrade agent framework azure ai projects

[Prachig-Microsoft]

This pull request introduces several improvements and refactors to the agent builder and related developer experience. The most significant changes are a major refactor of the AgentBuilder class to support the new Agent interface (instead of ChatAgent), improved handling of model-specific options, and updates to documentation and dependencies to align with the latest APIs.

Agent Builder and Agent Framework Refactor:

• Refactored AgentBuilder in agent_builder.py to build the new Agent class instead of ChatAgent, updated type hints throughout, improved middleware and context provider handling, and added logic to strip unsupported parameters for reasoning models. Also updated static creation methods and tool typing for compatibility with the latest agent framework. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14]

Dependency and Compatibility Updates:

• Upgraded agent-framework to version 1.3.0 in pyproject.toml and azure-ai-projects to 2.1.0 in requirements.txt to ensure compatibility with new APIs and features. [1] [2]

Code Sample and SDK Usage Updates:

• Updated infra/vscode_web/codeSample.py to use the latest SDK method names and patterns, including new thread, message, and run creation APIs, and improved message handling with the new ListSortOrder. [1] [2]

Documentation Improvements:

• Clarified and updated instructions in LocalDevelopmentSetup.md regarding the use of prerelease dependencies, and improved the process framework guide to reflect new workflow builder usage and simplified test commands. [1] [2] [3]

These changes modernize the agent framework integration, improve developer ergonomics, and ensure the codebase is aligned with the latest SDK and library best practices.## Purpose

• ...

Does this introduce a breaking change?

• Yes
• No

Golden Path Validation

• I have tested the primary workflows (the "golden path") to ensure they function correctly without errors.

Deployment Validation

• [x
  This pull request introduces several important updates to both the documentation and the agent framework codebase, with a focus on upgrading dependencies, improving API clarity, and aligning the code with the latest versions of key libraries. The most significant changes include refactoring the AgentBuilder to support the new Agent class (instead of ChatAgent), updating type annotations for middleware and tools, and revising documentation to reflect these updates and new best practices.

Agent Framework Refactoring and Type Modernization

• Refactored AgentBuilder in agent_builder.py to construct the new Agent class (not ChatAgent), updated type annotations for middleware, tools, and message stores, and added logic to handle model-specific options and reasoning models. This includes new helper functions, improved option handling, and a more robust build process. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14]

Dependency Upgrades

• Upgraded agent-framework to version 1.3.0 in pyproject.toml and azure-ai-projects to 2.1.0 in requirements.txt, ensuring compatibility with the latest features and APIs. [1] [2]

Sample Code and Usage Updates

• Updated infra/vscode_web/codeSample.py to use the new agents.threads, agents.messages, and agents.runs APIs, and improved error handling and message printing to match the upgraded SDK. [1] [2]

Documentation Improvements

• Revised documentation in LocalDevelopmentSetup.md to clarify the need for the --prerelease=allow flag and explain its purpose more clearly.
• Updated ProcessFrameworkGuide.md to reflect the new workflow builder API, showing how to instantiate and chain executors, and simplified the unit test command to remove unnecessary flags. [1] [2]

These changes collectively modernize the codebase, improve developer experience, and ensure alignment with the latest agent framework and Azure SDK conventions.] I have validated the deployment process successfully and all services are running as expected with this change.

What to Check

Verify that the following are valid

• ...

Other Information

[github-actions]

Coverage Report •

File	Stmts	Miss	Cover	Missing
TOTAL	3097	208	93%

report-only-changed-files is enabled. No files were changed during this commit :)

Tests	Skipped	Failures	Errors	Time
588	0 💤	0 ❌	0 🔥	26.549s ⏱️

[github-actions]

Processor Coverage Report •

File	Stmts	Miss	Cover	Missing
src/processor/src/libs/agent_framework
agent_builder.py	223	38	82%	33–34, 40, 44, 53–59, 497, 499, 503, 505, 507, 509, 511, 513, 515, 521, 523, 525, 527, 838, 840, 842, 844, 846, 848, 850, 852, 854, 856, 862, 864, 866, 868
agent_framework_helper.py	77	6	92%	82, 149, 173, 195, 218, 235
agent_info.py	23	0	100%
agent_speaking_capture.py	66	4	93%	205–206, 209, 211
azure_openai_response_retry.py	325	93	71%	87, 197, 205, 227, 253, 263–265, 389, 397–400, 402–404, 410–412, 429, 450–451, 456–459, 462–465, 467–470, 472, 482–484, 486–489, 491–494, 496–500, 502, 510–512, 514, 530–532, 544, 546–547, 550, 552, 556, 559, 563, 574–577, 581–583, 586–587, 594–595, 606, 610–611, 617–618, 623, 625, 646–647, 650–651, 656, 660, 663–664
groupchat_orchestrator.py	547	90	83%	138–139, 146–147, 152–153, 481, 484–488, 490, 492–493, 496, 499, 502, 504, 506–509, 516–517, 524–525, 532–533, 536–538, 541–542, 547–549, 552–553, 558, 561–563, 566–567, 572, 575, 581, 584, 588, 590–594, 598–599, 605, 608, 612, 617, 620, 631–632, 634, 636–637, 639, 649–650, 652, 744, 918, 937, 939, 941, 970, 1099, 1101, 1217, 1226, 1228, 1273–1274, 1277, 1298–1301, 1319
middlewares.py	80	0	100%
shared_memory_context_provider.py	124	15	87%	109, 136, 178, 182, 222, 233, 237, 242, 274, 285, 290, 313–315, 323
src/processor/src/libs/base
orchestrator_base.py	165	49	70%	63, 69, 72–75, 81–82, 84–85, 128, 139, 144, 149–150, 154, 162, 164, 166, 173–174, 181, 183, 190, 194, 203, 207, 212, 214–215, 217, 316–318, 321, 327, 334–336, 363–365, 368, 375, 382–384, 435–436
src/processor/src/libs/mcp_server
MCPBlobIOTool.py	5	0	100%
MCPDatetimeTool.py	6	0	100%
MCPMicrosoftDocs.py	3	0	100%
src/processor/src/steps
migration_processor.py	268	44	83%	92–93, 149–150, 164–167, 171, 177, 212–213, 219–220, 224, 228, 299–302, 305–308, 312–313, 326–327, 387–388, 490–491, 541–542, 549–550, 588–589, 607–608, 672–673, 697, 726
src/processor/src/steps/analysis/orchestration
analysis_orchestrator.py	85	8	90%	46–47, 61, 65, 112, 115, 121, 123
src/processor/src/steps/convert/orchestration
yaml_convert_orchestrator.py	97	5	94%	67, 115, 118, 124, 126
src/processor/src/steps/design/orchestration
design_orchestrator.py	82	9	89%	45–46, 53, 57, 107, 110, 117–118, 120
src/processor/src/steps/documentation/orchestration
documentation_orchestrator.py	95	6	93%	72, 120, 123, 129–130, 132
TOTAL	5802	729	87%

Tests	Skipped	Failures	Errors	Time
814	0 💤	0 ❌	0 🔥	18.257s ⏱️