# mani-aitrainer/agentic_ai_training architecture

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

- Interactive diagram: https://gitdiagram.com/mani-aitrainer/agentic_ai_training
- Repository: https://github.com/mani-aitrainer/agentic_ai_training

## Overview

This repository is a collection of independent AI workflow examples, not one application. Its major products cover dispute resolution, support chat, PDF-based graph RAG, and collaborative research reports, alongside a loan-approval demo. The graphs below emphasize each example’s user-to-result path and documented internal stages. Several connections rely on the SOURCE INDEX rather than full excerpts; unsampled implementations and wiring are not inferred where evidence is insufficient.

Main entry points: [`research_system/research_report_team/src/research_team/team.py`](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/research_system/research_report_team/src/research_team/team.py) (Collaborative Team), [`dispute_resolution/src/dispute_agent/state.py`](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/state.py) (Shared Case State), [`dispute_resolution/src/dispute_agent/agents/fraud_investigator.py`](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/agents/fraud_investigator.py) (Fraud Investigator), [`docker/app/src/support_agent/graph.py`](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/docker/app/src/support_agent/graph.py) (Conversation Graph)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dispute["Dispute Resolution"]
  node_dispute_cli["Dispute CLI<br/>[cli.py]"]
  node_dispute_graph["Workflow Graph<br/>[graph.py]"]
  node_dispute_nodes["Workflow Nodes<br/>[nodes.py]"]
  node_dispute_router["Branch Routers<br/>[routers.py]"]
  node_dispute_agents["Specialist Agents<br/>[specialists.py]"]
  node_dispute_fraud_agent["Fraud Investigator"]
  node_dispute_state["Shared Case State<br/>[state.py]"]
  node_dispute_config["Policy Settings<br/>[config.py]"]
  node_dispute_prompts["Agent Prompts<br/>[prompts.py]"]
  node_dispute_scratchpad["Agent Scratchpad<br/>[scratchpad.py]"]
end

subgraph group_support["Support Agent"]
  node_support_api["Support API<br/>[api.py]"]
  node_support_graph["Conversation Graph<br/>[graph.py]"]
  node_support_llm["LLM Factory<br/>[llm.py]"]
  node_support_tools["Support Tools<br/>[tools.py]"]
  node_support_state[("Conversation Store<br/>[state_store.py]")]
end

subgraph group_graphrag["Graph RAG"]
  node_pipeline["PDF Extraction Pipeline<br/>[pipeline.py]"]
  node_org_graph[("Organization Graph<br/>[graph_rag.py]")]
  node_rag_query["Graph Retrieval &amp; Answering<br/>[graph_rag.py]"]
end

subgraph group_research["Research Teams"]
  node_research_cli["Research CLI<br/>[cli.py]"]
  node_research_runner["Report Runner<br/>[runner.py]"]
  node_research_team["Collaborative Team<br/>[team.py]"]
  node_research_agents["Researcher Writer Critic<br/>[agents.py]"]
  node_research_tools["Search Tools<br/>[tools.py]"]
  node_research_model["Model Clients<br/>[model_client.py]"]
end

subgraph group_loan["Loan Approval"]
  node_loan_demo["Loan Approval Demo<br/>[loan_approval.py]"]
end

node_dispute_user(("Dispute User"))
node_support_user(("Support User"))
node_pdf["PDF Input"]
node_rag_user(("Questioner"))
node_research_user(("Report Requester"))
node_loan_user(("Loan Applicant"))

node_dispute_user -.->|"submits case"| node_dispute_cli
node_dispute_cli -.->|"starts workflow"| node_dispute_graph
node_dispute_nodes -->|"reads and writes"| node_dispute_state
node_dispute_router -->|"routes from state"| node_dispute_state
node_dispute_agents -->|"coordinates through"| node_dispute_state
node_dispute_fraud_agent -->|"updates case state"| node_dispute_state
node_dispute_nodes -->|"uses settings"| node_dispute_config
node_dispute_fraud_agent -->|"uses prompts"| node_dispute_prompts
node_dispute_fraud_agent -->|"uses scratchpad"| node_dispute_scratchpad
node_support_user -.->|"sends request"| node_support_api
node_support_api -.->|"dispatches chat"| node_support_graph
node_support_graph -->|"uses model factory"| node_support_llm
node_support_graph -->|"uses tools"| node_support_tools
node_support_llm -->|"binds tools"| node_support_tools
node_pdf -->|"provides document"| node_pipeline
node_pipeline -->|"builds graph"| node_org_graph
node_pipeline -->|"supplies extraction stages"| node_rag_query
node_org_graph -->|"retrieves graph facts"| node_rag_query
node_rag_user -.->|"asks question"| node_rag_query
node_research_user -.->|"requests report"| node_research_cli
node_research_cli -->|"invokes runner"| node_research_runner
node_research_runner -->|"runs team"| node_research_team
node_research_team -->|"assembles agents"| node_research_agents
node_research_team -->|"selects search tool"| node_research_tools
node_research_team -->|"builds model clients"| node_research_model
node_loan_user -.->|"provides application"| node_loan_demo

