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

T

Eric Zhu 2133043f11 Python: [Breaking] Remove WorkflowCompletedEvent, introduce workflow output and migrate to ctx.yield_output() + a huge refactoring (#845 )

* Introduce input and output types for executor and workflow

* WorkflowOutputContext handles two types

* Remove can_handle_types from Executor

* Update validation

* Move workflow executor

* Move workflow executor

* Fix issues in WorkflowExecutor

* refactor executor

* update execute signature to create workflow context within Executor

* fix simple sub workflow test; fix validation

* fix output types in WorkflowExecutor

* fix issue in Executor handling of SubWorkflowRequestInfo

* update tests to use proper workflow output

* update orchestration patterns to use output

* Update sample -- not finished

* Update python/packages/main/tests/workflow/test_workflow_states.py

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

* Update python/packages/main/tests/workflow/test_concurrent.py

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

* address comments

* WorkflowOutputContext --> WorkflowContext

* remove WorkflowCompletedEvent

* update samples

* Update doc string for important classes; update WorkflowExecutor to support concurrent execution

* use Never instead of None for default type

* Update usage of WorkflowContext[None to WorkflowContext[Never

* address comments

* remove filter for None

* address comments, minor fixes

* quality of life improvement on interceptor types

---------

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

2133043f11 · 2025-09-23 20:52:53 +00:00

388 Commits

.github

Python: Add tau2 benchmark integration with comprehensive testing and documentation (#817 )

2025-09-21 23:08:45 +00:00

docs

Python: update to packaging section of python package design doc (#727 )

2025-09-23 06:37:35 +00:00

dotnet

.NET Workflows - Integrate Element Aliasing (#835 )

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

python

Python: [Breaking] Remove WorkflowCompletedEvent, introduce workflow output and migrate to ctx.yield_output() + a huge refactoring (#845 )

2025-09-23 20:52:53 +00:00

user-documentation-dotnet

Move package installation instructions to user-guide (#572 )

2025-09-01 17:30:11 +00:00

user-documentation-python

MCP support for Foundry (#652 )

2025-09-09 20:07:20 +00:00

workflow-samples

.NET Workflows - Integrate Element Aliasing (#835 )

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

.gitattributes

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

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

.gitignore

Add agents.md to gitignore (#870 )

2025-09-23 15:10:06 +00:00

CODE_OF_CONDUCT.md

CODE_OF_CONDUCT.md committed

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

CONTRIBUTING.md

Added contributing guidelines (#470 )

2025-08-26 20:10:55 +00:00

LICENSE

LICENSE committed

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

README.md

Update link for Orchestration Samples in README (#825 )

2025-09-18 22:03:06 +00:00

SECURITY.md

SECURITY.md committed

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

SUPPORT.md

Fix broken links (#583 )

2025-09-02 12:18:12 +00:00

README.md

Microsoft Agent Framework

Welcome to the Private Preview of Agent Framework!

You're getting early access to Microsoft's comprehensive multi-language framework for building, orchestrating, and deploying AI agents with support for both .NET and Python implementations. This framework provides everything from simple chat agents to complex multi-agent workflows with graph-based orchestration.

📋 Important Setup Information

Package Availability: Public PyPI and NuGet packages are not yet available. You have two options:

Option 1: Run samples directly from this repository (no package installation needed)

Clone this repository
For .NET: Run samples with dotnet run from any sample directory (e.g., dotnet/samples/GettingStarted/Agents/Agent_Step01_Running)
For Python: Run samples from any sample directory (e.g., python/samples/getting_started/minimal_sample.py) after setting up the local dev environment following this guide.

Option 2: Install packages in your own project

.NET Getting Started Guide - Instructions for using nightly packages
Python Package Installation Guide - Install packages directly from GitHub

Stay Updated: This is an active project - sync your local repository regularly to get the latest updates.

💬 We want your feedback!

For bugs, please file a GitHub issue.
For feedback and suggestions for the team, please fill out this survey.

✨ 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

Agent Framework Documentation

Languages

Python 50.9%

C# 45.8%

TypeScript 2.7%

HTML 0.2%

PowerShell 0.1%

Other 0.1%