.NET: Python: Azure Functions feature branch by dmytrostruk · Pull Request #1916 · microsoft/agent-framework

dmytrostruk · 2025-11-05T00:42:25Z

This PR merges the feature-azure-functions branch into main. More info on this feature below:

Durable Task extension for Microsoft Agent Framework

This PR introduces two new .NET packages and one new Python package, enabling new scenarios for MAF on Azure Functions. In particular, this extension enables hosting MAF agents in distributed, serverless environments and integrates them natively into the Durable Functions orchestrations.

Documentation

Detailed MSLearn docs and tutorials: https://github.com/MicrosoftDocs/semantic-kernel-pr/pull/755

Added NuGet Packages

Microsoft.Agents.AI.DurableTask: Core logic for the durable extension that contains the main abstractions and can be self-hosted.
Microsoft.Agents.AI.Hosting.AzureFunctions: Azure Functions integration, including built-in HTTP triggers, MCP tool triggers, etc.

Added Python Packages

agent-framework-azurefunctions: Azure Functions integration as well as the core durable extension abstractions. This may be split into two packages (similar to .NET) in the future.

Added Samples

Several new samples have been added for both .NET and Python demonstrating how to use this new extension, covering several use cases. The samples also include detailed READMEs, guiding users through the process of running the samples locally.

Added Tests

Both the .NET and Python changes include unit and integration tests. The integration tests also take care of validating the new samples we added above, ensuring that they continue to work as we make changes. The new integration tests depend primarily on Azure OpenAI as the external resource, use Azure CLI credentials (no secrets), and have been stable for several days.

Test Modifications

In order to run our integration tests, we've updated dotnet-build-and-test.yml and python-merge-tests to run a new action, azure-functions-integration-setup which starts up two emulators (Azurite for Azure Storage and the Durable Task Scheduler emulator) as well as installing the Azure Functions Core Tools, which is used for running samples validation. This action only runs for integration tests and is not expected to contribute much to the length of the CI process.

Feature Branch PRs

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

Copilot

Pull Request Overview

This PR adds a new Python package for Azure Functions integration with the Microsoft Agent Framework. The package enables hosting Agent Framework agents on Azure Durable Functions with features like state persistence, conversation history replay, and automatic failure recovery.

Adds a new agent-framework-azurefunctions package under python/packages/azurefunctions/
Updates the uv.lock file to include the new package and its dependencies (azure-functions, azure-functions-durable, furl, orderedmultidict, werkzeug)
Updates transitive dependency versions (fsspec, google-auth, polars, polars-runtime-32, sse-starlette)

Reviewed Changes

Copilot reviewed 5 out of 6 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
python/uv.lock	Adds new package dependencies for Azure Functions integration and updates several transitive dependencies to newer versions
python/packages/azurefunctions/pyproject.toml	Defines project metadata, dependencies, and build configuration for the new Azure Functions package
python/packages/azurefunctions/agent_framework_azurefunctions/init.py	Creates package entry point with copyright notice
python/packages/azurefunctions/README.md	Provides installation instructions and basic usage documentation for the Azure Functions integration
python/packages/azurefunctions/LICENSE	Adds MIT license file for the new package
.github/CODEOWNERS	Assigns code ownership for the Azure Functions package

python/packages/azurefunctions/pyproject.toml

python/packages/azurefunctions/agent_framework_azurefunctions/__init__.py

python/packages/azurefunctions/README.md

markwallace-microsoft · 2025-11-05T00:50:09Z

Python Test Coverage Report •

File	Stmts	Miss	Cover	Missing
packages/azurefunctions/agent_framework_azurefunctions
_app.py	315	81	74%	165–166, 171–172, 361, 369–370, 390–392, 398–400, 406–408, 440–441, 455, 466, 483, 486, 495–497, 499–501, 503, 505–507, 518, 520–523, 525, 527–528, 530, 537–538, 540–541, 543–544, 546, 550, 560–562, 564–565, 567–569, 576, 578–579, 581, 585, 597, 667, 679, 686–688, 733, 747, 758–760, 762–765, 790, 797, 799, 802
_callbacks.py	13	0	100%
_entities.py	199	22	88%	96, 144–146, 216, 224, 229–230, 257–258, 267, 274, 285, 291–292, 311–312, 382, 415–417, 419
_errors.py	5	2	60%	12–13
_models.py	164	12	92%	202, 205, 208, 217, 220, 223, 242, 245, 250, 255, 272, 319
_orchestration.py	67	9	86%	199, 204–211
_state.py	62	2	96%	152, 169
TOTAL	14655	2123	85%

Python Unit Test Overview

Tests	Skipped	Failures	Errors	Time
2028	129 💤	0 ❌	0 🔥	39.365s ⏱️

* 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>

python/packages/core/agent_framework/azurefunctions/__init__.py

* 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>

* 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>

cgillum · 2025-11-12T20:45:52Z

I've updated PR description to remove the placeholder and add more detailed information.

dotnet/samples/AzureFunctions/README.md

dotnet/src/Microsoft.Agents.AI.DurableTask/DurableAgentJsonUtilities.cs

dotnet/src/Microsoft.Agents.AI.DurableTask/DurableAgentThread.cs

dotnet/src/Microsoft.Agents.AI.DurableTask/State/DurableAgentStateMessage.cs

