# jeev1992/supportdesk-rag-workshop architecture

> Architecture diagram of the GitHub repository jeev1992/supportdesk-rag-workshop, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jeev1992/supportdesk-rag-workshop
- Repository: https://github.com/jeev1992/supportdesk-rag-workshop

## Overview

SupportDesk-RAG is a hands-on workshop, not one integrated runtime application: its six independently runnable demos teach a progression from embeddings and document preparation through retrieval, answer generation, evaluation, and tool-using agents. The graph preserves those distinct learning stages and the agent’s demonstrated tool-dispatch layer. README statements establish the workshop capabilities; source excerpts confirm selected implementation details. Other module internals and cross-module data flow were not inspected, so no runtime pipeline between demos is implied.

Main entry points: [`modules/4_rag_pipeline/demo.py`](https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/4_rag_pipeline/demo.py) (RAG pipeline), [`modules/5_evaluation/demo.py`](https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/5_evaluation/demo.py) (RAG evaluation), [`modules/1_embeddings/demo.py`](https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/1_embeddings/demo.py) (Embedding similarity), [`modules/2_chunking/demo.py`](https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/2_chunking/demo.py) (Document chunking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundations["Retrieval Foundations"]
  node_embeddings["Embedding similarity<br/>[demo.py]"]
  node_chunking["Document chunking<br/>[demo.py]"]
  node_indexing["Index strategies<br/>[demo.py]"]
end

subgraph group_rag["RAG Applications"]
  node_ragpipeline["RAG pipeline<br/>[demo.py]"]
  node_retrieval["Ticket retrieval<br/>[demo.py]"]
  node_groundedgeneration["Grounded generation<br/>[demo.py]"]
end

subgraph group_quality["Evaluation and Agents"]
  node_evaluation["RAG evaluation<br/>[demo.py]"]
  node_retrievalmetrics["Retrieval metrics<br/>[demo.py]"]
  node_generationmetrics["Generation metrics<br/>[demo.py]"]
  node_agent["Agentic RAG<br/>[demo.py]"]
  node_dispatch["Tool dispatch<br/>[demo.py]"]
  node_tickettools["Ticket tools<br/>[tools.py]"]
end

node_learner(("Workshop learner"))
node_openai{{"OpenAI APIs"}}

node_learner -->|"runs demo"| node_embeddings
node_learner -->|"runs demo"| node_chunking
node_learner -->|"runs demo"| node_indexing
node_learner -->|"runs demo"| node_ragpipeline
node_learner -->|"runs demo"| node_evaluation
node_learner -->|"runs demo"| node_agent
node_embeddings -->|"requests embeddings"| node_openai
node_chunking -->|"embeds sentences"| node_openai
node_ragpipeline -->|"configures"| node_retrieval
node_ragpipeline -->|"generates answers"| node_groundedgeneration
node_ragpipeline -->|"uses models"| node_openai
node_evaluation -->|"evaluates retrieval"| node_retrievalmetrics
node_evaluation -->|"evaluates answers"| node_generationmetrics
node_evaluation -->|"requests judgments"| node_openai
node_agent -->|"dispatches calls"| node_dispatch
node_dispatch -->|"invokes selected tool"| node_tickettools
node_tickettools -->|"creates embeddings"| node_openai

click node_embeddings "https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/1_embeddings/demo.py"
click node_chunking "https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/2_chunking/demo.py"
click node_indexing "https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/3_indexing/demo.py"
click node_ragpipeline "https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/4_rag_pipeline/demo.py"
click node_retrieval "https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/4_rag_pipeline/demo.py"
click node_groundedgeneration "https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/4_rag_pipeline/demo.py"
click node_evaluation "https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/5_evaluation/demo.py"
click node_retrievalmetrics "https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/5_evaluation/demo.py"
click node_generationmetrics "https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/5_evaluation/demo.py"
click node_agent "https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/6_agentic_rag/demo.py"
click node_dispatch "https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/6_agentic_rag/demo.py"
click node_tickettools "https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/6_agentic_rag/tools.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_embeddings,node_chunking,node_indexing toneBlue
class node_ragpipeline,node_retrieval,node_groundedgeneration toneAmber
class node_evaluation,node_retrievalmetrics,node_generationmetrics,node_agent,node_dispatch,node_tickettools,node_openai toneMint
class node_learner toneIndigo
```

## Components

### Retrieval Foundations

- [Embedding similarity](https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/1_embeddings/demo.py): `modules/1_embeddings/demo.py`
- [Document chunking](https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/2_chunking/demo.py): `modules/2_chunking/demo.py`
- [Index strategies](https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/3_indexing/demo.py): `modules/3_indexing/demo.py`

### RAG Applications

- [RAG pipeline](https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/4_rag_pipeline/demo.py): `modules/4_rag_pipeline/demo.py`
- [Ticket retrieval](https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/4_rag_pipeline/demo.py): `modules/4_rag_pipeline/demo.py`
- [Grounded generation](https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/4_rag_pipeline/demo.py): `modules/4_rag_pipeline/demo.py`

### Evaluation and Agents

- [RAG evaluation](https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/5_evaluation/demo.py): `modules/5_evaluation/demo.py`
- [Retrieval metrics](https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/5_evaluation/demo.py): `modules/5_evaluation/demo.py`
- [Generation metrics](https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/5_evaluation/demo.py): `modules/5_evaluation/demo.py`
- [Agentic RAG](https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/6_agentic_rag/demo.py): `modules/6_agentic_rag/demo.py`
- [Tool dispatch](https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/6_agentic_rag/demo.py): `modules/6_agentic_rag/demo.py`
- [Ticket tools](https://github.com/jeev1992/supportdesk-rag-workshop/blob/master/modules/6_agentic_rag/tools.py): `modules/6_agentic_rag/tools.py`

### Other components

- **Workshop learner**
- **OpenAI APIs**

## Connections

- Workshop learner → Embedding similarity: runs demo (evidence: `README.md`)
- Workshop learner → Document chunking: runs demo (evidence: `README.md`)
- Workshop learner → Index strategies: runs demo (evidence: `README.md`)
- Workshop learner → RAG pipeline: runs demo (evidence: `README.md`)
- Workshop learner → RAG evaluation: runs demo (evidence: `README.md`)
- Workshop learner → Agentic RAG: runs demo (evidence: `README.md`)
- Embedding similarity → OpenAI APIs: requests embeddings (evidence: `modules/1_embeddings/demo.py`)
- Document chunking → OpenAI APIs: embeds sentences (evidence: `modules/2_chunking/demo.py`)
- RAG pipeline → Ticket retrieval: configures (evidence: `modules/4_rag_pipeline/demo.py`)
- RAG pipeline → Grounded generation: generates answers (evidence: `modules/4_rag_pipeline/demo.py`)
- RAG pipeline → OpenAI APIs: uses models (evidence: `modules/4_rag_pipeline/demo.py`)
- RAG evaluation → Retrieval metrics: evaluates retrieval (evidence: `modules/5_evaluation/demo.py`)
- RAG evaluation → Generation metrics: evaluates answers (evidence: `modules/5_evaluation/demo.py`)
- RAG evaluation → OpenAI APIs: requests judgments (evidence: `modules/5_evaluation/demo.py`)
- Agentic RAG → Tool dispatch: dispatches calls (evidence: `modules/6_agentic_rag/demo.py`)
- Tool dispatch → Ticket tools: invokes selected tool (evidence: `modules/6_agentic_rag/demo.py`)
- Ticket tools → OpenAI APIs: creates embeddings (evidence: `modules/6_agentic_rag/tools.py`)
