agent-framework

Python: OpenAI Responses Image Generation Stream Support, Sample and Unit Tests (#1853 )

* support for image gen streaming

* small fixes

* fixes

* added comment

Giles Odigwe · 2025-11-11 19:01:37 +00:00

1d7292fba6

Python: Handle agent user input request in AgentExecutor (#2022 )

* Handle agent user input request in AgentExecutor

* fix test

* Address comments

* Fix tests

* Fix tests

* Address comments

* Address comments

Tao Chen · 2025-11-11 18:59:57 +00:00

cd9073aa11

Python: Fix Model ID attribute not showing up in invoke_agent span (#2061 )

* Best effort to surface the model id to invoke agent span

* Fix tests

* Fix tests

Tao Chen · 2025-11-10 22:32:04 +00:00

448aff536a

Python: Fix underlying tool choice bug and all for return to previous Handoff subagent (#2037 )

* Fix tool_choice override bug and add enable_return_to_previous support

* Add unit test for handoff checkpointing

* Handle tools when we have them

Evan Mattson · 2025-11-10 10:55:52 +00:00

548e0f028e

Python: Updates to Tools (#1835 )

* updated tool samples

* mypy and readme fixes

* updated call logic

* added function invocation config

* added include detailed error

* added tests

* updated FRC exception handling

* updated tests

* fix oai test

* fix name in sample

* imporoved tests coverage and removed some dead code paths

Eduard van Valkenburg · 2025-11-05 08:33:19 +00:00

51b32ed1ac

Fix mcp tool cloning for handoff pattern (#1883 )

Evan Mattson · 2025-11-04 22:49:34 +00:00

d5040236c9

Python: [BREAKING] consolidate workflow run APIs (#1723 )

* consolidate workflow run apis

* improve validation, add tests

* Proper code tags for docs

* Update sample output

* Remove cycle validation

* PR feedback

* Validation

* Cleanup

Evan Mattson · 2025-11-03 23:34:59 +00:00

50d9b13bfc

Python: fix middleware and cleanup confusing function (#1865 )

* fix middleware and cleanup redundant function

* added test to validate

Eduard van Valkenburg · 2025-11-03 18:42:59 +00:00

e462d209fd

Python: Ensure agent thread is part of checkpoint (#1756 )

* ensure agent thread is part of checkpoint

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

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

* remove data copying for server side thread.

* refine warning check

---------

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

Eric Zhu · 2025-10-31 15:48:43 +00:00

889f45a7ef

[BREAKING] Python: Remove request_type param from ctx.request_info() (#1824 )

* Remove request_type param from ctx.request_info()

* Address comments

Tao Chen · 2025-10-31 14:31:15 +00:00

68b6a55757

[BREAKING] Python: Replace RequestInfoExecutor with request_info API and @response_handler (#1466 )

* Prototype: Add request_info API and @response_handler

* Add original_request as a parameter to the response handler

* Prototype: request interception in sub workflows

* Prototype: request interception in sub workflows 2

* WIP: Make checkpointing work

* checkpointing with sub workflow

* Fix function executor

* Allow sub-workflow to output directly

* Remove ReqeustInfoExecutor and related classes; Debugging checkpoint_with_human_in_the_loop

* Fix Handoff and sample

* fix pending requests in checkpoint

* Fix unit tests

* Fix formatting

* Resolve comments

* Address comment

* Add checkpoint tests

* Add tests

* misc

* fix mypy

* fix mypy

* Use request type as part of the key

* Log warning if there is not response handler for a request

* Update Internal edge group comments

* REcord message type in executor processing span

* Update sample

* Improve tests

Tao Chen · 2025-10-29 23:31:23 +00:00

943d92674e

Python: Fix type compatibility check (#1753 )

* Fix type compatibility check

* Address comments

Tao Chen · 2025-10-29 00:48:01 +00:00

1fbdcf8268

Python: Added thread to AgentRunContext (#1732 )

* Added thread to agent run context

* Added sample

* Update python/samples/getting_started/middleware/thread_behavior_middleware.py

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

* Small fix

---------

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

Dmytro Struk · 2025-10-28 16:31:09 +00:00

adba312cd6

Python: reject @executor on staticmethod/classmethod with clear error message (#1719 )

* reject executor on static method w clear error

* Simplify

* Cleanup

Evan Mattson · 2025-10-27 05:31:58 +00:00

e2d1ba3192

Python: [BREAKING] Python: Intro group chat and refactor orchestrations. Fix as_agent(). Standardize orchestration start msg types. (#1538 )

* Intro group chat and refactor magentic. Fix as_agent()

* Cleanup and improvements

* Add as_agent docstring clarification

* Standardize orchestration messages to use agent-style inputs.

* Simplify group chat constructs

* Further cleanup

* Add sk to af group chat migration sample. Update README.

* Improvements and simplifications

* consolidating shared orchestration logic

* Further clean up

* Add group chat sample

* Improve typing

* Fix test imports

* Fix readme links

* Cleanup per PR Feedback

Evan Mattson · 2025-10-25 00:14:06 +00:00

e3aad8e4e0

[BREAKING] Python: Refactor Checkpointing for runner and runner context (#1645 )

* Refactor Checkpointing for runner and runner context

* exception

* Fix formatting

* Comments

* rename

* Add detailed doc string

Tao Chen · 2025-10-24 03:34:55 +00:00

31701dbb92

Python: MCP Error Handling Fix + Added Unit Tests (#1621 )

* mcp error fix

* test docstring fixes

Giles Odigwe · 2025-10-23 18:01:10 +00:00

1f19a6da5c

Python: Skip flaky openai vector store file tests (#1667 )

* Add poll interval to fix integration test

* skip flaky tests

Eric Zhu · 2025-10-23 17:31:41 +00:00

905e730dc2

Python: Add Handoff orchestration pattern support (#1469 )

* Add Handoff orchestration pattern support

* PR feedback

* Use AOAI client in samples

* Adjust to tool

* Handoff to sub-agent via ai function

* PR feedback

* More cleanup

* Improvements

* PR feedback cleanup

* Add handoff migration sample.

* Remove type ignore

* fix markdown link formatting

* Remove readme link for non-existent sample

Evan Mattson · 2025-10-22 01:51:51 +00:00

b66619a544

Code clean up: Checkpoint and WorkflowBuilder (#1557 )

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

Tao Chen · 2025-10-20 16:34:06 +00:00

083d0de3f3

Python: Updated package version (#1528 )

* Updated package version

* Update python/CHANGELOG.md

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

* Updated metadata for Purview

* Updated test

---------

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

Dmytro Struk · 2025-10-16 22:32:25 +00:00

8c24a72107

Python: Agent Name Sanitization (#1523 )

* a2a agent name sanitization

* fix

* small fix

---------

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

Giles Odigwe · 2025-10-16 20:33:25 +00:00

76ae0a62ac

Python: Enhanced documentation for dependency injection and serialization features (#1324 )

* improvements in dep injection and sample

* fix for falsy default

* fix mypy

* update to use a nested dict instead of a string.

* clarify docs

* Update python/packages/core/agent_framework/_tools.py

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

* Update python/packages/core/agent_framework/_tools.py

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

* Update python/packages/core/agent_framework/_tools.py

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

* Update python/packages/core/agent_framework/_serialization.py

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

* format

---------

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

Eric Zhu · 2025-10-13 20:34:27 +00:00

9148392d00

Python: Refactor RequestInfoExecutor (#1403 )

* Refactor RequestInfoExecutor

* Update AI script

* Fix formatting

* Address comments

* fix unit test

Tao Chen · 2025-10-13 19:18:17 +00:00

fc12ab9fed

Python: Fix Failure with Function Approval Messages in Chat Clients (#1322 )

* Python: set role=tool when processing approval responses

* Python: set role=tool when processing approval responses

* Fix approval mode with OpenAIChatClient and threads: add approval requests to assistant message, fix deduplication/rejection call_id, filter approval content, add tests and example

* update test tools after change

* Rename _collect_approval_todos to _collect_approval_responses and filter empty call_ids

Victor Dibia · 2025-10-10 18:38:23 +00:00

e032fe3993

Python: Fixed instructions duplication in model clients (#1332 )

* Small fix

* Updated instruction handling in chat clients

Dmytro Struk · 2025-10-09 14:49:03 +00:00

a02b82f022

Python: Fix deadlock in Magentic workflow (#1325 )

* Fix deadlock in Magentic workflow

* Fix unit test

Tao Chen · 2025-10-09 00:23:46 +00:00

2397795c1d

Python: improved thread serialization and deser with better tests (#1316 )

* improved thread serialization and deser with better tests

* update redis with the same

Eduard van Valkenburg · 2025-10-08 19:04:11 +00:00

a36e183600

Python: Reorganize workflows modules (#1282 )

* Reorganize modules

* Fix unit tests

* Remove submodules

Tao Chen · 2025-10-08 17:04:06 +00:00

c2c8ec3d4e

Python: fix tool call content not showing up in workflow events (#1290 )

* fix tool call content not showing up in workflow events

* fix lint

* touch up

* add another sample to show function bridge

* missing sample

Eric Zhu · 2025-10-08 16:39:08 +00:00

1c5e607a1f

Python: [BREAKING] parameter naming and other fixes (#1255 )

* parameter naming and other fixes

* fix test

* fix azure openai responses decorator ordering

* fix test

* fix mypy

* fixes in options handling

* fix tests

* final fixes

* exclude macos tests

* fix model param

Eduard van Valkenburg · 2025-10-07 21:18:48 +00:00

76900f0eab

Python: Add PDF file support to OpenAI content parser with filename mapping (#1121 )

* Add mapping for application media type in OpenAI responses client

* Enhance multimodal input samples: Add PDF testing functionality and fix image sample

* Standardize filename handling and add multimodal samples

- Standardized filename extraction logic between chat and responses clients
- Both clients now omit filename when not provided (no default fallback)
- Added Azure Responses API multimodal sample with PDF support
- Cleaned up Azure Chat sample to focus on supported features only
- Fixed test comment placement for better code documentation
- Updated README with clear API capability differences

* Enhance multimodal input samples with image and PDF handling

- Refactor image and PDF handling in `azure_chat_multimodal.py` and `openai_chat_multimodal.py` to use new utility functions.
- Add `load_sample_pdf` and `create_sample_image` functions for better test asset management.
- Remove redundant code for creating sample images and PDFs.
- Introduce a sample PDF file in `sample_assets` for testing purposes.

* Fix formatting in OpenAI chat client

---------

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

Christian Glessner · 2025-10-07 17:04:33 +00:00

8bb1266020

Python: Introduce add_agent functionality and added output_response to AgentExecutor; agent streaming behavior to follow workflow invocation (#1184 )

* refactor AgentExecutor, add output_response flag for switching on or off workflow output for each agent.

* introduce add_agent

* make default agent's streaming to false

* address comments

* fix test

* add is_streaming to RunnerContext and WorkflowContext

* fix add_agent return

* fix tests

* address comments

* resolve conflict

* update to address comments

* fix

Eric Zhu · 2025-10-07 16:11:40 +00:00

d01d9afb92

Python: added approval_mode and allowed_tools to local MCP (#1203 )

* added approval_mode and allowed_tools to local MCP

* updated docs

Eduard van Valkenburg · 2025-10-07 07:44:08 +00:00

b49395fa3d

Python: OpenAI Clients accepting api_key callback (#1139 )

* openai clients accepting callable

* fixes

* version checks

Giles Odigwe · 2025-10-06 19:51:34 +00:00

4e6ae443cf

Python: updated docstrings (#1225 )

* updated docstrings

* fix tests and mypy

* hosted file search docstring update

* updated versions

Eduard van Valkenburg · 2025-10-06 16:04:39 +00:00

714e7b50d4

feat: Add name and description support to workflows (#1183 )

Add optional name and description fields to workflows in both Python and .NET implementations, matching the existing agent API pattern.

Python changes:
- Add name/description parameters to WorkflowBuilder.__init__
- Add name/description attributes to Workflow class
- Include name/description in to_dict() serialization
- Add WORKFLOW_NAME and WORKFLOW_DESCRIPTION OTEL attributes
- Add tests in test_serialization.py and test_workflow_observability.py

.NET changes:
- Add Name and Description properties to Workflow and Workflow<T>
- Add WithName() and WithDescription() fluent methods to WorkflowBuilder
- Add WorkflowName and WorkflowDescription OTEL tags
- Add test in WorkflowBuilderSmokeTests.cs

This enables applications like DevUI to display human-readable workflow names (e.g., 'Data Processing Pipeline') instead of auto-generated UUIDs (e.g., 'Workflow 50fdd917').

Fixes: #1181

Victor Dibia · 2025-10-04 15:20:17 +00:00

5a7ca13af6

Python: Introducing AI Function approval (#1131 )

* support for local function approval

* small fix

* fix mypy

* added bigger test scenario's for function calling and approvals

* updated lock

* updated return message for rejection

* fix test

* updated function result content handling

Eduard van Valkenburg · 2025-10-04 15:19:16 +00:00

fd819c6c02

Python: Fix: MCP tool calls flatten nested JSON arguments (handle $ref schemas) (#990 )

* Initial plan

* Fix nested JSON argument flattening in MCP tools - handle $ref schemas

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

* Apply code formatting fixes from ruff linter

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

* Fixed formatting

* Refactor JSON type mapping to use match-case statement

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

---------

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

Copilot · 2025-10-01 00:22:46 +00:00

bdfa62c834

Python: [BREAKING] added SerializationMixin and applied to contents, agents, chat client… (#1012 )

* added SerializationMixin and applied to contents, agents, chat clients, removed AFBaseModel

* fix annotations type

* mypy fixes

* fix tests

* fix serializable subvalues and added large docstring

* updated indents in code block

* fixed exported urls

Eduard van Valkenburg · 2025-09-30 19:53:46 +00:00

54ad135914

Python: fix string parsing in azure openai client (#1023 )

* fix string parsing in azure openai client

* test fix

* changed setup func name and check if there is a conn string

* redid parsing in safe way

Eduard van Valkenburg · 2025-09-30 19:33:12 +00:00

3eb26632ce

Python: [BREAKING] Python: Rename workflow to workflows (#1007 )

* Rename workflow to workflows

* Update occurence of workflow to new name

Evan Mattson · 2025-09-30 11:21:34 +00:00

b42bb700fb

Python: [BREAKING] Main to core (#983 )

* removed pydantic from types

* fix assistants client

* Remove Pydantic usage from workflow code.

* updated lock and test fixes

* moved main to core, and setup meta package

* updated versions

* updated lock

* fixed agents dependency

* added retry to merge tests

---------

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

Eduard van Valkenburg · 2025-09-30 07:18:36 +00:00

35d2d9fe7f

43 Commits