[BREAKING] Python: Schema changes for azure functions package by gavin-aguiar · Pull Request #2151 · microsoft/agent-framework

gavin-aguiar · 2025-11-12T22:27:39Z

Motivation and Context

Updates the python SDK so that it saves durable agent entity state according to the proposed schema

Description

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.

…ramework (#1823) * Add scafolding * update readme * add code owners and label * update owners

* add initial changes * Move code and add single sample * Update logger * Remove unused code * address PR comments * cleanup code and address comments --------- Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

* Add Unit tests for Azurefunctions * remove duplicate import

…gents as MCP tools (#1979)

* Move all samples * fix comments * remove dead lines * Make samples simpler

)

* Add Integration tests * Remove DTS extension * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Add pyi file for type safety * Add samples in readme * Updated all readme instructions * Address comments * Update readmes * Fix requirements * Address comments --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

…tegration tests (#2070) Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

#2106) Also fixes an issue where we were trying to start docker containers for integration tests on Windows, which doesn't work. Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Add README for Azure Functions samples setup Added setup instructions for Azure Functions samples, including environment setup, virtual environment creation, and running samples. * Update python/samples/getting_started/azure_functions/README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Apply suggestion from @Copilot Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Laveesh Rohra <larohra@microsoft.com>

…ges (#2118)

* Add Identity Auth to samples * Update python/samples/getting_started/azure_functions/README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update python/samples/getting_started/azure_functions/01_single_agent/function_app.py Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update python/samples/getting_started/azure_functions/02_multi_agent/function_app.py Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update python/samples/getting_started/azure_functions/06_multi_agent_orchestration_conditionals/README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Rename to threadid * Respond in plain text * Make snake-case * Add http prefix * rename to wait-for-response * Add query param check * address comments

* Move import to Azure * fix mypy * Update python/packages/azurefunctions/README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Add missing types * Address comments --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

…__init__.py Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

- Adds a link from the /dotnet/samples/README.md to /dotnet/samples/AzureFunctions - Make DurableAgentThread deserialization internal for future-proofing - Update JSON serialization logic to address recently discovered issues with source generator serialization

python/packages/azurefunctions/agent_framework_azurefunctions/_entities.py

python/packages/azurefunctions/agent_framework_azurefunctions/_models.py

python/packages/azurefunctions/agent_framework_azurefunctions/_orchestration.py

python/packages/azurefunctions/agent_framework_azurefunctions/_durable_agent_state.py

…t/agent-framework into gaaguiar/schema_changes

python/packages/azurefunctions/agent_framework_azurefunctions/_app.py

python/packages/azurefunctions/agent_framework_azurefunctions/_entities.py

python/packages/azurefunctions/agent_framework_azurefunctions/_models.py

python/packages/azurefunctions/agent_framework_azurefunctions/_durable_agent_state.py

* Initial fixes * Address more comments * Address remaining comments

…t/agent-framework into gaaguiar/schema_changes

…oft#2151) * Python: Add Scaffolding for Durable AzureFunctions package to Agent Framework (microsoft#1823) * Add scafolding * update readme * add code owners and label * update owners * .NET: Durable extension: initial src and unit tests (microsoft#1900) * Python: Add Durable Agent Wrapper code (microsoft#1913) * add initial changes * Move code and add single sample * Update logger * Remove unused code * address PR comments * cleanup code and address comments --------- Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com> * Azure Functions .NET samples (microsoft#1939) * Python: Add Unit tests for Azurefunctions package (microsoft#1976) * Add Unit tests for Azurefunctions * remove duplicate import * .NET: [Feature Branch] Migrate state schema updates and support for agents as MCP tools (microsoft#1979) * Python: Add more samples for Azure Functions (microsoft#1980) * Move all samples * fix comments * remove dead lines * Make samples simpler * .NET: [Feature Branch] Durable Task extension integration tests (microsoft#2017) * .NET: [Feature Branch] Update OpenAI config for integration tests (microsoft#2063) * Python: Add Integration tests for AzureFunctions (microsoft#2020) * Add Integration tests * Remove DTS extension * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Add pyi file for type safety * Add samples in readme * Updated all readme instructions * Address comments * Update readmes * Fix requirements * Address comments --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * .NET: [Feature Branch] Update dotnet-build-and-test.yml to support integration tests (microsoft#2070) Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Fix DTS startup issue and improve logging (microsoft#2103) * .NET: [Feature Branch] Introduce Azure OpenAI config for .NET pipeline (microsoft#2106) Also fixes an issue where we were trying to start docker containers for integration tests on Windows, which doesn't work. Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Fix uv.lock after merge * Python: Add README for Azure Functions samples setup (microsoft#2100) * Add README for Azure Functions samples setup Added setup instructions for Azure Functions samples, including environment setup, virtual environment creation, and running samples. * Update python/samples/getting_started/azure_functions/README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Apply suggestion from @Copilot Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Laveesh Rohra <larohra@microsoft.com> * Fix or remove broken markdown file links (microsoft#2115) * .NET: [Feature Branch] Update HTTP API to be consistent across languages (microsoft#2118) * Python: Fix AzureFunctions Integration Tests (microsoft#2116) * Add Identity Auth to samples * Update python/samples/getting_started/azure_functions/README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update python/samples/getting_started/azure_functions/01_single_agent/function_app.py Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update python/samples/getting_started/azure_functions/02_multi_agent/function_app.py Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update python/samples/getting_started/azure_functions/06_multi_agent_orchestration_conditionals/README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Python: Fix Http Schema (microsoft#2112) * Rename to threadid * Respond in plain text * Make snake-case * Add http prefix * rename to wait-for-response * Add query param check * address comments * .NET: Remove IsPackable=false in preparation for nuget release (microsoft#2142) * Python: Move `azurefunctions` to `azure` for import (microsoft#2141) * Move import to Azure * fix mypy * Update python/packages/azurefunctions/README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Add missing types * Address comments --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update python/packages/azurefunctions/pyproject.toml Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update python/packages/azurefunctions/agent_framework_azurefunctions/__init__.py Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Fix imports * Address PR feedback from westey-m (microsoft#2150) - Adds a link from the /dotnet/samples/README.md to /dotnet/samples/AzureFunctions - Make DurableAgentThread deserialization internal for future-proofing - Update JSON serialization logic to address recently discovered issues with source generator serialization * Schema changes for azure functions * Fixed serialization bug * update to camel case * Adding logs * merge with main * sync uv.lock * Updated schema * Fixed tests * Addressed comments * Fixed mypy errors * Fixed bug in responsetype and authorName * Addressed feedback * Addressed more feedback * Python: Addressing comments for microsoft#2151 (microsoft#2315) * Initial fixes * Address more comments * Address remaining comments * Fixed remaining snake_case properties * Fixed remaining snake_case properties * Fixed mypy errors * Minor changes * revert tool names * Fixed mypy errors --------- Co-authored-by: Laveesh Rohra <larohra@microsoft.com> Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com> Co-authored-by: Chris Gillum <cgillum@microsoft.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Anirudh Garg <anirudhg@microsoft.com> Co-authored-by: Victoria Hall <victoriahall@microsoft.com>

larohra and others added 30 commits November 3, 2025 08:33

Python: Add Scaffolding for Durable AzureFunctions package to Agent F…

e7e68fe

…ramework (#1823) * Add scafolding * update readme * add code owners and label * update owners

Merge branch 'main' into feature-azure-functions

0808fd2

Merge branch 'main' into feature-azure-functions

1d5677b

.NET: Durable extension: initial src and unit tests (#1900)

5686a00

Python: Add Durable Agent Wrapper code (#1913)

1762cda

* add initial changes * Move code and add single sample * Update logger * Remove unused code * address PR comments * cleanup code and address comments --------- Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

Azure Functions .NET samples (#1939)

90742ba

Python: Add Unit tests for Azurefunctions package (#1976)

754491c

* Add Unit tests for Azurefunctions * remove duplicate import

.NET: [Feature Branch] Migrate state schema updates and support for a…

40b6def

…gents as MCP tools (#1979)

Python: Add more samples for Azure Functions (#1980)

0aa8d30

* Move all samples * fix comments * remove dead lines * Make samples simpler

.NET: [Feature Branch] Durable Task extension integration tests (#2017)

304b809

.NET: [Feature Branch] Update OpenAI config for integration tests (#2063

916b51f

)

.NET: [Feature Branch] Update dotnet-build-and-test.yml to support in…

17f6cc3

…tegration tests (#2070) Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Fix DTS startup issue and improve logging (#2103)

246bf07

.NET: [Feature Branch] Introduce Azure OpenAI config for .NET pipeline (

3eda97a

#2106) Also fixes an issue where we were trying to start docker containers for integration tests on Windows, which doesn't work. Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Merge branch 'main' into feature-azure-functions

66f2dd6

Fix uv.lock after merge

3ddbf06

Fix or remove broken markdown file links (#2115)

cc13e1f

Merge branch 'main' into feature-azure-functions

586238c

.NET: [Feature Branch] Update HTTP API to be consistent across langua…

2329bd4

…ges (#2118)

Python: Fix Http Schema (#2112)

ff28066

* Rename to threadid * Respond in plain text * Make snake-case * Add http prefix * rename to wait-for-response * Add query param check * address comments

.NET: Remove IsPackable=false in preparation for nuget release (#2142)

601b75a

Update python/packages/azurefunctions/pyproject.toml

3fc355e

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Update python/packages/azurefunctions/agent_framework_azurefunctions/…

8345b00

…__init__.py Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Merge branch 'main' into feature-azure-functions

de0f804

Fix imports

513a971

larohra reviewed Nov 18, 2025

View reviewed changes

gavin-aguiar added 3 commits November 18, 2025 13:53

Addressed feedback

a3b9934

Merge branch 'gaaguiar/schema_changes' of https://github.com/microsof…

511a813

…t/agent-framework into gaaguiar/schema_changes

Addressed more feedback

3cd7c4f

larohra reviewed Nov 18, 2025

View reviewed changes

moonbox3 mentioned this pull request Nov 19, 2025

Python: Addressing comments for #2151 #2315

Merged

4 tasks

DeagleGross removed the .NET label Nov 19, 2025

larohra and others added 11 commits November 19, 2025 13:38

Python: Addressing comments for #2151 (#2315)

4a5d029

* Initial fixes * Address more comments * Address remaining comments

Fixed remaining snake_case properties

63964b4

Merge branch 'gaaguiar/schema_changes' of https://github.com/microsof…

43acc12

…t/agent-framework into gaaguiar/schema_changes

Fixed remaining snake_case properties

8ddf167

Merge branch 'main' into gaaguiar/schema_changes

58b85c8

Merge branch 'gaaguiar/schema_changes' of https://github.com/microsof…

89cf49d

…t/agent-framework into gaaguiar/schema_changes

Fixed mypy errors

0fb791b

Minor changes

fe7ef9a

Merge branch 'gaaguiar/schema_changes' of https://github.com/microsof…

8c16919

…t/agent-framework into gaaguiar/schema_changes

revert tool names

98c1209

Fixed mypy errors

e54279c

larohra approved these changes Nov 19, 2025

View reviewed changes

larohra changed the title ~~.NET: Python: Schema changes for azure functions package~~ [BREAKING] Python: Schema changes for azure functions package Nov 19, 2025

gavin-aguiar enabled auto-merge November 19, 2025 23:44

gavin-aguiar added 2 commits November 19, 2025 17:47

Merge branch 'main' into gaaguiar/schema_changes

ebf63d4

Merge branch 'main' into gaaguiar/schema_changes

4b7086b

hallvictoria approved these changes Nov 20, 2025

View reviewed changes

gavin-aguiar added this pull request to the merge queue Nov 20, 2025

Merged via the queue into main with commit 6ae32f0 Nov 20, 2025
23 checks passed

crickman deleted the gaaguiar/schema_changes branch November 24, 2025 17:09

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[BREAKING] Python: Schema changes for azure functions package#2151

[BREAKING] Python: Schema changes for azure functions package#2151
gavin-aguiar merged 67 commits intomainfrom
gaaguiar/schema_changes

gavin-aguiar commented Nov 12, 2025 •

edited by larohra

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

11 participants

Conversation

gavin-aguiar commented Nov 12, 2025 • edited by larohra Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Motivation and Context

Description

Contribution Checklist

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

11 participants

gavin-aguiar commented Nov 12, 2025 •

edited by larohra

Loading