agent-framework

[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

7ebe00ec3d

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

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

.NET: Add support for Subworkflows and many threading fixes (#1066 )

* feat: Add support for Workflow-as-Executor

* Fixes routing of 'object' compile-typed variables to properly take in type information
* Fixes a concurrency issue in StepTracer

* fix: Make Subworkflow ExternalRequests work properly

* fix: Threading and Concurrency fixes; prep for OffThread Mode

* refactor: Remove dead code around OffStreamRunEventStream

Currently not used, and will be replaced with a rewrite when brought back, so having it in the change is not valuable.

* ci: Work around issues with dotnet-format not properly analyzing the source

* fix: Fix the logic of AsyncCoordinator and AsyncBarrier

* Prevent individual wait cancellations from canceling the entire barrier
* Propagate information about whether the wait was completed or cancelled, and whether any waiters were present when released

* fix: Remove superfluous acces to .Keys in InProcStepTracer

* refactor: Clean up AsyncCoordinator's use of AsyncBarrier

Jacob Alber · 2025-10-03 17:26:30 +00:00

32e7ff00b5

Add sample showing how to use any foundry model (#1159 )

westey · 2025-10-03 15:34:16 +00:00

6a4e759965

update a2a sample to work with latest a2a library (#1149 )

SergeyMenshykh · 2025-10-03 12:04:43 +00:00

ca9f6fe21d

Update A2A library to 0.3.1-preview (#1141 )

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

Stephen Toub · 2025-10-03 09:31:31 +00:00

cf831b0348

.NET Workflows - Clean-up declarative docs and product-context. (#1134 )

* Clean-up

* Rollback sample

---------

Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>

Chris · 2025-10-02 20:06:40 +00:00

390cc541ea

.NET: dotnet sample for OTEL -> Application Insights + Grafana (#1083 )

* Add Azure Monitor OpenTelemetry Exporter to AgentOpenTelemetry sample

* Update README to include Application Insights setup and Grafana dashboard links

* Update dotnet/samples/GettingStarted/AgentOpenTelemetry/README.md

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

---------

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

wuweng · 2025-10-02 15:21:11 +00:00

074529e5a0

.NET: Add Prompt to support and improve AI Agent SK->AF Migration Results (#1081 )

* Prompt progress

* Enriched prompt + Added to SLN visibility

* Set starting point for Copilot Migration

* Address prompt detail + prepare copilot migration to work with Agent nugets

* Address more prompt details

* Prompt update

* Improve description for migration

* Improve description for migration

* Improve description for migration

* Improve description for migration

* SLnx Upgrade Assistant use-case

* Extra tweaks to the migration prompt

* Update prompt

* Adding the migration guida as a visible reference to the project

* Improvements

* IMprovement

* Small improvements

* AI Guidance Overhaul.

* Update migration guide with better straightforward examples

* Update breaking glass instructions

* Namespace change + address feedback

* ChatComletionService considerations

* Add middleware guidance + public packages

* Removing + ignoring future generated files

* Potential gh bug?

* Prompt progress

* Enriched prompt + Added to SLN visibility

* Set starting point for Copilot Migration

* Address prompt detail + prepare copilot migration to work with Agent nugets

* Address more prompt details

* Prompt update

* Improve description for migration

* Improve description for migration

* Improve description for migration

* Improve description for migration

* SLnx Upgrade Assistant use-case

* Extra tweaks to the migration prompt

* Update prompt

* Adding the migration guida as a visible reference to the project

* Improvements

* IMprovement

* Small improvements

* AI Guidance Overhaul.

* Update migration guide with better straightforward examples

* Update breaking glass instructions

* Namespace change + address feedback

* ChatComletionService considerations

* Add middleware guidance + public packages

* Removing + ignoring future generated files

* Potential gh bug?

* Version bump

* Address observation

* Address observation

---------

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

Roger Barreto · 2025-10-02 15:00:19 +00:00

79def868b6

.NET Workflows - Re-enable Declarative Integration Tests (#1080 )

* Investigate

* Next

* Update initialization

* Should be ok

* Agent definition dx

* Link agent definitions

* Link agent definitions

* Path resolution #2

* Fix path resolution

* Another pass

* Another

* Better

* One more

* Whoopsie

* Update dotnet/tests/Microsoft.Agents.AI.Workflows.Declarative.IntegrationTests/Framework/AgentFactory.cs

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

* Namespace

* Cleanup

* Temp config for pipeline

* Another temp workaround

* Test config: Bing Grounding Tool

* Update template

* Next pass

* Ok now

* Cleanup

* Test note

---------

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

Chris · 2025-10-01 22:21:45 +00:00

6d0f28eb9b

.NET: Re-enable ImplicitUsings in samples and clean up NoWarns (#1060 )

* Re-enable ImplicitUsings in samples and clean up NoWarns

* Fix dotnet format

* More dotnet format

* More dotnet format

---------

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

Stephen Toub · 2025-10-01 19:37:03 +00:00

a414461570

Remove System.Linq.Async dependency from src assemblies (#1069 )

We shouldn't be shipping any more dependencies on this package, as it's becoming legacy, replaced by System.Linq.AsyncEnumerable.

We'll eventually want to replace it with System.Linq.AsyncEnumerable in all tests/samples, too, but that's hard to do until SK updates to use S.L.AsyncEnumerable once its 10.0.0 version is released. I did remove the package reference from tests/samples where it's not needed.

Stephen Toub · 2025-10-01 17:17:21 +00:00

0fef277c70

.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

.NET Workflows -Fix Declarative Workflow Tests (#1065 )

* Fixed

* Restore generated workflow

* Project

* Fine tune

* Update baseline

* Adjust test-case

Chris · 2025-10-01 16:15:46 +00:00

f5ca4f42c0

.NET: OpenAI Reasoning Agent sample (#1047 )

* OpenAI reasoning agent sample

* Refactor OpenAI agent sample: streamline warning handling and improve output formatting

Christian Glessner · 2025-10-01 13:32:11 +00:00

74e2e2e21d

.NET: Align environment variable names (#1053 )

* alignt environment variable names

* rename modelId variable names

SergeyMenshykh · 2025-10-01 10:49:45 +00:00

5f1417ab94

Address bug when agent rawrepresentation is a MEAI type and returns it with null RawRep (#1054 )

Roger Barreto · 2025-10-01 10:37:12 +00:00

f9a3918916

fix failing CheckpointWithHumanInTheLoop sample (#1034 )

SergeyMenshykh · 2025-10-01 08:40:07 +00:00

2680edff65

.NET: Sample for the MCP and Foundry Agents documentation (#972 )

* Foundry Agent MCP

* Foundry Agent MCP

* Use Foundry SDK directly

* Use raw representation factory

* Fix typo

---------

Co-authored-by: Mark Wallace <markwallace@microsoft.com>

Mark Wallace · 2025-10-01 07:37:12 +00:00

2b4ff5f076

Use IApplicationLifetime instead of a custom token (#1031 )

Glenn Condron · 2025-10-01 07:21:33 +00:00

43fe7c6dbe

Hide/remove some JSON utility classes (#1039 )

Stephen Toub · 2025-10-01 05:38:46 +00:00

498fc06fd6

Remove defunct AgentExtensions.WithOpenTelemetry (#1033 )

Stephen Toub · 2025-10-01 00:24:13 +00:00

9360780ce5

.NET: Workflow observability (#959 )

* Add basic Workflow telemetry

* Add sample

* Add source propagation for executor spans

* Fix tests and address comments

* Fix formatting

* Fix declarative unit tests

* Address comments

* Remove Microsoft.Extensions.AI.Agents.EnableTelemetry

* Formatting

* Formatting

* Formatting

* fix solution

* Address comments

* Add workflow json definition for serialization

* Formmating

* Address comments

Tao Chen · 2025-09-30 23:40:04 +00:00

042099009f

.NET: Fix some more static analysis diagnostics (#1025 )

* S1006

* S2219

* S3236

* S3260

* S1125

* IDE0063

* IDE0062

* IDE0028

Stephen Toub · 2025-09-30 22:50:22 +00:00

2539282d30

.NET Workflows - Code Generation for Declarative Workflow (#655 )

* Notes

* Readme typo

* Update readme

* Checkpoint

* Namespace fix

* Fix ID and namespace

* Checkpoint

* Verified

* Comments

* Isolate "Kit"

* Address note: static

* Checkpoint

* Checkpoint "Executor<>"

* Prefix and internal executors

* Test passing

* Cleanup

* Rename "session" concept

* Revert workflow debug

* Fix template base / pragma

* Tune system scope

* Update dotnet/src/Microsoft.Agents.Workflows.Declarative/CodeGen/ResetVariableTemplate.tt

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

* Fix empty template

* Add validation for codegen ut

* Fix test

* Codegen baselines

* Constant

* Prep

* Mark TODO

* Fix

* Namespace

* One more

* Update baselines

* Checkpoint

* Checkpoint

* Checkpoint

* fme

* Checkpoint

* Another step

* Fixed up

* Roslyn

* Fix

* More cleaning

* Async

* Fix

* Enum checkpoint

* Refine enum

* Checkpoint

* Sync templates

* Checkpoint

* Streamline

* Pre-merge analyzer updates

* Foreach

* Placeholders

* Checkpoint

* Clean-up

* Sample path resolution

* Checkpoint

* Checkpoint - Workflow Code Building

* Validation

* Test cleanup

* Update test basline

* Update test baseline

* Fix DefaultTemplate usage

* Validation checkpoint

* Fix break/continue edges

* Verify generated code builds

* Fix merge

* Fix build validation

* Update template handling of literal string values.

* Test for metadata case

* Update baselines

* Fix merge

* Checkpoint

* Checkpoint: Conditions

* Invoke Agent Checkpoint

* Namespace

* Address code-analysis issues

* Cross platform test support

* Invoke agent checkpoint

* Clean sample

* Checkpoint: Agent Invoke Input Messages

* Checkpoint - Passing

* Checkpoint

* Regenerate all template + port conversation fix

* Checkpoint: Tests good

* Fix test for unbuntu

* Fix build command

* Checkpoint - E2E

* Test fix

* Update integration tests

* Fix merge

* Update

* Checkpoint !!!

* Baby steps

* Checkpoint

* Checkpoint E2E !!!

* So close...

* Integrate test validation

* Fix merge

* Rebase tests

* Namespace

* Namespace

* Test cleanup

* Sample comment cleanup

* Checkpoint: List conversion

* Include these

* CheckPoint: ParseValue

* Namespace

* Fix sampel

* More namspace

* Comments

* Test updates

* Test fix

* Better build

* Shared code

* Sort solution

* Fix build

* Prune solution

* One more

* Conversion matrix

* Final table conversion

---------

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

Chris · 2025-09-30 21:56:14 +00:00

77404d165c

align env. varibale names (#1022 )

SergeyMenshykh · 2025-09-30 18:29:41 +00:00

69284e9dfc

.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

.NET Workflows - Fix "Human In Loop" sample and update "AutoSend" behavior (#991 )

* Fix sample and autosend

* Specify "ConversationId"

* Namespace

* Perf fix

* Namespace

* Filter for appropriate message

Chris · 2025-09-30 16:13:15 +00:00

1e53fb458f

.NET: Update Migration Samples for SK OpenAIResponsesAgent Step 1 & 2 (#1010 )

* Addressing a SK bug where threads can't be reused + threads should be capture after the request, not created before

* Using storedenabled to align with AF default behavior

* Address copilot comment

* Address Azure + OpenAI remaining sample improvements

Roger Barreto · 2025-09-30 15:49:16 +00:00

ff8b97cc72

.NET: AI Agent with plugin (#1009 )

* add sample to demonstrate plugins for ai agent

* Update dotnet/samples/GettingStarted/Agents/Agent_Step15_Plugins/Program.cs

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

* Update dotnet/samples/GettingStarted/Agents/Agent_Step15_Plugins/Program.cs

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

* Update dotnet/samples/GettingStarted/Agents/Agent_Step15_Plugins/Program.cs

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

* remove lang version property

* address review comments

* rename functionInvocationServices to services

* restore the solution file corrupted during the merge with lates main

---------

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

SergeyMenshykh · 2025-09-30 15:10:03 +00:00

bd167ee476

fix env variable name for migration samples (#1014 )

SergeyMenshykh · 2025-09-30 14:30:52 +00:00

38b6f68d70

Python: .NET: [BREAKING] Remove Actor-based runtime (#977 )

* Remove Actor-based runtime

* Fix formatting

* Remove cosmos db vestigials

---------

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

Reuben Bond · 2025-09-30 14:09:32 +00:00

7967983755

.NET: Update OpenTelemetryAgent to latest spec (#967 )

* Update OpenTelemetryAgent to latest spec

It was stale. Rather than try to keep it up-to-date manually, I've changed it to piggy back on OpenTelemetryChatClient, so that it inherits everything OpenTelemetryChatClient does and then augments it just with agent-specific tags.

* Address feedback / merge

Stephen Toub · 2025-09-30 13:50:01 +00:00

0502f3ef91

.NET: Clean up some CancellationToken usage (#996 )

* Clean up some CancellationToken usage

* Unused usings

Stephen Toub · 2025-09-30 13:44:53 +00:00

4fd61924fc

.NET: Clean up stale mentions of M.E.AI.Agents (#997 )

* Clean up stale mentions of M.E.AI.Agents

* Unused usings

Stephen Toub · 2025-09-30 08:36:06 +00:00

77e5f527c4

Update M.E.AI and MCP versions (#992 )

But not yet M.E.AI.OpenAI, which depends on the latest OpenAI, which conflicts with the latest Azure.AI.OpenAI.

Stephen Toub · 2025-09-30 07:17:59 +00:00

fc4fce7973

Python: Update README files: Fill empty documentation and expand minimal content (#980 )

* Initial plan

* Fill empty python/samples README and expand dotnet custom implementation README

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

* Fix broken documentation links in main README

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

* Fix installation instructions in Python main package README

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

* Address PR feedback: revert main README and Python package README, remove empty prerequisites section and repository link

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-09-29 23:59:50 +00:00

170c2c715a

.NET: Rename workflows projects (#975 )

* Renaming Microsoft.Agent.Workflows to Microsoft.Agents.AI.Workflows

* Removing local settings.

* Removing remining old files from merge.

Ben Thomas · 2025-09-29 18:30:45 +00:00

647db9635a

.NET: Add Agent Filtering Middleware (#478 )

* WIP

* Wip

* Updated ADR

* Updated ADR

* Update files

* Address copilot comments

* Update filters from Task<T> to Task only

* Project endpoint

* Add agent ctor filter

* Other Agent Framework investigation

* Remove SK Java, no support

* Update LlamaIndex info

* Removing unrelated files

* Implementation with specialization

* Remove the specialization option as extra unecessary complexity

* Move middleware responsibility to a decorator

* Update readme

* Function invocation wip

* Add Agent Builder

* Adding comparison samples

* Reorganize Samples and Processor vs Decorator

* Remove merge files

* Address formating warnigs

* Update ADR

* Step13 README's update

* Address PR feedback

* Address PR feedback

* Remove configure await from ADR samples

* Update variables

* Address feedback

* Address Agent level tool invocation with Options.ToolsTransformer strategy

* Removing the Processor approach

* Proposal design for Middleware in CreateAIAgent extensions

* Examples clean up and consolitation

* Update middlewares to work with ApprovalREquiredFunction

* Clean-up sample

* Update override function call sample

* Drop configuration from the extensions, looks overkill

* Builder interface ..

* Revert IAIBuilder interface approach

* Cleanup sample

* Adding unit tests

* Fix UT

* Cleanup sample

* Remove unneeded dependency

* Address PR comment + Readme Samples

* Add missing comments for Program.cs Middleware

* Address mor PR comments + add client factory for OpenAI extensions

* Add OpenAI UnitTests for extensions

* Add AzureAI PersistentChatClient UT

* Addess feedback

* Add function invoking UT

* Add builder extension UT

* Address feedback + Rearange abstractions + UT fixes

* Drop context based middleware for full decorating impl

* Update unit tests

* Update UT coverage

* Removing Middelware namespace

* Add missing UT

* Remove internal ToolTransformation Property

* Adjust xmldoc

* Remove transient file

* Address merge conflict

* Add xmldoc remark for clarity

* Address comment

* Address feedback

* Update UT

---------

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

Roger Barreto · 2025-09-29 17:58:04 +00:00

7a8b456294

.NET: rename A2A extension methods (#915 )

* rename

* simplify via agentProxy

* Update dotnet/src/Microsoft.Extensions.AI.Agents.Hosting.A2A.AspNetCore/WebApplicationExtensions.cs

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

* Update dotnet/src/Microsoft.Extensions.AI.Agents.Hosting.A2A/Microsoft.Extensions.AI.Agents.Hosting.A2A.csproj

---------

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

Korolev Dmitry · 2025-09-29 17:43:50 +00:00

fe6492ce60

.NET: Make serialize methods sync and rename one to match others. (#946 )

* Make serialize methods sync and rename one to match others.

* Remove unnecessary async postfixes.

* Remove nullability of ChatMessageStore.Serialize return type, since the default JsonElement already represents an undefined json element.

* Fix unit test

westey · 2025-09-29 09:32:01 +00:00

bf5931932e

Update System.CommandLine dependency (#918 )

Stephen Toub · 2025-09-28 18:55:48 +00:00

ff7d301389

[BREAKING] Delete Microsoft.Agents.Orchestration (#949 )

Replaced by AgentWorkflowBuilder.

Stephen Toub · 2025-09-28 18:54:52 +00:00

0d9f133e3b

.NET: Fix samples, improve readme language and add readme to sln. (#942 )

* Fix samples, improve readme language and add readme to sln.

* Fix threading in openai samples too.

westey · 2025-09-27 06:48:26 +00:00

499838565e

.NET: Change Runtime namespaces to Microsoft.Agents.AI.Runtime (#957 )

* Rename MEAI.Runtime to MAAI.Runtime.

* Missed.

Aditya Mandaleeka · 2025-09-27 06:10:14 +00:00

28ad256931

.NET: Change Hosting namespaces to Microsoft.Agents.AI.Hosting (#953 )

* Rename MEAI.Hosting to MAAI.Hosting.

* dotnet format.

Aditya Mandaleeka · 2025-09-26 22:32:53 +00:00

6222a2cd18

.NET: Adding a few small sample improvements (#914 )

* A few small sample improvements

* Address PR comments.

* Simplify Mcp sample further.

westey · 2025-09-26 10:25:29 +00:00

863c8d7471

Rename AI Agent packages to use Microsoft.Agents.AI (#913 )

* Rename AI Agent packages to use Microsoft.Agents.AI

* Fix for build

* Fix formatting

* Fix formatting

* Ignore in VSTHRD200 in migration samples

* Ignore in VSTHRD200 in migration samples

* Add some missing projects and run format

* Fix build errors

* Address code review feedback

* Fix merge issues

---------

Co-authored-by: Mark Wallace <markwallace@microsoft.com>

Mark Wallace · 2025-09-25 19:31:25 +00:00

32e054f1fe

.NET: Update Workflow Input/Output Redesign (#881 )

* feat: Make Executor id field mandatory

When checkpointing is involved, it is critical to keep executor ids consistent between runs, even when recreating a new object tree for the workflow.

The default id-setting mechanism generated a guid for part of the id, making it not work when restoring from a checkpoint.

This change prevents this situation from arising.

* feat: Enable running untyped Workflows

With the change to enable delay-instantiation of executors and support for async Executor factory methods, we must instantiate the starting executor to know what are the valid input types for the workflow.

To avoid forcing instantiation every time, and to better support workflows with multiple input types, we enable support for build and interacting with the base Workflow type without type annotations, and remove the requirement to know a valid input type when initiating a run.

* feat: Support Output from any executor and multiple outputs.

Jacob Alber · 2025-09-25 02:03:22 +00:00

39e071c430

397 Commits