agent-framework

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

Python: Fix runtime response format for responses client (#2440 )

* Fix runtime response format for responses client

* Handle run time schema for Azure AI Client.

Evan Mattson · 2025-11-25 07:50:20 +00:00

2a4802eac3

fix: always include output in function call result message (#2414 )

This follows the official OpenAI API schema

Tomek Słoma · 2025-11-25 00:44:43 +00:00

c78edda64f

Python: Preserve MCP array items schema in Pydantic field generation (#2382 )

* mcp tool parameter fix

* small fixes

Giles Odigwe · 2025-11-24 17:16:30 +00:00

bcbf1b33e8

Python: renamed ai search and cleanup of samples and unified import logic (#2369 )

* renamed ai search and cleanup of samples and unified import logic

* fixed error messages

* fixed folder name

* remove old samples from readme

Eduard van Valkenburg · 2025-11-24 17:06:22 +00:00

9f43108ef1

Bug fix for Redis TypeError (#2411 )

Evan Mattson · 2025-11-24 10:48:33 +00:00

f9a94ce7b5

Python: feat(mcp): add full _meta field support for CallToolResult objects (#2286 )

* feat(mcp): add full _meta field support for CallToolResult objects

- Extract and preserve complete _meta field from MCP CallToolResult responses
- Merge metadata into additional_properties of converted content items
- Handle isError field for proper error state integration
- Support arbitrary metadata like token usage, costs, and performance metrics
- Maintain backward compatibility with existing tool execution workflows
- Add comprehensive test coverage for all metadata scenarios including edge cases
- Update documentation with metadata handling examples and patterns

Fixes protocol compliance violation where _meta fields were being dropped,
enables proper monitoring and cost tracking of MCP tool usage.

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

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

* Clarify MCP _meta field test to use generic example metadata

- Updated test_mcp_call_tool_result_with_meta_arbitrary_data to use arbitrary metadata fields
- Added comments to emphasize that _meta structure is server-specific and not standardized

---------

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

Bryan Ostdiek · 2025-11-21 08:43:24 +00:00

d18ce24bf8

removed additional properties from messages sent to OAI responses and chat (#2344 )

Eduard van Valkenburg · 2025-11-21 08:41:38 +00:00

a7a0660cac

Sample to show passing in JSON schema for structured outputs (#2362 )

Evan Mattson · 2025-11-21 01:42:46 +00:00

5bdf8a774a

Updated package versions (#2360 )

Dmytro Struk · 2025-11-20 16:07:10 -08:00

cf13e35c73

Python: Feature/azure ai search agentic rag (search as separate package) (#2328 )

* Python: Fix pyright errors and move search provider to core (#1546)

* address pablo coments

* update azure ai search pypi version to latest prev

* init update

* Fix MyPy type annotation errors in search provider

- Add type annotation to DEFAULT_CONTEXT_PROMPT
- Add type annotation to vectorizable_fields
- Add union type annotation to vector_queries

* Fix DEFAULT_CONTEXT_PROMPT MyPy error and update test

- Rename DEFAULT_CONTEXT_PROMPT to _DEFAULT_SEARCH_CONTEXT_PROMPT to avoid conflict with base class Final variable
- Update test to use new constant name
- All core package tests passing (1123 passed)

* Python: Move Azure AI Search to separate package per PR feedback

Addresses reviewer feedback from PR #1546 by isolating the beta dependency
(azure-search-documents==11.7.0b2) into a new agent-framework-aisearch package.

Changes:
- Created new agent-framework-aisearch package with complete structure
- Moved AzureAISearchContextProvider from core to aisearch package
- Added AzureAISearchSettings class for environment variable auto-loading
- Added support for direct API key string (auto-converts to AzureKeyCredential)
- Added azure_openai_api_key parameter for Knowledge Base authentication
- Updated embedding_function type to Callable[[str], Awaitable[list[float]]]
- Moved Role import to top-level imports
- Maintained lazy loading through agent_framework.azure module
- Removed beta dependency from core package
- Updated all tests to use new package location
- All quality checks pass: ruff format/lint, pyright, mypy (0 errors)
- All 21 unit tests pass with 59% coverage

Semantic search mode verified working with both API key and managed identity authentication.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Python: Clarify top_k parameter only applies to semantic mode

Updated documentation to clarify that the top_k parameter only affects
semantic search mode. In agentic mode, the server-side Knowledge Base
determines retrieval based on query complexity and reasoning effort.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Python: Add Knowledge Base output mode and retrieval reasoning effort parameters

Added support for configurable Knowledge Base behavior in agentic mode:

- knowledge_base_output_mode: "extractive_data" (default) or "answer_synthesis"
  Some knowledge sources require answer_synthesis mode for proper functionality.

- retrieval_reasoning_effort: "minimal" (default), "medium", or "low"
  Controls query planning complexity and multi-hop reasoning depth.

These parameters give users fine-grained control over Knowledge Base behavior
and enable support for knowledge sources that require answer synthesis.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

* effort and outputmode query params

* Address PR review feedback for Azure AI Search context provider

* comments eduward

* ed latest comments

---------

Co-authored-by: Farzad Sunavala <farzad.sunavala.enovate.ai>
Co-authored-by: farzad528 <farzad528@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>

Farzad Sunavala · 2025-11-20 22:34:46 +00:00

04e711cd55

fix(observability): handle datetime serialization in tool results (#2248 )

Fixes #2219

Adds default=str to json.dumps() calls to handle non-JSON-serializable
types like datetime objects in tool function results.

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

Hayato Kishikawa · 2025-11-20 17:50:45 +00:00

f99dca033f

Python: Fix tool execution bleed-over in aiohttp/Bot Framework scenarios (#2314 )

* Deep copy the agent chat options to avoid mutations

* avoiding _thread.RLock pickling errors

Evan Mattson · 2025-11-20 08:06:14 +00:00

d714b91a14

Python: propagate as_tool() kwargs. Add sample for runtime context with as_tool kwargs and middleware. (#2311 )

* as tool kwargs

* simplify

Evan Mattson · 2025-11-20 00:53:44 +00:00

4fcc5a4b7d

487 Commits