# tonydeb42/agentic-ai-a-beginner-s-handbook architecture

> Architecture diagram of the GitHub repository tonydeb42/agentic-ai-a-beginner-s-handbook, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tonydeb42/agentic-ai-a-beginner-s-handbook
- Repository: https://github.com/tonydeb42/agentic-ai-a-beginner-s-handbook

## Overview

This repository is a notebook-first learning handbook, not a deployable agent application. Its main workflow is for a learner to follow the curriculum, run chapter notebooks, and progress from agent fundamentals through retrieval and safeguards to evaluation and serving. The README documents the chapter capabilities and recommended order; the notebook contents were not provided, so the graph does not infer runtime calls or integrations within them.

Main entry points: [`README.md`](https://github.com/tonydeb42/agentic-ai-a-beginner-s-handbook/blob/main/README.md) (Curriculum guide), [`2. Langraph.ipynb`](https://github.com/tonydeb42/agentic-ai-a-beginner-s-handbook/blob/main/2.%20Langraph.ipynb) (Graphs and MCP), [`3. Vectorless Rag.ipynb`](https://github.com/tonydeb42/agentic-ai-a-beginner-s-handbook/blob/main/3.%20Vectorless%20Rag.ipynb) (Vectorless RAG), [`4. Deepagents.ipynb`](https://github.com/tonydeb42/agentic-ai-a-beginner-s-handbook/blob/main/4.%20Deepagents.ipynb) (Planning and delegation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agent_building["Agent Building"]
  node_langchain["LLM tools and approvals<br/>[1. Langchain.ipynb]"]
  node_langgraph["Graphs and MCP<br/>[2. Langraph.ipynb]"]
end

subgraph group_agent_capabilities["Agent Capabilities"]
  node_rag["Vectorless RAG"]
  node_deepagents["Planning and delegation"]
end

subgraph group_quality_serving["Quality and Serving"]
  node_guardrails["Guardrails and review"]
  node_evaluation["LLM evaluation"]
  node_gateway["Model gateway"]
end

node_learner(("Learner"))
node_handbook["Curriculum guide<br/>[README.md]"]

node_learner -->|"follows curriculum"| node_handbook
node_handbook -->|"links chapter"| node_langchain
node_handbook -->|"links chapter"| node_langgraph
node_handbook -->|"links chapter"| node_rag
node_handbook -->|"links chapter"| node_deepagents
node_handbook -->|"links chapter"| node_guardrails
node_handbook -->|"links chapter"| node_evaluation
node_handbook -->|"links chapter"| node_gateway
node_langchain -->|"study next"| node_langgraph
node_langgraph -->|"study next"| node_rag
node_rag -->|"study next"| node_deepagents
node_deepagents -->|"study next"| node_guardrails
node_guardrails -->|"study next"| node_evaluation
node_evaluation -->|"study next"| node_gateway

click node_handbook "https://github.com/tonydeb42/agentic-ai-a-beginner-s-handbook/blob/main/README.md"
click node_langchain "https://github.com/tonydeb42/agentic-ai-a-beginner-s-handbook/blob/main/1.%20Langchain.ipynb"
click node_langgraph "https://github.com/tonydeb42/agentic-ai-a-beginner-s-handbook/blob/main/2.%20Langraph.ipynb"
click node_rag "https://github.com/tonydeb42/agentic-ai-a-beginner-s-handbook/blob/main/3.%20Vectorless%20Rag.ipynb"
click node_deepagents "https://github.com/tonydeb42/agentic-ai-a-beginner-s-handbook/blob/main/4.%20Deepagents.ipynb"
click node_guardrails "https://github.com/tonydeb42/agentic-ai-a-beginner-s-handbook/blob/main/5.%20Guardrails.ipynb"
click node_evaluation "https://github.com/tonydeb42/agentic-ai-a-beginner-s-handbook/blob/main/6.%20LLM%20Evaluation.ipynb"
click node_gateway "https://github.com/tonydeb42/agentic-ai-a-beginner-s-handbook/blob/main/7.%20LLM%20Gateway.ipynb"

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_langchain,node_langgraph toneBlue
class node_rag,node_deepagents toneAmber
class node_guardrails,node_evaluation,node_gateway toneMint
class node_learner toneIndigo
class node_handbook toneTeal
```

## Components

### Agent Building

- [LLM tools and approvals](https://github.com/tonydeb42/agentic-ai-a-beginner-s-handbook/blob/main/1.%20Langchain.ipynb): `1. Langchain.ipynb`
- [Graphs and MCP](https://github.com/tonydeb42/agentic-ai-a-beginner-s-handbook/blob/main/2.%20Langraph.ipynb): `2. Langraph.ipynb`

### Agent Capabilities

- [Vectorless RAG](https://github.com/tonydeb42/agentic-ai-a-beginner-s-handbook/blob/main/3.%20Vectorless%20Rag.ipynb): `3. Vectorless Rag.ipynb`
- [Planning and delegation](https://github.com/tonydeb42/agentic-ai-a-beginner-s-handbook/blob/main/4.%20Deepagents.ipynb): `4. Deepagents.ipynb`

### Quality and Serving

- [Guardrails and review](https://github.com/tonydeb42/agentic-ai-a-beginner-s-handbook/blob/main/5.%20Guardrails.ipynb): `5. Guardrails.ipynb`
- [LLM evaluation](https://github.com/tonydeb42/agentic-ai-a-beginner-s-handbook/blob/main/6.%20LLM%20Evaluation.ipynb): `6. LLM Evaluation.ipynb`
- [Model gateway](https://github.com/tonydeb42/agentic-ai-a-beginner-s-handbook/blob/main/7.%20LLM%20Gateway.ipynb): `7. LLM Gateway.ipynb`

### Other components

- **Learner**
- [Curriculum guide](https://github.com/tonydeb42/agentic-ai-a-beginner-s-handbook/blob/main/README.md): `README.md`

## Connections

- Learner → Curriculum guide: follows curriculum (evidence: `README.md`)
- Curriculum guide → LLM tools and approvals: links chapter (evidence: `README.md`)
- Curriculum guide → Graphs and MCP: links chapter (evidence: `README.md`)
- Curriculum guide → Vectorless RAG: links chapter (evidence: `README.md`)
- Curriculum guide → Planning and delegation: links chapter (evidence: `README.md`)
- Curriculum guide → Guardrails and review: links chapter (evidence: `README.md`)
- Curriculum guide → LLM evaluation: links chapter (evidence: `README.md`)
- Curriculum guide → Model gateway: links chapter (evidence: `README.md`)
- LLM tools and approvals → Graphs and MCP: study next (evidence: `README.md`)
- Graphs and MCP → Vectorless RAG: study next (evidence: `README.md`)
- Vectorless RAG → Planning and delegation: study next (evidence: `README.md`)
- Planning and delegation → Guardrails and review: study next (evidence: `README.md`)
- Guardrails and review → LLM evaluation: study next (evidence: `README.md`)
- LLM evaluation → Model gateway: study next (evidence: `README.md`)