agent-framework

Updated (#2076 )

Chris · 2025-11-11 17:17:34 +00:00

ad2ebfc0c8

.NET: fix: WorkflowAsAgent Sample (#1787 )

* fix: WorkflowAsAgent Sample

* Also makes ChatForwardingExecutor public

* feat: Expand ChatForwardingExecutor handled types

Make ChatForwardingExecutor match the input types of ChatProtocolExecutor.

* fix: Update for the new AgentRunResponseUpdate merge logic

AIAgent always sends out List<ChatMessage> now.

Jacob Alber · 2025-11-11 16:35:22 +00:00

a39e6561fd

Update README.md to change Grafana links to Azure portal links for dashboard access (#1983 )

wuweng · 2025-11-11 05:08:33 +00:00

177b0c95be

.NET: Separate all memory and rag samples into their own folders (#2000 )

* Separate all memory and rag samples into their own folders

* Fix broken link.

westey · 2025-11-10 15:34:20 +00:00

c0c12df851

.NET: Remove moved OpenAPI sample and point to SK one. (#1997 )

* Remove moved OpenAPI sample and point to SK one.

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

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

---------

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

westey · 2025-11-10 12:29:26 +00:00

01f3a3d881

.NET: Remove launchSettings.json from .gitignore in dotnet/samples (#2006 )

* Remove launchSettings.json from .gitignore in dotnet/samples

* Update dotnet/samples/GettingStarted/DevUI/DevUI_Step01_BasicUsage/Properties/launchSettings.json

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

* Update dotnet/samples/AGUIClientServer/AGUIServer/Properties/launchSettings.json

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

---------

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

Reuben Bond · 2025-11-07 23:45:15 +00:00

1aaf37dab8

.NET: DevUI - Do not automatically add/map OpenAI services/endpoints (#2014 )

* Don't add OpenAIResponses as part of Dev UI

You should be able to add and remove Dev UI without impacting your other production endpoints.

* Remove `AddDevUI()` and do not map OpenAI endpoints from `MapDevUI()`

* Fix comment wording

* Revise documentation

---------

Co-authored-by: Daniel Roth <daroth@microsoft.com>

Jeff Handley · 2025-11-07 23:03:54 +00:00

85484c0259

.NET: DevUI: Use relative URLs for backend API by default (#2005 )

* DevUI: Use relative URLs for backend API by default

* dotnet format

* rebuild application

Reuben Bond · 2025-11-07 17:01:04 +00:00

3d94ae57ed

.NET: Remove sequential\concurrent workflow extensions (#1731 )

* remove non-standard workflow extensions, create overloads for IHostedAgentBuilder

* rework

* rollback extensions in a2a

Korolev Dmitry · 2025-11-07 11:58:21 +00:00

b7cddaaba8

.NET: Chathistory memory provider add (#1867 )

* Add ChatHistoryMemoryProvider with unit tests

* Set new project to not packable.

* Fix bugs

* Add serialization support.

* Update dotnet/src/Microsoft.Agents.AI.VectorDataMemory/ChatHistoryMemoryProvider.cs

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

* Remove unnecessary line

* Convert ChatHistoryMemoryProvider to use Dynamic collections.

* Sealing options and scope classes.

* Add sample, add scope to logs and improve scope validation

* Move ChatHistoryMemoryProvider to MAAI project.

---------

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

westey · 2025-11-07 11:46:35 +00:00

e5d9d74c2d

.NET: Add tool calling sample with OpenAPI (#1968 )

* Add tool calling sample with OpenAPI

* Address PR comments.

* Rename folders and moved literal to inline.

* Fix broken link.

westey · 2025-11-06 14:34:27 +00:00

6e205445be

.NET: Add DevUI package for .NET (#1603 )

* Implement DevUI

* Review feedback

* Fix build

Reuben Bond · 2025-11-05 20:02:48 +00:00

8855bfb065

.NET: [BREAKING] refactor: Normalize WorkflowBuilder APIs (#1935 )

* [BREAKING] refactor: Normalize WorkflowBuilder APIs

* "partitioner" => "assigner"
* normalize ordering so sources always to the left of targets for edges
* normalize parameter ordering so sources and targets are always first arguments
* remove `params` (users should use collection expressions instead)

* refactor: Align name with Python

Jacob Alber · 2025-11-05 19:50:01 +00:00

94a5ba3448

.NET: [Breaking Change] Moving MAAI.AzureAI V1 Package -> MAAI.AzureAI.Persistent (V1) (#1902 )

* Update AzureAI -> AzureAI.Persistent

* Fix sample reference

Roger Barreto · 2025-11-05 13:28:00 +00:00

6ca907f23f

.NET: [BREAKING] Simplify TextSearchProvider construction and improve Mem0Provider scoping. (#1905 )

* Simplify TextSearchProvider construction and improve Mem0Provider scoping

* Fixing indentation.

westey · 2025-11-05 13:00:18 +00:00

5e38c63455

.NET: Add Writer-Critic Iterative Refinement Workflow Sample (#1790 )

* Adding Sample for writer-critic workflow implemented using Worfklow, custom executors, agents, switch, custom states, different entry points for the executors.

* Update dotnet/samples/GettingStarted/Workflows/_Foundational/08_WriterCriticWorkflow/Program.cs

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

* Update dotnet/samples/GettingStarted/Workflows/_Foundational/08_WriterCriticWorkflow/Program.cs

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

* using now structured output, with streaming for UX responsiveness.

* improved comments and order, so comments directly precede what they're describing

* fixing issue with internal class that the analyzer doesn't recognize that CriticDecision is instantiated, just indirectly via JSON deserialization

---------

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

Jose Luis Latorre Millas · 2025-11-04 23:50:41 +00:00

f415959d33

.NET: Add rag samples with sample TextSearchStore (#1664 )

* Port store for adding text to a vector store to AF

* Fix typo.

* Change TextSearchStore to sample, and add sample to use it and do rag with a custom schema

* Add more tests and fix broken ones

* Fix merge issue

* Fix sample after merge.

* Convert TextSearchStore to use Dynamic mode to be AOT compatible.

* Add some more clarification on when to use assistant messages in rag searches.

westey · 2025-11-04 16:24:26 +00:00

ada5b83c80

.NET: Response & foundry agent hosted MCP sample (#1568 )

* Adding sample demonstrating hosted MCP with Responses

* Add mcp readme.md to slnx

* Update FoundryAgent sample to use MCP types from abstraction and to show how to do approval

* Fix param name after package update.

* Fix environment variable name for consistency

* Apply suggestion from @Copilot

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

---------

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

westey · 2025-11-04 15:54:20 +00:00

64fc3f381f

.NET: Add workflow as an agent with observability sample (#1612 )

* Add workflow as an agent with observability sample

* Address comment

* Fix formatting

* enable sensitive data

* enable sensitive data for sub agents

* adjust aggregator handlers

Tao Chen · 2025-11-03 20:36:33 +00:00

b0ee7028a6

.NET: [BREAKING] Unify ExecutorIsh and ExecutorRegistration, unify/simplify APIs (#1637 )

* refactor: Unify ExecutorIsh and ExecutorRegistration => ExecutorBinding

* Switch to more modern Record type-tree for Sum Types
* Unify APIs for getting ExecutorBinding
* Fix an issue where workflows consisting entirely of cross-run shareable executors which are not instance-resettable do not properly clear state when running non-concurrently.

* feat: Simplify function-to-executor pattern

* refactor: Normalize API naming

Jacob Alber · 2025-11-03 18:20:35 +00:00

b25b0af49b

.NET: Change GetAIAgentAsync to be synchronous (#1846 )

* Change GetAIAgentAsync to be synchronous

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

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

---------

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

Stephen Toub · 2025-11-03 15:16:19 +00:00

e87eed573b

.NET: Background responses sample (#1831 )

* add samples that demonstrate background responses with function calling and agent state persistence

* update readme

* update sample description

* rename sample project

* remove unnecessary namespace and ysed task delay instead thread sleep generated by ai

* change names

* Update dotnet/samples/GettingStarted/Agents/Agent_Step20_BackgroundResponsesWithToolsAndPersistence/AgentStateStore.cs

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

* simplify sample and address pr review comments

---------

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

SergeyMenshykh · 2025-10-31 17:13:43 +00:00

a5db641ce3

.NET: Add a Mem0 usage sample (#1779 )

* Add a Mem0 usage sample

* Change charset

* Add variable types

westey · 2025-10-30 09:31:29 +00:00

36532e929e

Shorten TextSearchSearchResult to TextSearchResult (#1780 )

westey · 2025-10-29 21:16:28 +00:00

f6eadd412e

.NET: Add a sample that shows how to do RAG with the TextSearchProvider (#1757 )

* Add a sample that shows how to do RAG with the TextSearchProvider

* Update file encoding.

westey · 2025-10-29 14:34:00 +00:00

8a3cab38ee

.NET Workflows - Sample and Package Update (#1759 )

* Update #1

* Sample comments

* Formatting

* Whitespace

Chris · 2025-10-28 23:26:55 +00:00

00a78d7bc6

.NET Workflows - Add support for tool approval (#1685 )

* Draft

* Nullable init

* Complete

* Consistency

* Test fix

* Typo

* Comment

* Updated

* Fix identifier

* Test fix

* Comment typo

* Better naming

* Comment

* Tweak comment

Chris · 2025-10-27 17:40:45 +00:00

92925a8bc7

update the sample to have more relevant background responses prompts and reference official documentation. (#1654 )

SergeyMenshykh · 2025-10-23 17:47:54 +00:00

c408a2d8c3

samples: WorkflowHelper => WorkflowFactory (#1640 )

Jacob Alber · 2025-10-23 04:34:26 +00:00

feb3404a27

.NET: Add support for background responses (#1501 )

* add support for background responses

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

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

* fix broken link

* fix xml comments and background responses properties override funcitonity

* change ai model provider

* use Run{Streaming}Async overloads that don't require messages

* stop using m: prefix in cref attribute of <see/> element.

* reject input messages provided with continuation token + don't extract messages from message store and context provide if continuation token is provided

* use agent thread for background-responses sample

* require agent thread for background responses

* Update dotnet/src/Microsoft.Agents.AI/ChatClient/ChatClientAgent.cs

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

* Update dotnet/src/Microsoft.Agents.AI/ChatClient/ChatClientAgent.cs

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

* remove CA1200

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

Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>

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

Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>

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

Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>

* address pr review comments

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

Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Roger Barreto <19890735+rogerbarreto@users.noreply.github.com>
Co-authored-by: westey <164392973+westey-m@users.noreply.github.com>

SergeyMenshykh · 2025-10-22 17:43:57 +00:00

1bf520a7c2

.NET: Sample on Worflows mixing Agents And Executors, showcasing best patte… (#1562 )

* Sample on Worflows mixing Agents And Executors, showcasing best patterns which are reusable.

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

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

* Update dotnet/samples/GettingStarted/Workflows/_Foundational/07_MixedWorkflowAgentsAndExecutors/Program.cs

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

* minor fix

* fixed ambiguous signature due to framework changes.

---------

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

Jose Luis Latorre Millas · 2025-10-21 23:41:59 +00:00

4554de00ab

refactor: [BREAKING] Remove generic Workflow<T> (#1551 )

Remove input type checking in favour of explicit `.DescribeProtocolAsync()` flow. Also removes `.AsAgentAsync()` as the validation happens at workflow run time. This makes it easier to use Workflows with DI without resorting to async-over-sync.

Jacob Alber · 2025-10-21 00:13:41 +00:00

0ef4e739d5

.NET: Sample 06_subWorkflows to showcase the sub workflows (workflow composability) (#1493 )

* Sample 06_subWorkflows ready.

* minor fix

Jose Luis Latorre Millas · 2025-10-16 18:11:43 +00:00

85921eda68

.NET: [BREAKING] Enable sharing of workflow instances across concurrently executing runs (#1464 )

* refactor: remove unused internals

* feat: Execution Mode for sharing a workflow among concurrent runs

* feat: Update WorkflowHostAgent to support concurrent execution

* Also update AsAgent APIs to support injecting a CheckpointManager and an IWorkflowExecutionEnvironment

* fix: Make Read logic consistent in DeclarativeWorkflowContext

Jacob Alber · 2025-10-15 21:34:17 +00:00

331c750515

.NET: ChatClientBuilderExtensions should be in the M.E.AI namespace (#1484 )

* ChatClientBuilderExtensions should be in the M.E.AI namespace

* ChatClientBuilderExtensions should be in the M.E.AI namespace

Mark Wallace · 2025-10-15 14:58:41 +00:00

d7094d5432

Update to M.E.AI 9.10 (#1461 )

And other System.*/Microsoft.Extensions.* updated today

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

Stephen Toub · 2025-10-15 08:33:33 +00:00

ab450078ab

.NET Workflows - Support agent level function invocation for declarative workflow (#1442 )

* Checkpoint

* Checkpoint

* Checkpoint

* Good

* Namespace

* Namespace

* Dun

* Async Test

* AgentId

* Portable pattern

* Portable2

* Portable3

* Respond to comments

* Namespace

* Function call selection

* ToHashSet

* ToHashSet

* Updated

* Parameter name

* Final

* Tests

Chris · 2025-10-14 20:42:15 +00:00

a6b6937b94

.NET: Remove reflection samples (#1460 )

* Removing usage of ReflectingExecutor<T> from workflow samples.

* Removing uneeded changes.

* Clean up.

* Update dotnet/samples/GettingStarted/Workflows/_Foundational/01_ExecutorsAndEdges/Program.cs

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

* Update dotnet/samples/GettingStarted/Workflows/_Foundational/01_ExecutorsAndEdges/Program.cs

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

* Update dotnet/samples/GettingStarted/Workflows/_Foundational/02_Streaming/Program.cs

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

* Update dotnet/samples/GettingStarted/Workflows/_Foundational/02_Streaming/Program.cs

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

* Updates per PR feedback.

* Undo changes to generated file.

---------

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

Ben Thomas · 2025-10-14 20:34:04 +00:00

a4039134de

.NET: Add sample showing how to create ai function per a2a skill (#1452 )

* add sample showing how to create ai function per a2a skill

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

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

* Update dotnet/samples/GettingStarted/A2A/A2AAgent_AsFunctionTools/Program.cs

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

* Update dotnet/samples/GettingStarted/A2A/A2AAgent_AsFunctionTools/Program.cs

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

* address pr review comments

* rename local function

* add readmes

* fix broken links

---------

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

SergeyMenshykh · 2025-10-14 17:57:19 +00:00

1f0faff623

.NET Workflows - Update State Serialization for JSON Checkpointing (#1388 )

* Checkpoint

* Checkpoint

* Namespace

* All ready

* Namespace

* Clean

* Fix

Chris · 2025-10-10 20:10:17 +00:00

5fa153642e

.NET: Inline const values in samples where used only once (#1387 )

* Inline const values in samples where used only once

* Fix some spacing issues and use consistent ordering of settings/params

westey · 2025-10-10 16:50:53 +00:00

d6fdb91480

.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

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

Updated (#1272 )

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

1a81ed202e

.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

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

[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

.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

170 Commits