Awesome Microsoft Agent Framework

Open-source development kit for building AI agents and multi-agent workflows for .NET and Python.

Contents

• Getting Started
• Official Documentation
• Video Resources
• Blog Posts & Articles
• Tutorials
• Examples & Samples
• Tools & Frameworks
• Related Technologies
• Community

Getting Started

Installation

• Get Started with Agent Framework - Official installation and setup guide for Python and .NET.
• Python Package (PyPI) - Python package listing with installation instructions.
• .NET Package (NuGet) - .NET package listing with installation instructions.

Quick Start Resources

• Microsoft Agent Framework GitHub Repository - Official source code and examples.
• Quick Start Guide - Get started with a simple agent.
• Hello World Agents Sample - Try it out in GitHub Codespaces.

Official Documentation

• Official Documentation Hub - Complete documentation portal.
• Microsoft Agent Framework Overview - High-level overview and concepts.
• Tutorials - Step-by-step tutorials.
• User Guide - In-depth user guide for building agents and workflows.
• Migration from Semantic Kernel - Guide for migrating from Semantic Kernel.
• Migration from AutoGen - Guide for migrating from AutoGen.

Video Resources

• Microsoft Agent Framework Introduction (30 min) - Full framework introduction.
• Microsoft Agent Framework WorkFlows Explained (30 min) - A detailed walkthrough of the workflow system in Microsoft Agent Framework, covering core concepts and usage patterns.
• AI Show Episodes - Microsoft AI Show coverage.
• Deep Dive into Microsoft Agent Framework for AutoGen Users - Comprehensive walkthrough for developers migrating from AutoGen.
• DevUI in Action (1 min) - Interactive developer UI demo.
• Agent Framework Lab - The AI Show episode - The experimental modules of Microsoft Agent Framework.
• Microsoft Agent Framework Playlist - YouTube playlist collection of videos and tutorials.
• End-to-End Example (Part 2: Deployment Options) - Demonstration of deploying an AI-powered backend using different deployment strategies by Rasmus Wulff Jensen.

Blog Posts & Articles

Community Blogs

• Microsoft Agent Framework: Why This Matters for the Future of Enterprise AI - Article by Muhammad Zubair.
• From ChatGPT to Codex: How I Built an Agent Framework Lab That Talks to OpenAI and Ollama - Article by Fabian Williams.
• Microsoft Agent Framework - Article by Bill Ayers.
• Microsoft Agent Framework Python Auth0 Token Vault - Guide on integrating Auth0 Token Vault with Microsoft Agent Framework in Python.
• Microsoft Agent Framework: First Look - Article by Jamie Maguire.
• Microsoft Agent Framework: Conversations and Threads - Article by Jamie Maguire.
• Microsoft Agent Framework: Extending Agent Intelligence Using Function Tools - Article by Jamie Maguire.
• Microsoft Agent Framework: Using Agents as Function Tools - Article by Jamie Maguire.
• Microsoft Agent Framework is now AG UI compatible - Blog post about AG UI compatibility with Microsoft Agent Framework.
• My Take: Why Microsoft Agent Framework Matters - Article by Edgar Mcochieng.
• Give Your Agents New Capabilities and Expertise Using Skills with Microsoft Agent Framework - Practical guide on implementing Agent Skills by Arafat Tehsin.
• Microsoft Agent Framework - Agent Skills - Overview and walkthrough of Agent Skills by Ravikanth Chaganti.
• Agent Skills - Deep dive into Agent Skills architecture, components, and how they introduce a modular approach to designing agents, by Lana Noor.
• Giving AI Agents a Real Computer - Technical deep-dive on the GitHub Copilot provider for Microsoft Agent Framework and building Sandcastle, by Maxim Salnikov.

Official Microsoft Blogs

