# harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni architecture

> Architecture diagram of the GitHub repository harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni
- Repository: https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni

## Overview

This repository is a code companion to a sixteen-chapter handbook, not one deployed application. Its product workflow is for a reader to explore runnable examples that progress from AI and prompt foundations through retrieval, agents, and operational deployment. The graph preserves the major documented branches; arrows are limited to relationships visible in the README or sampled source. Many chapter examples were not sampled, so their internal calls and connections are left unspecified.

Main entry points: [`chapter_03/01_the_six_stage_ingestion_pipeline.py`](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_03/01_the_six_stage_ingestion_pipeline.py) (Vector Knowledge Base), [`chapter_10/01_the_ai_health_copilot.py`](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_10/01_the_ai_health_copilot.py) (Health Copilot), [`chapter_12/02_wrapping_the_chapter_10_model_as_a_real_fastapi_service.py`](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_12/02_wrapping_the_chapter_10_model_as_a_real_fastapi_service.py) (Prediction API), [`chapter_03/02_a_fifteen_line_rag_agent.py`](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_03/02_a_fifteen_line_rag_agent.py) (RAG Agent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_retrieval["Retrieval Systems"]
  node_ingestion["Document Ingestion"]
  node_vectorstore[("Vector Knowledge Base")]
  node_rag_agent["RAG Agent"]
  node_hybrid_search["Hybrid Retrieval"]
  node_retrieval_eval["Retrieval Evaluation"]
end

subgraph group_agents["Agents and Reasoning"]
  node_sql_tool["Natural Language SQL"]
  node_investment_agent["Investment Agent"]
  node_n8n_workflow["n8n Automation"]
  node_supervisor_team["Specialist Supervisor"]
  node_human_checkpoint["Human Checkpoint"]
  node_vision_agent["Vision Agent"]
end

subgraph group_mlops["ML and Operations"]
  node_health_copilot["Health Copilot"]
  node_qlora["QLoRA Fine-Tuning"]
  node_fastapi_service["Prediction API"]
  node_deployment["Multi-Service Deployment"]
  node_security["Request Security"]
  node_explainability["SHAP Explainability"]
  node_operations["ITDO Operations"]
end

subgraph group_learning["Foundations and Cases"]
  node_foundations["AI Foundations"]
  node_prompting["Prompt Engineering"]
  node_capstone["Capstone Evaluation"]
  node_field_cases["Field Case Patterns"]
end

node_reader(("Handbook Reader"))

node_reader -->|"explores examples"| node_foundations
node_reader -->|"explores examples"| node_prompting
node_reader -->|"explores examples"| node_ingestion
node_reader -->|"explores examples"| node_health_copilot
node_reader -->|"explores examples"| node_field_cases
node_ingestion -->|"adds chunks"| node_vectorstore
node_ingestion -->|"queries chunks"| node_vectorstore
node_rag_agent -->|"uses knowledge base"| node_vectorstore
node_hybrid_search -->|"retrieves chunks"| node_vectorstore
node_retrieval_eval -->|"queries collection"| node_vectorstore
node_health_copilot -->|"serves predictions"| node_fastapi_service
node_fastapi_service -->|"hardens endpoint"| node_security
node_health_copilot -->|"extends prediction workflow"| node_operations

click node_foundations "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_01/01_tracing_the_perceive.py"
click node_prompting "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_02/01_measuring_the_ladder_s_first_three_rungs_on_one_real_questio.py"
click node_ingestion "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_03/01_the_six_stage_ingestion_pipeline.py"
click node_vectorstore "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_03/01_the_six_stage_ingestion_pipeline.py"
click node_rag_agent "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_03/02_a_fifteen_line_rag_agent.py"
click node_hybrid_search "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_04/01_hybrid_search.py"
click node_retrieval_eval "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_04/02_a_retrieval_evaluation_harness.py"
click node_sql_tool "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_05/01_a_natural_language_to_sql_tool.py"
click node_investment_agent "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_06/01_a_multi_tool_investment_analyst.py"
click node_n8n_workflow "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_07/01_reading_a_real_n8n_workflow_s_exported_json.py"
click node_supervisor_team "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_08/01_a_three_specialist_supervisor_team.py"
click node_human_checkpoint "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_09/01_adding_a_human_checkpoint_to_a_real_sequential_pipeline.py"
click node_health_copilot "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_10/01_the_ai_health_copilot.py"
click node_vision_agent "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_11/01_a_vision_agent.py"
click node_qlora "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_11/02_qlora_fine_tuning.py"
click node_fastapi_service "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_12/02_wrapping_the_chapter_10_model_as_a_real_fastapi_service.py"
click node_deployment "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_12/01_a_real_multi_service_docker_compose_file.py"
click node_security "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_13/01_hardening_the_chapter_12_deployment_with_rate_limiting_and_i.py"
click node_explainability "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_14/01_real_shap_values.py"
click node_operations "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_14/02_bolting_an_operation_layer_onto_the_chapter_10_health_copilo.py"
click node_capstone "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_15/01b_evaluation_harness_go_no_go.py"
click node_field_cases "https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/tree/main/chapter_16"

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_ingestion,node_vectorstore,node_rag_agent,node_hybrid_search,node_retrieval_eval toneBlue
class node_sql_tool,node_investment_agent,node_n8n_workflow,node_supervisor_team,node_human_checkpoint,node_vision_agent toneAmber
class node_health_copilot,node_qlora,node_fastapi_service,node_deployment,node_security,node_explainability,node_operations toneMint
class node_foundations,node_prompting,node_capstone,node_field_cases toneRose
class node_reader toneIndigo
```

## Components

### Retrieval Systems

- [Document Ingestion](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_03/01_the_six_stage_ingestion_pipeline.py): `chapter_03/01_the_six_stage_ingestion_pipeline.py`
- [Vector Knowledge Base](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_03/01_the_six_stage_ingestion_pipeline.py): `chapter_03/01_the_six_stage_ingestion_pipeline.py`
- [RAG Agent](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_03/02_a_fifteen_line_rag_agent.py): `chapter_03/02_a_fifteen_line_rag_agent.py`
- [Hybrid Retrieval](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_04/01_hybrid_search.py): `chapter_04/01_hybrid_search.py`
- [Retrieval Evaluation](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_04/02_a_retrieval_evaluation_harness.py): `chapter_04/02_a_retrieval_evaluation_harness.py`

### Agents and Reasoning

- [Natural Language SQL](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_05/01_a_natural_language_to_sql_tool.py): `chapter_05/01_a_natural_language_to_sql_tool.py`
- [Investment Agent](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_06/01_a_multi_tool_investment_analyst.py): `chapter_06/01_a_multi_tool_investment_analyst.py`
- [n8n Automation](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_07/01_reading_a_real_n8n_workflow_s_exported_json.py): `chapter_07/01_reading_a_real_n8n_workflow_s_exported_json.py`
- [Specialist Supervisor](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_08/01_a_three_specialist_supervisor_team.py): `chapter_08/01_a_three_specialist_supervisor_team.py`
- [Human Checkpoint](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_09/01_adding_a_human_checkpoint_to_a_real_sequential_pipeline.py): `chapter_09/01_adding_a_human_checkpoint_to_a_real_sequential_pipeline.py`
- [Vision Agent](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_11/01_a_vision_agent.py): `chapter_11/01_a_vision_agent.py`

### ML and Operations

- [Health Copilot](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_10/01_the_ai_health_copilot.py): `chapter_10/01_the_ai_health_copilot.py`
- [QLoRA Fine-Tuning](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_11/02_qlora_fine_tuning.py): `chapter_11/02_qlora_fine_tuning.py`
- [Prediction API](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_12/02_wrapping_the_chapter_10_model_as_a_real_fastapi_service.py): `chapter_12/02_wrapping_the_chapter_10_model_as_a_real_fastapi_service.py`
- [Multi-Service Deployment](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_12/01_a_real_multi_service_docker_compose_file.py): `chapter_12/01_a_real_multi_service_docker_compose_file.py`
- [Request Security](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_13/01_hardening_the_chapter_12_deployment_with_rate_limiting_and_i.py): `chapter_13/01_hardening_the_chapter_12_deployment_with_rate_limiting_and_i.py`
- [SHAP Explainability](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_14/01_real_shap_values.py): `chapter_14/01_real_shap_values.py`
- [ITDO Operations](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_14/02_bolting_an_operation_layer_onto_the_chapter_10_health_copilo.py): `chapter_14/02_bolting_an_operation_layer_onto_the_chapter_10_health_copilo.py`

### Foundations and Cases

- [AI Foundations](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_01/01_tracing_the_perceive.py): `chapter_01/01_tracing_the_perceive.py`
- [Prompt Engineering](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_02/01_measuring_the_ladder_s_first_three_rungs_on_one_real_questio.py): `chapter_02/01_measuring_the_ladder_s_first_three_rungs_on_one_real_questio.py`
- [Capstone Evaluation](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/blob/main/chapter_15/01b_evaluation_harness_go_no_go.py): `chapter_15/01b_evaluation_harness_go_no_go.py`
- [Field Case Patterns](https://github.com/harrypatria/agentic-ai-masterclass-handbook-usecases-convergeni/tree/main/chapter_16): `chapter_16`

### Other components

- **Handbook Reader**

## Connections

- Handbook Reader → AI Foundations: explores examples (evidence: `README.md`)
- Handbook Reader → Prompt Engineering: explores examples (evidence: `README.md`)
- Handbook Reader → Document Ingestion: explores examples (evidence: `README.md`)
- Handbook Reader → Health Copilot: explores examples (evidence: `README.md`)
- Handbook Reader → Field Case Patterns: explores examples (evidence: `README.md`)
- Document Ingestion → Vector Knowledge Base: adds chunks (evidence: `chapter_03/01_the_six_stage_ingestion_pipeline.py`)
- Document Ingestion → Vector Knowledge Base: queries chunks (evidence: `chapter_03/01_the_six_stage_ingestion_pipeline.py`)
- RAG Agent → Vector Knowledge Base: uses knowledge base (evidence: `chapter_03/02_a_fifteen_line_rag_agent.py`)
- Hybrid Retrieval → Vector Knowledge Base: retrieves chunks (evidence: `chapter_04/01_hybrid_search.py`)
- Retrieval Evaluation → Vector Knowledge Base: queries collection (evidence: `chapter_04/02_a_retrieval_evaluation_harness.py`)
- Health Copilot → Prediction API: serves predictions (evidence: `chapter_12/02_wrapping_the_chapter_10_model_as_a_real_fastapi_service.py`)
- Prediction API → Request Security: hardens endpoint (evidence: `chapter_12/02_wrapping_the_chapter_10_model_as_a_real_fastapi_service.py`)
- Health Copilot → ITDO Operations: extends prediction workflow (evidence: `chapter_14/02_bolting_an_operation_layer_onto_the_chapter_10_health_copilo.py`)