agent-framework

Update 3

Roger Barreto · 2025-11-07 21:53:36 +00:00

469525d9e6

Update 2

Roger Barreto · 2025-11-07 21:44:31 +00:00

6e04c6bbbe

Update

Roger Barreto · 2025-11-07 20:01:38 +00:00

f5d6056074

Bugbash Samples

Roger Barreto · 2025-11-07 17:51:17 +00:00

9586a3ea53

Restructure Step1

Roger Barreto · 2025-11-07 12:46:04 +00:00

82bd9cf6b5

Merge branch 'main' into feature-foundry-agents

Chris · 2025-11-06 08:32:05 -08:00

2ee34beed5

.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

Merge branch 'main' into feature-foundry-agents

Chris · 2025-11-05 12:26:13 -08:00

55a4aa2b53

.NET: Update Extensions for Strict Agent Definitions + Improvements (#1892 )

* Update Package Nameing: V1 -> AzureAI.Persistent / V2 -> AzureAI

* Update agents and extensions to comply with strict agent definitions

* More static updates

* Address UT, and ResponseTool support

* Improving reusability extensions

* Addressing ResponseTools Unit Tests and extension setup

* Adapted workaround on breaking AAA with OpenAI 2.6.0

* Small updates

* Remove strictness when retrieving agents, improved XmlDocs

* Improve sample comments

* Update dotnet/tests/Microsoft.Agents.AI.AzureAI.UnitTests/AgentsClientExtensionsTests.cs

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

* Apply suggestion from @Copilot

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

* Apply suggestion from @Copilot

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

* Address PR comments

* Address UT failing

* Address Copilot feedback

* Address Copilot feedback

* Address comment typo

* Address PR feedback

* Address typo

* Add missing Extensions with ChatClientAgentOptions

* Address comments

---------

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

Roger Barreto · 2025-11-05 20:14:12 +00:00

279d91f58e

Update Package Nameing: V1 -> AzureAI.Persistent / V2 -> AzureAI (#1829 )

Roger Barreto · 2025-11-05 20:13:36 +00:00

51e7a2134a

.NET: Change model to be required just for prompt agent definition specific extensions (#1812 )

* Remove unneeded model from extensions

* Add noop justification

Roger Barreto · 2025-11-05 20:11:43 +00:00

90226526fa

.NET: Azure.AI.Agents Package Split + Initial Extensions (#1657 )

* Move packages

* Update nuget.config

* Address Xmldoc

* Remove format from branches checks

* Address Xmldocs

* Add more details to the implementation

* Moving Agent logic to ChatClient

* Adding Name and Id overrides to AzureAIAgent

* Updating extensions

* Add GetAiAgent extensions

* Adding support for version as name can conflict 409 using the Agents API with same name

* Addressing more updates to the extensions

* More improvements

* Remove debugging code from sample

* Address copilot feedback

* Apply suggestions from co-pilot code review

Roger Barreto · 2025-11-05 20:10:24 +00:00

7e23140ca9

.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

171 Commits