AI Agents for Beginners
Microsoft's open 18-lesson AI agent course covers design patterns, tool use, agentic RAG, multi-agent systems, context, memory, deployment, and security with Python and .NET examples.
Project overview
AI Agents for Beginners is Microsoft's open course for developers who want a path from agent concepts to working systems. Its 18 lessons connect design patterns, tool use, agentic RAG, planning, multi-agent orchestration, context engineering, memory, Microsoft Agent Framework, browser use, deployment, local agents, and security. Written guides, short videos, Python notebooks, .NET samples, knowledge checks, and assignments make it useful as both a self-study course and a team curriculum.
Core capabilities
Agent foundations and design patterns
Lessons 01 through 03 explain agent use cases, compare frameworks, and introduce design patterns before learners add tools or orchestration.
Tools, retrieval, and planning
Lessons 04, 05, and 07 cover tool calling, agentic RAG, and planning, with notebooks and exercises linked from each lesson.
Multi-agent and protocol design
The course covers multi-agent workflows and agent protocols including MCP, A2A, and NLWeb, then connects them to Microsoft Agent Framework orchestration patterns.
Context, memory, and self-review
Dedicated lessons explain context selection, persistent memory, and metacognitive review as separate design concerns rather than one undifferentiated prompt.
Deployment, local operation, and security
The final lessons cover scalable Microsoft Foundry deployment, smoke tests, an on-device Foundry Local agent, and auditable or tamper-evident agent actions.
Access and usage
Use a shallow clone, create an isolated Python 3.12 environment, copy the example environment file, and begin with the setup lesson. Provision Microsoft Foundry resources only when a selected notebook requires them.
Let an AI Agent install it
Send this prompt to Codex, Claude Code, or another AI agent that can work with your local environment.
Help me safely set up AI Agents for Beginners from https://github.com/microsoft/ai-agents-for-beginners. First read README.md, 00-course-setup/README.md, .env.example, requirements.txt, SECURITY.md, and LICENSE at commit 25b7985f3b2dc37a84f4a7387ccd3c9f0e5b1595. Confirm Git, Python 3.12+, available disk space, whether I need Python or .NET, and whether I want the Microsoft Foundry cloud path or Foundry Local. Use a shallow or sparse clone because the complete repository history is about 3 GB. Create an isolated virtual environment before installing requirements. Never print, commit, or invent endpoints, subscription identifiers, connection IDs, API keys, or tokens. Ask before Azure login, resource creation, paid model calls, browser control, deployment, or file operations outside the course directory. Start with one low-risk notebook, report every command and file change, and separate documentation claims from observed results.- Git
- Python 3.12 or newer
- pip and virtual environment support
- Azure CLI for the primary cloud exercises
- An Azure subscription and Microsoft Foundry project for most notebooks
- .NET 10 or newer for .NET samples
- A deployed model such as the documented gpt-5-mini deployment
git clone --depth 1 https://github.com/microsoft/ai-agents-for-beginners.git- 1Choose a learning path
New learners should follow Lessons 01 through 06 in order. Developers with a specific goal can use STUDY_GUIDE.md to select paths for tools, RAG, multi-agent systems, production, or local agents.
- 2Clone only what you need
Use a depth-one clone for the complete current course, or sparse checkout for the setup lesson and selected lesson directories. This avoids downloading roughly 3 GB of translation assets and history.
- 3Prepare an isolated runtime
Create a Python 3.12 virtual environment and install requirements.txt. Install .NET 10 only when following .NET samples.
- 4Configure one provider path
For the primary path, authenticate with Azure CLI and set the documented Microsoft Foundry endpoint and model deployment in a local .env file. Configure optional services only for the lessons that use them.
- 5Run a low-risk lesson
Begin with an early notebook that does not deploy infrastructure or control a browser. Review outputs, token usage, data sent to the provider, and any created files.
- 6Add production checks gradually
When moving toward deployment, use the course material on trust, evaluation, observability, smoke tests, and security. Treat the educational examples as starting points that still need project-specific review.
After installing dependencies, run az login and az account show only if using the cloud path, copy .env.example to .env, enter your own endpoint and deployment name, and open one early Python notebook. Confirm that imports and authentication succeed before attempting tools, retrieval, deployment, or browser control. This review did not perform those steps.
- Use sparse checkout when only a few lessons are needed
- The main cloud path uses Azure CLI authentication and a Microsoft Foundry project
- Lesson-specific services should be configured only when reaching those lessons
- Foundry Local is useful for local study but does not expose every cloud feature
Use cases
Structured self-study
Follow a coherent path from agent vocabulary and design to tools, RAG, orchestration, production, and security while keeping one small demo across lessons.
Internal developer training
Use written lessons, notebooks, assignments, and knowledge checks as a shared curriculum for a team adopting Microsoft Agent Framework.
Architecture comparison
Compare single-agent, multi-agent, cloud-hosted, and local-first patterns with concrete examples and explicit trust boundaries.
Production readiness checklist
Use the later lessons to identify missing work in deployment, routing, caching, evaluation, tracing, approval, testing, and security.
Assessment
AI Agents for Beginners earns its place as a substantial learning resource because the curriculum connects core concepts to maintained code, assignments, testing material, deployment guidance, and security topics. The study guide makes the breadth navigable, and the changelog shows recent migration work around Microsoft Agent Framework and Foundry. The main cost is operational. Most runnable cloud examples need Azure resources, some lessons add specialized services, and the unversioned repository requires commit-level review for repeatable training. Public documentation and source were checked for this entry; AgentMatter did not independently execute the notebooks.
Why it may be useful
- Eighteen lessons span foundations, implementation, production, and security
- Written guides, videos, notebooks, .NET samples, assignments, and knowledge checks support different learning styles
- A study guide offers goal-based paths instead of requiring a strictly linear course
- MIT licensing, Microsoft ownership, a security policy, tests, and recent maintenance are publicly verifiable
- Cloud and local-first agent paths are both documented
What to know first
- Most primary notebooks require Azure and Microsoft Foundry resources
- Several lessons need additional services or runtimes
- The repository has no official GitHub release or tag to pin
- The full history and translation assets are large
- This catalog review did not install dependencies or execute code
README
AI Agents for Beginners
Overview
Microsoft's open 18-lesson AI agent course covers design patterns, tool use, agentic RAG, multi-agent systems, context, memory, deployment, and security with Python and .NET examples. An 18-lesson open course for getting started with AI agents using written guides, videos, Python notebooks, and .NET samples.
Getting started
- Use a shallow clone, create an isolated Python 3.12 environment, copy the example environment file, and begin with the setup lesson. Provision Microsoft Foundry resources only when a selected notebook requires them.
- The course contains 18 lessons. The first six establish concepts, frameworks, design patterns, tool use, agentic RAG, and trustworthy behavior. Later lessons add planning, multi-agent design, metacognition, production concerns, protocols, context, memory, Microsoft Agent Framework, browser use, scalable deployment, local agents, and security.
- Each lesson combines a written README with a short video and Python code samples. The repository also includes .NET examples, knowledge checks, assignments, a study guide, and more than 50 automated translations, including Simplified Chinese.
- After installing dependencies, run az login and az account show only if using the cloud path, copy .env.example to .env, enter your own endpoint and deployment name, and open one early Python notebook. Confirm that imports and authentication succeed before attempting tools, retrieval, deployment, or browser control. This review did not perform those steps.
Configuration
git clone --depth 1 https://github.com/microsoft/ai-agents-for-beginners.gitRead the complete README on GitHub →