Microsoft Agent Framework (.NET)

GA 1.0 unified .NET SDK that merges Semantic Kernel and AutoGen. Build C# agents with ChatClientAgent, orchestrate multi-agent workflows, integrate with Azure AI services via managed identity, and stream via SignalR or SSE.

Install

dotnet add package Microsoft.Agents.AI

Version

v1.0.1 · April 2026 · .NET 8.0+

Best for

Enterprise .NET agents, Azure-native deployments, RBAC, multi-agent orchestration.

Zero → Hero

1 · Introduction What the framework is · 10 min

2 · Core fundamentals DI, IChatClient, configuration · 20 min

3 · Simple agents ChatClientAgent, chat, async · 25 min

4 · Multi-agent systems Sequential, concurrent, handoff · 30 min

5 · Tools integration Function tools, built-ins · 20 min

6 · Structured output Typed responses, validation · 15 min

7 · MCP MCP client + server · 20 min

8 · Agentic patterns ReAct, planning, reflection · 20 min

9 · Memory systems Cosmos DB, SQL, Azure Search · 20 min

10 · Azure AI integration Azure OpenAI, Content Safety · 15 min

11 · Azure RBAC Managed Identity, Entra ID · 20 min

12 · Semantic Kernel bridge SK plugin compat · 15 min

13 · 2025 features A2A, graphs, declarative · 25 min

14 · Advanced Complex patterns, customisation · 30 min

15 · Streaming (SSE) .NET streaming server · 20 min

16 · Production Deployment, scaling · 30 min

Jump to a topic

ChatClientAgent

Multi-agent orchestration

Tools integration

MCP

Memory systems

Context engineering

Azure AI

Azure RBAC

Copilot Studio

Semantic Kernel integration

2025 features

Streaming server

Reference

Comprehensive (.NET) Single-page technical reference.

2025 features

Advanced

Azure RBAC

Recipes

Diagrams

Production guide

Streaming server

What’s new in GA 1.0 (April 2026)

Stable APIs with LTS commitment.
First-party service connectors via IChatClient: Azure OpenAI, OpenAI, Anthropic Claude, Amazon Bedrock, Google Gemini, Ollama.
Unified orchestration — sequential, concurrent, handoff, group chat, Magentic-One.
Azure App Service support.

Install, minimal example

using Microsoft.Agents.AI;
using Azure.AI.OpenAI;

var client = new AzureOpenAIClient(
    new Uri(Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")!),
    new DefaultAzureCredential()
);

var agent = new ChatClientAgent(
    chatClient: client.GetChatClient("gpt-4o"),
    instructions: "You are a helpful assistant."
);

var response = await agent.RunAsync("What is 15 + 27?");
Console.WriteLine(response.Text);

Ready? Start Zero → Hero Step 1 →

Revision history

Date	Version	Changes
2026-04-21	1.0.1	Index redesigned with Zero → Hero + Jump-to-topic grid.
April 10, 2026	1.0.1	Patch release.
April 3-7, 2026	1.0 GA	GA; stable APIs; first-party connectors; Azure App Service.
November 2025	1.0 Preview	Initial .NET guide.

Other languages: Python.