• Introducing Microsoft Agent Framework - Azure AI and machine learning blog announcement.
• Introducing Microsoft Agent Framework: The Open-Source Engine for Agentic AI Apps - Azure AI Foundry blog announcement.
• Introducing Microsoft Agent Framework (Preview): Making AI Agents Simple for Every Developer - .NET blog announcement.
• Migrate your Semantic Kernel and AutoGen projects to Microsoft Agent Framework Release Candidate - Migration guide for transitioning projects to the release candidate.
• Build AI agents with GitHub Copilot SDK and Microsoft Agent Framework - Guide for building AI agents with GitHub Copilot SDK integration.
• Give Your Agents Domain Expertise with Agent Skills in Microsoft Agent Framework - Introducing Agent Skills for packaging domain expertise as reusable, portable skill modules.
• Agent Harness in Agent Framework - Overview of the Agent Harness feature in Microsoft Agent Framework.
• What's New in Agent Skills: Code Skills, Script Execution, and Approval for Python - New Agent Skills capabilities including code skills, script execution, and approval workflows for Python.
• AG-UI Multi-Agent Workflow Demo - Building a customer support multi-agent workflow with MAF handoffs and AG-UI protocol for real-time UI streaming.
• CodeAct with Hyperlight - Introducing CodeAct support in Agent Framework via the agent-framework-hyperlight package, collapsing multi-step tool-call loops into single sandboxed Python executions for lower latency and token usage.
• A2A v1 is here: Cross-platform agent communication in Microsoft Agent Framework for .NET - Announcing the A2A v1 release and cross-platform agent-to-agent communication support in Microsoft Agent Framework for .NET.
• A Tour of Handoff Orchestration Pattern - Deep dive into the handoff orchestration pattern for coordinating multi-agent workflows in Microsoft Agent Framework.
• From Local to Production: Deploy your Microsoft Agent Framework Agent with Foundry-Hosted Agents - Guide to moving Microsoft Agent Framework agents from local development to production using Foundry-hosted agents.
• Build a Real-World Example with Microsoft Agent Framework, Microsoft Foundry, MCP, and Aspire - Walkthrough of an open-source Interview Coach sample showing how to build a production-style multi-agent application using Microsoft Agent Framework, Microsoft Foundry, MCP servers, and Aspire for cloud-native orchestration.
• Governance at the Speed of Agents: Microsoft Agent Framework and Agent Governance Toolkit, Better Together - How Agent Governance Toolkit pairs with Microsoft Agent Framework to enforce policy at runtime, govern agent actions, and provide end-to-end auditability for production AI agents.
• FIDES: Flow Integrity Deterministic Enforcement System in Agent Framework - Introducing FIDES, an information-flow control middleware that labels content with integrity and confidentiality labels to deterministically enforce policies and protect against prompt injection attacks.
• Agent Loops, Workflows, and Harnesses: The Layered SDK Powering Microsoft Agent Framework - Explains how Microsoft Agent Framework's layered SDK is organized around agent loops, workflows, and harnesses to move from a prompt to a production-ready agent.
• The Microsoft Agent Framework Harness is now released - Announcing the stable, batteries-included agent harness for Python and .NET that wraps a chat client with a complete agentic pipeline including function invocation, planning, memory, compaction, tool approvals, web search, and telemetry.

Tutorials

