agent-framework

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

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

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

Python: Updated package versions (#2737 )

* Updated package versions

* Updated changelog

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

43302fb4cd

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

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

Fix observability module mypy error (#2641 )

Tao Chen · 2025-12-04 19:11:05 +00:00

d858c23bab

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: Fix: AgentRunResponse.created_at returns local datetime labeled as UTC (#2590 )

* Initial plan

* Fix created_at to use UTC datetime and add unit tests

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

* Address code review feedback: move datetime imports to top of test files

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

* Add UTC timestamp test for OpenAIResponsesClient._create_response_content

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

* Fix lint issue

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: moonbox3 <35585003+moonbox3@users.noreply.github.com>
Co-authored-by: Evan Mattson <evan.mattson@microsoft.com>

Copilot · 2025-12-04 05:09:52 +00:00

292a2078fa

Add support for Pydantic BaseModel as function call result (#2606 )

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: Evan Mattson <35585003+moonbox3@users.noreply.github.com>

Copilot · 2025-12-04 01:41:47 +00:00

ae06c9e4bb

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: Use executor_id and edge_group_id as span names for meaningful observability traces (#2538 )

* Use executor_id and edge_group_id as span names for meaningful observability traces

* Update tests

* Adjust naming

Evan Mattson · 2025-12-04 01:03:12 +00:00

a683c0e865

Python: Add type annotations for AgentRunEvent and AgentRunUpdateEvent data attributes (#2589 )

* Add type annotations for AgentRunEvent and AgentRunUpdateEvent data attributes

* Fix unnecessary cast after typing improvement

* Mcp pkg update introduced type change. Fix it.

* update opentelemetry deps to 1.39.0 and use LogRecordExporter for type compatibility

Evan Mattson · 2025-12-04 00:40:49 +00:00

a597a925cb

Python: Pin meta core (#2597 )

* pin core dependency in the meta package

* fix for mcp latest

* fix mypy

* test fix

* test fix

* fix tests for content parsing

Eduard van Valkenburg · 2025-12-03 18:19:17 +00:00

a81279d960

feat: pass agent run kwargs through to context providers (#1681 )

`_prepare_thread_and_messages` and `_notify_thread_of_new_messages` now are passing through the agent's `run` kwargs, sothat they can provide the context_provider with said kwargs

#1679

Co-authored-by: David Jadczyk <david.jadczyk@lht.dlh.de>
Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>
Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

David Jadczyk · 2025-12-02 14:35:32 +00:00

1edd28b264

Fix MangenticAgentExecutor producing repr str for tool call content (#2566 )

Evan Mattson · 2025-12-02 08:40:11 +00:00

c2d285e614

Python: Emit ExecutorFailedEvent before WorkflowFailedEvent when executor throws exception (#2537 )

* Emit ExecutorFailedEvent before WorkflowFailedEvent when executor throws exception

* Cleanup

Evan Mattson · 2025-12-02 01:21:28 +00:00

0d5d10d24a

Python: Add sample to show handoff as agent with HITL (#2534 )

* Add sample to show handoff as agent with HITL

* Update uv.lock with latest pkg versions. Fix lint error.

* Upgrade grpcio to 1.76.0

* Handle grpcio versions

* Case insensitive compare for declarative

Evan Mattson · 2025-12-02 00:50:13 +00:00

e3b700ad9f

Python: Refactor ag-ui to clean up some patterns (#2363 )

* Refactor ag-ui to clean up some patterns

* Mypy fixes

* Fix imports, typing, tests, logging.

* Fix test import error

* Fix imports again

* Fix thread handling

Evan Mattson · 2025-11-27 02:13:03 +00:00

8cf8b0f995

Python: docs: Update Python orchestration documentation (#2087 )

* docs: Update Python orchestration documentation

Remove outdated 'coming soon' statements for GroupChat, Sequential,
and Concurrent orchestrations in core package README and transparency FAQ.

Add links to existing samples in python/samples/getting_started/workflows/orchestration/.

Note: python/README.md was already updated in PR #1914 (2499262f).

Fixes documentation inconsistency found in Issue #1899.

* Address review feedback: make TRANSPARENCY_FAQ language-neutral

Remove Python-specific sample links from TRANSPARENCY_FAQ.md as it should
pertain to all MAF languages (Python and .NET), not strictly Python.

The python/packages/core/README.md retains the specific sample links as
that is Python-specific documentation.

* Update Learn documentation link in README

---------

Co-authored-by: kishikawa-hayato <84244732+HerBest-max@users.noreply.github.com>
Co-authored-by: Victor Dibia <chuvidi2003@gmail.com>

Hayato Kishikawa · 2025-11-27 00:13:15 +00:00

6c624319db

[BREAKING] Python: Standardize orchestration outputs as list of ChatMessage. Allow agent as group chat manager. (#2291 )

* Standardize orchestration outputs as list of chatmessage. Add chat options to group chat prompt manager

* refactor group chat

* Improve group chat manager

* README Update

* Cleanup

* Add comment

* More cleanup

* Standardize termination condition for group chat

* Improvements on termination logic

* Fix tests

* Fix new line

* PR feedback

* Update ChatKit based on OpenAI type change

* Raise error if response format is not expected type

* Only one starting executor required. Add tests.

* Add magentic start executor test

Evan Mattson · 2025-11-26 07:51:04 +00:00

907d79ab3c

Python: [BREAKING] Removed default "store" value (#2443 )

* Removed default store value

* Small fix

Dmytro Struk · 2025-11-25 17:53:08 +00:00

b8260ae24c

[BREAKING] Python: Adjust magentic event types raised. No need for custom events. (#2215 )

* Adjust magentic event types raised. No need for custom events.

* Cleanup

* Fix test

* Update python/packages/core/agent_framework/_workflows/_magentic.py

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

---------

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

Evan Mattson · 2025-11-25 08:24:08 +00:00

27b3a517eb

Python: fix for logging setup (#2371 )

* fix for logging setup

* typo fixes

* fix text

Eduard van Valkenburg · 2025-11-25 08:19:34 +00:00

1b4103dce3

350 Commits