fix: Upgrade azure-ai-projects and agent-framework

[Prachig-Microsoft]

This pull request updates both the ContentProcessor and ContentProcessorWorkflow projects to support the latest agent-framework (1.3.0) and azure-ai-projects (2.1.0) releases, and removes support for deprecated Azure agent client types. It also updates the code to use the new OpenAI client classes and adapts helper logic and retry wrappers accordingly.

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

• 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	1217	161	86%

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

Tests	Skipped	Failures	Errors	Time
244	0 💤	0 ❌	0 🔥	4.318s ⏱️

[Copilot]

Pull request overview

Updates the ContentProcessor and ContentProcessorWorkflow Python code to align with newer agent-framework / azure-ai-projects APIs by migrating from deprecated agent/client/message types to the newer Agent / Message / OpenAI client classes, and refreshing retry/middleware/orchestration integrations.

Changes:

• Bumps agent-framework and azure-ai-projects dependency pins and updates the uv.lock resolution.
• Migrates workflow steps, middleware, orchestrator, and helpers from legacy ChatAgent/ChatMessage/Azure client classes to Agent/Message/OpenAI client classes and new workflow streaming event shapes.
• Updates infra sample code and unit tests to match the new SDK/client interfaces.

Reviewed changes

Copilot reviewed 29 out of 31 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
src/tests/ContentProcessorWorkflow/libs/agent_framework/test_input_observer_middleware.py	Updates test to use Message (but still uses Role.USER in a way that no longer matches middleware role handling).
src/tests/ContentProcessorWorkflow/libs/agent_framework/test_azure_openai_response_retry_utils.py	Updates tests to Message, but still asserts TextContent content type.
src/tests/ContentProcessorWorkflow/libs/agent_framework/test_agent_framework_helper.py	Updates patch targets to new agent_framework.openai client classes.
src/tests/ContentProcessorWorkflow/libs/agent_framework/test_agent_builder.py	Updates patch target from ChatAgent to Agent and adapts option passing expectations.
src/ContentProcessorWorkflow/tests/unit/libs/agent_framework/test_input_observer_middleware.py	Migrates unit test to Message and string role usage.
src/ContentProcessorWorkflow/tests/unit/libs/agent_framework/test_azure_openai_response_retry_utils.py	Migrates unit test to new content typing (Content) and Message.
src/ContentProcessorWorkflow/tests/unit/libs/agent_framework/test_agent_framework_helper.py	Updates unit tests for new OpenAI client class construction paths.
src/ContentProcessorWorkflow/tests/unit/libs/agent_framework/test_agent_builder.py	Adjusts unit tests for Agent creation and option passing.
src/ContentProcessorWorkflow/src/steps/summarize/executor/summarize_executor.py	Migrates executor to Message, SupportsChatGetResponse, and ctx.set_state.
src/ContentProcessorWorkflow/src/steps/rai/executor/rai_executor.py	Migrates executor to Message, SupportsChatGetResponse, and ctx.set_state.
src/ContentProcessorWorkflow/src/steps/gap_analysis/executor/gap_executor.py	Migrates executor to Message, SupportsChatGetResponse, and ctx.set_state.
src/ContentProcessorWorkflow/src/steps/document_process/executor/document_process_executor.py	Switches workflow output persistence from set_shared_state to set_state.
src/ContentProcessorWorkflow/src/steps/claim_processor.py	Updates workflow builder/streaming API usage and event handling to new WorkflowEvent model.
src/ContentProcessorWorkflow/src/libs/agent_framework/middlewares.py	Migrates middleware types to AgentContext/Message and string role comparisons.
src/ContentProcessorWorkflow/src/libs/agent_framework/groupchat_orchestrator.py	Migrates orchestrator to new agent-framework types/events and builder API; adds local ManagerSelectionResponse.
src/ContentProcessorWorkflow/src/libs/agent_framework/azure_openai_response_retry.py	Migrates retry wrappers to agent_framework.openai clients and updates option passing (options).
src/ContentProcessorWorkflow/src/libs/agent_framework/agent_speaking_capture.py	Updates middleware context type to AgentContext.
src/ContentProcessorWorkflow/src/libs/agent_framework/agent_info.py	Removes deprecated ToolProtocol typing and broadens tools typing.
src/ContentProcessorWorkflow/src/libs/agent_framework/agent_framework_helper.py	Migrates client creation to agent_framework.openai classes and removes deprecated Azure agent client support.
src/ContentProcessorWorkflow/src/libs/agent_framework/agent_builder.py	Reworks builder to construct Agent with ChatOptions (default_options) and new middleware/history types.
src/ContentProcessorWorkflow/pyproject.toml	Pins agent-framework==1.1.1 and azure-ai-projects==2.1.0.
src/ContentProcessor/uv.lock	Updates locked dependency set for newer agent-framework ecosystem; enables prerelease mode.
src/ContentProcessor/src/libs/pipeline/handlers/map_handler.py	Migrates map handler call from ChatMessage to Message.
src/ContentProcessor/src/libs/agent_framework/azure_openai_response_retry.py	Migrates retry wrappers to agent_framework.openai clients and options parameter.
src/ContentProcessor/src/libs/agent_framework/agent_info.py	Removes deprecated ToolProtocol typing and broadens tools typing.
src/ContentProcessor/src/libs/agent_framework/agent_framework_helper.py	Migrates client creation to new OpenAI client classes; removes deprecated Azure agent client support.
src/ContentProcessor/src/libs/agent_framework/agent_builder.py	Reworks builder to construct Agent with ChatOptions (default_options) and new middleware/history types.
src/ContentProcessor/pyproject.toml	Pins agent-framework==1.1.1.
infra/vscode_web/requirements.txt	Updates azure-ai-projects requirement to 2.1.0.
infra/vscode_web/codeSample.py	Updates AIProjectClient agent/thread/message/run calls to the newer agents.* namespaces and adds run failure handling.

Comments suppressed due to low confidence (3)

src/tests/ContentProcessorWorkflow/libs/agent_framework/test_azure_openai_response_retry_utils.py:151

• This test still expects _set_message_text to populate TextContent, but the implementation now builds contents via Content.from_text(...) in azure_openai_response_retry.py. The TextContent import and isinstance(..., TextContent) assertion will fail; update the test to assert against the new content type (or to assert on the resulting text value rather than a concrete content class).

        m = Message(role="user", contents=["A" * 100_000])
        result = _set_message_text(m, "truncated")
        assert result.text == "truncated"
        assert len(result.contents) == 1
        assert isinstance(result.contents[0], TextContent)

src/ContentProcessor/src/libs/agent_framework/agent_builder.py:436

• The build() docstring still describes returning a ChatAgent, but the method signature/implementation now returns Agent. Please update the docstring (and any other ChatAgent references in this module) to match the upgraded agent-framework API.

    def build(self) -> Agent:
        """Build and return the configured ChatAgent.

        Returns:
            ChatAgent: Configured agent instance ready for use

src/ContentProcessorWorkflow/src/libs/agent_framework/azure_openai_response_retry.py:604

• The AzureOpenAIChatClientWithRetry docstring says it overrides both _inner_get_response and _inner_get_streaming_response, but the streaming override has been removed in this version of the wrapper. Please update the docstring to reflect the actual overridden methods so retry/streaming behavior is clear.

class AzureOpenAIChatClientWithRetry(OpenAIChatCompletionClient):
    """Azure OpenAI Chat client with 429 retry at the request boundary.

    This wraps the underlying chat-completions call used by Agent Framework by overriding
    the internal `_inner_get_response` / `_inner_get_streaming_response` methods.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.