# microsoft/building-ai-agents-from-zero-to-production architecture

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

- Interactive diagram: https://gitdiagram.com/microsoft/building-ai-agents-from-zero-to-production
- Repository: https://github.com/microsoft/building-ai-agents-from-zero-to-production

## Overview

This repository is a hands-on course, not one deployable product. Its central learning path takes an engineer from agent design through specialist-agent development, evaluation, and deployment, then extends into production hosting, toolboxes, and agent-to-agent communication. The deployment lesson includes a hosted onboarding agent and an optional ChatKit web interface with persisted conversations. Edges between lessons reflect the README’s stated progression; source-level edges are limited to relationships visible in excerpts or the source index.

Main entry points: [`lesson-2-agent-development/agent-orchestration.py`](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-2-agent-development/agent-orchestration.py) (Handoff Orchestrator), [`lesson-2-agent-development/README.md`](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-2-agent-development/README.md) (Agent Development), [`lesson-3-agent-evals/README.md`](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-3-agent-evals/README.md) (Agent Evaluations), [`lesson-4-agentdeployment/README.md`](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-4-agentdeployment/README.md) (Agent Deployment)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_course["Course Stages"]
  node_design["Agent Design<br/>[README.md]"]
  node_development_lesson["Agent Development<br/>[README.md]"]
  node_evaluation_lesson["Agent Evaluations<br/>[README.md]"]
  node_deployment_lesson["Agent Deployment<br/>[README.md]"]
  node_production_lesson["Production Hosting<br/>[README.md]"]
end

subgraph group_development["Agent Development"]
  node_orchestrator["Handoff Orchestrator"]
  node_employee_agent["Employee Search"]
  node_learning_agent["Learning Recommender"]
  node_coding_agent["Coding Assistant<br/>[coding-agent.py]"]
  node_azure_learning["Azure Learning Agent"]
  node_task_recommendation["Task Recommender"]
  node_vector_setup["Vector Store Setup"]
end

subgraph group_evaluation["Evaluation"]
  node_evaluation_runtime["Workflow Evaluation<br/>[agent-evals.py]"]
end

subgraph group_deployment["Deployment"]
  node_deployment_runtime["Deployment Workflow"]
  node_hosted_agent["Hosted Onboarding Agent<br/>[main.py]"]
  node_chat_ui["ChatKit Interface<br/>[App.tsx]"]
  node_chat_server["ChatKit Server<br/>[app.py]"]
  node_chat_store[("Conversation Store<br/>[store.py]")]
end

subgraph group_extensions["Agent Extensions"]
  node_toolbox_lesson["Toolbox Lesson<br/>[README.md]"]
  node_toolbox_agent["Toolbox Consumer<br/>[toolbox_agent.py]"]
  node_a2a_lesson["A2A Lesson<br/>[README.md]"]
  node_a2a_client["A2A Client<br/>[a2a_client.py]"]
  node_a2a_server["A2A Server<br/>[a2a_server.py]"]
end

node_learner(("Course Learner"))
node_foundry{{"Microsoft Foundry"}}
node_learn_mcp{{"Microsoft Learn MCP"}}

node_learner -->|"studies"| node_design
node_design -->|"progresses to"| node_development_lesson
node_development_lesson -->|"progresses to"| node_evaluation_lesson
node_evaluation_lesson -->|"progresses to"| node_deployment_lesson
node_deployment_lesson -->|"extends into"| node_production_lesson
node_development_lesson -->|"implements"| node_orchestrator
node_orchestrator -->|"hands off"| node_employee_agent
node_orchestrator -->|"hands off"| node_learning_agent
node_orchestrator -->|"hands off"| node_coding_agent
node_learning_agent -->|"hands off"| node_coding_agent
node_vector_setup -.->|"creates vector store"| node_foundry
node_evaluation_lesson -->|"demonstrates"| node_evaluation_runtime
node_evaluation_runtime -->|"evaluates agents"| node_foundry
node_deployment_lesson -->|"demonstrates"| node_deployment_runtime
node_deployment_runtime -.->|"deploys"| node_hosted_agent
node_hosted_agent -->|"runs on"| node_foundry
node_hosted_agent -->|"queries"| node_learn_mcp
node_chat_ui -->|"posts chat"| node_chat_server
node_chat_server -->|"persists threads"| node_chat_store
node_chat_server -->|"requests agent response"| node_foundry
node_toolbox_lesson -->|"demonstrates"| node_toolbox_agent
node_toolbox_agent -->|"connects toolbox"| node_foundry
node_a2a_lesson -->|"demonstrates"| node_a2a_client
node_a2a_lesson -->|"demonstrates"| node_a2a_server
node_a2a_client -->|"calls remotely"| node_a2a_server

