# coleam00/ai-agents-masterclass architecture

> Architecture diagram of the GitHub repository coleam00/ai-agents-masterclass, 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/coleam00/ai-agents-masterclass
- Repository: https://github.com/coleam00/ai-agents-masterclass

## Overview

This repository is a collection of independent AI-agent tutorials and supplemental projects, not one integrated application. A representative user-to-result workflow is a chat interface passing messages to an agent, which may invoke tools and return a response; the clearest sampled orchestration is the LangGraph task agent. Other branches demonstrate RAG, workflow integrations, model evaluation, and a GoHighLevel SaaS backend. Edges are limited to relationships visible in excerpts, the SOURCE INDEX, or the README; unsampled examples are shown as components without inferred wiring.

Main entry points: [`llm-agent-evaluation-framework/runnable.py`](https://github.com/coleam00/ai-agents-masterclass/blob/main/llm-agent-evaluation-framework/runnable.py) (Agent evaluation), [`10-deploy-ai-agent-langserve/tools/asana_tools.py`](https://github.com/coleam00/ai-agents-masterclass/blob/main/10-deploy-ai-agent-langserve/tools/asana_tools.py) (Asana tools), [`gohighlevel-saas-backend/functions/src/ghl_conversation_langchain.js`](https://github.com/coleam00/ai-agents-masterclass/blob/main/gohighlevel-saas-backend/functions/src/ghl_conversation_langchain.js) (Conversation backend), [`7-langgraph-agent/runnable.py`](https://github.com/coleam00/ai-agents-masterclass/blob/main/7-langgraph-agent/runnable.py) (LangGraph agent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agent_demos["Agent demos"]
  node_langgraph_agent["LangGraph agent<br/>[runnable.py]"]
  node_first_agent["First agent<br/>[agents.py]"]
  node_langchain_agent["LangChain agent<br/>[langchain-agent.py]"]
  node_agent_ui["Agent UI<br/>[agent-with-ui.py]"]
  node_task_agent["Task management"]
end

subgraph group_rag["RAG examples"]
  node_rag_agent["Local RAG<br/>[local-rag-agent.py]"]
  node_rag_loader["Document loader"]
  node_rag_task_agent["RAG task agent<br/>[rag-task-agent.py]"]
  node_korvus_rag["Korvus RAG<br/>[korvus_rag.py]"]
end

subgraph group_integrations["Tool integrations"]
  node_langgraph_tools["Asana tools<br/>[tools.py]"]
  node_asana_tools["Asana tools<br/>[asana_tools.py]"]
  node_drive_tools["Drive tools"]
  node_vector_tools["Vector DB tools<br/>[vector_db_tools.py]"]
end

subgraph group_platforms["Deployment and SaaS"]
  node_langserve_runtime["LangServe runtime<br/>[runnable.py]"]
  node_evaluation["Agent evaluation<br/>[runnable.py]"]
  node_evaluation_ui["Evaluation chat UI"]
  node_ghl_conversation["Conversation backend"]
  node_ghl_helpers["Backend helpers<br/>[helpers.js]"]
  node_textualy_graph["Textualy graph<br/>[textualy_graph.js]"]
end

node_user(("User"))
node_asana["Asana"]

node_user -.->|"sends messages"| node_langgraph_agent
node_langgraph_agent -->|"dispatches calls"| node_langgraph_tools
node_langgraph_tools -->|"calls API"| node_asana
node_langserve_runtime -->|"imports tools"| node_asana_tools
node_asana_tools -->|"calls API"| node_asana
node_evaluation_ui -->|"gets runnable"| node_evaluation
node_evaluation -->|"imports tools"| node_asana_tools
node_evaluation -->|"imports tools"| node_drive_tools
node_evaluation -->|"imports tools"| node_vector_tools
node_ghl_conversation -->|"uses helpers"| node_ghl_helpers
node_ghl_conversation -->|"uses graph"| node_textualy_graph

click node_langgraph_agent "https://github.com/coleam00/ai-agents-masterclass/blob/main/7-langgraph-agent/runnable.py"
click node_langgraph_tools "https://github.com/coleam00/ai-agents-masterclass/blob/main/7-langgraph-agent/tools.py"
click node_first_agent "https://github.com/coleam00/ai-agents-masterclass/blob/main/1-first-agent/agents.py"
click node_langchain_agent "https://github.com/coleam00/ai-agents-masterclass/blob/main/2-langchain-agent/langchain-agent.py"
click node_agent_ui "https://github.com/coleam00/ai-agents-masterclass/blob/main/3-agent-ui/agent-with-ui.py"
click node_task_agent "https://github.com/coleam00/ai-agents-masterclass/blob/main/4-task-management-agent/task-management-agent.py"
click node_rag_agent "https://github.com/coleam00/ai-agents-masterclass/blob/main/5-rag-agent/local-rag-agent.py"
click node_rag_loader "https://github.com/coleam00/ai-agents-masterclass/blob/main/6-rag-task-agent/rag-document-loader.py"
click node_rag_task_agent "https://github.com/coleam00/ai-agents-masterclass/blob/main/6-rag-task-agent/rag-task-agent.py"
click node_korvus_rag "https://github.com/coleam00/ai-agents-masterclass/blob/main/korvus-simple-rag/korvus_rag.py"
click node_langserve_runtime "https://github.com/coleam00/ai-agents-masterclass/blob/main/10-deploy-ai-agent-langserve/runnable.py"
click node_asana_tools "https://github.com/coleam00/ai-agents-masterclass/blob/main/10-deploy-ai-agent-langserve/tools/asana_tools.py"
click node_drive_tools "https://github.com/coleam00/ai-agents-masterclass/blob/main/10-deploy-ai-agent-langserve/tools/google_drive_tools.py"
click node_vector_tools "https://github.com/coleam00/ai-agents-masterclass/blob/main/10-deploy-ai-agent-langserve/tools/vector_db_tools.py"
click node_evaluation "https://github.com/coleam00/ai-agents-masterclass/blob/main/llm-agent-evaluation-framework/runnable.py"
click node_evaluation_ui "https://github.com/coleam00/ai-agents-masterclass/blob/main/llm-agent-evaluation-framework/llm-eval-chatbot.py"
click node_ghl_conversation "https://github.com/coleam00/ai-agents-masterclass/blob/main/gohighlevel-saas-backend/functions/src/ghl_conversation_langchain.js"
click node_ghl_helpers "https://github.com/coleam00/ai-agents-masterclass/blob/main/gohighlevel-saas-backend/functions/src/helpers.js"
click node_textualy_graph "https://github.com/coleam00/ai-agents-masterclass/blob/main/gohighlevel-saas-backend/functions/src/textualy_graph.js"

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_langgraph_agent,node_first_agent,node_langchain_agent,node_agent_ui,node_task_agent,node_user toneBlue
class node_rag_agent,node_rag_loader,node_rag_task_agent,node_korvus_rag toneAmber
class node_langgraph_tools,node_asana_tools,node_drive_tools,node_vector_tools toneMint
class node_langserve_runtime,node_evaluation,node_evaluation_ui,node_ghl_conversation,node_ghl_helpers,node_textualy_graph toneRose
class node_asana toneIndigo
```

## Components

### Agent demos

- [LangGraph agent](https://github.com/coleam00/ai-agents-masterclass/blob/main/7-langgraph-agent/runnable.py): `7-langgraph-agent/runnable.py`
- [First agent](https://github.com/coleam00/ai-agents-masterclass/blob/main/1-first-agent/agents.py): `1-first-agent/agents.py`
- [LangChain agent](https://github.com/coleam00/ai-agents-masterclass/blob/main/2-langchain-agent/langchain-agent.py): `2-langchain-agent/langchain-agent.py`
- [Agent UI](https://github.com/coleam00/ai-agents-masterclass/blob/main/3-agent-ui/agent-with-ui.py): `3-agent-ui/agent-with-ui.py`
- [Task management](https://github.com/coleam00/ai-agents-masterclass/blob/main/4-task-management-agent/task-management-agent.py): `4-task-management-agent/task-management-agent.py`

### RAG examples

- [Local RAG](https://github.com/coleam00/ai-agents-masterclass/blob/main/5-rag-agent/local-rag-agent.py): `5-rag-agent/local-rag-agent.py`
- [Document loader](https://github.com/coleam00/ai-agents-masterclass/blob/main/6-rag-task-agent/rag-document-loader.py): `6-rag-task-agent/rag-document-loader.py`
- [RAG task agent](https://github.com/coleam00/ai-agents-masterclass/blob/main/6-rag-task-agent/rag-task-agent.py): `6-rag-task-agent/rag-task-agent.py`
- [Korvus RAG](https://github.com/coleam00/ai-agents-masterclass/blob/main/korvus-simple-rag/korvus_rag.py): `korvus-simple-rag/korvus_rag.py`

### Tool integrations

- [Asana tools](https://github.com/coleam00/ai-agents-masterclass/blob/main/7-langgraph-agent/tools.py): `7-langgraph-agent/tools.py`
- [Asana tools](https://github.com/coleam00/ai-agents-masterclass/blob/main/10-deploy-ai-agent-langserve/tools/asana_tools.py): `10-deploy-ai-agent-langserve/tools/asana_tools.py`
- [Drive tools](https://github.com/coleam00/ai-agents-masterclass/blob/main/10-deploy-ai-agent-langserve/tools/google_drive_tools.py): `10-deploy-ai-agent-langserve/tools/google_drive_tools.py`
- [Vector DB tools](https://github.com/coleam00/ai-agents-masterclass/blob/main/10-deploy-ai-agent-langserve/tools/vector_db_tools.py): `10-deploy-ai-agent-langserve/tools/vector_db_tools.py`

### Deployment and SaaS

- [LangServe runtime](https://github.com/coleam00/ai-agents-masterclass/blob/main/10-deploy-ai-agent-langserve/runnable.py): `10-deploy-ai-agent-langserve/runnable.py`
- [Agent evaluation](https://github.com/coleam00/ai-agents-masterclass/blob/main/llm-agent-evaluation-framework/runnable.py): `llm-agent-evaluation-framework/runnable.py`
- [Evaluation chat UI](https://github.com/coleam00/ai-agents-masterclass/blob/main/llm-agent-evaluation-framework/llm-eval-chatbot.py): `llm-agent-evaluation-framework/llm-eval-chatbot.py`
- [Conversation backend](https://github.com/coleam00/ai-agents-masterclass/blob/main/gohighlevel-saas-backend/functions/src/ghl_conversation_langchain.js): `gohighlevel-saas-backend/functions/src/ghl_conversation_langchain.js`
- [Backend helpers](https://github.com/coleam00/ai-agents-masterclass/blob/main/gohighlevel-saas-backend/functions/src/helpers.js): `gohighlevel-saas-backend/functions/src/helpers.js`
- [Textualy graph](https://github.com/coleam00/ai-agents-masterclass/blob/main/gohighlevel-saas-backend/functions/src/textualy_graph.js): `gohighlevel-saas-backend/functions/src/textualy_graph.js`

### Other components

- **User**
- **Asana**

## Connections

- User → LangGraph agent: sends messages
- LangGraph agent → Asana tools: dispatches calls (evidence: `7-langgraph-agent/runnable.py`)
- Asana tools → Asana: calls API (evidence: `7-langgraph-agent/tools.py`)
- LangServe runtime → Asana tools: imports tools (evidence: `10-deploy-ai-agent-langserve/runnable.py`)
- Asana tools → Asana: calls API (evidence: `10-deploy-ai-agent-langserve/tools/asana_tools.py`)
- Evaluation chat UI → Agent evaluation: gets runnable (evidence: `llm-agent-evaluation-framework/llm-eval-chatbot.py`)
- Agent evaluation → Asana tools: imports tools (evidence: `llm-agent-evaluation-framework/runnable.py`)
- Agent evaluation → Drive tools: imports tools (evidence: `llm-agent-evaluation-framework/runnable.py`)
- Agent evaluation → Vector DB tools: imports tools (evidence: `llm-agent-evaluation-framework/runnable.py`)
- Conversation backend → Backend helpers: uses helpers (evidence: `gohighlevel-saas-backend/functions/src/ghl_conversation_langchain.js`)
- Conversation backend → Textualy graph: uses graph (evidence: `gohighlevel-saas-backend/functions/src/ghl_conversation_langchain.js`)