- 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/_app.py

python/packages/azurefunctions/pyproject.toml

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

e7e68fe

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

dmytrostruk self-assigned this Nov 5, 2025

dmytrostruk added the python label Nov 5, 2025

Copilot AI review requested due to automatic review settings November 5, 2025 00:42

markwallace-microsoft added the documentation Improvements or additions to documentation label Nov 5, 2025

dmytrostruk marked this pull request as draft November 5, 2025 00:42

Merge branch 'main' into feature-azure-functions

0808fd2

Copilot AI reviewed Nov 5, 2025

View reviewed changes

python/packages/azurefunctions/pyproject.toml Outdated Show resolved Hide resolved

python/packages/azurefunctions/agent_framework_azurefunctions/__init__.py Show resolved Hide resolved

python/packages/azurefunctions/README.md Show resolved Hide resolved

Merge branch 'main' into feature-azure-functions

1d5677b

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

5686a00

markwallace-microsoft added the .NET label Nov 5, 2025

github-actions bot changed the title ~~Python: [WIP] Azure Functions feature branch~~ .NET: Python: [WIP] Azure Functions feature branch Nov 5, 2025

larohra and others added 2 commits November 5, 2025 16:21

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

eavanvalkenburg reviewed Nov 7, 2025

View reviewed changes

python/packages/core/agent_framework/azurefunctions/__init__.py Show resolved Hide resolved

larohra and others added 3 commits November 7, 2025 08:29

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

markwallace-microsoft temporarily deployed to integration November 8, 2025 07:26 — with GitHub Actions Inactive

cgillum temporarily deployed to integration November 8, 2025 22:25 — with GitHub Actions Inactive

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

304b809

cgillum temporarily deployed to integration November 10, 2025 18:27 — with GitHub Actions Inactive

cgillum had a problem deploying to integration November 10, 2025 18:27 — with GitHub Actions Failure

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

916b51f

)

cgillum temporarily deployed to integration November 10, 2025 23:58 — with GitHub Actions Inactive

cgillum had a problem deploying to integration November 10, 2025 23:58 — with GitHub Actions Failure

larohra temporarily deployed to integration November 12, 2025 17:56 — with GitHub Actions Inactive

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

601b75a

cgillum temporarily deployed to integration November 12, 2025 19:50 — with GitHub Actions Inactive

cgillum temporarily deployed to integration November 12, 2025 19:51 — with GitHub Actions Inactive

larohra temporarily deployed to integration November 12, 2025 20:13 — with GitHub Actions Inactive

larohra had a problem deploying to integration November 12, 2025 20:13 — with GitHub Actions Error

larohra and others added 3 commits November 12, 2025 12:26

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

westey-m reviewed Nov 12, 2025

View reviewed changes

dotnet/samples/AzureFunctions/README.md Show resolved Hide resolved

westey-m reviewed Nov 12, 2025

View reviewed changes

dotnet/src/Microsoft.Agents.AI.DurableTask/DurableAgentJsonUtilities.cs Show resolved Hide resolved

westey-m reviewed Nov 12, 2025

View reviewed changes

dotnet/src/Microsoft.Agents.AI.DurableTask/DurableAgentThread.cs Outdated Show resolved Hide resolved

westey-m reviewed Nov 12, 2025

View reviewed changes

dotnet/src/Microsoft.Agents.AI.DurableTask/State/DurableAgentStateMessage.cs Show resolved Hide resolved

westey-m approved these changes Nov 12, 2025

View reviewed changes

cgillum mentioned this pull request Nov 12, 2025

.NET: Minor serialization updates from review feedback #2150

Merged

4 tasks

larohra and others added 3 commits November 12, 2025 13:32

Fix imports

513a971

Merge branch 'main' into feature-azure-functions

3829e1c

dmytrostruk commented Nov 13, 2025

View reviewed changes

python/packages/azurefunctions/pyproject.toml Outdated Show resolved Hide resolved

larohra mentioned this pull request Nov 13, 2025

Python: Update azurefunctions version and address comments from #1916 #2160

Merged

4 tasks

Address comments (#2160)

be56177

moonbox3 approved these changes Nov 13, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

.NET: Python: Azure Functions feature branch#1916

.NET: Python: Azure Functions feature branch#1916
dmytrostruk merged 32 commits intomainfrom
feature-azure-functions

dmytrostruk commented Nov 5, 2025 •

edited by larohra

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

markwallace-microsoft commented Nov 5, 2025 •

edited

Loading

Uh oh!

Uh oh!

cgillum commented Nov 12, 2025 •

edited

Loading

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!

9 participants

Conversation

dmytrostruk commented Nov 5, 2025 • edited by larohra Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Durable Task extension for Microsoft Agent Framework

Documentation

Added NuGet Packages

Added Python Packages

Added Samples

Added Tests

Test Modifications

Feature Branch PRs

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

markwallace-microsoft commented Nov 5, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Python Unit Test Overview

Uh oh!

Uh oh!

cgillum commented Nov 12, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

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!

9 participants

dmytrostruk commented Nov 5, 2025 •

edited by larohra

Loading

markwallace-microsoft commented Nov 5, 2025 •

edited

Loading

cgillum commented Nov 12, 2025 •

edited

Loading