• Agent Framework Demos Day 1: Intercepting Function Calls - Practical guide to intercepting and handling function calls in Microsoft Agent Framework.
• Agent Framework Deep Dive - Deep dive tutorial and comprehensive guide to Microsoft Agent Framework.
• Build AI Agents in C# with the Microsoft Agent Framework and Hugging Face MCP Tools - Tutorial on building AI agents in C# using Microsoft Agent Framework integrated with Hugging Face MCP tools.
• Build a Documentation Assistant with Microsoft Agent Framework and Azure AI Foundry - Hands-on C# tutorial for building an internal docs assistant using Microsoft Agent Framework, Azure AI Foundry, and custom tools.
• Generative AI Notebooks - Collection of Jupyter notebooks demonstrating Microsoft Agent Framework concepts and implementations.
• M365 Graph DevUI Walkthrough - Step-by-step walkthrough for using DevUI with Microsoft 365 Graph integration.
• Microsoft Agent Framework Playbook - Chapter-based learning path covering MAF concepts from agent fundamentals to workflows, orchestration, streaming, middleware, and DevUI.
• Multi-Model AI Agent Orchestration in .NET 9 - Tutorial on building multi-model AI agent orchestration using Microsoft Agent Framework in .NET 9.
• Taking Multi-Model AI Orchestration Further: Azure AI Foundry Persistent Agents in .NET 9 - Advanced tutorial on implementing persistent agents with Azure AI Foundry and Microsoft Agent Framework in .NET 9.
• Build Long-Running AI Agents on Azure App Service with Microsoft Agent Framework - Step-by-step guide for building and deploying long-running AI agents on Azure App Service.
• Part 2: Build Long-Running AI Agents on Azure App Service with Microsoft Agent Framework - Continuation of the practical guide for deploying long-running AI agents on Azure App Service.
• Multi-agent Workflow with Human Approval using Agent Framework - Tutorial on implementing multi-agent workflows with human-in-the-loop approval patterns.
• Bulletproof Agents with the Durable Task Extension for Microsoft Agent Framework - Tutorial on building bulletproof agents using the Durable Task Extension.

Examples & Samples

Python Samples

• Getting Started with Agents - Basic agent creation and tool usage.
• Getting Started with Workflows - Basic workflow creation.
• Chat Client Examples - Direct chat client usage patterns.
• Observability Examples - Monitoring and tracing.
• Middleware Examples - Custom middleware implementations.

.NET Samples

• Getting Started with Agents - Basic agent creation and tool usage.
• Agent Provider Samples - Different agent providers.
• Workflow Samples - Advanced multi-agent patterns.
• OpenTelemetry Integration - Telemetry and monitoring.
• Middleware Examples - Custom middleware.

Community Examples

• PrivyDoc - Local document intelligence tool powered by Foundry Local for secure, on-device document analysis.
• AICalcX - Real-time AI project cost estimation combining live Azure pricing, human resources, and autonomous agents for accurate enterprise TCO.

Tools & Frameworks

Development Tools

• Agent Framework Toolkit - An opinionated C# toolkit that simplifies development with Microsoft Agent Framework, providing convenient factories and options for creating agents with multiple AI providers.
• DevUI - Interactive developer UI for agent development, testing, and debugging workflows.
• VS Code AI Toolkit - Streamlined experience for building with Microsoft Agent Framework.
• AF Labs - Experimental packages for cutting-edge features including benchmarking and reinforcement learning.
• Agent Skills Repository - Official repository of ready-made skills, MCP servers, custom agents, and reusable agent components.

Integration Options

• Agent Framework MS - Project demonstrating how to extend the agent-framework by creating a custom chat client for Google's Gemini large language models.
• Model Context Protocol (MCP) - Connect to external tools and data servers.
• Agent as MCP Server - Example of exposing an agent as an MCP server using Microsoft Agent Framework with STDIO transport.
• Agent-to-Agent (A2A) - Cross-runtime agent collaboration.
• Nylas CLI - MCP server giving agents email, calendar, and contacts access to Outlook, Exchange, Microsoft 365, plus Gmail, Yahoo, iCloud, and IMAP through one auth flow. 16 tools, install with nylas mcp install.

Related Technologies

Microsoft AI Ecosystem

• Semantic Kernel - Predecessor framework for AI orchestration.
• AutoGen - Multi-agent conversation framework.
• Azure AI Foundry - Cloud platform for AI development.
• Microsoft 365 Agents SDK - Enterprise agent development.
• Copilot Studio - Low-code agent development.

Standards & Protocols

• Model Context Protocol (MCP) - Standard for tool integration.
• OpenAPI - API specification standard.
• OpenTelemetry - Observability standard.
• Azure AI Content Safety - Content moderation and safety.

Community

• Azure AI Foundry Discord - Join the community on Discord, see the #agent-framework channel for discussions.
• Reddit r/MSAgentFramework - Community discussions, questions, and sharing experiences.

Contributing

Contributions welcome! Read the contribution guidelines first.

Footnotes

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.