mirror of https://github.com/microsoft/agent-framework.git synced 2026-06-16 21:04:09 +08:00

T

Jacob Alber 32711cfa95 .Net: WIP: feat: Define Workflow and Executor APIs (#261 )

* feat: Define Workflow and Executor APIs

* feat: Define IExecutionContext and Events

* feat: Simple Workflow Demos

* refactor: Move Workflows classes to separate assembly

* feat: Move FanOut/In to LowLevel API with new semantics

* feat: Implement Local Execution

* refactor: Assembly name .Workflow => .Workflows

* feat: Enable Default Message Handling

* also lifts Bind in MessageHandlerInfo to better be able to direclty invoke handlers (for AOT, later)

* feat: Implement StreamingHandle APIs

This allows the user to respond to WorkflowEvents with external messages, enabling HIL.

* feat: Add checks for duplicate edges and chain cycles

* feat: Add built-in WorkflowEvents

* refactor: Pull classes into own files

* refactor: Simplify Disposal pattern in Executor

* refactor: Break EdgeRunner file into per-type files

* refactor: Use Throw.IfNull()

* refactor: Remove AddLoop()

Per https://github.com/microsoft/agent-framework/pull/272#discussion_r2241739079 we decided this was not very useful.

* refactor: Normalize use of ValueTask

* fix: Build Break from removing .AddLoop

* refactor: Explicit routing and RouteBuilder

Split out reflection from MessageRouter implemention into build phase, enabling AOT compilation to drive RouteBuilding without reflection.

* test: Add Reflection/Invocation tests

* fix: Terminate on Completion event

* refactor: Update public API surface

* feat: Add support for external requests

* feat: Support hosting AIAgent instances in Workflows

* fix: Fix routing to go through Executor.ExecuteAsync

* test: Update samples for "must SendMessage" semantics

* Add invoking samples to unit tests to avoid future breaks

* fix: ExternalRequest should block Workflow completion

* feat: Normalize API surface against Python

* Also adds xmldoc to all public APIs

* refactor: Normalize UnitTest and Sample namespaces

* fix: Formatting

* refactor: Normalize project/folder names

* feat: Remove DynamicCodeExecution from ValueTaskTypeErasure

* fix: Fix ILTrim warnings

* docs: Add missing docs and fix typos

* feat: Hosted Agents should report Run events

* fix: Fix type propagation for ILTrim changes

* refactor: Simplify DynamicallyAccessedMembers annotations

* sample: Use static-Type construction of InputPort

* feat: Support non-Streaming Run Mode

* test: Add test for non-streaming execution

* refactor: Remove unused types

* refactor: Simplify Event and EdgeData type hierarchies

* feat: Add Switch (=Conditional Edge Group) control flow

* feat: Make .NET AutoSend the MessageHandler result

* feat: Implement State APIs

* refactor: Simplify public namespaces and code organization

* refactor: Reconcile .NET and Python names

---------

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

32711cfa95 · 2025-08-13 22:34:39 +00:00

170 Commits

.github

Python: Introducing Local MCP Servers (#389 )

2025-08-13 09:48:22 +00:00

docs

Remove outdated design doc (#320 )

2025-08-05 14:39:24 +00:00

dotnet

.Net: WIP: feat: Define Workflow and Executor APIs (#261 )

2025-08-13 22:34:39 +00:00

python

Python: Introducing Local MCP Servers (#389 )

2025-08-13 09:48:22 +00:00

.gitattributes

.Net: Agent Samples - Adding AzureAIAgentsPersistent to Steps (#105 )

2025-06-26 22:17:59 +00:00

.gitignore

Python: Define Workflow and Executor APIs (#272 )

2025-08-06 23:26:15 +00:00

CODE_OF_CONDUCT.md

CODE_OF_CONDUCT.md committed

2025-04-28 12:54:41 -07:00

LICENSE

LICENSE committed

2025-04-28 12:54:43 -07:00

README.md

Add information about workflows to README.md (#413 )

2025-08-13 18:13:59 +00:00

SECURITY.md

SECURITY.md committed

2025-04-28 12:54:42 -07:00

SUPPORT.md

SUPPORT.md committed

2025-04-28 12:54:43 -07:00

README.md

Microsoft Agent Framework

Highlights

Flexible Agent Framework: build, orchestrate, and deploy AI agents and workflows
Multi-Agent Orchestration: group chat, sequential, concurrent, and handoff patterns
Graph-based Workflows: connect agents and deterministic functions using data flows with streaming, checkpointing, time-travel, and Human-in-the-loop.
Plugin Ecosystem: extend with native functions, OpenAPI, Model Context Protocol (MCP), and more
LLM Support: OpenAI, Azure OpenAI, Azure AI Foundry, and more
Runtime Support: in-process and distributed agent execution
Multimodal: text, vision, and function calling
Cross-Platform: .NET and Python implementations

Below are the basics for each language implementation. For more details on python see here and for .NET see here.

More Examples & Samples

Python

Getting Started with Agents: basic agent creation and tool usage
Chat Client Examples: direct chat client usage patterns
Azure Integration: Azure OpenAI and AI Foundry integration
Getting Started with Workflows: basic workflow creation and integration with agents

.Net

Getting Started with Agents: basic agent creation and tool usage
Agent Provider Samples: samples showing different agent providers
Orchestration Samples: advanced multi-agent patterns
Getting Started with Workflows: (Coming soon) basic workflow creation and integration with agents

Agent Framework Documentation

Languages

Python 50.9%

C# 45.8%

TypeScript 2.7%

HTML 0.2%

PowerShell 0.1%

Other 0.1%