agent-framework

.NET: NET Workflows - Skip conversation initialization when identifier is provided (#1087 )

* Fix

* Code-gen case

* Tests

* Autosend logic

* Build fix

* Namespace

* Validation enhancement

Chris · 2025-10-02 14:27:46 +00:00

08ea625de0

.NET: Improve some core types xml docs (#1115 )

* Improve some core types xml docs

* Consistent period usage

westey · 2025-10-02 14:18:22 +00:00

cb62407fb8

.NET: Fix lists in XML comments so they render properly in the documentation. (#1113 )

* fix lists in XML comments so they render properly in documentation.

* Update dotnet/src/Microsoft.Agents.AI.A2A/A2AHostAgent.cs

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

* Update dotnet/src/Microsoft.Agents.AI.A2A/A2AHostAgent.cs

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

* Update dotnet/src/Microsoft.Agents.AI.A2A/A2AHostAgent.cs

Co-authored-by: Stephen Toub <stoub@microsoft.com>

* Update dotnet/src/Microsoft.Agents.AI.A2A/A2AHostAgent.cs

Co-authored-by: Stephen Toub <stoub@microsoft.com>

* Update dotnet/src/Microsoft.Agents.AI.A2A/A2AHostAgent.cs

Co-authored-by: Stephen Toub <stoub@microsoft.com>

* Update dotnet/src/Microsoft.Agents.AI.A2A/Extensions/A2ACardResolverExtensions.cs

Co-authored-by: Stephen Toub <stoub@microsoft.com>

* Update dotnet/src/Microsoft.Agents.AI.A2A/A2AHostAgent.cs

Co-authored-by: Stephen Toub <stoub@microsoft.com>

* Update dotnet/src/Microsoft.Agents.AI.A2A/A2AHostAgent.cs

Co-authored-by: Stephen Toub <stoub@microsoft.com>

* Update dotnet/src/Microsoft.Agents.AI.A2A/A2AHostAgent.cs

Co-authored-by: Stephen Toub <stoub@microsoft.com>

---------

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

SergeyMenshykh · 2025-10-02 13:58:11 +00:00

56beb52124

.NET: Move the AsAIAgent extension methods to the correct class (#1106 )

* Move the AsAIAgent extension methods to the correct class

* Fix format issue

* Disable unit test, see issue #1109

---------

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

Mark Wallace · 2025-10-02 12:41:22 +00:00

b1282254df

Tweak AgentAbstractionsJsonUtilities to better match AIJsonUtilities (#1094 )

Functional change includes setting the encoder used by the options and employing JsonStringEnumConverter.

Stephen Toub · 2025-10-02 05:19:27 +00:00

3ae9065b6b

.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

Added nuget-props to hosting packages (#1068 )

Dmytro Struk · 2025-10-01 16:20:41 +00:00

193503cab9

.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

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

.NET: Use copilot to improve XML docs for M.Agents.AI{.Abstractions} (#1042 )

* Use copilot to improve XML docs for M.Agents.AI{.Abstractions}

Asked copilot to help improve some of the docs, then I reviewed them.

I also cleaned up a few things along the way, like a couple of extension method types that should be combined.

* Update dotnet/src/Microsoft.Agents.AI.Abstractions/InMemoryChatMessageStore.cs

---------

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

Stephen Toub · 2025-10-01 08:44:33 +00:00

f21b9d14f8

Add linePragmas="false" to t4 templates (#1041 )

Stephen Toub · 2025-10-01 08:43:29 +00:00

5c0bea12e3

Bump version and fix duplicate project titles (#1046 )

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

Mark Wallace · 2025-10-01 08:01:29 +00:00

0966a1d8ae

.Net: Bugfix FunctionInvocation Middleware not working when no ChatOptions provided (#1030 )

* Bugfix FunctionInvocation Middleware

* Throw when specialized RunOptions are used for Function Invocation middleware + UT

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

3d04517877

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

.NET: Update M.A.AI.OpenAI implementations (#1018 )

* Update M.A.AI.OpenAI implementations

- There was only a ChatClient-based agent. Add a Responses one, too.
- Fix the public extension methods to create OpenAI types even when not backed by the right OpenAI client.
- Add reusable AgentRunResponse{Update} to ChatResponse{Update} conversion routines that are then used by the OpenAI agents and elsewhere

* Address feedback

Stephen Toub · 2025-09-30 19:06:10 +00:00

2d20e644df

Clean up a few ifdefs (#1016 )

Stephen Toub · 2025-09-30 18:58:00 +00:00

2d2a5bcd66

.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: Remove automatic messageId assignment to fix integration test (#1006 )

* Remove automatic messageid asssignment to fix integration test

* Remove other overrides from ChatClientAgent as well.

westey · 2025-09-30 15:54:36 +00:00

0c2891f351

.NET: Align or add NuGet package settings for all packages (#1013 )

* Align or add NuGet package settings for all packages

* Update dotnet/src/Microsoft.Agents.AI.AzureAI/Microsoft.Agents.AI.AzureAI.csproj

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

* Address code review feedback

---------

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

Mark Wallace · 2025-09-30 15:25:09 +00:00

4866936041

.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

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

fix sample (#1008 )

Korolev Dmitry · 2025-09-30 12:08:35 +00:00

f8ad327651

Update the package version and suffix in preparation for public preview (#970 )

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

Mark Wallace · 2025-09-30 10:08:23 +00:00

189434dd4b

.NET: Fix DI for ChatClientAgent (#973 )

* fix di for chat client agent so ai funcitons dependencies can be resolved from di container

* merge with latest main

SergeyMenshykh · 2025-09-30 08:40:03 +00:00

3dc8e1e025

.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

.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

Fix AIContextProvider comments (#971 )

westey · 2025-09-29 17:11:22 +00:00

9e8f5e62e7

.NET Workflows - Declarative Workflow Integration Tests (#956 )

* Checkpoint / 100% Pass

* Checkpoint: ActionExecutorResult

* Update dotnet/tests/Microsoft.Agents.Workflows.Declarative.IntegrationTests/Testcases/Marketing.json

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

* Namespace

* Sync updates

---------

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

Chris · 2025-09-29 16:40:15 +00:00

e11ec9d941

.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

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

Replaced by AgentWorkflowBuilder.

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

0d9f133e3b

Change RootNamespace for Agent abstractions project. (#958 )

Aditya Mandaleeka · 2025-09-28 18:54:09 +00:00

8ae15f10ed

.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 Workflows - Introduce support for Local variable scope (#944 )

* Prepare for update

* Checkpoint

* Comments

* All fixed

* Mixed casre test added

* Rollback nuget

* Remove redundant restorable

* Namespace

Chris · 2025-09-26 21:44:19 +00:00

4d63899812

feat: Solidify Concurrency Model for Inproc Workflows (#925 )

* Disallow execution of multiple workflows at once
* Define notion of executor Reset() to allow reuse of workflows with shared executor instances
* Switch to delivering all messages to a single executor sequentially, with executors running in parallel

Jacob Alber · 2025-09-26 15:44:02 +00:00

9614eea875

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 Workflows - Declarative update for AzureAgentProvider usage (#907 )

* Updated

* Update dotnet/src/Microsoft.Agents.Workflows.Declarative/Extensions/IWorkflowContextExtensions.cs

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

* Constant / override

* Namespace

* Protect against race

* Simplify collection usage

* Rollback name resolution

* One more rollback

---------

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

Chris · 2025-09-25 17:17:59 +00:00

f527fbe6ce

.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

421 Commits