# microsoft/langchain-for-beginners architecture

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

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

## Overview

This repository is a hands-on LangChain course, not a single application. Its principal learner journey moves from model interactions and prompts through tools and agents, then document retrieval and agentic RAG, ending with a Microsoft Foundry hosted-agent example. The README documents that progression and the major capabilities; sampled code confirms examples such as tool-using agents, vector-store search, conversational RAG, and hosting. Many chapter examples were not sampled, so chapter-level nodes represent documented capabilities without asserting unverified internal calls.

Main entry points: [`06-mcp`](https://github.com/microsoft/langchain-for-beginners/tree/main/06-mcp) (MCP Integration), [`07-documents-embeddings-semantic-search`](https://github.com/microsoft/langchain-for-beginners/tree/main/07-documents-embeddings-semantic-search) (Document Processing), [`08-agentic-rag-systems/code/02_agentic_rag.py`](https://github.com/microsoft/langchain-for-beginners/blob/main/08-agentic-rag-systems/code/02_agentic_rag.py) (Agentic RAG), [`04-function-calling-tools`](https://github.com/microsoft/langchain-for-beginners/tree/main/04-function-calling-tools) (Function Tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundations["Model Foundations"]
  node_intro["LangChain Basics"]
  node_chat["Chat Models"]
end

subgraph group_interaction["Prompts and Tools"]
  node_prompts["Prompts and Outputs"]
  node_tools["Function Tools"]
  node_travel["Travel Assistant"]
end

subgraph group_agents["Agents and MCP"]
  node_agents["Agent Patterns"]
  node_research["Research Agent<br/>[research_agent.py]"]
  node_mcp["MCP Integration"]
  node_context7["Context7 Example<br/>[context7_basic.py]"]
  node_mcp_errors["MCP Error Handling"]
end

subgraph group_retrieval["Search and RAG"]
  node_documents["Document Processing"]
  node_embeddings["Embedding Concepts"]
  node_book_search["Semantic Book Search<br/>[book_search.py]"]
  node_rag_intro["RAG Decisions"]
  node_traditional_rag["Traditional RAG"]
  node_agentic_rag["Agentic RAG<br/>[02_agentic_rag.py]"]
  node_knowledge_rag["Knowledge Base Q&amp;A"]
  node_conversational_rag["Conversational RAG"]
end

subgraph group_hosting["Hosted Deployment"]
  node_deployment["Foundry Hosted Agent<br/>[main.py]"]
end

node_learner(("Learner"))
node_foundry["Microsoft Foundry"]

node_learner -->|"starts with"| node_intro
node_intro -->|"continues to"| node_chat
node_chat -->|"continues to"| node_prompts
node_prompts -->|"continues to"| node_tools
node_tools -->|"precedes"| node_agents
node_tools -->|"includes solution"| node_travel
node_agents -->|"includes solution"| node_research
node_agents -->|"continues to"| node_mcp
node_mcp -->|"includes solution"| node_context7
node_mcp -->|"covers errors"| node_mcp_errors
node_mcp -->|"precedes"| node_documents
node_documents -->|"explores"| node_embeddings
node_documents -->|"includes solution"| node_book_search
node_documents -->|"supports retrieval"| node_rag_intro
node_rag_intro -->|"compares with"| node_traditional_rag
node_rag_intro -->|"introduces"| node_agentic_rag
node_agentic_rag -->|"includes solution"| node_knowledge_rag
node_agentic_rag -->|"extends to conversation"| node_conversational_rag
node_agentic_rag -->|"precedes deployment"| node_deployment
node_deployment -->|"hosts agent on"| node_foundry

click node_intro "https://github.com/microsoft/langchain-for-beginners/tree/main/01-introduction"
click node_chat "https://github.com/microsoft/langchain-for-beginners/tree/main/02-chat-models"
click node_prompts "https://github.com/microsoft/langchain-for-beginners/tree/main/03-prompts-messages-outputs"
click node_tools "https://github.com/microsoft/langchain-for-beginners/tree/main/04-function-calling-tools"
click node_travel "https://github.com/microsoft/langchain-for-beginners/blob/main/04-function-calling-tools/solution/travel_assistant.py"
click node_agents "https://github.com/microsoft/langchain-for-beginners/tree/main/05-agents"
click node_research "https://github.com/microsoft/langchain-for-beginners/blob/main/05-agents/solution/research_agent.py"
click node_mcp "https://github.com/microsoft/langchain-for-beginners/tree/main/06-mcp"
click node_context7 "https://github.com/microsoft/langchain-for-beginners/blob/main/06-mcp/solution/context7_basic.py"
click node_mcp_errors "https://github.com/microsoft/langchain-for-beginners/blob/main/06-mcp/code/04_mcp_error_handling.py"
click node_documents "https://github.com/microsoft/langchain-for-beginners/tree/main/07-documents-embeddings-semantic-search"
click node_embeddings "https://github.com/microsoft/langchain-for-beginners/blob/main/07-documents-embeddings-semantic-search/code/09_embedding_relationships.py"
click node_book_search "https://github.com/microsoft/langchain-for-beginners/blob/main/07-documents-embeddings-semantic-search/solution/book_search.py"
click node_rag_intro "https://github.com/microsoft/langchain-for-beginners/blob/main/08-agentic-rag-systems/code/01_when_to_use_rag.py"
click node_traditional_rag "https://github.com/microsoft/langchain-for-beginners/blob/main/08-agentic-rag-systems/code/01a_traditional_rag.py"
click node_agentic_rag "https://github.com/microsoft/langchain-for-beginners/blob/main/08-agentic-rag-systems/code/02_agentic_rag.py"
click node_knowledge_rag "https://github.com/microsoft/langchain-for-beginners/blob/main/08-agentic-rag-systems/solution/knowledge_base_rag.py"
click node_conversational_rag "https://github.com/microsoft/langchain-for-beginners/blob/main/08-agentic-rag-systems/solution/conversational_rag.py"
click node_deployment "https://github.com/microsoft/langchain-for-beginners/blob/main/09-deploy-to-microsoft-foundry/code/main.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_intro,node_chat toneBlue
class node_prompts,node_tools,node_travel toneAmber
class node_agents,node_research,node_mcp,node_context7,node_mcp_errors toneMint
class node_documents,node_embeddings,node_book_search,node_rag_intro,node_traditional_rag,node_agentic_rag,node_knowledge_rag,node_conversational_rag toneRose
class node_deployment,node_learner,node_foundry toneIndigo
```

## Components

### Model Foundations

- [LangChain Basics](https://github.com/microsoft/langchain-for-beginners/tree/main/01-introduction): `01-introduction`
- [Chat Models](https://github.com/microsoft/langchain-for-beginners/tree/main/02-chat-models): `02-chat-models`

### Prompts and Tools

- [Prompts and Outputs](https://github.com/microsoft/langchain-for-beginners/tree/main/03-prompts-messages-outputs): `03-prompts-messages-outputs`
- [Function Tools](https://github.com/microsoft/langchain-for-beginners/tree/main/04-function-calling-tools): `04-function-calling-tools`
- [Travel Assistant](https://github.com/microsoft/langchain-for-beginners/blob/main/04-function-calling-tools/solution/travel_assistant.py): `04-function-calling-tools/solution/travel_assistant.py`

### Agents and MCP

- [Agent Patterns](https://github.com/microsoft/langchain-for-beginners/tree/main/05-agents): `05-agents`
- [Research Agent](https://github.com/microsoft/langchain-for-beginners/blob/main/05-agents/solution/research_agent.py): `05-agents/solution/research_agent.py`
- [MCP Integration](https://github.com/microsoft/langchain-for-beginners/tree/main/06-mcp): `06-mcp`
- [Context7 Example](https://github.com/microsoft/langchain-for-beginners/blob/main/06-mcp/solution/context7_basic.py): `06-mcp/solution/context7_basic.py`
- [MCP Error Handling](https://github.com/microsoft/langchain-for-beginners/blob/main/06-mcp/code/04_mcp_error_handling.py): `06-mcp/code/04_mcp_error_handling.py`

### Search and RAG

- [Document Processing](https://github.com/microsoft/langchain-for-beginners/tree/main/07-documents-embeddings-semantic-search): `07-documents-embeddings-semantic-search`
- [Embedding Concepts](https://github.com/microsoft/langchain-for-beginners/blob/main/07-documents-embeddings-semantic-search/code/09_embedding_relationships.py): `07-documents-embeddings-semantic-search/code/09_embedding_relationships.py`
- [Semantic Book Search](https://github.com/microsoft/langchain-for-beginners/blob/main/07-documents-embeddings-semantic-search/solution/book_search.py): `07-documents-embeddings-semantic-search/solution/book_search.py`
- [RAG Decisions](https://github.com/microsoft/langchain-for-beginners/blob/main/08-agentic-rag-systems/code/01_when_to_use_rag.py): `08-agentic-rag-systems/code/01_when_to_use_rag.py`
- [Traditional RAG](https://github.com/microsoft/langchain-for-beginners/blob/main/08-agentic-rag-systems/code/01a_traditional_rag.py): `08-agentic-rag-systems/code/01a_traditional_rag.py`
- [Agentic RAG](https://github.com/microsoft/langchain-for-beginners/blob/main/08-agentic-rag-systems/code/02_agentic_rag.py): `08-agentic-rag-systems/code/02_agentic_rag.py`
- [Knowledge Base Q&A](https://github.com/microsoft/langchain-for-beginners/blob/main/08-agentic-rag-systems/solution/knowledge_base_rag.py): `08-agentic-rag-systems/solution/knowledge_base_rag.py`
- [Conversational RAG](https://github.com/microsoft/langchain-for-beginners/blob/main/08-agentic-rag-systems/solution/conversational_rag.py): `08-agentic-rag-systems/solution/conversational_rag.py`

### Hosted Deployment

- [Foundry Hosted Agent](https://github.com/microsoft/langchain-for-beginners/blob/main/09-deploy-to-microsoft-foundry/code/main.py): `09-deploy-to-microsoft-foundry/code/main.py`

### Other components

- **Learner**
- **Microsoft Foundry**

## Connections

- Learner → LangChain Basics: starts with (evidence: `README.md`)
- LangChain Basics → Chat Models: continues to (evidence: `README.md`)
- Chat Models → Prompts and Outputs: continues to (evidence: `README.md`)
- Prompts and Outputs → Function Tools: continues to (evidence: `README.md`)
- Function Tools → Agent Patterns: precedes (evidence: `README.md`)
- Function Tools → Travel Assistant: includes solution (evidence: `README.md`)
- Agent Patterns → Research Agent: includes solution (evidence: `README.md`)
- Agent Patterns → MCP Integration: continues to (evidence: `README.md`)
- MCP Integration → Context7 Example: includes solution (evidence: `06-mcp/solution/context7_basic.py`)
- MCP Integration → MCP Error Handling: covers errors (evidence: `README.md`)
- MCP Integration → Document Processing: precedes (evidence: `README.md`)
- Document Processing → Embedding Concepts: explores (evidence: `README.md`)
- Document Processing → Semantic Book Search: includes solution (evidence: `07-documents-embeddings-semantic-search/solution/book_search.py`)
- Document Processing → RAG Decisions: supports retrieval (evidence: `README.md`)
- RAG Decisions → Traditional RAG: compares with (evidence: `08-agentic-rag-systems/code/01a_traditional_rag.py`)
- RAG Decisions → Agentic RAG: introduces (evidence: `README.md`)
- Agentic RAG → Knowledge Base Q&A: includes solution (evidence: `README.md`)
- Agentic RAG → Conversational RAG: extends to conversation (evidence: `08-agentic-rag-systems/solution/conversational_rag.py`)
- Agentic RAG → Foundry Hosted Agent: precedes deployment (evidence: `README.md`)
- Foundry Hosted Agent → Microsoft Foundry: hosts agent on (evidence: `09-deploy-to-microsoft-foundry/code/main.py`)
