agent-framework

[BREAKING] Python: Refactor orchestrations (#3023 )

* Group chat refactoring Part 1; Next: HIL and handoff

* Add agent approval flow; next samples

* WIP: samples

* WIP: HIL samples

* Group chat HIL working; next: handoff

* Fix group chat tool approval sample

* WIP: refactor handoff; next handoff handling

* Handoff done; next handoff samples and concurrent and sequential

* Handoff samples, concurrent, and sequential done; next Magentic

* WIP: magentic; next test with samples + HIL

* Magentic Working; next fix all samples and tests

* Fix handoff samples; next tests

* WIP: fixing tests; some orchestration as agent samples are failing

* Group chat unit tests done

* Handoff  unit tests done

* Remove old orchestration_request_info and fix related tests

* Magentic unit tests done

* Fix samples

* Fix test

* Fix test 2

* mypy

* Address comments

* Update readme

* Address comments

* Address comments 2

* Replace display name

Tao Chen · 2026-01-13 18:40:26 +00:00

0b152418b6

Python: [BREAKING]: Introducing Options as TypedDict and Generic (#3140 )

* WIP typeddict for options

* updated all clients and ChatAgents

* updated everything

* added ADR

* fix mypy

* proper typevar imports

* fixed import

* fixed other imports

* slight update in the sample

* updated from feedback

* fixes

* fixed missing covariants and test fixes

* fixed typing

* updated anthropic thinking config

* ruff fixes

* fixed int tests

* fix tests and mypy

* updated integration tests

* updated docstring and test fix

* improved options handling in obser

* mypy fix

* updated a host of integration tests

* fix tests

* bedrock fix

Eduard van Valkenburg · 2026-01-13 16:41:05 +00:00

3e97425245

Python: Add declarative workflow runtime (#2815 )

* Further support for declarative python workflows

* Add tests. Clean up for typing and formatting

* Improvements and cleanup

* Typing cleanup. Improve docstrings

* Proper code in docstrings

* Fix malformed code-block directive in docstring

* Remove dead links

* PR feedback

* Address PR feedback

* Address PR feedback

* Remove sl

* Update devui frontend

* More cleanup

* Fix uv lock

* Skip Py 3.14 tests as powerfx doesn't support it

* Fix mypy error

* Fix for tool calls

* Removed stale docstring

* Fix lint

* Standardize on .NET namespaces. Revert DevUI changes (bring in later)

* Implement remaining items for Python declarative support to match dotnet

Evan Mattson · 2026-01-13 07:11:21 +00:00

9c094573e8

Python: [BREAKING]: removed display_name, renamed context_providers, middleware and AggregateContextProvider (#3139 )

* removed display_name, renamed context_providers, middleware and AggregateContextProvider

* fixes

* fixed test

* testfix

* removed mistakenly put back test

* updated new test

* rename middlewares to middleware

* middleware fixes

Eduard van Valkenburg · 2026-01-13 02:24:07 +00:00

203fb7b1c4

azureai direct a2a endpoint support (#3127 )

Giles Odigwe · 2026-01-12 22:03:04 +00:00

ef44fb4960

Python: Fix MCPStreamableHTTPTool to use new streamable_http_client API (#3088 )

* Fix MCPStreamableHTTPTool to use new streamable_http_client API with proper httpx client cleanup

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Update docstring to reflect new streamable_http_client API usage

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Refactor MCPStreamableHTTPTool to accept optional http_client parameter and delegate client creation to streamable_http_client

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Update mcp package minimum version to 1.24.0 for streamable_http_client API support

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Fix critical bugs: apply headers/timeout/sse_read_timeout when creating httpx client, add version constraint <2, and properly manage client lifecycle

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Simplify implementation: remove headers/timeout/sse_read_timeout params, remove kwargs, remove close() override per feedback

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Add back **kwargs parameter for backward compatibility (accepted but not used)

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Remove unused httpx import from test file

Note: The uv.lock file needs to be updated with 'uv sync' to reflect the mcp version constraint change (>=1.24.0,<2)

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* cicd fixes

* udpated samples with headers examples

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>
Co-authored-by: eavanvalkenburg <github@vanvalkenburg.eu>

Copilot · 2026-01-12 17:26:53 +00:00

e63c148fc7

Fix Ollama model env var in documentation (#3156 )

Signed-off-by: Dina Suehiro Jones <dina.s.jones@intel.com>

Dina Suehiro Jones · 2026-01-12 14:15:49 +00:00

3a5fe31263

Python: Add tool call/result content types and update connectors and samples (#2971 )

* Add new AI content types and image tool support

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Add Python content types for tool calls/results and image generation tool support

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Address review feedback for tool content and samples

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Tighten image generation typing and sample tools list

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Align image generation output typing

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Handle MCP naming, image options mapping, and connector tool content

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Allow MCP call in function approval request

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Remove raw image_generation tool remapping

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Restore Anthropic tool_use to function calls unless code execution

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Fix lint issues for hosted file docstring and MCP parsing

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Import ChatResponse types in Anthropic client

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Fix Anthropics citation type imports and MCP typing for handoff/tools

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Skip lightning tests without agentlightning and fix function call import

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* fix lint on lab package

* rebuilt anthropic parsing

* redid anthropic parsing

* typo

* updated parsing and added missing docstrings

* fix tests

* mypy fixes

* second mypy fix

* add new class to other samples

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>
Co-authored-by: eavanvalkenburg <github@vanvalkenburg.eu>

Copilot · 2026-01-08 19:46:32 +00:00

3f7ea350dc

Python: Streaming sample for azurefunctions (#3057 )

* Streaming sample for azurefunctions

* Fixed links and sample name

* Addressed feedback

* Addressed feedback

* Fixed integration tests

* Updated test

Gavin Aguiar · 2026-01-07 22:20:42 +00:00

f4ab586f11

sharepoint sample fix (#3108 )

Giles Odigwe · 2026-01-06 22:57:54 +00:00

ea370f8ff6

Python: Fix ExecutorInvokedEvent and ExecutorCompletedEvent observability data (#3090 )

* Fix ExecutorInvokedEvent.data mutation bug

* Fix bug related to not yielding output type

Evan Mattson · 2026-01-06 09:12:26 +00:00

844d345106

Python: Introducing support for Bedrock-hosted models (Anthropic, Cohere, etc.) (#2610 )

* Pushing the bedrock related changes to the new branch after addressing the review comments

* 2524 Addressed the second round review comments

* 2524 Addressed few more minor comments on the PR

* resolving the merge conflict

* 2524 resolved the uv.lock conflicts

* 2524 addressed more comments

* 2524 removed the print statement to fix the checks failure

* 2524 resolved the CI failure issues

* 2524 fixing the CI breaks

* 2524 Addressed the review comment

* 2524 resolved conflict

---------

Co-authored-by: Sunil Dutta <sunil.dutta@penske.com>
Co-authored-by: budgetboardingai <apurva.sharma31@gmail.com>

Sunil Dutta · 2025-12-19 18:35:53 +00:00

3b77192ad0

Python: Preserve reasoning blocks with OpenRouter (#2950 )

* Preserve reasoning blocks with OpenRouter

* Put encrypted reasoning in TextReasoningContent

* Remove unneccessary change

* Fix docs

* Support streaming

* Fix handling None in TextReasoningContent.text

SuperKenVery · 2025-12-19 17:03:19 +00:00

85d70f01f6

Python: Added GitHub MCP sample with PAT (#2967 )

* added github mcp sample with PAT

* addressed copilot fixes

* env fix

Giles Odigwe · 2025-12-19 16:46:12 +00:00

6930c0f0b6

Python: Fix WorkflowAgent event handling and kwargs forwarding (#2946 )

* Fix kwargs propagation through workflow.as_agent()

* Fix WorkflowAgent to respect AgentExecutor output_response setting

Evan Mattson · 2025-12-18 19:35:07 +00:00

b0a7a1fcb8

Python: Add Azure Managed Redis Support with Credential Provider (#2887 )

* azure redis support

* small fixes

* azure managed redis sample

* fixes

Giles Odigwe · 2025-12-18 17:10:55 +00:00

37b4cfd024

Python: Add workflow cancellation sample (#2732 )

* Add workflow cancellation sample

Add sample demonstrating how to cancel a running workflow using asyncio
tasks. Shows both cancellation mid-execution and normal completion paths.
Useful for implementing timeouts, graceful shutdown, or A2A executors.

* update docstring

Victor Dibia · 2025-12-18 14:12:42 +00:00

8ff34f9a43

Python: Workflow add option to visualize internal executors (#2917 )

* Workflow add option to visualize internal executors

* Address Copilot comments

Tao Chen · 2025-12-18 14:04:03 +00:00

b4f2709b6d

Python: Move ollama samples to samples getting started dir (#2921 )

* Move ollama samples to samples getting started dir

* Address feedback

Evan Mattson · 2025-12-18 08:37:05 +00:00

ca1532cf22

Pass kwargs into subworkflows (#2923 )

Evan Mattson · 2025-12-18 04:34:33 +00:00

360839782c

Python: Azure AI Agent with Bing Grounding Citations Sample (#2892 )

* bing grounding sample with citations

* small fix

* fix

Giles Odigwe · 2025-12-17 00:43:38 +00:00

d5527982b6

Python: Flow custom kwargs to agents via Workflow SharedState (#2894 )

* Flow custom kwargs to agents via SharedState

* Address Copilot feedback

* Improve sample typing

* Fix test

Evan Mattson · 2025-12-17 00:04:00 +00:00

6adcac2e97

[BREAKING] Python: Add factory pattern to handoff orchestration builder (#2844 )

* WIP: Factory pattern to handoff

* Add factory pattern to concurrent orchestration builder; Next: tests and sample verification

* Add tests and improve comments

* Fix mypy

* Simplify handoff_simple.py

* Simplify handoff_autonoumous.py and bug fix

* Update readme

* Address Copilot comments

Tao Chen · 2025-12-16 23:38:33 +00:00

8fca71e5ad

Python: Update Mem0Provider to use v2 search API filters parameter (#2766 )

* short fix to move id parameters to filters object

* added tests

* small fix

* mem0 dependency update

Giles Odigwe · 2025-12-16 18:23:37 +00:00

54f482df73

Python : Ollama Connector for Agent Framework (#1104 )

* Initial Commit for Olama Connector

* Added Olama Sample

* Add Sample & Fixed Open Telemetry

* Fixed Spelling from Olama to Ollama

* remove"opentelemetry-semantic-conventions-ai ~=0.4.13" since its handled in a different pr

* Added Tool Calling

* Finalizing test cases

* Adjust samples to be more reliable

* Update python/packages/ollama/agent_framework_ollama/_chat_client.py

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

* Update python/packages/ollama/pyproject.toml

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

* Update python/packages/ollama/tests/test_ollama_chat_client.py

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

* Update python/packages/ollama/agent_framework_ollama/_chat_client.py

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

* Improved Docstrings & Sample

* Update python/packages/ollama/agent_framework_ollama/_chat_client.py

Co-authored-by: Eduard van Valkenburg <eavanvalkenburg@users.noreply.github.com>

* Integrate PR Feedback
- Divided Streaming and Non-Streaming into independent Methods
- Catch Ollama Validation Error
- Add OTEL Provider Name
- Checked Ollama Messages
- Add Usage Statistics

* Revert setting, so it can be none

* Validate Message formatting between AF and Ollama

* Catch Ollama Error and raise a ServiceResponse Error

* Fix mypy error

* remove .vscode comma

* Add Reasoning support & adjust to new structure

* Add Ollama Multimodality and Reasoning

* Add test cases for reasoning

* Add Tests for Error Handling in Ollama Client

* Update python/samples/getting_started/multimodal_input/ollama_chat_multimodal.py

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

* Integrated Copilot Feedback

* Implement first PR Feedback

* Adjust Readme files for examples

* Adjust argument passing via additional chat options

* Implemented PR Feedback

* Removing Ollama Package from Core and moving samples

* Fix Link & Adding Samples to Main Sample Readme

* Fixing Links in Readme

* Moved Multimodal and Chat Example

* Fixed Link in ChatClient to Ollama

* Fix AgentFramework Links in Ollama Project

* Fix observability breaking change

---------

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

Nico Möller · 2025-12-16 15:02:38 +00:00

2f06fe557a

Python: Fix context duplication in handoff workflows when restoring from checkpoint (#2867 )

* Fix context duplication in handoff workflows when restoring from checkpoint

* Address Copilot PR review

Evan Mattson · 2025-12-16 09:52:59 +00:00

958a488f96

Python: [BREAKING] Observability updates (#2782 )

* fixes Python: Add env_file_path parameter to setup_observability() similar to AzureOpenAIChatClient
Fixes #2186

* WIP on updates using configure_azure_monitor

* improved setup and clarity

* fixed root .env.example

* revert changes

* updated files

* updated sample

* updated zero code

* test fixes and fixed links

* fix devui

* removed planning docs

* added enable method and updated readme and samples

* clarified docstring

* add return annotation

* updated naming

* update capatilized version

* updated readme and some fixes

* updated decorator name inline with the rest

* feedback from comments addressed

Eduard van Valkenburg · 2025-12-16 06:56:30 +00:00

3139347526

Fix WorkflowAgent to include thread convo history. Enable checkpointing. (#2774 )

Evan Mattson · 2025-12-12 04:04:31 +00:00

0fc7933a92

Python: Added custom args and thread object to ai_function kwargs (#2769 )

* Added an example of using kwargs in ai_function

* Added thread object to ai_function kwargs

* Updated docs

* Small fix

* Added thread parameter filtering

Dmytro Struk · 2025-12-12 01:53:04 +00:00

d7434d59ce

Capture file IDs from code interpreter in streaming responses (#2741 )

Evan Mattson · 2025-12-11 07:30:19 +00:00

3481914981

Python: Add factory pattern to concurrent orchestration builder (#2738 )

* Add factory pattern to concurrent orchestration builder

* Update readme

* Address AI comments

* Fix unit tests

* Fix import

* Prevent multiple calls to set participants or factories

* Add comments

* Mitigate warnings

* Fix mypy

* Address comments

* Address Copilot comments

* Fix tests

Tao Chen · 2025-12-11 01:23:28 +00:00

191779ce80

Python: Add factory pattern to sequential orchestration builder (#2710 )

* Add factory pattern to sequential orchestration builder

* Use temp list to avoid override

* Add sample and some other fixes

* Fix comments

* Small fix

* Update readme

Tao Chen · 2025-12-10 18:16:10 +00:00

523305ac62

Python: extend HITL support for all orchestration patterns (#2620 )

* Support HITL for orchestration patterns

* Cleanup around naming

* Fix typing issues

* Clean up

* Naming clean up

* Updates to HITL to make it cleaner

* Rename human input hook to orchestration request info

* Clean up per PR feedback

Evan Mattson · 2025-12-10 15:59:29 +00:00

b378ca75d1

fix: Standardize OpenAI API key environment variable naming (#1001 ) (#2629 )

- Replace OPENAI_APIKEY with OPENAI_API_KEY across all samples
- Replace AZURE_FOUNDRY_OPENAI_APIKEY with AZURE_FOUNDRY_OPENAI_API_KEY
- Ensures consistency with OpenAI's standard naming convention
- Applies to .NET and Python samples

Fixes #1001

Co-authored-by: Alexander Zarei <alzarei@users.noreply.github.com>

Alexander Zarei · 2025-12-10 10:33:35 +00:00

2f0b2db12a

azureai image gen sample update (#2709 )

Giles Odigwe · 2025-12-09 13:50:04 +00:00

b55095f0fb

Python: Fix DurableState schema serializations (#2670 )

* Fix created at

* Add pattern matching

Laveesh Rohra · 2025-12-08 22:38:45 +00:00

71d9d268dd

Python: Update fan in fan out sample to show concurrency (#2705 )

* Update fan in fan out sample to show concurrency

* Update python/samples/getting_started/workflows/parallelism/fan_out_fan_in_edges.py

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

---------

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

Tao Chen · 2025-12-08 19:53:37 +00:00

d7ca96923b

fixes Python: DevUI fails when uploading Pdf file (tested on Python Foundry Agent) (#2675 )

Fixes #2652

Victor Dibia · 2025-12-08 17:00:57 +00:00

0675000f4b

Python: Feature/fix context provider lifecycle agentic mode (#2650 )

* refactor KB for index creation logic

* add user agent header for tracking

* fix mypy issues

* fix agentic mode bug for search context provider

---------

Co-authored-by: farzad528 <farzad528@users.noreply.github.com>

Farzad Sunavala · 2025-12-08 09:52:18 +00:00

551219cb55

Improve sample logging (#2692 )

Evan Mattson · 2025-12-08 06:56:45 +00:00

c34af002b8

Renamed async_credential to credential (#2648 )

Dmytro Struk · 2025-12-08 01:21:18 +00:00

cfcb71334a

Python: Added Azure OpenAI Responses File Search sample + Integration test update (#2645 )

* added azure responses file search sample + int test update

* sample update to use token credential

Giles Odigwe · 2025-12-05 19:01:48 +00:00

f5f909f2e2

Python: Support an autonomous handoff flow (#2497 )

* Support an autonomous handoff flow.

* Simplify public API

* Address feedback

Evan Mattson · 2025-12-05 07:13:22 +00:00

b78a2b6d2e

Python: WorkflowBuilder registry (#2486 )

* Add workflow builder factory pattern

* Add internal edge groups to registered executors; next samples

* Update samples: Part 1

* register -> register_executor

* update hil samples

* Update other samples

* Update agent  samples

* Update doc string

* Add new sample

* Fix mypy

* Address comments

* Fix mypy

Tao Chen · 2025-12-05 05:26:10 +00:00

f2ed5b55f6

Python: AzureAI Local MCP Sample (#2616 )

* added azure ai local mcp sample

* small fix

* handling for local mcp

* remove redundant local mcp handling

Giles Odigwe · 2025-12-04 19:10:00 +00:00

365e438981

Python [BREAKING]: support magentic agent tool call approvals and plan stalling HITL behavior (#2569 )

* Provide way for HITL with magentic

* support tool call approvals and hitl stall replan

* human plan intervention sample

* Clean up

* Improve loging

* updates

Evan Mattson · 2025-12-04 05:13:27 +00:00

19ac6e57c0

Python: Add executor I/O data to ExecutorInvokedEvent and ExecutorCompletedEvent (#2591 )

* Add executor I/O data to ExecutorInvokedEvent and ExecutorCompletedEvent

* Sample cleanup

Evan Mattson · 2025-12-04 01:41:40 +00:00

f7a9005235

Python: added inline yaml sample (#2582 )

* added inline yaml sample

* fixed some typos and added intro comment

* added description params and pass through to client

* add azure assistants

* fix tests

* observabiltiy mypy fix

* for some reason mypy doesn't accept a subclass

---------

Co-authored-by: Evan Mattson <35585003+moonbox3@users.noreply.github.com>

Eduard van Valkenburg · 2025-12-04 01:30:56 +00:00

d774b64df0

Python: Document ChatKit frontend requirements and air-gapped limitations (#2587 )

- Add "Requirements and Limitations" section to chatkit package README
- Add "Network Requirements" and "Limitations" sections to chatkit-integration sample README
- Add explanatory comments in frontend code for CDN dependency and domain key configuration

Fixes #2347

Victor Dibia · 2025-12-04 01:19:14 +00:00

42ffe59592

Python: Enable Agentic Mode to Use Existing Knowledge Bases Without index_name (#2464 )

* refactor KB for index creation logic

* add user agent header for tracking

* fix mypy issues

---------

Co-authored-by: farzad528 <farzad528@users.noreply.github.com>

Farzad Sunavala · 2025-12-03 16:00:59 +00:00

b5595f6f70

504 Commits