Prompts · Publisher repository

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.

74.6k StarsMITJupyter NotebookUpdated 3 days ago
01

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.

02

Core capabilities

01

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.

02

Tools, retrieval, and planning

Lessons 04, 05, and 07 cover tool calling, agentic RAG, and planning, with notebooks and exercises linked from each lesson.

03

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.

04

Context, memory, and self-review

Dedicated lessons explain context selection, persistent memory, and metacognitive review as separate design concerns rather than one undifferentiated prompt.

05

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.

03

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.

AI AGENT INSTALL

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.
01Before you start
  • 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
02Copy the install command or configuration
git clone --depth 1 https://github.com/microsoft/ai-agents-for-beginners.git
03Complete the setup steps
  1. 1
    Choose 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.

  2. 2
    Clone 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.

  3. 3
    Prepare an isolated runtime

    Create a Python 3.12 virtual environment and install requirements.txt. Install .NET 10 only when following .NET samples.

  4. 4
    Configure 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.

  5. 5
    Run 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.

  6. 6
    Add 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.

How to verify the setup

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.

Before using it
  • 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
04

Use cases

SCENARIO 01

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.

SCENARIO 02

Internal developer training

Use written lessons, notebooks, assignments, and knowledge checks as a shared curriculum for a team adopting Microsoft Agent Framework.

SCENARIO 03

Architecture comparison

Compare single-agent, multi-agent, cloud-hosted, and local-first patterns with concrete examples and explicit trust boundaries.

SCENARIO 04

Production readiness checklist

Use the later lessons to identify missing work in deployment, routing, caching, evaluation, tracing, approval, testing, and security.

05

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
06

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.git
Read the complete README on GitHub