agent-framework

.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

.NET: Add AgentWorkflowBuilder group chat (#861 )

* Add AgentWorkflowBuilder group chat

And fix a variety of issues along the way:
- Use DateTime{Offset}.UtcNow rather than Now
- AIAgentHostExecutor shouldn't be publishing empty messages
- Sequential workflows should be flowing all history and not just the output from the previous agent as the input into the next agent
- Renamed some of the new agent workflow methods... still not super happy with the shape, though
- Simplified handoffs builder, e.g. using a hashset with a custom comparer instead of a dictionary
- Improved multi-service use by trying to change assistant->user role for messages created by other agents
- Changed MessageMerger to rely on M.E.AI's coalescing more and to avoid empty contents / text
- Ensured that messages from ChatClientAgent include MessageId and CreatedAt timestamps
- Avoided including instructions for agents in a handoff workflow that don't have any handoffs
- Removed the unnecessary end function in handoffs
- Improved naming of executors to include agent name for debuggability
- Use "N" formatting with Guid.ToString everywhere, to avoid the unnecessary extra dash character which is also not valid in various places (like function tool names)
- Replace `params T[]` with `params IEnumerable<T>` to make public APIs more flexible in what they consume

* Address feedback

- Fix unintentional provider change in sample

Stephen Toub · 2025-09-24 16:38:34 +00:00

03ef7f054f

.NET: Use observability term (#889 )

* use observability term instead of telemetry

* rename telemetry folder to observability

* rolledback changed sample description

SergeyMenshykh · 2025-09-24 15:27:00 +00:00

7c70c33157

.NET: [BREAKING] Add GetService for AIContextProviders and ChatMessageStore (#874 )

* Add GetService for AIContextProviders and ChatMessageStore

* Change styling and fix format issues

* Update sample code to allow for missing memory component.

westey · 2025-09-24 14:58:16 +00:00

bd61e5f411

Remove extraneous project reference (#841 )

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

Mark Wallace · 2025-09-24 12:17:11 +00:00

ae018ca4d9

.NET Workflows - Improvements to Declarative Framework (#838 )

* Closure

* Verified

* Update dotnet/src/Microsoft.Agents.Workflows.Declarative/Interpreter/DeclarativeWorkflowContext.cs

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

* Sample folder

* System scope fix

* Fix link

* Integrate Foundry SDK fix

* File naming fix

* Update dotnet/src/Microsoft.Agents.Workflows.Declarative/Interpreter/DeclarativeWorkflowContext.cs

Co-authored-by: Tao Chen <taochen@microsoft.com>

* Namespace

* Optimize bind

---------

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

Chris · 2025-09-23 21:08:07 +00:00

06827e9f1a

.NET Workflows - Integrate Element Aliasing (#835 )

* Checkpoint

* Update test workflows

* Update workflows/MathChat.yaml

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

* Update folder

* Cleanup

* Signed package version

* Rollback nuget.config

* Cleanup

* Set `ProductContext`

* Move product initialization.

---------

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

Chris · 2025-09-23 18:08:35 +00:00

0f913bcdeb

.NET: [BREAKING] Subclass AgentThread so that different agents have their own threads with their own typed settings. (#798 )

* Subclass AgentThread so that different agents have their own threads with their own typed settings.

* Address PR comment.

* Add unit tests for base abstract threads

* Fix style warning

* Fix stlying

* FIx and suppress warnings as needed.

* Remove covariant thread response types and fix some styling.

* Remove unecessary json property name attributes and make OrchestratingAgentThread private

* Fix break from merge from main.

* Fix formatting

* Fix deserialization bug in Memory sample

* Remove thread deletion from basic samples.

* Remove public constructors for thread subclasses and add more factory methods to concrete agent types.

* Update AgentProxy thread constructors to be internal as well.

* Revert AgentProxyThread to internal

* Change AIContextProvider to internal set

* Change conversation id and message store properties to internal set

* Update styling.

* Seal various thread types.

* Add thread type check for thread deletion

* Fix tests after latest merge from main

* Add thread type checks for thread deletion.

---------

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

westey · 2025-09-23 10:30:06 +00:00

3571a7d321

Add a sample using multiple services (#851 )

Stephen Toub · 2025-09-23 01:07:51 +00:00

09bdd64dcb

Some more analyzer cleanup (#815 )

Stephen Toub · 2025-09-22 13:20:32 +00:00

c5e6735b7a

Add AgentWorkflowBuilder with Sequential, Concurrent, Handoff (#792 )

Stephen Toub · 2025-09-19 19:16:07 +00:00

52790b9f6a

.NET Workflows - Rename folder containing sample workflows (#836 )

* coolio

* Update dotnet/samples/GettingStarted/Workflows/Declarative/README.md

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

---------

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

Chris · 2025-09-19 17:40:51 +00:00

7cd45e313b

.NET: Add provider sample for OpenAI Assistants (#812 )

* Add provider sample for OpenAI Assistants

* Suggestions from pr

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

* Add deprecation warnings for OpenAI Assistants

---------

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

westey · 2025-09-18 15:22:06 +00:00

daee44d583

Fix sample (#816 )

Chris · 2025-09-18 15:20:30 +00:00

387b15997d

Fix step number for memory usage sample (#803 )

Updated the link for the 'Using memory with an agent' sample to reflect the new step number.

Mark Wallace · 2025-09-18 15:04:29 +01:00

3e5d398bf8

Enable more analyzers and various code tweaks/cleanup (#738 )

Stephen Toub · 2025-09-18 01:48:25 +00:00

5e5761b288

.NET: [BREAKING] Support Checkpoint Serialization (#735 )

* feat: Support Checkpoint Serialization

* Implements serialization roundtripping for checkpoints.
* Adds support for JSON serialization
* Adds FileSystem-based checkpoint persistence

* fix: Executor State does not deserialize correctly

The StateManager was not properly handling delay-deserialized values.

* Fix PortableValue handling in StateManager (this makes it delegate to PortableValue the uwnrapping)
* Fix UnitTest to actually test checkpoint serialization
* Additional review comment fixes

---------

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

Jacob Alber · 2025-09-17 19:57:19 +00:00

2015f0dc09

.NET: Update AgentThread, MessageStores and Context Providers to deserialize via constructor. (#779 )

* Update AgentThread, MessageStores and Context Providers to deserialize via constructor.

* Fix pr comment.

* Add additional validation for AgentThread deserialization

* Update WorkflowMessageStore desreialize to improve error checking.

* Reduce allocations in InMemoryChatMessageStore

---------

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

westey · 2025-09-17 10:08:13 +00:00

4247fc26dd

.NET Workflow - Declarative Workflow Event Fix (#765 )

* Checkpoint

* Update workflows/DeepResearch.yaml

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

* Comment

* Fix comment

* Update package version

* Fix nuget haxx

* Checkpoint

* Code complete

* Testing

* Message content workaround

* Add sequential flow

* Checkpoint

* Integration test project

* Checkpoint

* Checkpoint cleanup

* Complete

* Checkpoint

* Fix tests

* Comment cleanup

* Namespace

* Formatting

* Analyzer updates

* Workflow update

* Fixed!

* Update dotnet/tests/Microsoft.Agents.Workflows.Declarative.UnitTests/DeclarativeWorkflowTest.cs

Co-authored-by: Tao Chen <taochen@microsoft.com>

* Fix build error

* Purge "immutable" set and dictionary

* Fix as task

* Collection expression

* Another

* Frozen => Readonly (perf)

* Fix

* Namespace

* Checkpoint

* Add test

* Fix

* Rollback workflow edit

* nitty

---------

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

Chris · 2025-09-16 18:57:07 +00:00

b2d2019874

.NET: Add AIContextProvider support (#691 )

* Add AIContextProvider support

* Address feedback.

* Address PR comments.

* Switch to valuetask and remove parallel calls for AIContextProvider

* Remove Model from ModelInvokingAsync method name

* Remove agent thread id again and remove it from context provider interface

* Add AIContextProvider serialization support to AgentThread and update sample to show this feature

* Address PR comments

* Improve memory sample

* Update sample comment.

* Remove AggregateAIContextProvider for now since it makes too many assumptions.  We can include it later as a sample if needed.

* Update AIContextProviders to have an Invoked method instead of MessagesAddingAsync.

* Remove unused using.

* Address PR comments.

* Address PR comment.

* Update comment.

* Update comment

* Address PR comments.

westey · 2025-09-16 09:54:18 +00:00

66fe1c957c

Use LangVersion 13 rather than 12 (#760 )

Stephen Toub · 2025-09-16 02:49:00 +00:00

a0664201e2

.NET Workflow - Integrated updated CPS Object Model (#681 )

* Checkpoint

* Update workflows/DeepResearch.yaml

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

* Comment

* Fix comment

* Update package version

* Fix nuget haxx

* Checkpoint

* Code complete

* Testing

* Message content workaround

* Add sequential flow

* Checkpoint

* Integration test project

* Checkpoint

* Checkpoint cleanup

* Complete

* Update package

---------

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

Chris · 2025-09-15 20:41:07 +00:00

74879489a4

.NET: [BREAKING] Change implementation to use AsFunctionTool extension method to create a function from an agent (#686 )

* Change implementation to use AsFunctionTool extension method to create a function from an agent

* Update dotnet/tests/Microsoft.Extensions.AI.Agents.UnitTests/AgentExtensionsTests.cs

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

* Address code review feedback and add a new sample

* Address some code review feedback

---------

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

Mark Wallace · 2025-09-15 08:39:38 +00:00

636e3acf37

.NET: Fix Semantic Kernel migration samples (#739 )

* use GetOpenAIResponseClient

Signed-off-by: Jianguo Ma <jiangma@microsoft.com>

* use PersistentAgentsClient

Signed-off-by: Jianguo Ma <jiangma@microsoft.com>

---------

Signed-off-by: Jianguo Ma <jiangma@microsoft.com>

Jianguo Ma · 2025-09-15 07:49:41 +00:00

2a75482777

.NET: BREAKING Update AIAgent.Run to take IEnumerable instead of IReadonlyCollection (#729 )

* Update AIAgent,Run to take IEnumerable instead of IReadonlyCollection

* Address PR comment.

* Cast to IReadonlyCollection since this is typically all that is required to avoid unecessary allocation.

* Update OrchestratingAgent protected methods as well.

westey · 2025-09-12 14:58:46 +00:00

8af4918f56

Update M.E.AI and delete a bunch of dead code (#676 )

Stephen Toub · 2025-09-11 00:40:58 +00:00

f9e133237d

.NET: Workflow getting started samples in .Net (Second batch) (#650 )

* Add loop and agents in workflows samples

* Add foundry agent and workflow as agent samples

* Checkpoint sample WIP

* Checkpoint sample 1 Done

* Add HIL samples

* Fix formatting

* Force folder name change step 1

* Force folder name change step 2

* Fix formatting

* Fix formatting

* Add checkpoint and rehydrate sample

* _Foundational

* Fix formatting

Tao Chen · 2025-09-10 18:47:13 +00:00

89c8418705

.NET: Adding Image Multi Modality Sample (#688 )

* Adding Multi Modal Sample

* Address typos

* Update sample to Azure OpenAI

* Update readme

* Update readme

* Update readme

* Use thread

Roger Barreto · 2025-09-10 18:34:08 +00:00

2393351a03

.NET Workflows - Add declarative action events (#679 )

* Updated

* Typos

* Update sample

* Typo

* Add parent and prior action ids to event

Chris · 2025-09-10 17:45:11 +00:00

adb901cf19

.NET: Add getting started samples that show how to call MCP tools (#635 )

* Add getting started samples that show how to call MCP tools

* Add getting started samples that show how to call MCP tools

* Update dotnet/samples/GettingStarted/ModelContextProtocol/Agent_MCP_Server_Auth/README.md

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

* Fix README

* Address code review feedback

---------

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

Mark Wallace · 2025-09-10 05:52:30 +00:00

7786e2f405

368 Commits