agent-framework

Python: Added chat middleware and more examples (#883 )

* Added example with stateful middleware

* Added chat middleware

* Updated middleware example with override scenario

* Small revert

* Small fixes

* Added kwargs to context objects

* Added README

* Added function middleware to chat client

* Small refactoring

* Reverted example files

* Made MiddlewareWrapper generic

* Added Middleware exception

* Small refactoring

* Small fix

Dmytro Struk · 2025-09-26 15:10:56 +00:00

eec7f192eb

Python: support checkpoints for workflow orchestrations and sub-workflows (#863 )

* Magentic checkpoint wip

* Magentic checkpoint updates

* Support checkpointing for magentic orchestration.

* Checkpointing for sub-workflows

* Use _execute_contexts instead of _pending_requests

* Remove unnecessary type ignores

* Support checkpoints for other orchestrations, refactor some code.

* Regenerate uv.lock

Evan Mattson · 2025-09-26 02:21:06 +00:00

2cd7ab342b

[BREAKING] Python: Observability cleanup (#905 )

* Further observability cleanup and update telemetry samples

* Add VS Code Extension config

* Fix unit tests

* Fix unit tests

* Add more comments

* Remove live metric

Tao Chen · 2025-09-25 18:50:50 +00:00

a480ccfd16

Python: [BREAKING] updated structure and samples (#875 )

* updated structure and samples

* updated names and removed cross tests

* updated projects etc

* updated tests

* updated test

* test fixes

* removed devui for now

* updated all-tests task

* removed old style configs

* remove coverage from tests

* updated to unit tests with all-tests

* updated foundry everywhere

* fix azure ai tests

* fix merge tests

* fix mypy

Eduard van Valkenburg · 2025-09-25 07:02:53 +00:00

9355329dfd

Python: [BREAKING] Remove Request Interceptor Architecture - Simplify Sub-workflow Communication (#898 )

* removed intercepts_request and simplified how interception is handled

* parameterize SubWorkflowRequestInfo

* revert back the field rename of RequestResponse

* remove duplicate tests

* ignore type error

* remove SubWorkflowResponse

* Remove SubWorkflowRequestInfo and update RequestInfoMessage with source_executor_id for correlation

Eric Zhu · 2025-09-25 12:43:37 +09:00

366a7f7d47

Python: Fixed parameter handling in OpenAI Responses client (#887 )

* Small fix in OpenAI Responses parameters

* Updated test

Dmytro Struk · 2025-09-24 15:17:40 +00:00

6975309c38

Python: Allow union types in FanIn edge group (#868 )

* Improve type utils

* Add sample

* Add Union

* Add more test cases

* Add more test cases

* Fix RequestResponse typing to only coerce mapping original_request

---------

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

Tao Chen · 2025-09-23 21:02:00 +00:00

b28e1db478

Python: [Breaking] Remove WorkflowCompletedEvent, introduce workflow output and migrate to ctx.yield_output() + a huge refactoring (#845 )

* Introduce input and output types for executor and workflow

* WorkflowOutputContext handles two types

* Remove can_handle_types from Executor

* Update validation

* Move workflow executor

* Move workflow executor

* Fix issues in WorkflowExecutor

* refactor executor

* update execute signature to create workflow context within Executor

* fix simple sub workflow test; fix validation

* fix output types in WorkflowExecutor

* fix issue in Executor handling of SubWorkflowRequestInfo

* update tests to use proper workflow output

* update orchestration patterns to use output

* Update sample -- not finished

* Update python/packages/main/tests/workflow/test_workflow_states.py

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

* Update python/packages/main/tests/workflow/test_concurrent.py

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

* address comments

* WorkflowOutputContext --> WorkflowContext

* remove WorkflowCompletedEvent

* update samples

* Update doc string for important classes; update WorkflowExecutor to support concurrent execution

* use Never instead of None for default type

* Update usage of WorkflowContext[None to WorkflowContext[Never

* address comments

* remove filter for None

* address comments, minor fixes

* quality of life improvement on interceptor types

---------

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

Eric Zhu · 2025-09-23 20:52:53 +00:00

2133043f11

Python: Telemetry and observability follow-up (#833 )

* updated telemetry work

* updated telemetry

* slight improvement

* updated tests

* fixes for telemetry

* fixes for mypy

* added settings setup to runner to avoid error

* streamline usage

* updated tests

* updated tests

* further refinement

* fix dumped item for otel

* removed enable_workflow_otel

* final fixes

* final fixes

* updated samples

* removed exporters

* fix tests

* fixed last import'

* fixed devui

Eduard van Valkenburg · 2025-09-23 06:21:56 +00:00

2576e7a091

Python: Introduce as_tool() for BaseAgent (#684 )

* introduce as_tool for BaseAgent

* fix types

* fix tests

* add async callback support

* address comments

* Update python/packages/main/agent_framework/_agents.py

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

* address comments

---------

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

Eric Zhu · 2025-09-23 01:37:04 +00:00

f93f16a9ad

Python: OpenAI Responses Image Generation Tool (#842 )

* Image generation + Added Samples

* extended image gen tool for responses

* uv fix

* removed hosted image gen

* copilot suggestions

* Update python/packages/main/agent_framework/openai/_responses_client.py

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

---------

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

Giles Odigwe · 2025-09-22 22:38:44 +00:00

adb6dcd2af

Python: Extending middleware capabilities (#844 )

* Implemented termination

* Added termination sample

* Allowed middleware pipeline modification

* Added run-level middleware

* Added more validation to function-based middleware

* Added example with function-based decorator approach

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

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

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

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

* Small improvements

* Fixed tests

---------

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

Dmytro Struk · 2025-09-22 04:37:57 +00:00

f61d8abe58

Python: [BREAKING] Python: Make executor ID required, improvements around handling rehydrating checkpoints (#832 )

* Make executor ID required, improvements around handling rehydrating checkpoints.

* Duplicate executor validation added

* fix remaining issues

---------

Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>

Evan Mattson · 2025-09-19 18:57:09 +00:00

aba094b5cf

Python: Fix: Add meaningful error message when graphviz binary is not installed (#826 )

* Initial plan

* Fix: Add meaningful error message for missing graphviz binary

Co-authored-by: ekzhu <320302+ekzhu@users.noreply.github.com>

* Fix CI error: Make graphviz test conditional to avoid import errors

Co-authored-by: ekzhu <320302+ekzhu@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: ekzhu <320302+ekzhu@users.noreply.github.com>
Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>

Copilot · 2025-09-19 05:56:49 +00:00

965918b883

Python: Agent and Function middleware (#770 )

* Initial middleware implementation

* Small fixes

* Small updates

* Small updates in samples

* Moved middleware functionality to decorator

* Removed obsolete file

* Renamed AgentInvocationContext to AzureRunContext

* Added unit tests

* Small settings update for test discovery in VS Code

* Added unit tests

* Reverted changes in environment settings

* Added context result override

* Renaming and updates to logic

* Added more samples

* Updated DEV_SETUP.md

* Addressed PR feedback

* Addressed PR feedback

* Removed unused parameter

* Small fix

* Small fix in telemetry logic

* Revert "Small fix in telemetry logic"

This reverts commit 6f82660d2d.

* Small fix

---------

Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>

Dmytro Struk · 2025-09-18 23:30:05 +00:00

99860a5d07

Python: Workflow event source updates (#789 )

* Workflow event source updates

* Add WorkflowLifecycleEvent TypeAlias. Update docstrings

* Updates

* Rename

---------

Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>

Evan Mattson · 2025-09-18 15:17:55 +00:00

960196cd52

Python: Enhance tool call handling and function result processing (#790 )

* Tool call enhancement

* add tests

* fix comments

* resolve comments

---------

Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>
Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>

Yuge Zhang · 2025-09-18 04:13:30 +00:00

1dba779f76

Python: Fix falsy values being filtered out in ChatOptions.to_provider_settings (#787 )

* Python: Fix temperature=0 filtered out in chat options

* fix failing tests

---------

Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>

Yuge Zhang · 2025-09-18 03:57:37 +00:00

4c80e7017d

Python: Fix Multimodal input bug (#799 )

* fix multimodal bug python

* update file names

* precommit fixes

* Update python/samples/getting_started/multimodal_input/README.md

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

* udpate readme

* add copyright line, remove audio example function

---------

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

Victor Dibia · 2025-09-17 21:44:42 +00:00

f3264966ff

Python: Add base_url support to OpenAI settings and improve initialization (#788 )

Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>

Yuge Zhang · 2025-09-17 07:56:11 +00:00

3050c8c8bd

Python: [BREAKING] Move workflow to main package (#767 )

* Move workflow to main package

* Remove workflow specific unit test config

* Remove workflow-specific version info

* Revert unintended telemetry changes

* Removed the obsolete packages/workflow/tests target

* Rename dir workflow to _workflow

* Fix test imports

Evan Mattson · 2025-09-16 12:04:07 +00:00

732d9f6cd7

Python: added args and results to function call span (#733 )

* added args and results to function call span

* add ignores for mypy

* improved serialization

* also add None result

* improved handling

* log args when None

* slight tweak

* fix tests

Eduard van Valkenburg · 2025-09-15 18:28:01 +00:00

db58a10a37

.NET: Python: OpenAI Responses Agent Completeness (#721 )

* OpenAI Responses Agent Completeness

* prepare options

* added unit tests

* azure responses test fix

* resolved conflict

* pre commit fix

* Revert "Merge remote changes and resolve conflicts"

This reverts commit 56787f25a4, reversing
changes made to f71a27ebfe.

* Fixes

* azure responses file search fix

* Fix corrupted uv.lock file

---------

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

Giles Odigwe · 2025-09-15 16:19:53 +00:00

0715e0f8d3

Python: Add OpenAI reasoning events support to Responses client (#698 )

* feat: add OpenAI reasoning events support with comprehensive test coverage

- Implement reasoning event handling in OpenAI Responses client
  * Add support for ResponseReasoningTextDeltaEvent
  * Add support for ResponseReasoningTextDoneEvent
  * Add support for ResponseReasoningSummaryTextDeltaEvent
  * Add support for ResponseReasoningSummaryTextDoneEvent
  * Map all reasoning events to TextReasoningContent objects
  * Preserve metadata across reasoning events

- Add comprehensive test coverage (5 focused test functions)
  * test_streaming_reasoning_text_delta_event
  * test_streaming_reasoning_text_done_event
  * test_streaming_reasoning_summary_text_delta_event
  * test_streaming_reasoning_summary_text_done_event
  * test_streaming_reasoning_events_preserve_metadata

- Add sample demonstrating reasoning functionality
  * Shows how to enable reasoning in chat options
  * Demonstrates accessing reasoning content from responses

- Code quality improvements
  * Follow existing code patterns and style guidelines
  * Organize imports properly
  * Maintain backwards compatibility
  * All tests pass and quality checks succeed

* fix: resolve type errors and cleanup unused imports after rebase

- Add proper hasattr checks for optional attributes in union types
- Remove unused OpenAI event type imports
- Fix line length formatting issues
- Ensure type safety when accessing content attributes

Christian Glessner · 2025-09-12 12:07:49 +00:00

f79fbfa92e

Python: Context providers abstraction and Mem0 implementation (#631 )

* Added context provider abstractions

* Added mem0 implementation

* Example and small fixes

* Added unit tests for agent

* Added unit tests for mem0 provider

* Updated README

* Small doc updates

* Update python/packages/mem0/agent_framework_mem0/_provider.py

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

* Small fixes in tests

* Renaming based on PR feedback

* Small fixes

* Added tests for AggregateContextProvider

* Small improvements

* More improvements based on PR feedback

* Small constant update

* Added more examples

* Added README for Mem0 examples

* Small updates to API

* Updated initialization logic

* Updates for context manager

* Updated Context class

* Dependency update

* Revert changes

* Fixed tests

---------

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

Dmytro Struk · 2025-09-10 21:11:42 +00:00

57d09afe04

Python: Improved telemetry setup (#421 )

* test with stack and simplified names

* quick demo of agent decorator

* moved builder to protocol to enhance functionality

* undid chatclientAgent -> agent rename

* one more

* reverted AIAgent rename

* final reverts

* fixed foundry import

* revert changes

* streamlined otel and fcc decorators

* cleanup of telemetry

* further refinement

* lots of updates

* fixed typing

* fix for mypy

* added input and output atttributes

* fix import

* initial work on baking in otel

* major update to telemetry

* final fixes after rename

* fix

* fix test

* updated tests

* fix for tests

* fixes for tests

* updated based on comments

* removed agent decorator

* fix for Python: ServiceResponseException when using multiple tools
Fixes #649

* addressed comments

* fix tests

* fix tests

* fix tools tests

* fix for conversation_id in assistants client

* fix responses test

* fix tests and mypy

* updated test

* foundry fix

---------

Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>

Eduard van Valkenburg · 2025-09-10 14:52:42 +00:00

82ca4065cb

Python: Introducing UserInputRequest and Response types and HostedMcpTool (#405 )

* initial work on User Approval (and hosted mcp to validate)

* small update to the comments in the sample

* enable local MCP tools in chatClient get methods

* working streaming and improved setup

* fix for pyright

* updated create_approval -> create_response method

* added tests

* updated HostedMcpTool and addressed feedback

* update type name

* naming updates

* small docstring update

* mypy fix

* fixes and updates

* fixes for responses

* fix int tests

* removed broken tests

* updated test running

* removed specific content check on websearch

* increased timeout

* split slow foundry test

* don't parallel run samples

* add dist load to unit tests

---------

Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>

Eduard van Valkenburg · 2025-09-10 13:37:34 +00:00

6aa746d891

Python: add base_url parameter for openai chat client (#661 )

* added base_url option for openai chat client

* fix test url

Eduard van Valkenburg · 2025-09-09 23:31:26 +00:00

383d51443c

Python: Samples Integration Tests (#615 )

* Samples Tests

* small fixes

* job fix

* telemetry dependency fix

* job error fix

* sorting provider specific tests

* telemetry fixes

* openai file search fix

---------

Co-authored-by: Giles Odigwe <gilesodigwe@microsoft.com>

Giles Odigwe · 2025-09-08 23:45:51 +00:00

ee56314a26

Python: name changes executed (#607 )

* name changes executed

* updated adr to accepted

* renamed openai base config

* renamed openai config to mixin

* added renames in user docs

* reverted mcperror

* fix tests

* remove sse from tests

Eduard van Valkenburg · 2025-09-04 15:00:38 +00:00

40ab6e9d67

Removed list_messages method from thread (#564 )

Dmytro Struk · 2025-08-29 22:51:52 +00:00

2037e533b3

improved openai integration tests (#553 )

Co-authored-by: Giles Odigwe <gilesodigwe@microsoft.com>

Giles Odigwe · 2025-08-29 21:04:02 +00:00

907792f18f

Add message id to OpenAI chat response update (#561 )

Tao Chen · 2025-08-29 19:52:30 +00:00

15f0147164

Improved exception messages (#479 )

Dmytro Struk · 2025-08-25 14:46:48 +00:00

4b9eea906f

Python: Improved main package test coverage (#445 )

* Fixed failing foundry tests and improved main coverage

* Add back mistakenly deleted code

* Update python/packages/main/tests/openai/test_openai_assistants_client.py

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

* Update python/packages/main/tests/openai/test_openai_assistants_client.py

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

* Small fix

---------

Co-authored-by: Giles Odigwe <gilesodigwe@microsoft.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

Giles Odigwe · 2025-08-20 20:18:48 +00:00

123a0bca10

Python: Web search file search tools (#395 )

* Add web and file search tools

* add tests

* PR comments

* Add tools support for chat and assistants clients

* fix code checks

* add tests for assistants client

* Add samples

* fix fn descriptions

* Add openai responses model id to environment variables

---------

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

peterychang · 2025-08-15 19:35:23 +00:00

0410f51777

Python: Thread storage and serialization (#394 )

* Updates for message store support

* Added unit tests

* Added suspend-resume example

* Added example with custom chat message store

* Small fix

* Addressed PR feedback

* Renaming and documentation

* More renaming

* Addressed more PR feedback

* Small fixes in Foundry chat client and examples

* Small update

* Addressed PR feedback

* Increased timeout for Azure tests

Dmytro Struk · 2025-08-14 21:15:42 +00:00

dea736e550

Python: Introducing Local MCP Servers (#389 )

* mcp parts

* mcp parts 2

* removed structured output in favor of handling in chatresponse, mcp as AITool and running samples

* updated naming

* fixed test

Eduard van Valkenburg · 2025-08-13 09:48:22 +00:00

ad3d8171bf

Python: openai updates (#388 )

* openai updates

* rebuild of openai structure

* updated responses structure

* renamed sample

* added file id support to code interpreter

* added hosted file ids to code interpretor

* mypy fixes

* removed default az cred from codebase

* updated agent name setup

* added kwargs to entra methods

* and further kwargs

* extra comment

* updated all samples

* readded custom get methods for responses

* updated int tests with ad credential

* missed one

Eduard van Valkenburg · 2025-08-12 06:14:22 +00:00

df9d85d1f0

Python: added HostedFileContent and HostedVectorStoreContent (#379 )

* added HostedFileContent and HostedVectorStoreContent

* added convenience functions for hostedcodeinterpretertools

* fix docstrings

* udpated docstring

* clarified parsing logic

* updated type names

* updated test

* and vector stores

Eduard van Valkenburg · 2025-08-11 14:23:32 +00:00

bbc07931c1

Python: added AIAnnotation types and extra tests (#374 )

* added AIAnnotation types and extra tests

* fixed typing and such

* use copy

* fix raw representation for add

* handle annotations in add

* clarified concat

* self to first

Eduard van Valkenburg · 2025-08-08 20:27:31 +00:00

82d39bc1f7

Added author name logic to ChatClientAgent (#313 )

Dmytro Struk · 2025-08-05 05:47:52 +00:00

544d2ba48f

Python: OpenAI Assistants Chat Client and Agent (#288 )

* Initial version of assistant client

* More updates to assistant client

* Finished assistant chat client implementation

* Small fixes and basic example

* Added code interpreter example

* More examples

* Added chat client example

* Small fixes

* Added tests

* Enabled telemetry

* Small fix

* Removed files temporarily

* Revert "Removed files temporarily"

This reverts commit 5cdfa0d299.

* Small fixes

* Addressed PR feedback

* Fixed tests

* Small update

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

75794b4687

Python: add agent telemetry (#283 )

* add agent telemetry

* updated comments

* update AgentRunResponseUpdate

* updated create_agent var

---------

Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>

Eduard van Valkenburg · 2025-07-31 10:29:38 +00:00

caee8bfa90

Python: updated API in sync with dotnet (#269 )

* updated API in sync with dotnet

* fix test

* updated name and display_name

* fixed mypy setup

* add pre-commit cache

Eduard van Valkenburg · 2025-07-30 08:50:22 +00:00

1ed89d4db8

Merge tests (#247 )

* removed hardcoded model names from tests

* add debug line

Eduard van Valkenburg · 2025-07-28 11:12:28 +02:00

ba008cf4c0

Python telemetry (#223 )

* initial work on telemetry

* moved tool operation const

* missing quotes

* working otel with samples

* updated readme and other assets

* added tests

* added tests

* small updates

* updated genaiattributes docs

* updated tests

* additional warning

* cleanup of tests

Eduard van Valkenburg · 2025-07-28 07:33:42 +00:00

0ce8eb1e2f

Python: OpenAI responses client (#239 )

* Responses client WIP

* add responses class

* fix typing errors

* move test

* streaming responses, structured outputs

* tests

* Update python/packages/main/tests/openai/test_openai_responses_client.py

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

* pr comments

* fix override import

* fix mypy

* add missing function override

* PR comments

* add docstrings

---------

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

peterychang · 2025-07-25 17:56:22 +00:00

3ee9dddfa2

Python: Added fixes and more examples for OpenAI and Azure chat client agents (#232 )

* Added non-streaming and streaming examples

* Updated resource management

* Added examples with thread management

* Added function tools examples

* Small rename

* Added code interpreter example

* Updated example

* Addressed PR feedback

* Added more OpenAI and Azure chat completion examples

* File renaming

* Small fix in tests

* Small revert

* More renaming

* Small fix

Dmytro Struk · 2025-07-24 15:31:05 +00:00

a72245287f

Python: moved prepare tools into class (#215 )

* moved prepare tools into class

* moved test

* changed tool handling

* fix test

* second fix

Eduard van Valkenburg · 2025-07-22 21:37:18 +00:00

27f7af2160

59 Commits