Python: [Breaking] Python: Respond with AgentRunResponse with serialized structured output

[larohra]

Motivation and Context

• Fixed the DurableAIAgent.run function to respond with AgentRunResponse rather than Any to be more in line with agent-framework's protocols.
• Handling deserialization of the response.value as part of the agent run, making it easier for the customer to author their codes.
• Remove unnecessary class wrappers (AgentResponse).
• Fixes https://github.com/Azure/durable-agent-framework/issues/133 and https://github.com/Azure/durable-agent-framework/issues/164

Description

The changes bring parity with Dotnet experience and also with agent-framework in general.

This introduces a breaking change where now we need to use yield from when calling the DurableAIAgent (vs just yield before) -

initial_raw = yield from writer.run(
        messages=f"Write a short article about '{payload.topic}'.",
        thread=writer_thread,
        response_format=GeneratedContent,
    )

Additionally, the responses are now of type AgentRunResponse and the structured response is stored in AgentRunResponse.value (as opposed to response["structured_response"] before).

Contribution Checklist

• The code builds clean without any errors or warnings
• The PR follows the Contribution Guidelines
• All unit tests pass, and I have added new tests where possible
• Is this a breaking change? If yes, add "[BREAKING]" prefix to the title of the PR.

[markwallace-microsoft]

Python Test Coverage Report •

File	Stmts	Miss	Cover	Missing
packages/azurefunctions/agent_framework_azurefunctions
_entities.py	179	21	88%	120, 160–161, 212, 220, 225–226, 253–254, 263, 270, 281, 287–288, 307–308, 378, 410–412, 414
_models.py	150	12	92%	204, 207, 210, 222, 225, 244, 247, 252, 257, 274, 329, 348
_orchestration.py	87	18	79%	168, 173, 175–176, 178, 193, 202–203, 205, 261, 266–273
TOTAL	15449	2360	84%

Python Unit Test Overview

Tests	Skipped	Failures	Errors	Time
2220	130 💤	0 ❌	0 🔥	53.413s ⏱️

[Copilot]

Pull Request Overview

This PR introduces a breaking change to make DurableAIAgent.run() return AgentRunResponse instead of raw dictionaries, aligning with the agent-framework protocols and bringing parity with the .NET experience. The key changes include:

• Modified DurableAIAgent.run() to use generator protocol (yield from) and return typed AgentRunResponse
• Removed the AgentResponse wrapper class in favor of using AgentRunResponse directly with metadata in additional_properties
• Deserialization of structured output (response.value) now happens in the orchestration layer via _ensure_response_format()
• Updated all samples and tests to use yield from syntax and access structured responses via .value property

Reviewed Changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 9 comments.

Show a summary per file

File	Description
python/packages/azurefunctions/agent_framework_azurefunctions/_orchestration.py	Added generator-based run() method returning AgentRunResponse, with helper methods _load_agent_response() and _ensure_response_format() for response handling and structured output parsing
python/packages/azurefunctions/agent_framework_azurefunctions/_entities.py	Modified run_agent() to return AgentRunResponse directly, removed JSON parsing logic (now handled at orchestration layer), updated metadata handling via additional_properties
python/packages/azurefunctions/agent_framework_azurefunctions/_models.py	Removed AgentResponse dataclass as it's replaced by AgentRunResponse
python/samples/getting_started/azure_functions/04_single_agent_orchestration_chaining/function_app.py	Updated to use yield from and access response via .text property
python/samples/getting_started/azure_functions/05_multi_agent_orchestration_concurrency/function_app.py	Updated to manually advance generators for concurrent execution, accessing results via .text property
python/samples/getting_started/azure_functions/06_multi_agent_orchestration_conditionals/function_app.py	Updated to use yield from and access structured responses via .value property, removed _coerce_structured() helper
python/samples/getting_started/azure_functions/07_single_agent_orchestration_hitl/function_app.py	Updated to use yield from and access structured responses via .value property with validation, removed _coerce_generated_content() helper
python/packages/azurefunctions/tests/test_orchestration.py	Added tests for _load_agent_response() helper method covering instance, serialized, and None cases
python/packages/azurefunctions/tests/test_models.py	Removed all tests for the deleted AgentResponse class
python/packages/azurefunctions/tests/test_entities.py	Updated assertions to check AgentRunResponse type and access metadata via additional_properties
python/packages/azurefunctions/tests/test_app.py	Updated assertions to check AgentRunResponse type and access metadata via additional_properties

[Copilot]

Pull Request Overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 2 comments.

[cgillum]

In addition to the feedback below, can we open an issue to track updating the snippets lab (the one we used for Ignite) to account for these breaking changes?

[larohra]

In addition to the feedback below, can we open an issue to track updating the snippets lab (the one we used for Ignite) to account for these breaking changes?

Opened an issue #2435

[Copilot]

Pull request overview

Copilot reviewed 12 out of 12 changed files in this pull request and generated 4 comments.

---

You can also share your feedback on Copilot code review for a chance to win a $100 gift card. Take the survey.

[cgillum]

The latest version looks great! Just one comment to fix up the sample.