agent-framework

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: cleanup and refactoring of chat clients (#2937 )

* refactoring and unifying naming schemes of internal methods of chat clients

* set tool_choice to auto

* fix for mypy

* added note on naming and fix #2951

* fix responses

* fixes in azure ai agents client

Eduard van Valkenburg · 2025-12-18 12:02:23 +00:00

e5c11d38d6

Python: fix: correct BadRequestError when using Pydantic model in response_fo… (#1843 )

* fix: correct BadRequestError when using Pydantic model in response_format

* Fix lint

---------

Co-authored-by: Evan Mattson <evan.mattson@microsoft.com>

samueljohnsiby · 2025-12-18 08:42:00 +00:00

0298e0a401

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: Correction of MCP image type conversion in _mcp.py (#2901 )

* Correction of MCP image type conversion in  _mcp.py

* Added a new overload to the init function of the DataContent() type of the Agent Framework, edited the test case to correctly test the usage of the data and uri fields while using DataContent()

* Fixed tests related to the changes of the DataContent type, added testing for both string and byte representations

Ege Ozan Özyedek · 2025-12-17 16:11:39 +00:00

ee53fe4666

Added additional arguments for Azure AI agent (#2922 )

Dmytro Struk · 2025-12-17 08:08:01 +00:00

3cd805f0bf

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

Updated Ollama package version (#2920 )

Dmytro Struk · 2025-12-17 00:42:27 +00:00

ec1c5e9c11

Fix Pydantic error when using Literal type for tool params (#2893 )

Evan Mattson · 2025-12-17 00:27:01 +00:00

06cdcb93f0

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: Switch to new "run" method name. (#2890 )

* Switch to `run` method.

* Add support for deprecated `run_agent`.

* Fix entity method name.

* Fix method name and improve tests.

* Update comment.

* Update Python CHANGELOG.

Phillip Hoff · 2025-12-16 22:08:12 +00:00

2bde58f915

Updated package versions (#2913 )

Dmytro Struk · 2025-12-16 18:51:44 +00:00

e319707058

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: Fix middleware terminate flag to exit function calling loop immediately (#2868 )

* Fix middleware terminate flag to exit function calling loop immediately

* Eliminating duck typing

* Improve function exec result handling

* Fix race condition

* Fix mypy issues

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

11d6dcfe80

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

Python: Use agent description in HandoffBuilder auto-generated tools (#2713 ) (#2714 )

## Summary
Enhanced `HandoffBuilder._apply_auto_tools` to use the target agent's
description when creating handoff tools, providing more informative tool
descriptions for LLMs.

## Changes
- Modified `_apply_auto_tools` to extract `description` from
  `AgentExecutor._agent` when available
- Updated iteration to use `.items()` for more efficient dict traversal
- Handoff tools now use agent descriptions instead of generic placeholders

## Example
Before: "Handoff to the refund_agent agent."
After: "You handle refund requests. Ask for order details and process refunds."

## Testing
- All handoff tests pass (20/20)
- No breaking changes to existing API

Fixes #2713

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

刘邦学AI · 2025-12-16 01:31:26 +00:00

3c379718e9

Python: Fix WorkflowAgent to emit yield_output as agent response (#2866 )

* Fix WorkflowAgent to emit yield_output as agent response

* use raw_representation

* Raw representation handling

Evan Mattson · 2025-12-16 01:14:26 +00:00

a7298757f5

Python: Filter framework kwargs from MCP tool invocations (#2870 )

* Filter framework kwargs from MCP tool invocations

* Fixes

Evan Mattson · 2025-12-16 01:10:09 +00:00

0dcebc6eae

Python: Remove warnings from workflow builder on not using factories (#2808 )

* Revert concurrent

* Fix comments

Tao Chen · 2025-12-12 07:56:16 +00:00

e0ff153ee9

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

Python: Updated package versions (#2784 )

* Updated package versions

* Small fix

Dmytro Struk · 2025-12-11 18:39:08 +00:00

8d53b20026

Python: added more complete parsing for mcp tool arguments (#2756 )

* added more complete parsing for mcp tool arguments

* fixed mypy

* added nonlocal model counter, and some fixes

* fixes in naming logic

* extracted json parsing function, added parametrized test and checked coverage

Eduard van Valkenburg · 2025-12-11 17:24:08 +00:00

c376868ec9

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

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

3481914981

Python: fix: GroupChat ManagerSelectionResponse JSON Schema for OpenAI Structured Outpu… (#2750 )

* fix: ManagerSelectionResponse JSON Schema for OpenAI Structured Output Strict Mode

* refactor: install pre-commit then commit again

Kurt · 2025-12-11 02:34:12 +00:00

4c6a5d4aa1

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: Change DurableAIAgent log level from warning to debug when invoked without thread (#2736 )

* Initial plan

* Change logger.warning to logger.debug for missing thread

Co-authored-by: larohra <41490930+larohra@users.noreply.github.com>

* Fix test to use getMessage() method for log records

Co-authored-by: larohra <41490930+larohra@users.noreply.github.com>

* Remove test for logging change per review feedback

Co-authored-by: larohra <41490930+larohra@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: larohra <41490930+larohra@users.noreply.github.com>
Co-authored-by: Laveesh Rohra <larohra@microsoft.com>

Copilot · 2025-12-10 17:57:08 +00:00

3f4eeb00be

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

Python: Updated package versions (#2737 )

* Updated package versions

* Updated changelog

Dmytro Struk · 2025-12-09 22:58:45 +00:00

43302fb4cd

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: Title: DevUI Fix WorkflowFailedEvent error extraction (#2706 )

* Title: Fix WorkflowFailedEvent error extraction to use details instead of error Body:
Summary
Fixed WorkflowFailedEvent mapping to extract error message from details.message instead of non-existent error attribute
Added support for including details.extra context in error messages when present
Problem
The WorkflowFailedEvent handler in _mapper.py was reading event.error, but WorkflowFailedEvent uses a details attribute (of type WorkflowErrorDetails), not error. This caused all workflow failures to display "Unknown error" in the UI instead of the actual error message.
Fix
Updated the handler to match the pattern already used by ExecutorFailedEvent:
Read from event.details instead of event.error
Extract details.message for the error text
Include details.extra context when available

* improve error handling consistency

Victor Dibia · 2025-12-08 21:44:32 +00:00

d889fa6f87

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: DevUI, Fix message serialization issue, improve tests (#2674 )

* fix message serialization issue, improve tests for devui

* update tests

Victor Dibia · 2025-12-06 02:20:54 +00:00

8c6b12e664

Python: Add configurable timeout support to A2AAgent (#2432 )

* a2a timeout config

* added default timeout info

---------

Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

Giles Odigwe · 2025-12-05 22:21:36 +00:00

2d3ba95036

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: Display system prompt in langfuse (#2653 )

* Display system prompt in langfuse

* Explain that the system_instructions are put first into the list

SuperKenVery · 2025-12-05 17:11:29 +00:00

f43261094f

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

Updated package versions (#2643 )

Dmytro Struk · 2025-12-04 22:08:47 +00:00

f5786b2c5b

1019 Commits