click node_dispute_cli "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/cli.py"
click node_dispute_graph "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/graph.py"
click node_dispute_nodes "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/nodes.py"
click node_dispute_router "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/routers.py"
click node_dispute_agents "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/agents/specialists.py"
click node_dispute_fraud_agent "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/agents/fraud_investigator.py"
click node_dispute_state "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/state.py"
click node_dispute_config "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/config.py"
click node_dispute_prompts "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/prompts.py"
click node_dispute_scratchpad "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/scratchpad.py"
click node_support_api "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/docker/app/src/support_agent/api.py"
click node_support_graph "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/docker/app/src/support_agent/graph.py"
click node_support_llm "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/docker/app/src/support_agent/llm.py"
click node_support_tools "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/docker/app/src/support_agent/tools.py"
click node_support_state "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/docker/app/src/support_agent/state_store.py"
click node_pipeline "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/graph_rag/pipeline.py"
click node_org_graph "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/graph_rag/graph_rag.py"
click node_rag_query "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/graph_rag/graph_rag.py"
click node_research_cli "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/research_system/research_report_team/cli.py"
click node_research_runner "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/research_system/research_report_team/src/research_team/runner.py"
click node_research_team "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/research_system/research_report_team/src/research_team/team.py"
click node_research_agents "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/research_system/research_report_team/src/research_team/agents.py"
click node_research_tools "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/research_system/research_report_team/src/research_team/tools.py"
click node_research_model "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/research_system/research_report_team/src/research_team/model_client.py"
click node_loan_demo "https://github.com/mani-aitrainer/agentic_ai_training/blob/main/Section2/HandsOn/loan_approval.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_dispute_cli,node_dispute_graph,node_dispute_nodes,node_dispute_router,node_dispute_agents,node_dispute_fraud_agent,node_dispute_state,node_dispute_config,node_dispute_prompts,node_dispute_scratchpad,node_dispute_user,node_support_user toneBlue
class node_support_api,node_support_graph,node_support_llm,node_support_tools,node_support_state toneAmber
class node_pipeline,node_org_graph,node_rag_query,node_research_user toneMint
class node_research_cli,node_research_runner,node_research_team,node_research_agents,node_research_tools,node_research_model toneRose
class node_loan_demo,node_pdf,node_rag_user,node_loan_user toneIndigo
```

## Components

### Dispute Resolution

- [Dispute CLI](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/cli.py): `dispute_resolution/src/dispute_agent/cli.py`
- [Workflow Graph](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/graph.py): `dispute_resolution/src/dispute_agent/graph.py`
- [Workflow Nodes](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/nodes.py): `dispute_resolution/src/dispute_agent/nodes.py`
- [Branch Routers](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/routers.py): `dispute_resolution/src/dispute_agent/routers.py`
- [Specialist Agents](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/agents/specialists.py): `dispute_resolution/src/dispute_agent/agents/specialists.py`
- [Fraud Investigator](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/agents/fraud_investigator.py): `dispute_resolution/src/dispute_agent/agents/fraud_investigator.py`
- [Shared Case State](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/state.py): `dispute_resolution/src/dispute_agent/state.py`
- [Policy Settings](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/config.py): `dispute_resolution/src/dispute_agent/config.py`
- [Agent Prompts](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/prompts.py): `dispute_resolution/src/dispute_agent/prompts.py`
- [Agent Scratchpad](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/dispute_resolution/src/dispute_agent/scratchpad.py): `dispute_resolution/src/dispute_agent/scratchpad.py`

### Support Agent

- [Support API](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/docker/app/src/support_agent/api.py): `docker/app/src/support_agent/api.py`
- [Conversation Graph](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/docker/app/src/support_agent/graph.py): `docker/app/src/support_agent/graph.py`
- [LLM Factory](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/docker/app/src/support_agent/llm.py): `docker/app/src/support_agent/llm.py`
- [Support Tools](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/docker/app/src/support_agent/tools.py): `docker/app/src/support_agent/tools.py`
- [Conversation Store](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/docker/app/src/support_agent/state_store.py): `docker/app/src/support_agent/state_store.py`

### Graph RAG

- [PDF Extraction Pipeline](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/graph_rag/pipeline.py): `graph_rag/pipeline.py`
- [Organization Graph](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/graph_rag/graph_rag.py): `graph_rag/graph_rag.py`
- [Graph Retrieval & Answering](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/graph_rag/graph_rag.py): `graph_rag/graph_rag.py`

### Research Teams

- [Research CLI](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/research_system/research_report_team/cli.py): `research_system/research_report_team/cli.py`
- [Report Runner](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/research_system/research_report_team/src/research_team/runner.py): `research_system/research_report_team/src/research_team/runner.py`
- [Collaborative Team](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/research_system/research_report_team/src/research_team/team.py): `research_system/research_report_team/src/research_team/team.py`
- [Researcher Writer Critic](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/research_system/research_report_team/src/research_team/agents.py): `research_system/research_report_team/src/research_team/agents.py`
- [Search Tools](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/research_system/research_report_team/src/research_team/tools.py): `research_system/research_report_team/src/research_team/tools.py`
- [Model Clients](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/research_system/research_report_team/src/research_team/model_client.py): `research_system/research_report_team/src/research_team/model_client.py`

### Loan Approval

- [Loan Approval Demo](https://github.com/mani-aitrainer/agentic_ai_training/blob/main/Section2/HandsOn/loan_approval.py): `Section2/HandsOn/loan_approval.py`

### Other components

- **Dispute User**
- **Support User**
- **PDF Input**
- **Questioner**
- **Report Requester**
- **Loan Applicant**

## Connections

- Dispute User → Dispute CLI: submits case
- Dispute CLI → Workflow Graph: starts workflow
- Workflow Nodes → Shared Case State: reads and writes (evidence: `dispute_resolution/src/dispute_agent/state.py`)
- Branch Routers → Shared Case State: routes from state (evidence: `dispute_resolution/src/dispute_agent/routers.py`)
- Specialist Agents → Shared Case State: coordinates through (evidence: `dispute_resolution/src/dispute_agent/state.py`)
- Fraud Investigator → Shared Case State: updates case state (evidence: `dispute_resolution/src/dispute_agent/state.py`)
- Workflow Nodes → Policy Settings: uses settings (evidence: `dispute_resolution/src/dispute_agent/nodes.py`)
- Fraud Investigator → Agent Prompts: uses prompts (evidence: `dispute_resolution/src/dispute_agent/agents/fraud_investigator.py`)
- Fraud Investigator → Agent Scratchpad: uses scratchpad (evidence: `dispute_resolution/src/dispute_agent/agents/fraud_investigator.py`)
- Support User → Support API: sends request
- Support API → Conversation Graph: dispatches chat
- Conversation Graph → LLM Factory: uses model factory (evidence: `docker/app/src/support_agent/graph.py`)
- Conversation Graph → Support Tools: uses tools (evidence: `docker/app/src/support_agent/graph.py`)
- LLM Factory → Support Tools: binds tools (evidence: `docker/app/src/support_agent/llm.py`)
- PDF Input → PDF Extraction Pipeline: provides document (evidence: `graph_rag/pipeline.py`)
- PDF Extraction Pipeline → Organization Graph: builds graph (evidence: `graph_rag/pipeline.py`)
- PDF Extraction Pipeline → Graph Retrieval & Answering: supplies extraction stages (evidence: `graph_rag/graph_rag.py`)
- Organization Graph → Graph Retrieval & Answering: retrieves graph facts (evidence: `graph_rag/graph_rag.py`)
- Questioner → Graph Retrieval & Answering: asks question
- Report Requester → Research CLI: requests report
- Research CLI → Report Runner: invokes runner (evidence: `research_system/research_report_team/cli.py`)
- Report Runner → Collaborative Team: runs team (evidence: `research_system/research_report_team/src/research_team/runner.py`)
- Collaborative Team → Researcher Writer Critic: assembles agents (evidence: `research_system/research_report_team/src/research_team/team.py`)
- Collaborative Team → Search Tools: selects search tool (evidence: `research_system/research_report_team/src/research_team/team.py`)
- Collaborative Team → Model Clients: builds model clients (evidence: `research_system/research_report_team/src/research_team/team.py`)
- Loan Applicant → Loan Approval Demo: provides application
