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

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

samples: WorkflowHelper => WorkflowFactory (#1640 )

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

feb3404a27

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

[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

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

.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: Align environment variable names (#1053 )

* alignt environment variable names

* rename modelId variable names

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

5f1417ab94

fix failing CheckpointWithHumanInTheLoop sample (#1034 )

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

2680edff65

.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: Clean up some CancellationToken usage (#996 )

* Clean up some CancellationToken usage

* Unused usings

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

4fd61924fc

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

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

Add a sample using multiple services (#851 )

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

09bdd64dcb

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

Fix sample (#816 )

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

387b15997d

59 Commits