click node_design "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-1-agent-design/README.md"
click node_development_lesson "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-2-agent-development/README.md"
click node_evaluation_lesson "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-3-agent-evals/README.md"
click node_deployment_lesson "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-4-agentdeployment/README.md"
click node_production_lesson "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-5-hosted-agents-production/README.md"
click node_orchestrator "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-2-agent-development/agent-orchestration.py"
click node_employee_agent "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-2-agent-development/employee-search-agent.py"
click node_learning_agent "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-2-agent-development/learning-recommendation-agent.py"
click node_coding_agent "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-2-agent-development/coding-agent.py"
click node_azure_learning "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-2-agent-development/azure-learning-agent.py"
click node_task_recommendation "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-2-agent-development/task-recommendation-agent.py"
click node_vector_setup "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-2-agent-development/setup_vector_store.py"
click node_evaluation_runtime "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-3-agent-evals/agent-evals.py"
click node_deployment_runtime "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-4-agentdeployment/agent-deployment.py"
click node_hosted_agent "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-4-agentdeployment/hosted-agent/main.py"
click node_chat_ui "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-4-agentdeployment/chatkit-server/frontend/src/App.tsx"
click node_chat_server "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-4-agentdeployment/chatkit-server/app.py"
click node_chat_store "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-4-agentdeployment/chatkit-server/store.py"
click node_toolbox_lesson "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-6-toolbox/README.md"
click node_toolbox_agent "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-6-toolbox/toolbox_agent.py"
click node_a2a_lesson "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-7-multi-agent-a2a/README.md"
click node_a2a_client "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-7-multi-agent-a2a/a2a_client.py"
click node_a2a_server "https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-7-multi-agent-a2a/a2a_server.py"

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_design,node_development_lesson,node_evaluation_lesson,node_deployment_lesson,node_production_lesson toneBlue
class node_orchestrator,node_employee_agent,node_learning_agent,node_coding_agent,node_azure_learning,node_task_recommendation,node_vector_setup toneAmber
class node_evaluation_runtime toneMint
class node_deployment_runtime,node_hosted_agent,node_chat_ui,node_chat_server,node_chat_store toneRose
class node_toolbox_lesson,node_toolbox_agent,node_a2a_lesson,node_a2a_client,node_a2a_server,node_learner,node_foundry,node_learn_mcp toneIndigo
```

## Components

### Course Stages

- [Agent Design](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-1-agent-design/README.md): `lesson-1-agent-design/README.md`
- [Agent Development](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-2-agent-development/README.md): `lesson-2-agent-development/README.md`
- [Agent Evaluations](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-3-agent-evals/README.md): `lesson-3-agent-evals/README.md`
- [Agent Deployment](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-4-agentdeployment/README.md): `lesson-4-agentdeployment/README.md`
- [Production Hosting](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-5-hosted-agents-production/README.md): `lesson-5-hosted-agents-production/README.md`

### Agent Development

- [Handoff Orchestrator](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-2-agent-development/agent-orchestration.py): `lesson-2-agent-development/agent-orchestration.py`
- [Employee Search](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-2-agent-development/employee-search-agent.py): `lesson-2-agent-development/employee-search-agent.py`
- [Learning Recommender](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-2-agent-development/learning-recommendation-agent.py): `lesson-2-agent-development/learning-recommendation-agent.py`
- [Coding Assistant](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-2-agent-development/coding-agent.py): `lesson-2-agent-development/coding-agent.py`
- [Azure Learning Agent](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-2-agent-development/azure-learning-agent.py): `lesson-2-agent-development/azure-learning-agent.py`
- [Task Recommender](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-2-agent-development/task-recommendation-agent.py): `lesson-2-agent-development/task-recommendation-agent.py`
- [Vector Store Setup](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-2-agent-development/setup_vector_store.py): `lesson-2-agent-development/setup_vector_store.py`

### Evaluation

- [Workflow Evaluation](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-3-agent-evals/agent-evals.py): `lesson-3-agent-evals/agent-evals.py`

### Deployment

- [Deployment Workflow](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-4-agentdeployment/agent-deployment.py): `lesson-4-agentdeployment/agent-deployment.py`
- [Hosted Onboarding Agent](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-4-agentdeployment/hosted-agent/main.py): `lesson-4-agentdeployment/hosted-agent/main.py`
- [ChatKit Interface](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-4-agentdeployment/chatkit-server/frontend/src/App.tsx): `lesson-4-agentdeployment/chatkit-server/frontend/src/App.tsx`
- [ChatKit Server](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-4-agentdeployment/chatkit-server/app.py): `lesson-4-agentdeployment/chatkit-server/app.py`
- [Conversation Store](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-4-agentdeployment/chatkit-server/store.py): `lesson-4-agentdeployment/chatkit-server/store.py`

### Agent Extensions

- [Toolbox Lesson](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-6-toolbox/README.md): `lesson-6-toolbox/README.md`
- [Toolbox Consumer](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-6-toolbox/toolbox_agent.py): `lesson-6-toolbox/toolbox_agent.py`
- [A2A Lesson](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-7-multi-agent-a2a/README.md): `lesson-7-multi-agent-a2a/README.md`
- [A2A Client](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-7-multi-agent-a2a/a2a_client.py): `lesson-7-multi-agent-a2a/a2a_client.py`
- [A2A Server](https://github.com/microsoft/building-ai-agents-from-zero-to-production/blob/main/lesson-7-multi-agent-a2a/a2a_server.py): `lesson-7-multi-agent-a2a/a2a_server.py`

### Other components

- **Course Learner**
- **Microsoft Foundry**
- **Microsoft Learn MCP**

## Connections

- Course Learner → Agent Design: studies (evidence: `README.md`)
- Agent Design → Agent Development: progresses to (evidence: `README.md`)
- Agent Development → Agent Evaluations: progresses to (evidence: `README.md`)
- Agent Evaluations → Agent Deployment: progresses to (evidence: `README.md`)
- Agent Deployment → Production Hosting: extends into (evidence: `README.md`)
- Agent Development → Handoff Orchestrator: implements
- Handoff Orchestrator → Employee Search: hands off (evidence: `lesson-2-agent-development/agent-orchestration.py`)
- Handoff Orchestrator → Learning Recommender: hands off (evidence: `lesson-2-agent-development/agent-orchestration.py`)
- Handoff Orchestrator → Coding Assistant: hands off (evidence: `lesson-2-agent-development/agent-orchestration.py`)
- Learning Recommender → Coding Assistant: hands off
- Vector Store Setup → Microsoft Foundry: creates vector store
- Agent Evaluations → Workflow Evaluation: demonstrates
- Workflow Evaluation → Microsoft Foundry: evaluates agents (evidence: `lesson-3-agent-evals/agent-evals.py`)
- Agent Deployment → Deployment Workflow: demonstrates
- Deployment Workflow → Hosted Onboarding Agent: deploys
- Hosted Onboarding Agent → Microsoft Foundry: runs on (evidence: `lesson-4-agentdeployment/hosted-agent/main.py`)
- Hosted Onboarding Agent → Microsoft Learn MCP: queries (evidence: `lesson-4-agentdeployment/hosted-agent/main.py`)
- ChatKit Interface → ChatKit Server: posts chat (evidence: `lesson-4-agentdeployment/chatkit-server/frontend/src/App.tsx`)
- ChatKit Server → Conversation Store: persists threads (evidence: `lesson-4-agentdeployment/chatkit-server/app.py`)
- ChatKit Server → Microsoft Foundry: requests agent response (evidence: `lesson-4-agentdeployment/chatkit-server/app.py`)
- Toolbox Lesson → Toolbox Consumer: demonstrates
- Toolbox Consumer → Microsoft Foundry: connects toolbox (evidence: `lesson-6-toolbox/toolbox_agent.py`)
- A2A Lesson → A2A Client: demonstrates
- A2A Lesson → A2A Server: demonstrates
- A2A Client → A2A Server: calls remotely (evidence: `lesson-7-multi-agent-a2a/a2a_client.py`)
