agent-framework

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

* azure ai search sample

* small fix

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

334d52f300

Update readme.md sample to show sample parameter values and switch to openai sdk (#1265 )

* Update readme.md sample to show sample parameter values and make azure sdk pre-release

* Add clarifying comment about params.

* Switch sample to use the OpenAI SDK

westey · 2025-10-08 10:56:34 +00:00

523127fbf4

.NET: [BREAKING] Propagate CancellationToken into Workflow Executors and message handlers (#1280 )

* feat: Propagate CancellationToken to Executors

* Also adds cancellation propagation to `Executor`-accessible APIs
* Adds registrators for cancellable handlers to `RouteBuilder`
* [BREAKING]: Adds `CancellationToken` to `IMessageHandler.HandleAsync`

* test: Re-enable Concurrent Orchestration test

* refactor: Delete unused IInputCoordinator

* refactor: Remove superfluous argument qualifications

Jacob Alber · 2025-10-08 00:28:44 +00:00

dotnet-1.0.0-nightly-251008.1 5902bcb10a

.NET Workflows - Enhance support and validation for image input (#1274 )

* Updated

* Comments

* Namespace

* Comment

* Cleanup

* Update agent definition

* Disable

* Config

* Enable

Chris · 2025-10-08 00:00:34 +00:00

eb049c43a6

.NET: Add Azure Monitor OpenTelemetry Exporter samples (#1231 )

* Add Azure Monitor OpenTelemetry Exporter to enhance observability in agent samples

* add another sample code for application isnights

wuweng · 2025-10-07 23:16:32 +00:00

362652b966

Reference the correct JsonUtilities class (#1270 )

westey · 2025-10-07 22:02:19 +00:00

127bf68748

Python: bump version and update changelog (#1277 )

* bump version and update changelog

* undo lab package version bump

* add changelog to exclude pattern for links

* fix for ignore path

* exclude file

Eduard van Valkenburg · 2025-10-07 21:41:59 +00:00

python-1.0.0b251007 8b73b5b1be

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

Updated (#1272 )

Chris · 2025-10-07 19:09:41 +00:00

1a81ed202e

.NET: Add Orchestration SK->AF migration samples (#1044 )

* Add Orchestration SK->AF migration samples

* fix samples

* clean up

* Add handoff

* Comments

* Address comments

* Fix build error

* Comments

Tao Chen · 2025-10-07 18:54:41 +00:00

df5477921b

Python: Add CHANGELOG.md to python folder with all merged PRs since first release (#1205 )

* Initial plan

* Add CHANGELOG.md to python folder with all merged PRs since 1.0.0b251001

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

* Update python/CHANGELOG.md

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

* Update python/CHANGELOG.md

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

* fixed headers in changelog

---------

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: Eduard van Valkenburg <eavanvalkenburg@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: eavanvalkenburg <github@vanvalkenburg.eu>

Copilot · 2025-10-07 18:34:10 +00:00

dotnet-1.0.0-preview.251007.1 93577f76b1

Version preview.251007.1 (#1271 )

Mark Wallace · 2025-10-07 18:30:12 +00:00

2b2d3a44a5

Rename AsAIAgent to GetAIAgent and update for foundry as well (#1257 )

westey · 2025-10-07 18:19:18 +00:00

554e1617b3

Bump Aspire.Hosting.Azure.CognitiveServices from 9.5.0 to 9.5.1 (#1200 )

---
updated-dependencies:
- dependency-name: Aspire.Hosting.Azure.CognitiveServices
  dependency-version: 9.5.1
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

dependabot[bot] · 2025-10-07 18:16:12 +00:00

b2c5d797f7

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

enable enum serialization as strings and relaxed json escaping (#1267 )

SergeyMenshykh · 2025-10-07 17:07:13 +00:00

1cff86b4ff

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

Removing duplicating update coalescing logic in AgentRunResponseExtensions (#1169 )

Stephen Toub · 2025-10-07 13:42:01 +00:00

959e5842c2

.NET: Enable access to hosted AIAgents via OpenAI Responses (#947 )

* init

* wip

* wip wip wip

* wip wip

* open up API

* enable for multiple agents

* more wip

* make frontend respond.

* wip

* not sure if proper setup

* define type

* cleanup

* frontend streaming wip

* use System.Net.ServerSentEvents

* usings

* reformat via ichatclient

* merge main renaming + refactor

* fix main merge + fix sample (a2a change)

* fix sample

* some rebase (not working yet)

* make it at least build somehow

* make non-stream work without internal types

* Input without custom models

* implement streaming

* test frontend

* enable alerts and fix

* build fixes & rereview

* Update dotnet/src/Microsoft.Agents.AI.Hosting.OpenAI.Responses/Microsoft.Agents.AI.Hosting.OpenAI.Responses.csproj

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

* Update dotnet/src/Microsoft.Agents.AI.Hosting.OpenAI.Responses/Utils/ResponseItemJsonConverter.cs

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

* fix agent discovery

* rename

* rename project into Microsoft.Agents.AI.Hosting.OpenAI (no responses in name)

* PR address comments x1

* address PR comments x2

* correctly instantiate OpenAIResponse

* address PR comments x3

* reconfigure JSON serialization & handle AOT warnings

* fix build

* proper ref

* check update differently

* correct check

* exclude dotnet format diagnostics for IL2026 and IL3050

* space  :)

* re-review

* add comments

* remove unnecessary using

* always take last openai response item

* set responseItem Id explicitly

* add agent.name validation for uri

* cleanup

---------

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

Korolev Dmitry · 2025-10-07 12:39:08 +00:00

d10b44d6bb

.NET: Improve structured output for chat client agent (#1172 )

* improve structured output for chat client agent

* add comment to the result property

* remove code duplication and add tests

* refactor the CreateAIAgent extension methods to return specific types, so consumers can avoid unnecessary downcasting.

* fix type and remove unused using.

* add ChatClientAgentRunResponse and move AgentRunResponse to the abstractions package to reuse later.

* seal ChatClientAgentRunResponse

* update xml comment

* remove funcitons from sample

* rename agent for streaming

SergeyMenshykh · 2025-10-07 12:04:26 +00:00

3fd5768b34

Add AzureCLI to the dev containers (#1254 )

westey · 2025-10-07 10:46:54 +00:00

5117d7da5c

.NET: Add a CreateAIAgent extension method to IChatClient (#1223 )

* Add a CreateAIAgent extension method to IChatClient

* Fix unit tests

* Add tests with null chat clients to ensure appropriate failure

* Switch to similar constructor

* Add ChatClientBuilder BuildAgent extensions

* Address code review comments.

westey · 2025-10-07 09:47:33 +00:00

3dc14dac79

.NET: Fix bug where ChatClientAgent throws when providing a ChatMessageStore with a service that requries service storage (#1229 )

* Fix bug where ChatClientAgent throws when providing a ChatMessageStore with a service that requries service storage

* Update dotnet/tests/Microsoft.Agents.AI.UnitTests/ChatClient/ChatClientAgentTests.cs

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

---------

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

westey · 2025-10-07 08:31:34 +00:00

74905af778

.NET: Add sample to show ChatReducer usage (#1221 )

* Add sample to show ChatReducer usage

* Apply suggestion from @Copilot

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

---------

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

westey · 2025-10-07 08:17:31 +00:00

7506046f43

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

[BREAKING] .NET: Workflow Off-Thread Execution Mode (#1233 )

* Updates to async run loop.

* fix: Workflow Onwership can be release by nonowner

* fix: Incorrect handling of blockOnPending in StreamingRun

Depending on whether we are running in streaming on non-streaming mode, we may be using the StreamingRun in different ways. Unfortunately, the only place we can really know what is the actual state of execution is in the RunEventStream implementations.

This resulted in blocking where blocking was unneeded and occasionally not-blocking when blocking was needed.

The fix is to move the logic of handling this blocking into RunEventStream implementations.

* fix: Fix cleanup on error and end run

This ensures we clean up the background resources correctly.

* fix: Ensure we let the run loop proceed when shutting down

* fix: Add timeout for Input Waiting

* fix: Make the samples properly clean up `Run`s and `StreamingRun`s

* fix: Simplify Declarative Workflow Run disposal pattern

* Also fixes missing .Disposal() in Integration tests

---------

Co-authored-by: Ben Thomas <ben.thomas@microsoft.com>

Jacob Alber · 2025-10-07 01:07:38 +00:00

dotnet-1.0.0-nightly-251007.1 7ebe00ec3d

.NET Workflows - Fix code generation cases (#1242 )

* Updated

* Passing

* Ready

* Update dotnet/tests/Microsoft.Agents.AI.Workflows.Declarative.IntegrationTests/Workflows/ConversationMessages.yaml

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

* Comment

* Code analysis

* Unit-tests/provider signature

* Comment

* Consistent

* Checkpoint

* Fixed

* Revert

* Test display name

* Enable tests

---------

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

Chris · 2025-10-06 23:34:46 +00:00

0113e0466d

Bump danielpalme/ReportGenerator-GitHub-Action from 5.4.13 to 5.4.16 (#966 )

Bumps [danielpalme/ReportGenerator-GitHub-Action](https://github.com/danielpalme/reportgenerator-github-action) from 5.4.13 to 5.4.16.
- [Release notes](https://github.com/danielpalme/reportgenerator-github-action/releases)
- [Commits](https://github.com/danielpalme/reportgenerator-github-action/compare/5.4.13...5.4.16)

---
updated-dependencies:
- dependency-name: danielpalme/ReportGenerator-GitHub-Action
  dependency-version: 5.4.16
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

dependabot[bot] · 2025-10-06 23:29:23 +00:00

477c0dbf1a

Bump Aspire.Hosting.AppHost from 9.5.0 to 9.5.1 (#1199 )

---
updated-dependencies:
- dependency-name: Aspire.Hosting.AppHost
  dependency-version: 9.5.1
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

dependabot[bot] · 2025-10-06 23:26:35 +00:00

fb95a92fce

Bump Aspire.Microsoft.Azure.Cosmos from 9.5.0 to 9.5.1 (#1201 )

---
updated-dependencies:
- dependency-name: Aspire.Microsoft.Azure.Cosmos
  dependency-version: 9.5.1
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

dependabot[bot] · 2025-10-06 23:26:07 +00:00

00d5a09e01

.NET Workflows - Fix converation behaviors for declarative worfklows (#1237 )

* Updated

* Passing

* Ready

* Update dotnet/tests/Microsoft.Agents.AI.Workflows.Declarative.IntegrationTests/Workflows/ConversationMessages.yaml

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

* Comment

* Code analysis

* Unit-tests/provider signature

* Comment

* Consistent

---------

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

Chris · 2025-10-06 22:04:41 +00:00

dotnet-1.0.0-nightly-251006.2 f81b4a5abe

Correcting parameter assignment and using parameter naming vs relying on position (#1239 )

Michael McKechney · 2025-10-06 21:46:37 +00:00

f1694b0507

docs: update dev.md to fix "Get the Code" section (#1217 )

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

Kim · 2025-10-06 19:53:34 +00:00

66009c617d

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

test: Make ChatClientAgent no-message test less flaky (#1196 )

Capitalize instruction and relax assertion to accept any non-empty response instead of requiring exact text match. Fixes flaky test failures with reasoning models.

Victor Dibia · 2025-10-06 19:09:01 +00:00

ee8d95b3dc

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

Bump AWSSDK.Extensions.Bedrock.MEAI from 4.0.3.2 to 4.0.3.5 (#1102 )

---
updated-dependencies:
- dependency-name: AWSSDK.Extensions.Bedrock.MEAI
  dependency-version: 4.0.3.5
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

dependabot[bot] · 2025-10-06 15:16:35 +00:00

b2ab9931fd

Add Devcontainers to allow easy use of the AF repo from github codespaces (#1224 )

* Add dev containers

* Add workspace folder and cs dev extension

* Try other workspace folder format

* Add default solution.

* Move default solution to settings.json

* Fix repo open

* Remove duplicate python codespace and rename folder

* Add recommended C# extensions and a default build task

* Add vscode icons extension by default

* Add python setup and customizations, plus ai studio for all

* Add bash command

* Try running devsetup from workspace folder

* Remove echo and cd

* Change workspace mount

* Change dotnet workspace name

* Revert workspacemount addition

* Try workspace mount to root

* remove trailing slash

* Try workspacefolder with var

* Revert to original approach

* Modify dev containers to work in main repo.

* Remove trailing comma

* Apply suggestion from @Copilot

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

---------

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

westey · 2025-10-06 14:20:34 +00:00

b839669eee

.NET: Fix A2A conversion routines to ignore unknown content types instead of throwing exceptions (#1154 )

* Initial plan

* Update A2A conversion routines to ignore unknown content types

Co-authored-by: stephentoub <2642209+stephentoub@users.noreply.github.com>

* Fix dotnet format

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: stephentoub <2642209+stephentoub@users.noreply.github.com>
Co-authored-by: Stephen Toub <stoub@microsoft.com>
Co-authored-by: SergeyMenshykh <68852919+SergeyMenshykh@users.noreply.github.com>

Copilot · 2025-10-06 10:29:43 +00:00

62854197aa

Align skill naming (#1207 )

Fixing what looks like a simple copy-paste naming issue

Andrew Nikolin · 2025-10-06 07:43:04 +00:00

4c5c6d0f98

2155 Commits