Microsoft Agent Framework Samples

A comprehensive hands-on guide to building intelligent agents using the Microsoft Agent Framework. This repository contains practical examples, tutorials, and code samples that demonstrate how to create powerful AI agents using both Python and .NET implementations.

🚀 What You'll Learn

This repository provides step-by-step tutorials and real-world examples covering:

• Agent Foundations: Core concepts and architecture of the Microsoft Agent Framework
• Creating Your First Agent: Build a simple travel planning agent from scratch
• Framework Exploration: Deep dive into different providers and configurations
• Tools Integration: Implement vision, code interpretation, and custom tools
• Provider Patterns: Work with MCP (Model Context Protocol) and Agent-to-Agent communication
• RAG Implementation: Build knowledge-enhanced agents with file search capabilities
• Multi-Agent Systems: Orchestrate multiple agents working together
• Workflow Management: Create complex agent workflows and pipelines

📁 Repository Structure

Directory	Description	.NET Code Samples	Python Code Samples
00.ForBeginners	Beginner-friendly Microsoft Agent Framework examples extending AI Agents for Beginners	Travel Agent Basic Agent Design Patterns Tool Use RAG Search Planning Multi-Agent	Travel Agent Basic Agent Design Patterns Tool Use RAG Search Planning Multi-Agent
01.AgentFoundation	Core concepts and architecture of Microsoft Agent Framework	Documentation Only	Documentation Only
02.CreateYourFirstAgent	Build your first travel planning agent from scratch	Travel Agent with GitHub Models	Travel Agent with GitHub Models
03.ExploreAgentFramework	Deep dive into different providers and configurations	Azure OpenAI GitHub Models AI Foundry Foundry Local	Azure OpenAI GitHub Models AI Foundry Foundry Local
04.Tools	Vision, code interpretation, and custom tool integration	Vision Code Interpreter Bing Grounding File Search	Vision Code Interpreter Bing Grounding File Search
05.Providers	MCP (Model Context Protocol) and Agent-to-Agent communication	MCP with Microsoft Learn	MCP with Microsoft Learn
06.RAGs	Knowledge-enhanced agents with file search capabilities	File Search RAG	File Search RAG
07.Workflow	Complex agent workflows and orchestration patterns	Basic Workflow Sequential Concurrent Conditional	Basic Workflow Sequential Concurrent Conditional
08.EvaluationAndTracing	Agent evaluation, debugging, and observability tools	Python Only	Basic Agent DevUI Multi-Agent DevUI Foundry Agent DevUI Foundry Local DevUI Aspire Tracing
09.Cases	Real-world case studies combining Foundry workflows with production-ready multi-agent applications	Microsoft Foundry with AITK & MAF GHModel Multi-Agent (.NET)	Microsoft Foundry with AITK & MAF GHModel Multi-Agent (Python) Agentic Marketing Content Generation

🛠 Prerequisites

Note: This is internal priview intsallation guideline

Python Environment

• Python 3.10 or higher
• Install dependencies:

# Core only
# includes Azure OpenAI and OpenAI support by default
# also includes workflows and orchestrations
pip install agent-framework-core

# Core + Azure AI integration
pip install agent-framework-azure-ai

# Core + Microsoft Copilot Studio integration
pip install agent-framework-copilotstudio

# Core + both Microsoft Copilot Studio and Azure AI integration
pip install agent-framework-microsoft agent-framework-azure-ai

.NET Environment

• .NET 9.0 or higher
• Visual Studio 2022 or VS Code with C# extension

💻 Platform-Specific Setup

Windows ARM64 Configuration

If you're running on Windows ARM64, you may need to configure OpenSSL for certain dependencies:

git config --global core.longpaths true
winget install ShiningLight.OpenSSL.Dev
$env:OPENSSL_DIR="C:\Program Files\OpenSSL-Win64-ARM"
$env:OPENSSL_LIB_DIR="C:\Program Files\OpenSSL-Win64-ARM\lib\VC\arm64\MT"
$env:OPENSSL_STATIC="1"

Cross-Platform Compatibility

• Linux: Standard pip installation
• macOS: Homebrew for system dependencies
• Windows x64: Standard Windows installation

Required Services

• Azure OpenAI Service and Microsoft Foundry
• GitHub Models (for some examples)
• Azure CLI (authenticated)
• Azure Developer CLI (authenticated)

🚀 Quick Start

Environment Setup

Create a .env file in the root directory with your configurations:

# Azure OpenAI Configuration
AZURE_OPENAI_ENDPOINT=your_aoai_endpoint
AZURE_OPENAI_API_KEY=your_aoai_key
AZURE_OPENAI_DEPLOYMENT_NAME=your_model_deployment

# GitHub Models Configuration
GITHUB_TOKEN=your_github_token
GITHUB_ENDPOINT=https://models.inference.ai.azure.com
GITHUB_MODEL_ID=gpt-4o-mini

# Microsoft Foundry Configuration
FOUNDRY_PROJECT_ENDPOINT=your_foundry_endpoint
FOUNDRY_MODEL_DEPLOYMENT_NAME=your_model_name

📚 Tutorial Progression

Getting Started Level

0. 00.ForBeginners - Comprehensive beginner tutorials with Microsoft Agent Framework examples

Foundation Level

1. 01.AgentFoundation - Understand the core concepts and architecture
2. 02.CreateYourFirstAgent - Build your first travel planning agent

Intermediate Level

3. 03.ExploreAgentFramework - Explore different providers (Azure OpenAI, GitHub Models, AI Foundry)
4. 04.Tools - Add vision, code interpretation, and custom tool capabilities
5. 06.RAGs - Implement knowledge-enhanced agents with file search

Advanced Level

6. 05.Providers - Master MCP (Model Context Protocol) and Agent-to-Agent communication
7. 07.Workflow - Create complex agent workflows and orchestration patterns
8. 08.EvaluationAndTracing - Learn evaluation, debugging, and observability tools for agents

🔧 Key Features Demonstrated

• Multiple Provider Support: Azure OpenAI, GitHub Models, Microsoft Foundry
• Tool Integration: Vision analysis, code interpretation, custom functions
• RAG Capabilities: File search and knowledge base integration
• Multi-Agent Orchestration: Sequential and collaborative agent patterns
• MCP Integration: Model Context Protocol for enhanced capabilities
• Streaming Responses: Real-time agent interactions
• Persistent Agents: Stateful agent conversations
• Evaluation & Debugging: DevUI for visual debugging and observability tools for tracing

🤝 Contributing

We welcome contributions! Please feel free to submit issues, feature requests, or pull requests.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Resources

• Microsoft Agent Framework Documentation
• Azure AI Services
• Microsoft Foundry
• GitHub Models

🆘 Support

If you encounter any issues or have questions:

1. Check the individual README files in each chapter directory
2. Review the code samples for implementation details
3. Open an issue in this repository
4. Consult the official Microsoft Agent Framework documentation

---

Start your journey with Microsoft Agent Framework today! 🚀