agent-framework

Python: Move Workflow, Edge, EdgeGroup and Executor to AFBaseModel (#472 )

* Refactor workflow to introduce EdgeRunner for edge execution.

* Fix edge cases

* Convert Workflow, Edge, EdgeGroup, and Executor into AFBaseModel to support object model serialization

* format

* remove accidental file

* fix typing

* Add type information to EdgeGroup and Executor subclasses

* fix format

* Add condition_name field to Edge

* Add new fields

* remove Optional

* Update

Eric Zhu · 2025-08-22 22:02:34 +00:00

6e9d35830f

.NET: feat: Host Workflow as AIAgent (#469 )

* feat: Host Workflow as AIAgent

* Also changes AIAgent-as-Executor to use streaming runs and streaming
  events
* Also enables default setting for yielding events

* fix: Infinite loop in GenerateNewId()

* docs: Spelling

* test: Add Workflow-as-Agent sample and test

Jacob Alber · 2025-08-22 22:01:30 +00:00

88c51013c6

.NET: Enhance console samples while preserving copyability (#475 )

* Enhance console samples while preserving copyability

* Add readme for minimal console demo

* Suppress pre-release version warning

* Address PR comments

* Change showing settings to opt-in

* Update comment

westey · 2025-08-22 14:58:10 +00:00

71a0bf22eb

.NET: chore: support retries on Cosmos storage creation (#402 )

* support retries

* tests + registration options

* fix ordering ..

* HK + update packages

* fix paths

* Update dotnet/tests/CosmosDB.IntegrationTests/Microsoft.Extensions.AI.Agents.Runtime.Storage.CosmosDB.Tests/CosmosTestFixture.cs

* re create project and fix some pk usage

* fix all tests

* try workflow?

* wip 1

* fix definition

* try with cosmos_use_emulator env?

* try ignore SSL errors?

* other cert verifications

* hardcode to 8081?

* proper valuation of ENV

* logging

* ensure db exsists for CI

* bump

* cleanup

* fix usage

* nit comment

* try only release for stability?

* try skip some flaky tests

* merge fixes + rollback container

* reimplement with iasyncdisposable pattern

* remove example doc struct

Korolev Dmitry · 2025-08-21 18:37:12 +00:00

dotnet-0.0.1-nightly-250822.1 25291de8cb

Fix URLs in in README (#467 )

Eric Zhu · 2025-08-21 17:18:02 +00:00

1116916737

Fix AzureOpenAI version (#466 )

Roger Barreto · 2025-08-21 16:37:59 +00:00

9f934d8b55

Python: Use generic for WorkflowContext and use its type parameters to indicate executor's output types (#444 )

* Use generic for WorkflowContext and use its type parameters to indicate executor's output types

* Update

* Fix type errors and add in-line comments

* fix test

* type

* Fix executor type issues

Eric Zhu · 2025-08-21 02:40:43 +00:00

dotnet-0.0.1-nightly-250821.1 65836ab125

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: Request cancellation sample (#459 )

* request cancellation via tasks

* fix missing kwargs

peterychang · 2025-08-20 19:56:26 +00:00

feb4e908ae

.NET: Bring OpenAIResponsesChatClient temporarily (#449 )

* copy OpenAIResponsesChatClient from meai temporarly

* Update dotnet/src/Microsoft.Extensions.AI.Agents.OpenAI/NewOpenAIResponsesChatClient.cs

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

* add AsNewIChatClient extension method

---------

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

SergeyMenshykh · 2025-08-20 15:12:12 +00:00

011edfe420

.NET: Fix bugbash issues (#448 )

* Fix bugbash issues

* Update dotnet/samples/GettingStarted/Providers/AIAgent_With_OpenAIResponseClient.cs

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

---------

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

Mark Wallace · 2025-08-20 12:22:11 +00:00

0982aa9d6d

Decision on where Foundry SDK extensions should live (#442 )

* Decision on where Foundry SDK extensions should live

* Address code review feedback

Mark Wallace · 2025-08-20 11:46:19 +00:00

4277aa2576

Python: Workflow visualization. (#372 )

* Workflow visualization.

* fix typing

* address comments

* update all samples

* Update fan in edge group visual

* fix quality check

* Update python/samples/getting_started/workflow/step_06_map_reduce.py

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

* address comment

* Catch up with changes in workflow; add to_mermaid method

* Update examples

* fix test

* add installation guide to error messages

* Remove visualization for samples except for one.

---------

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

Eric Zhu · 2025-08-20 00:07:49 +00:00

dotnet-0.0.1-nightly-250820.1 6900d3456c

.NET: feat: Improve Support for AIAgent-as-Executor (#432 )

* feat: Support Executor-targeted messages

This adds support for only sending a message to a given executor. Messages will still only route through connected edges.

* feat: Support sending all valid input types after starting a run

* feat: Normalize AIAgent-as-Executor Message Protocol to use MEAI types

Jacob Alber · 2025-08-19 20:04:03 +00:00

baaa9c0aee

Fix chat options for Responses API (#441 )

peterychang · 2025-08-19 00:23:01 +00:00

dotnet-0.0.1-nightly-250819.1 953ed7560d

Enable Mypy for Workflow (#433 )

Tao Chen · 2025-08-15 22:57:28 +00:00

dotnet-0.0.1-nightly-250818.1 dotnet-0.0.1-nightly-250817.1 dotnet-0.0.1-nightly-250816.1 c0c49d31d0

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: Workflow Edge Groups (#393 )

* Introducing edge groups

* Add conditional and partitioning edge groups; next add samples and tests

* Add unit tests

* Add samples

* Address comments 1

* Address comments 2

* Update conditional edge group to take in cases and default

* Minor updates to sample

* Collapsing Paritioning Edge group and Conditional Edge group to source edge group

* Improve sample clarity

* Name consolidation

---------

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

Tao Chen · 2025-08-15 18:11:35 +00:00

ed86baa6cb

Python: Foundry Chat Client unit tests to improve coverage (#423 )

* Add unit tests for Foundry Chat Client to improve coverage

* Updated Azure OpenAI endpoint and tests timeout

* Error fixes for Foundry Chat Client tests

* Error fixes

---------

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

Giles Odigwe · 2025-08-15 17:45:14 +00:00

19d91bb950

.NET: Update MEAI 9.8.0 and accepted proposed abstractions (#427 )

* Update MEAI 9.8.0 and accepted proposed abstractions

* Address manual change in samples

* Address warnings

* Revert "Address warnings"

This reverts commit 52a7d60129.

Roger Barreto · 2025-08-15 17:34:56 +00:00

753f336a3a

.NET: Bring some MEAI types to AF temporarily. (#426 )

* Bring some MEAI types to AF temporarily.

* Exclude the copied files from code completion.

westey · 2025-08-15 15:41:45 +00:00

db253ccda0

.NET: Update OpenTelemetry Agent - Added Demo, AIAgentMetadata and Agent.GetService() (#356 )

* OTEL Demo

* updating telemetry sample

* OTEL updates

* WIP

* Adding GetService and Agent Metadata for Telemetry

* WIP

* Add UT for OTEL System behavior

* Address Unicode problem

* Add logging

* Adjust for new extensions

* Change Logger to LoggerFactory for the extension method

* Address AI Feedback

* Simplify script and readme just for Azure OpenAI

* Increase code converage

* Address merge conflict

* Another slnx fix

* Address PR comments

* Address PR feedback + Add UT

* Added Hosting UT to the solution

* Address PR comments

* Address missing sensitivity tests

* Remove unecessary override

* Address PR comments

Roger Barreto · 2025-08-15 15:41:21 +00:00

531132057b

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

dotnet-0.0.1-nightly-250815.1 dea736e550

Small fix in Foundry chat client and samples (#407 )

Dmytro Struk · 2025-08-14 20:21:23 +00:00

95cb20ca40

Azure package unit tests to improve coverage (#414 )

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

Giles Odigwe · 2025-08-14 16:19:44 +00:00

4007785b66

.Net: WIP: feat: Define Workflow and Executor APIs (#261 )

* feat: Define Workflow and Executor APIs

* feat: Define IExecutionContext and Events

* feat: Simple Workflow Demos

* refactor: Move Workflows classes to separate assembly

* feat: Move FanOut/In to LowLevel API with new semantics

* feat: Implement Local Execution

* refactor: Assembly name .Workflow => .Workflows

* feat: Enable Default Message Handling

* also lifts Bind in MessageHandlerInfo to better be able to direclty invoke handlers (for AOT, later)

* feat: Implement StreamingHandle APIs

This allows the user to respond to WorkflowEvents with external messages, enabling HIL.

* feat: Add checks for duplicate edges and chain cycles

* feat: Add built-in WorkflowEvents

* refactor: Pull classes into own files

* refactor: Simplify Disposal pattern in Executor

* refactor: Break EdgeRunner file into per-type files

* refactor: Use Throw.IfNull()

* refactor: Remove AddLoop()

Per https://github.com/microsoft/agent-framework/pull/272#discussion_r2241739079 we decided this was not very useful.

* refactor: Normalize use of ValueTask

* fix: Build Break from removing .AddLoop

* refactor: Explicit routing and RouteBuilder

Split out reflection from MessageRouter implemention into build phase, enabling AOT compilation to drive RouteBuilding without reflection.

* test: Add Reflection/Invocation tests

* fix: Terminate on Completion event

* refactor: Update public API surface

* feat: Add support for external requests

* feat: Support hosting AIAgent instances in Workflows

* fix: Fix routing to go through Executor.ExecuteAsync

* test: Update samples for "must SendMessage" semantics

* Add invoking samples to unit tests to avoid future breaks

* fix: ExternalRequest should block Workflow completion

* feat: Normalize API surface against Python

* Also adds xmldoc to all public APIs

* refactor: Normalize UnitTest and Sample namespaces

* fix: Formatting

* refactor: Normalize project/folder names

* feat: Remove DynamicCodeExecution from ValueTaskTypeErasure

* fix: Fix ILTrim warnings

* docs: Add missing docs and fix typos

* feat: Hosted Agents should report Run events

* fix: Fix type propagation for ILTrim changes

* refactor: Simplify DynamicallyAccessedMembers annotations

* sample: Use static-Type construction of InputPort

* feat: Support non-Streaming Run Mode

* test: Add test for non-streaming execution

* refactor: Remove unused types

* refactor: Simplify Event and EdgeData type hierarchies

* feat: Add Switch (=Conditional Edge Group) control flow

* feat: Make .NET AutoSend the MessageHandler result

* feat: Implement State APIs

* refactor: Simplify public namespaces and code organization

* refactor: Reconcile .NET and Python names

---------

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

Jacob Alber · 2025-08-13 22:34:39 +00:00

dotnet-0.0.1-nightly-250814.1 32711cfa95

Add information about workflows to README.md (#413 )

* Add information about workflows to README.md

* Apply suggestion from @Copilot

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

* Update README.md

* Update README.md

Co-authored-by: Jacob Alber <jalber@fernir.com>

---------

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

Eric Zhu · 2025-08-13 18:13:59 +00:00

825bcc3928

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

Fixed foundry sample issue (#403 )

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

Giles Odigwe · 2025-08-12 19:03:43 +00:00

dotnet-0.0.1-nightly-250813.1 80b0920e58

Python: add better test coverage to individual tests, and all-tests task, gh … (#400 )

* add better test coverage to individual tests, and all-tests task, gh action to surface

* remove cache location

* test version-file

* updated uv setup for consistency

* mypy fix

* update naming

* temporarily removed mypy from workflow

Eduard van Valkenburg · 2025-08-12 18:35:36 +00:00

53866218d2

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

dotnet-0.0.1-nightly-250812.1 df9d85d1f0

Python: introduce workflow checkpointing (#366 )

* Add workflow checkpointing functionality.

* Reintroduce protocol that went missing during merge

* Checkpoint updates

* Fix ordering of checkpointing

* Cleanup

* Cleanup - thanks Copilot

* Cleanup - thanks Copilot

* State reset updates

* State reset updates 2

* Workflow fixes and updates. Addressed PR feedback

* A few updates

Evan Mattson · 2025-08-11 22:33:46 +00:00

19676978e9

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

dotnet-0.0.1-nightly-250811.1 dotnet-0.0.1-nightly-250810.1 dotnet-0.0.1-nightly-250809.1 82d39bc1f7

Python: added create_agent and removed need for Field in annotations (#380 )

* added create_agent

* add minimal sample

* allow multiple annotations

* improved docstring

Eduard van Valkenburg · 2025-08-08 17:55:20 +00:00

8f27e63df6

Python: Added examples for Azure OpenAI Responses agent (#363 )

* Added examples for Azure OpenAI Responses agent

* Update python/samples/getting_started/agents/azure_responses_client/azure_responses_client_with_code_interpreter.py

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

---------

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

Dmytro Struk · 2025-08-08 14:45:07 +00:00

757c48e367

Bump Aspire.Hosting.Azure.CognitiveServices from 9.3.1 to 9.4.0 (#368 )

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

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

dependabot[bot] · 2025-08-07 23:53:34 +00:00

dotnet-0.0.1-nightly-250808.1 895151a304

Bump Aspire.Hosting.Azure.CosmosDB from 9.3.1 to 9.4.0 (#369 )

---
updated-dependencies:
- dependency-name: Aspire.Hosting.Azure.CosmosDB
  dependency-version: 9.4.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

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

dependabot[bot] · 2025-08-07 22:49:23 +00:00

440d74ad53

Bump Aspire.Hosting.AppHost from 9.3.1 to 9.4.0 (#367 )

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

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

dependabot[bot] · 2025-08-07 22:16:54 +00:00

3c96b258b3

Python: Define Workflow and Executor APIs (#272 )

* Workflow init commit

* Add samples and clean up

* ExecutionContext -> WorkflowContext

* Address comments 1

* Fix mypy

* flatting folder structure, and rename contexts

* Remove add_loop

* Add map reduce sample, remove Activation conditions

* Add AgentExecutor and allow multiple handlers per executor

* Minor improvement

* Add RequestInfoExecutor

* Add unit tests part 1

* Address comments 2

* Pre-commit update

* Add run method and more unit tests

* Add xml docs

* run_stream -> run_streaming

* message_handler -> handler

---------

Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>
Co-authored-by: Evan Mattson <evan.mattson@microsoft.com>

Tao Chen · 2025-08-06 23:26:15 +00:00

dotnet-0.0.1-nightly-250807.1 c8694a8c76

.NET: Avoid double responses when streaming (#365 )

* Avoid double responses when streaming.

* Fix tests.

Aditya Mandaleeka · 2025-08-06 23:10:34 +00:00

0d4d7abde1

.NET: Add agent hosting package and update sample (#296 )

* Add agent hosting package and update sample

* Review feedback and cleanup

* Include the narrator

* wip

* wip

* Remove workaround for empty state writes.

* Handle changes to AgentThread.

* One more.

* Fix.

---------

Co-authored-by: Aditya Mandaleeka <adityam@microsoft.com>

Reuben Bond · 2025-08-06 21:26:36 +00:00

e7441ee29e

Fix etag handling on read before write. (#351 )

Aditya Mandaleeka · 2025-08-06 15:31:32 +00:00

8dcc8533a6

Python: Azure Responses client (#311 )

* Azure Responses client

* Fix a change made in the wrong place

* allow api_version and token_endpoint to use env vars

* Add getting started sample

* add responses deployment name env var

* update azure clients to use defaults for api_version and token_endpoint

* make tests more reliable

---------

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

peterychang · 2025-08-06 14:18:38 +00:00

f43939d803

Fix README's and update getting started (#352 )

Mark Wallace · 2025-08-06 13:37:32 +00:00

5a1de491d4

.NET: Switch minimal console and a few samples to use latest patterns (#348 )

* Switch minimal console and a few samples to use latest patterns

* Use interpolation for sample output.

westey · 2025-08-06 10:01:03 +00:00

ef16774878

.Net: Add support for 3rd party thread storage and thread serialization (#203 )

* Add thread storage and serialization POC

* Switch to using JsonElement and add unit tests

* Add additional unit tests.

* Exclude private debugger properties from CodeCoverage.

* Rename IChatMessagesStorable to IChatMessageStore

* Apply suggestions from code review

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

* Improve xml doc.

* Update the message storing thread to always use external store for both local and remote storage.

* Remove threadid from the IChatMessageStore interface, since the store should own the thread id itself, if it requires one.

* Switch GetMessages to IEnumerable

* Address pr comments.

* Make jsonserializer options default consistent on DeserializeThreadAsync

* Move message storing thread functionality into AgentThread and simplify AgentThread behavior.

* Remove embedding generation from VectorStore chat history sample.

* Remove unecessary code and fix formatting.

* Make GetNewThread and DeserializeThread virtual with default implementations.
Remove unsued json utilities.

* Fix formatting

* Remove problem test.

* Add more unit tests

* Remove unused using clause.

* Address pr feedback.

* Address PR comments.

* Make InMemory store internal

* Switch InMemoryChatMessageStore to implement IList instead of inheriting from List.

* Rename store deserialize param.

* Update serialization based on PR comments.

* Remove confusing comment.

* Address Deserialization PR comments in the same way as Serialization

* Add State to IChatMessageStore Serialize and Deserialize names.
Make Thread Deserialize internal.
Make AgentThread type switching fobidden.

---------

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

westey · 2025-08-05 17:24:25 +00:00

dotnet-0.0.1-nightly-250806.1 ff3e13c2aa

Python: Azure OpenAI Assistants Chat Client and Agent (#300 )

* 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

* Added Azure assistants client and examples

* Added tests

* Small fix

Dmytro Struk · 2025-08-05 14:51:36 +00:00

c1d306ec95

Remove outdated design doc (#320 )

Eric Zhu · 2025-08-05 14:39:24 +00:00

98cf962b72

.NET: Clean / address some message warnings (#291 )

* WIP

* Structured Output sample

* Update dotnet/samples/GettingStarted/Steps/Step06_ChatClientAgent_StructuredOutputs.cs

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

* Address xml and comment targeting the Structured Output context

* Update with proposed fix for Persistent ChatClient

* Address PR feedback

* Address minor warnings

* Address initialization

* Address initialization

* Address PR comments, update suggestions

* Revert changes to NullableAttributese.cs

---------

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

Roger Barreto · 2025-08-05 12:55:44 +00:00

9faa27b8eb

2295 Commits