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

Update README.md to change Grafana links to Azure portal links for dashboard access (#1983 )

wuweng · 2025-11-11 05:08:33 +00:00

177b0c95be

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: DevUI: Add OpenAI Responses API proxy support + HIL for Workflows (#1737 )

* DevUI: Add OpenAI Responses API proxy support with enhanced UI features

This commit adds support for proxying requests to OpenAI's Responses API,
allowing DevUI to route conversations to OpenAI models when configured to enable testing.

Backend changes:
- Add OpenAI proxy executor with conversation routing logic
- Enhance event mapper to support OpenAI Responses API format
- Extend server endpoints to handle OpenAI proxy mode
- Update models with OpenAI-specific response types
- Remove emojis from logging and CLI output for cleaner text

Frontend changes:
- Add settings modal with OpenAI proxy configuration UI
- Enhance agent and workflow views with improved state management
- Add new UI components (separator, switch) for settings
- Update debug panel with better event filtering
- Improve message renderers for OpenAI content types
- Update types and API client for OpenAI integration

* update ui, settings modal and workflow input form, add register cleanup hooks.

* add workflow HIL support, user mode, other fixes

* feat(devui): add human-in-the-loop (HIL) support with dynamic response schemas

Implement  HIL workflow support allowing workflows to pause for user input
with dynamically generated JSON schemas based on response handler type hints.

Key Features:
- Automatic response schema extraction from @response_handler decorators
- Dynamic form generation in UI based on Pydantic/dataclass response types
- Checkpoint-based conversation storage for HIL requests/responses
- Resume workflow execution after user provides HIL response

Backend Changes:
- Add extract_response_type_from_executor() to introspect response handlers
- Enrich RequestInfoEvent with response_schema via _enrich_request_info_event_with_response_schema()
- Map RequestInfoEvent to response.input.requested OpenAI event format
- Store HIL responses in conversation history and restore checkpoints

Frontend Changes:
- Add HILInputModal component with SchemaFormRenderer for dynamic forms
- Support Pydantic BaseModel and dataclass response types
- Render enum fields as dropdowns, strings as text/textarea, numbers, booleans, arrays, objects
- Display original request context alongside response form

Testing:
- Add  tests for checkpoint storage (test_checkpoints.py)
- Add schema generation tests for all input types (test_schema_generation.py)
- Validate end-to-end HIL flow with spam workflow sample

This enables workflows to seamlessly pause execution and request structured user input
with type-safe, validated forms generated automatically from response type annotations.

* improve HIL support, improve workflow execution view

* ui updates

* ui updates

* improve HIL for workflows, add auth and view modes

* update workflow

* security improvements , ui fixes

* fix mypy error

* update loading spinner in ui

---------

Co-authored-by: Mark Wallace <127216156+markwallace-microsoft@users.noreply.github.com>

Victor Dibia · 2025-11-07 23:28:32 +00:00

94eae24082

Python: [Purview] Add Caching and background processing in Python Purview Middleware (#1844 )

* [PythonPurview] Add Caching and background processing

* [PythonPurview] Updates based on comments

Rishabh Chawla · 2025-11-07 07:43:22 +00:00

64826b8f56

Python: Thread Samples Fix (#1945 )

* thread samples fix

* custom chat message store fix

Giles Odigwe · 2025-11-06 02:59:22 +00:00

ee1661ecb7

Add simple workflow sample that mixes agents and executors (#1946 )

* Add workflow mix agent executor samples

* Apply suggestion from @Copilot

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

---------

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

Tao Chen · 2025-11-05 22:40:25 +00:00

9b471cc479

Python: [BREAKING] Replaced AIProjectClient with AgentsClient in Foundry (#1936 )

* Replaced AIProjectClient with AgentsClient in Foundry

* Update python/samples/getting_started/observability/azure_ai_agent_observability.py

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

* Update python/samples/getting_started/observability/azure_ai_chat_client_with_observability.py

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

* Small fix

* Removed TODO item

---------

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

Dmytro Struk · 2025-11-05 21:42:36 +00:00

d701e796cb

Python: Added parameter to disable agent cleanup in AzureAIAgentClient (#1882 )

* Removed automatic agent cleanup in AzureAIAgentClient

* Revert "Removed automatic agent cleanup in AzureAIAgentClient"

This reverts commit 89846c7212.

* Exposed boolean flag to control deletion behavior

* Update sample

Dmytro Struk · 2025-11-05 16:56:19 +00:00

14aee7e334

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

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: Introducing the Anthropic Client (#1819 )

* initial version of anthropic connector

* updated implementation and added tests

* fix type and readme

* mypy fix and int tests enabled

* add integration test setup

* updated based on comments

* improved function result handling

* added extra unordered test

* updated from review

* fix tool choice handling

* same fix for chat client

Eduard van Valkenburg · 2025-11-03 19:32:28 +00:00

12d17acdc0

[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

Python: [BREAKING] Cleanup of dependencies (#1803 )

* removed extra and non-released deps

* added comments

* added space and lock

* fix pyright config

Eduard van Valkenburg · 2025-10-30 15:24:29 +00:00

434ffb8ab8

Python: Azure AI Search Support Update + Refactored Samples & Unit Tests (#1683 )

* azure ai search sample update

* azure ai search update

* small fix

Giles Odigwe · 2025-10-30 02:30:06 +00:00

2059e7b3e8

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

Python: Added Samples for HostedCodeInterpreterTool with files (#1583 )

* code interpreter with files

* import fix

Giles Odigwe · 2025-10-21 01:37:53 +00:00

e8a7d3b1b7

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: Remove deprecated add_agent() calls from workflow samples (#1508 )

* Initial plan

* Remove add_agent calls from workflow samples

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

---------

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

Copilot · 2025-10-17 02:25:31 +00:00

151efd2e80

Python: Add Purview Middleware (#1142 )

* [Py Purview] Purview Python Initial Commit

* [Py Purview] Purview Python Minor Fixes

* [Py Purview] Purview Python Comment Fixesish

* [Py Purview] Purview Python Agent Middleware Done

* [Py Purview] Purview Python Agent Middleware Done

* [Py Purview] Purview Python Lint Errors

* [Py Purview] Purview Python Final Hopefully

* [Py Purview] Purview Python Final Hopefully

* [Py Purview] Purview Python Fix ReadMe

* [Py Purview] Purview Python Fix MyPy

* [Py Purview] Purview Python Minor Updates on comments

* [Py Purview] Purview Python Fix Build Error

---------

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

Rishabh Chawla · 2025-10-16 21:46:04 +00:00

59da578902

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

Added example with MCP and authentication (#1389 )

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

Dmytro Struk · 2025-10-10 19:10:24 +00:00

29cb87b805

Python: Fix AI Search Tool Sample and improve AI Search Exceptions (#1206 )

* Python: Fix AI Search Tool Sample and improve AI Search Exceptions

* Python: Fix AI Search Tool Test

---------

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

Hassan Warsi · 2025-10-10 18:46:57 +00:00

350cdfc1cd

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: AzureAI Bing Connection Name Support (#1364 )

* bing connection name support

* error handling + unit tests

* connection id and name handling

Giles Odigwe · 2025-10-09 21:13:07 +00:00

7238cde5af

Python: Added function approval example with streaming (#1365 )

* Added function approval example with streaming

* Update python/samples/getting_started/tools/ai_tool_with_approval.py

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

---------

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

Dmytro Struk · 2025-10-09 17:31:36 +00:00

9fe4a61dd0

Python: samples: add api_key for Ollama sample usage (#1240 )

* samples: add api_key for Ollama sample usage

* Update python/samples/getting_started/agents/ollama/ollama_with_openai_chat_client.py

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

* fix: update Ollama API key to an unused constant

---------

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

Mars Wang · 2025-10-08 20:45:24 +00:00

3d31a4a204

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

146 Commits