# microsoft/ai-agents-for-beginners architecture

> Architecture diagram of the GitHub repository microsoft/ai-agents-for-beginners, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/microsoft/ai-agents-for-beginners
- Repository: https://github.com/microsoft/ai-agents-for-beginners

## Overview

This repository is a self-guided course for learning to build AI agents, not a single agent application. Learners choose lessons covering setup, agent fundamentals, tools, retrieval, safety, planning, multi-agent workflows, production, protocols, memory, and related topics; each lesson provides written material and code samples. The graph maps the course’s major lesson stages and calls out the sampled MCP client/server and resumable-event-store components. Lesson-level relationships are documented at course level; only the sampled internal code relationships are shown as evidenced.

Main entry points: [`11-agentic-protocols/code_samples/mcp-agents/server/server.py`](https://github.com/microsoft/ai-agents-for-beginners/blob/main/11-agentic-protocols/code_samples/mcp-agents/server/server.py) (MCP Server), [`11-agentic-protocols/code_samples/mcp-agents/client/client.py`](https://github.com/microsoft/ai-agents-for-beginners/blob/main/11-agentic-protocols/code_samples/mcp-agents/client/client.py) (MCP Client), [`00-course-setup`](https://github.com/microsoft/ai-agents-for-beginners/tree/main/00-course-setup) (Course Setup), [`01-intro-to-ai-agents`](https://github.com/microsoft/ai-agents-for-beginners/tree/main/01-intro-to-ai-agents) (Agent Introduction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundations["Agent Foundations"]
  node_setup["Course Setup"]
  node_intro["Agent Introduction"]
  node_frameworks["Agent Frameworks"]
  node_patterns["Design Patterns"]
end

subgraph group_capabilities["Agent Capabilities"]
  node_tools["Tool Use"]
  node_rag["Agentic RAG"]
  node_trust["Trustworthy Agents"]
  node_planning["Planning And Design"]
  node_browser["Browser Use"]
end

subgraph group_orchestration["Agent Orchestration"]
  node_multiagent["Multi-Agent Systems"]
  node_metacognition["Metacognition"]
  node_context["Context Engineering"]
  node_memory["Agent Memory"]
  node_maf["Microsoft Agent Framework"]
end

subgraph group_operations["Deployment And Protocols"]
  node_production["Production Agents"]
  node_protocols["Agent Protocols"]
  node_mcpclient["MCP Client<br/>[client.py]"]
  node_mcpserver["MCP Server<br/>[server.py]"]
  node_eventstore[("Event Store<br/>[event_store.py]")]
  node_scaling["Scalable Agents"]
  node_local["Local Agents"]
  node_security["Agent Security"]
end

node_learner(("Learner"))

node_learner -->|"configures examples"| node_setup
node_learner -->|"studies lesson"| node_intro
node_learner -->|"studies lesson"| node_frameworks
node_learner -->|"studies lesson"| node_patterns
node_learner -->|"studies lesson"| node_tools
node_learner -->|"studies lesson"| node_rag
node_learner -->|"studies lesson"| node_trust
node_learner -->|"studies lesson"| node_planning
node_learner -->|"studies lesson"| node_multiagent
node_learner -->|"studies lesson"| node_metacognition
node_learner -->|"studies lesson"| node_production
node_learner -->|"studies lesson"| node_protocols
node_learner -->|"studies lesson"| node_context
node_learner -->|"studies lesson"| node_memory
node_learner -->|"studies lesson"| node_maf
node_learner -->|"studies lesson"| node_browser
node_learner -->|"studies lesson"| node_scaling
node_learner -->|"studies lesson"| node_local
node_learner -->|"studies lesson"| node_security
node_mcpserver -->|"stores events"| node_eventstore
node_mcpclient -.->|"connects by MCP"| node_mcpserver

click node_setup "https://github.com/microsoft/ai-agents-for-beginners/tree/main/00-course-setup"
click node_intro "https://github.com/microsoft/ai-agents-for-beginners/tree/main/01-intro-to-ai-agents"
click node_frameworks "https://github.com/microsoft/ai-agents-for-beginners/tree/main/02-explore-agentic-frameworks"
click node_patterns "https://github.com/microsoft/ai-agents-for-beginners/tree/main/03-agentic-design-patterns"
click node_tools "https://github.com/microsoft/ai-agents-for-beginners/tree/main/04-tool-use"
click node_rag "https://github.com/microsoft/ai-agents-for-beginners/tree/main/05-agentic-rag"
click node_trust "https://github.com/microsoft/ai-agents-for-beginners/tree/main/06-building-trustworthy-agents"
click node_planning "https://github.com/microsoft/ai-agents-for-beginners/tree/main/07-planning-design"
click node_multiagent "https://github.com/microsoft/ai-agents-for-beginners/tree/main/08-multi-agent"
click node_metacognition "https://github.com/microsoft/ai-agents-for-beginners/tree/main/09-metacognition"
click node_production "https://github.com/microsoft/ai-agents-for-beginners/tree/main/10-ai-agents-production"
click node_protocols "https://github.com/microsoft/ai-agents-for-beginners/tree/main/11-agentic-protocols"
click node_mcpclient "https://github.com/microsoft/ai-agents-for-beginners/blob/main/11-agentic-protocols/code_samples/mcp-agents/client/client.py"
click node_mcpserver "https://github.com/microsoft/ai-agents-for-beginners/blob/main/11-agentic-protocols/code_samples/mcp-agents/server/server.py"
click node_eventstore "https://github.com/microsoft/ai-agents-for-beginners/blob/main/11-agentic-protocols/code_samples/mcp-agents/server/event_store.py"
click node_context "https://github.com/microsoft/ai-agents-for-beginners/tree/main/12-context-engineering"
click node_memory "https://github.com/microsoft/ai-agents-for-beginners/tree/main/13-agent-memory"
click node_maf "https://github.com/microsoft/ai-agents-for-beginners/tree/main/14-microsoft-agent-framework"
click node_browser "https://github.com/microsoft/ai-agents-for-beginners/tree/main/15-browser-use"
click node_scaling "https://github.com/microsoft/ai-agents-for-beginners/tree/main/16-deploying-scalable-agents"
click node_local "https://github.com/microsoft/ai-agents-for-beginners/tree/main/17-creating-local-ai-agents"
click node_security "https://github.com/microsoft/ai-agents-for-beginners/tree/main/18-securing-ai-agents"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_setup,node_intro,node_frameworks,node_patterns toneBlue
class node_tools,node_rag,node_trust,node_planning,node_browser toneAmber
class node_multiagent,node_metacognition,node_context,node_memory,node_maf toneMint
class node_production,node_protocols,node_mcpclient,node_mcpserver,node_eventstore,node_scaling,node_local,node_security toneRose
class node_learner toneIndigo
```

## Components

### Agent Foundations

- [Course Setup](https://github.com/microsoft/ai-agents-for-beginners/tree/main/00-course-setup): `00-course-setup`
- [Agent Introduction](https://github.com/microsoft/ai-agents-for-beginners/tree/main/01-intro-to-ai-agents): `01-intro-to-ai-agents`
- [Agent Frameworks](https://github.com/microsoft/ai-agents-for-beginners/tree/main/02-explore-agentic-frameworks): `02-explore-agentic-frameworks`
- [Design Patterns](https://github.com/microsoft/ai-agents-for-beginners/tree/main/03-agentic-design-patterns): `03-agentic-design-patterns`

### Agent Capabilities

- [Tool Use](https://github.com/microsoft/ai-agents-for-beginners/tree/main/04-tool-use): `04-tool-use`
- [Agentic RAG](https://github.com/microsoft/ai-agents-for-beginners/tree/main/05-agentic-rag): `05-agentic-rag`
- [Trustworthy Agents](https://github.com/microsoft/ai-agents-for-beginners/tree/main/06-building-trustworthy-agents): `06-building-trustworthy-agents`
- [Planning And Design](https://github.com/microsoft/ai-agents-for-beginners/tree/main/07-planning-design): `07-planning-design`
- [Browser Use](https://github.com/microsoft/ai-agents-for-beginners/tree/main/15-browser-use): `15-browser-use`

### Agent Orchestration

- [Multi-Agent Systems](https://github.com/microsoft/ai-agents-for-beginners/tree/main/08-multi-agent): `08-multi-agent`
- [Metacognition](https://github.com/microsoft/ai-agents-for-beginners/tree/main/09-metacognition): `09-metacognition`
- [Context Engineering](https://github.com/microsoft/ai-agents-for-beginners/tree/main/12-context-engineering): `12-context-engineering`
- [Agent Memory](https://github.com/microsoft/ai-agents-for-beginners/tree/main/13-agent-memory): `13-agent-memory`
- [Microsoft Agent Framework](https://github.com/microsoft/ai-agents-for-beginners/tree/main/14-microsoft-agent-framework): `14-microsoft-agent-framework`

### Deployment And Protocols

- [Production Agents](https://github.com/microsoft/ai-agents-for-beginners/tree/main/10-ai-agents-production): `10-ai-agents-production`
- [Agent Protocols](https://github.com/microsoft/ai-agents-for-beginners/tree/main/11-agentic-protocols): `11-agentic-protocols`
- [MCP Client](https://github.com/microsoft/ai-agents-for-beginners/blob/main/11-agentic-protocols/code_samples/mcp-agents/client/client.py): `11-agentic-protocols/code_samples/mcp-agents/client/client.py`
- [MCP Server](https://github.com/microsoft/ai-agents-for-beginners/blob/main/11-agentic-protocols/code_samples/mcp-agents/server/server.py): `11-agentic-protocols/code_samples/mcp-agents/server/server.py`
- [Event Store](https://github.com/microsoft/ai-agents-for-beginners/blob/main/11-agentic-protocols/code_samples/mcp-agents/server/event_store.py): `11-agentic-protocols/code_samples/mcp-agents/server/event_store.py`
- [Scalable Agents](https://github.com/microsoft/ai-agents-for-beginners/tree/main/16-deploying-scalable-agents): `16-deploying-scalable-agents`
- [Local Agents](https://github.com/microsoft/ai-agents-for-beginners/tree/main/17-creating-local-ai-agents): `17-creating-local-ai-agents`
- [Agent Security](https://github.com/microsoft/ai-agents-for-beginners/tree/main/18-securing-ai-agents): `18-securing-ai-agents`

### Other components

- **Learner**

## Connections

- Learner → Course Setup: configures examples (evidence: `README.md`)
- Learner → Agent Introduction: studies lesson (evidence: `README.md`)
- Learner → Agent Frameworks: studies lesson (evidence: `README.md`)
- Learner → Design Patterns: studies lesson (evidence: `README.md`)
- Learner → Tool Use: studies lesson (evidence: `README.md`)
- Learner → Agentic RAG: studies lesson (evidence: `README.md`)
- Learner → Trustworthy Agents: studies lesson (evidence: `README.md`)
- Learner → Planning And Design: studies lesson (evidence: `README.md`)
- Learner → Multi-Agent Systems: studies lesson (evidence: `README.md`)
- Learner → Metacognition: studies lesson (evidence: `README.md`)
- Learner → Production Agents: studies lesson (evidence: `README.md`)
- Learner → Agent Protocols: studies lesson (evidence: `README.md`)
- Learner → Context Engineering: studies lesson (evidence: `README.md`)
- Learner → Agent Memory: studies lesson (evidence: `README.md`)
- Learner → Microsoft Agent Framework: studies lesson (evidence: `README.md`)
- Learner → Browser Use: studies lesson (evidence: `README.md`)
- Learner → Scalable Agents: studies lesson (evidence: `README.md`)
- Learner → Local Agents: studies lesson (evidence: `README.md`)
- Learner → Agent Security: studies lesson (evidence: `README.md`)
- MCP Server → Event Store: stores events (evidence: `11-agentic-protocols/code_samples/mcp-agents/server/server.py`)
- MCP Client → MCP Server: connects by MCP
