agent-framework

Python: Included existing agent definition in requests to Azure AI (#1285 )

* Fixed instructions handling for existing Azure AI agents

* Updated tool handling for existing agents

* Small update

* Added more comments

Dmytro Struk · 2025-10-08 20:33:57 +00:00

7e891fab39

Python: DevUI - Internal Refactor, Conversations API support, and per… (#1235 )

* Python: DevUI - Internal Refactor, Conversations API support, and performance improvements

Comprehensive refactor of DevUI package including samples relocation,
frontend reorganization, OpenAI Conversations API support, and critical
performance and code quality improvements.

Key Changes:

Architecture & Organization
- Moved DevUI samples to python/samples/getting_started/devui/
- Consolidated with other framework samples for better discoverability
- Added .env.example files and comprehensive README
- Restructured frontend components into feature-based folders (agent, workflow, gallery, layout)
- Created new OpenAI-compliant message renderers (devui should render oai responses types primarily)

New Features
- Added _conversations.py (467 lines) - Full conversation storage abstraction, replaces the /threads endpoint to better match oai conversations api
- Implements OpenAI Conversations API for thread management, Supports in-memory and extensible storage backends

API Simplification
- Use 'model' field as entity_id (agent/workflow name) instead of extra_body
- Use standard OpenAI 'conversation' field for conversation context.

Performance & Quality Improvements
- Improved context management in MessageMapper with bounded memory (~500KB max)
- Implemented hybrid LRU + cleanup approach to prevent unbounded memory growth
- General QOL improvement - Eliminated ~150 lines of dead/duplicate code, Consolidated helper functions into _utils.py, Extracted magic numbers to module-level constants, Optimized conversation item lookups with index-based approach

Testing
- Added test_conversations.py (13 tests)
- Added test_performance_fixes.py (9 tests)
- Updated existing tests for code consolidation
- 53 tests passing

Impact: 76 files changed: +4,106 insertions, -2,373 deletions
All linting and formatting checks passing. No breaking changes - backward compatible.

Migration: Samples moved to python/samples/getting_started/devui/

* readme lint fixes

* initial support for function approval and minor ui fixes

Victor Dibia · 2025-10-08 19:34:30 +00:00

c341ee7ed2

Python: sample with Foundry Redteams (#1306 )

* sample with evals

* remove demo output

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

f5abbc67ae

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: AzureAI Agent AI Search Sample (#1281 )

* azure ai search sample

* small fix

Giles Odigwe · 2025-10-08 15:52:02 +00:00

334d52f300

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: Added method to expose agent as MCP server (#1248 )

* Added method to expose agent as MCP server

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

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

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

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

* Addressed PR feedback

* Updated doc string

---------

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

Dmytro Struk · 2025-10-07 17:21:53 +00:00

a45e2ab28e

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: ollama + azureai openapi samples fix (#1244 )

* ollama + azureai openapi samples fix

* small fix

Giles Odigwe · 2025-10-07 16:14:34 +00:00

1d27b57672

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: Sample on integration of Azure OpenAI Responses Client with a local MCP server (#1215 )

* added a sample on integration of Azure OpenAI Responses Client with hosted Model Context Protocol (MCP)

* added additional comments mentioning that the Microsoft Learn MCP server can be replaced by any other desired MCP server

* corrected the MCP server type to local

* added a newline at the end

* Update python/samples/getting_started/agents/azure_openai/azure_responses_client_with_local_mcp.py

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

---------

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

Saurabh Vartak · 2025-10-07 07:54:29 +00:00

49f25358d7

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

docs: Update References to Agent2Agent protocol to use correct terminology (#1162 )

Should be `Agent2Agent Protocol` not `Agent-to-Agent` unless talking about general agent to agent communication

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

Holt Skinner · 2025-10-03 19:10:05 +00:00

50c532b4ae

docs: add missing pre flag (#1130 )

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

Vincent Koc · 2025-10-02 18:50:47 +00:00

2696de7428

Python: Added Ollama example using OpenAIChatClient (#1100 )

* Added Ollama example using OpenAIChatClient

* Small improvement

Dmytro Struk · 2025-10-02 15:14:29 +00:00

c7f20c8ec5

Python: Fix Azure AI Getting Started samples: Improve documentation and code readability (#1089 )

* Initial plan

* Fix Azure AI samples: Add dotenv support, fix async input, improve docs

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

* Remove dotenv.load_dotenv() and revert async input() changes per review feedback

Co-authored-by: dmytrostruk <13853051+dmytrostruk@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>

Copilot · 2025-10-02 03:22:44 +00:00

07db91174b

Python: Fix multimodal input sample: Document required environment variables and configuration options (#1088 )

* Initial plan

* Update multimodal input sample to document required environment variables

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

* Add examples showing how to pass deployment_name as parameter

Co-authored-by: dmytrostruk <13853051+dmytrostruk@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>

Copilot · 2025-10-02 01:34:31 +00:00

cd1bdc1483

Update getting started samples to reflect AF. Update a unit test. (#1093 )

Evan Mattson · 2025-10-02 01:20:12 +00:00

4f4890cf6a

.NET: Add link inspector (#1062 )

* Add link inspector

* Comment out excludedirs while it's empty

* Fix broken links

* More links fixes

* Push further fixes

* Fix more links

westey · 2025-10-01 16:43:17 +00:00

364188c44f

Python: Foundry Agent Completeness (#954 )

* foundry completeness

* tests + openapi sample

* bing grounding sample

* options integration tests

* merge conflict fix

* fix failing test

* add mcp approval handling

Giles Odigwe · 2025-10-01 13:38:51 +00:00

b0971fdec6

Agents + Chat Client Samples Doctsring Updates (#1028 )

* agents + chat client samples doctsring updates

* fixes

Giles Odigwe · 2025-10-01 07:18:53 +00:00

b88143b686

Python: Tool definitions otel (#936 )

* added tool_definitions

* removed json dump

* improved logic

* updated for pydantic

Eduard van Valkenburg · 2025-09-30 20:11:54 +00:00

40f5b6d8fe

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: Update installation instructions (#1026 )

* Update installation instructions

* address comments

Tao Chen · 2025-09-30 19:28:54 +00:00

f7e9490494

.Net: Visualizing dotnet workflows (#882 )

* Adding more test for workflow vizualization.

* Improving README for sample.

* More cleanup.

* Removing rendering of workflow visualization and adding basic support for mermaid format.

* Adding basic mermaid tests.

* Improving sample. Switching to another branch.

* About to merge from main.

* Formatting.

* More fromatting.

* Removng uneeded call to ToUpper.

* Adding README.

* Moving samples under workflow to workflows.

* Removing uneeded README for map-reduce sample.

Ben Thomas · 2025-09-30 16:29:19 +00:00

df3e12b2ed

Python: [Doc] Update python observability sample with Grafana dashboards (#995 )

* Update python observability sample with Grafana dashboards

* fix case

---------

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

wuweng · 2025-09-30 16:16:20 +00:00

522bf4bf23

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] removed pydantic from types and workflows (#917 )

* removed pydantic from types

* fix test

* fix test

* fix tests

* fix assistants client

* Remove Pydantic usage from workflow code.

* updated pydantic removal

* updated lock and test fixes

* fix mypy

* updated build system

* updated chat client parsing

* fix broken test

---------

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

Eduard van Valkenburg · 2025-09-29 21:19:58 +00:00

b4ebafa9b1

Python: basic python a2a support (#906 )

* basic python a2a support

* fixes

* small fixes

---------

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

Giles Odigwe · 2025-09-29 17:53:45 +00:00

c102706146

Python: [BREAKING] cleanup of thread API and serialization (#893 )

* cleanup of threads and serialization

* fix for sliding window

* fix redis test

* updated from comments

* updated context provider and threads

* updated lock

* add asyncio default

* fix redis tests

* fix tests

* fix tests

* renamed to invoking

* fixed tests

* fix for instructions

Eduard van Valkenburg · 2025-09-29 16:22:34 +00:00

10d10364a9

Small fixes (#969 )

Dmytro Struk · 2025-09-29 08:43:00 +00:00

4cd76bf2b0

Added structured output to agent streaming (#943 )

Dmytro Struk · 2025-09-27 17:07:17 +00:00

f2f0d40437

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: Add support for Mem0 Open Memory (#876 )

* Add support for Mem0 Open Memory

* Linting fixes

* Linting fixes

* Add sample and documentation

* Small fixes

* Update sample code imports/class names for new package structure

* Improved typing

---------

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

amritpal-singh-98 · 2025-09-26 09:50:40 +00:00

ef9c072eab

Python: typo fix (#920 )

* typo fix

* fixed two other typos

Eduard van Valkenburg · 2025-09-26 08:15:54 +00:00

0f2f2263c5

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: Clean left-over WorkflowCompletedEvent (#884 )

* Clean left-over WorkflowCompletedEvent

* Improve comments

* Fix type check error

Tao Chen · 2025-09-24 00:52:51 +00:00

36933de345

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: additional Foundry Tools (#611 )

* initial work on additional foundry tools

* fixes

* fix tests

* fix import

* updated lock

* added hosted MCP for foundry

* fixes

* fix for test

* updated samples

* fix result parsing

Eduard van Valkenburg · 2025-09-23 11:20:20 +00:00

9eb68ab2f9

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: add RedisContextProvider (#716 )

* Setting up

* Readme

* Add redis tests path to all-tests

* First pass integration

* Keep provider convention

* First pass integration

* add redis integration tests

* update README.md

* Add basic sample for redis integration

* Add partitioning, add partition-aware tests, improve sample script

* Fix code quality check

* Try to resolve pytest check

* Try to identify if pytest is the cause of failed checks

* Re-enable tests

* Rename redis test file

* Removing some tests to narrow down issue

* Revert, no difference

* Delete temp files

* Starting refactor of RedisProvider

* Build dynamic schema builder, still need to do dynamic embedding model config

* Add scope control

* Complete first pass functionality with OpenAI + HF vectors -> Tests, Samples, Demo to follow

* Fix code quality

* attempt to identify rootcause of failed test

* attempt to identify rootcause of failed test

* Attempt to resolve code quality fail

* Update pyproject.toml for foundry to pin     azure-ai-projects == 1.1.0b3,azure-ai-agents == 1.2.0b3

* Add tests for redisprovider

* Remove invalid tests

* Add API key handling for openai vectorizer

* Update uv.locl

* Use master uv.lock

* Begin sample file, add lazy index creation, fix faulty override

* Index drop and reinit depends on drop_redis_index not overwrite

* Add samples, threading included, escaped queries, verify threading works, sample README.md

* Refactor filters

* Opinionated vars

* Allow filter expression combination

* Try inline stubs for mypy

* Address mypy errors

* Better docstrings, tweaks for feedback

* Tweak example 3 in redis_threads.py sample

* adjust confusing name

* Enrich docstrings

* Add descriptions and comments to samples, externalize vectorizer choice, remove nltk and sentencetransformers dependnecy

* Add descriptions and comments to samples, externalize vectorizer choice, remove nltk and sentencetransformers dependnecy

* Incorporate initial feedback from dmytrostruk

* Fix uv.lock

* Attempt to resolve conflict

* Use remote .tomls

* Sanity check

* fix tests

* Remove hardcoded API key from samples

* Fix incorrect env var

* Make add and redis_search private

* Fix tests relying on private funcs

* Expand tests

* Explainer comments to each test

* Add a 'get_conversation_history' function to RedisProvider - This just returns messages in sequential order. Added 'created_at_*' timestamps to facilitate sequential recovery. function has to be manually invoked by user

* Add agent-framework-redis to  python/pyproject.toml

* Remove get_conversation_history

* improve redis context provider with pydantic techniques and safe index handling patterns

* add RedisChatMessageStore

* remove integration test :(

* fix mypy error

* Remove unused params

* Redo schema validation to be order-invariant, handle attrs (previously throwing errors due to strict ==)

* Expand explanation

* Add ChatMessageStore example

* Fix comments in redis_conversation.py

* Resolving uv.lock conflict, update to match main

* Fix test in redis provider

* Apply suggestion from @ekzhu

* Update python/packages/main/pyproject.toml

---------

Co-authored-by: Tyler Hutcherson <tyler.hutcherson@redis.com>
Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>

Han · 2025-09-23 00:36:27 +00:00

ca810076e8

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: Add custom agent and chat client implementation examples (#849 )

* Initial plan

* Add custom agent and chat client examples with complete implementations and documentation

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

* Simplify custom examples per feedback: remove __init__.py, keep only EchoAgent/EchoingChatClient, add proper documentation, update README table format

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

* Small fixes and formatting

---------

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

Copilot · 2025-09-22 04:42:33 +00:00

39566d1dbf

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: Added Anthropic agent example (#850 )

* Added Anthropic example

* Small fix

Dmytro Struk · 2025-09-22 04:04:07 +00:00

08f792e511

113 Commits