# sufian-01/multi-agent-scheduling-assistant architecture

> Architecture diagram of the GitHub repository sufian-01/multi-agent-scheduling-assistant, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sufian-01/multi-agent-scheduling-assistant
- Repository: https://github.com/sufian-01/multi-agent-scheduling-assistant

## Overview

This is a multi-agent scheduling and workplace-assistant application: users can manage calendar events, handle email, ask questions against a company FAQ, or get general conversational help. The LangGraph workflow classifies a request, routes it to a specialist, and lets tool-using specialists dispatch tools before returning a response. The sampled sources show those routes and the calendar, Gmail, and RAG tool implementations; the README is empty, and the frontend and app entry-point internals were not excerpted, so their connections are shown only as unverified.

Main entry points: [`graph.py`](https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/graph.py) (Workflow graph), [`agent/booking_agent.py`](https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/agent/booking_agent.py) (Booking agent), [`agent/email_agent.py`](https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/agent/email_agent.py) (Email agent), [`agent/rag_agent.py`](https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/agent/rag_agent.py) (Knowledge agent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User interface"]
  node_frontend["Frontend<br/>[main.py]"]
  node_app["Application entry<br/>[app.py]"]
end

subgraph group_orchestration["Agent orchestration"]
  node_graph["Workflow graph<br/>[graph.py]"]
  node_triage["Intent triage<br/>[triage_agent.py]"]
end

subgraph group_capabilities["Assistant capabilities"]
  node_booking["Booking agent<br/>[booking_agent.py]"]
  node_email["Email agent<br/>[email_agent.py]"]
  node_rag["Knowledge agent<br/>[rag_agent.py]"]
  node_general["General agent<br/>[general_agent.py]"]
end

subgraph group_integrations["Tools and integrations"]
  node_calendar["Calendar tools<br/>[calendar_tools.py]"]
  node_gmail["Gmail tools<br/>[gmail_tools.py]"]
  node_ragtools["FAQ retrieval<br/>[rag_tools.py]"]
  node_faq["Company FAQ PDF<br/>[company_faq.pdf]"]
  node_auth["Google auth<br/>[google_auth.py]"]
end

subgraph group_shared["Shared runtime"]
  node_prompts["Agent prompts<br/>[prompts.py]"]
  node_state["Conversation state<br/>[state.py]"]
  node_config["Runtime config<br/>[config.py]"]
end

node_user(("User"))
node_google{{"Google APIs"}}
node_gemini{{"Gemini model"}}

node_user -.->|"submits request"| node_frontend
node_frontend -.->|"sends request"| node_app
node_app -.->|"invokes workflow"| node_graph
node_graph -->|"starts at"| node_triage
node_graph -->|"routes intent"| node_booking
node_graph -->|"routes intent"| node_email
node_graph -->|"routes intent"| node_rag
node_graph -->|"routes intent"| node_general
node_triage -->|"classifies with"| node_gemini
node_booking -->|"binds tools"| node_calendar
node_email -->|"binds tools"| node_gmail
node_rag -->|"binds tool"| node_ragtools
node_graph -->|"registers tools"| node_calendar
node_graph -->|"registers tools"| node_gmail
node_graph -->|"registers tool"| node_ragtools
node_calendar -->|"uses Calendar API"| node_google
node_gmail -->|"uses Gmail API"| node_google
node_calendar -->|"gets credentials"| node_auth
node_gmail -->|"gets credentials"| node_auth
node_auth -->|"authenticates"| node_google
node_ragtools -->|"loads PDF"| node_faq
node_rag -->|"invokes model"| node_gemini
node_booking -->|"invokes model"| node_gemini
node_email -->|"invokes model"| node_gemini
node_triage -->|"uses prompt"| node_prompts
node_booking -->|"uses prompt"| node_prompts
node_email -->|"uses prompt"| node_prompts
node_rag -->|"uses prompt"| node_prompts
node_triage -->|"reads and updates"| node_state
node_booking -->|"reads and updates"| node_state
node_email -->|"reads and updates"| node_state
node_rag -->|"reads and updates"| node_state
node_graph -->|"builds over"| node_state
node_triage -->|"loads API key"| node_config
node_booking -->|"loads API key"| node_config
node_email -->|"loads API key"| node_config
node_rag -->|"loads API key"| node_config

click node_frontend "https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/frontend/main.py"
click node_app "https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/app.py"
click node_graph "https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/graph.py"
click node_triage "https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/agent/triage_agent.py"
click node_booking "https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/agent/booking_agent.py"
click node_email "https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/agent/email_agent.py"
click node_rag "https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/agent/rag_agent.py"
click node_general "https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/agent/general_agent.py"
click node_calendar "https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/tools/calendar_tools.py"
click node_gmail "https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/tools/gmail_tools.py"
click node_ragtools "https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/tools/rag_tools.py"
click node_faq "https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/knowledge_base/company_faq.pdf"
click node_auth "https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/tools/google_auth.py"
click node_prompts "https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/prompts.py"
click node_state "https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/state.py"
click node_config "https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/config.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_frontend,node_app,node_user toneBlue
class node_graph,node_triage toneAmber
class node_booking,node_email,node_rag,node_general,node_google toneMint
class node_calendar,node_gmail,node_ragtools,node_faq,node_auth toneRose
class node_prompts,node_state,node_config,node_gemini toneIndigo
```

## Components

### User interface

- [Frontend](https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/frontend/main.py): `frontend/main.py`
- [Application entry](https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/app.py): `app.py`

### Agent orchestration

- [Workflow graph](https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/graph.py): `graph.py`
- [Intent triage](https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/agent/triage_agent.py): `agent/triage_agent.py`

### Assistant capabilities

- [Booking agent](https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/agent/booking_agent.py): `agent/booking_agent.py`
- [Email agent](https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/agent/email_agent.py): `agent/email_agent.py`
- [Knowledge agent](https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/agent/rag_agent.py): `agent/rag_agent.py`
- [General agent](https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/agent/general_agent.py): `agent/general_agent.py`

### Tools and integrations

- [Calendar tools](https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/tools/calendar_tools.py): `tools/calendar_tools.py`
- [Gmail tools](https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/tools/gmail_tools.py): `tools/gmail_tools.py`
- [FAQ retrieval](https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/tools/rag_tools.py): `tools/rag_tools.py`
- [Company FAQ PDF](https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/knowledge_base/company_faq.pdf): `knowledge_base/company_faq.pdf`
- [Google auth](https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/tools/google_auth.py): `tools/google_auth.py`

### Shared runtime

- [Agent prompts](https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/prompts.py): `prompts.py`
- [Conversation state](https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/state.py): `state.py`
- [Runtime config](https://github.com/sufian-01/multi-agent-scheduling-assistant/blob/main/config.py): `config.py`

### Other components

- **User**
- **Google APIs**
- **Gemini model**

## Connections

- User → Frontend: submits request
- Frontend → Application entry: sends request
- Application entry → Workflow graph: invokes workflow (evidence: `app.py`)
- Workflow graph → Intent triage: starts at (evidence: `graph.py`)
- Workflow graph → Booking agent: routes intent (evidence: `graph.py`)
- Workflow graph → Email agent: routes intent (evidence: `graph.py`)
- Workflow graph → Knowledge agent: routes intent (evidence: `graph.py`)
- Workflow graph → General agent: routes intent (evidence: `graph.py`)
- Intent triage → Gemini model: classifies with (evidence: `agent/triage_agent.py`)
- Booking agent → Calendar tools: binds tools (evidence: `agent/booking_agent.py`)
- Email agent → Gmail tools: binds tools (evidence: `agent/email_agent.py`)
- Knowledge agent → FAQ retrieval: binds tool (evidence: `agent/rag_agent.py`)
- Workflow graph → Calendar tools: registers tools (evidence: `graph.py`)
- Workflow graph → Gmail tools: registers tools (evidence: `graph.py`)
- Workflow graph → FAQ retrieval: registers tool (evidence: `graph.py`)
- Calendar tools → Google APIs: uses Calendar API (evidence: `tools/calendar_tools.py`)
- Gmail tools → Google APIs: uses Gmail API (evidence: `tools/gmail_tools.py`)
- Calendar tools → Google auth: gets credentials (evidence: `tools/calendar_tools.py`)
- Gmail tools → Google auth: gets credentials (evidence: `tools/gmail_tools.py`)
- Google auth → Google APIs: authenticates (evidence: `tools/google_auth.py`)
- FAQ retrieval → Company FAQ PDF: loads PDF (evidence: `tools/rag_tools.py`)
- Knowledge agent → Gemini model: invokes model (evidence: `agent/rag_agent.py`)
- Booking agent → Gemini model: invokes model (evidence: `agent/booking_agent.py`)
- Email agent → Gemini model: invokes model (evidence: `agent/email_agent.py`)
- Intent triage → Agent prompts: uses prompt (evidence: `agent/triage_agent.py`)
- Booking agent → Agent prompts: uses prompt (evidence: `agent/booking_agent.py`)
- Email agent → Agent prompts: uses prompt (evidence: `agent/email_agent.py`)
- Knowledge agent → Agent prompts: uses prompt (evidence: `agent/rag_agent.py`)
- Intent triage → Conversation state: reads and updates (evidence: `agent/triage_agent.py`)
- Booking agent → Conversation state: reads and updates (evidence: `agent/booking_agent.py`)
- Email agent → Conversation state: reads and updates (evidence: `agent/email_agent.py`)
- Knowledge agent → Conversation state: reads and updates (evidence: `agent/rag_agent.py`)
- Workflow graph → Conversation state: builds over (evidence: `graph.py`)
- Intent triage → Runtime config: loads API key (evidence: `agent/triage_agent.py`)
- Booking agent → Runtime config: loads API key (evidence: `agent/booking_agent.py`)
- Email agent → Runtime config: loads API key (evidence: `agent/email_agent.py`)
- Knowledge agent → Runtime config: loads API key (evidence: `agent/rag_agent.py`)
