Welcome! This hands-on lab teaches you to build Snippy, an intelligent code snippet manager using Azure Functions, Azure OpenAI, and the Model Context Protocol (MCP).

• Serverless API with Azure Functions for saving/retrieving code snippets
• Vector Search using Azure OpenAI embeddings and Cosmos DB
• MCP Tools that GitHub Copilot can discover and use
• AI Agents that generate documentation and style guides from your code
• Multi-Agent Orchestration using Durable Functions

Before starting, ensure you have:

• Visual Studio Code - Download
• Python 3.11+ - Download
• Git - Download
• Azure CLI - Install
• Azure Functions Core Tools v4 - Install
• Azure Developer CLI (azd) - Install
• Docker Desktop - Download

• uv package manager (faster than pip) - Install
• REST Client Extension for VS Code - Install

• Azure Subscription - Create free account
• GitHub Account with Copilot - GitHub Copilot

1. Clone this repository

   git clone https://github.com/Azure-Samples/snippy.git
   cd snippy

2. Follow the tutorial

   • Open TUTORIAL.md for step-by-step instructions
   • Refer to TROUBLESHOOTING.md if you encounter issues

3. Clean up when done

   azd down --purge --force

• Azure Functions as an AI integration platform
• Model Context Protocol (MCP) for AI assistant integration
• Vector embeddings and semantic search with RAG patterns
• Microsoft Agent Framework for building AI agents
• Durable Functions for multi-agent orchestration
• Azure OpenAI integration with embeddings and chat models

• Issues: Found a bug? Open an issue
• Questions: Check TROUBLESHOOTING.md first
• Discussions: GitHub Discussions

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