用户输入自然语言（IT问题）
    │
    ▼
┌─────────────────────────────────────┐
│     LangGraph StateGraph            │
│  ┌─────────┐    ┌──────────────┐   │
│  │ Agent   │───→│ 条件判断      │   │
│  │ 节点    │    │ should_      │   │
│  │(LLM推理)│←───│  continue    │   │
│  └────┬────┘    └──────┬───────┘   │
│       │                │            │
│       │         ┌──────┘            │
│       │         ▼                   │
│       │    ┌──────────┐             │
│       │    │  Tools   │             │
│       │    │  节点     │             │
│       │    └────┬─────┘             │
│       │         │                   │
│       └─────────┘                   │
└─────────────────────────────────────┘
    │
    ▼
┌──────────────┐  ┌──────────────┐  ┌──────────────┐
│  MCP Server  │  │   ChromaDB   │  │   SQLite     │
│  4个 Tool    │  │  向量检索     │  │  记忆存储     │
└──────┬───────┘  └──────────────┘  └──────────────┘
       │
    ┌──┴──┬──────────┬──────────┐
    ▼     ▼          ▼          ▼
 search_ query_   reset_     escalate_
 kb     ticket    password   human

git clone https://github.com/xiaohe9/helpdesk-mcp-server.git
cd helpdesk-mcp-server

# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate  # Linux/Mac
# .venv\Scripts\activate  # Windows

pip install -r requirements.txt

# 启动 Flask 健康检查服务
python app.py

# 运行 AI Agent（交互模式）
python agent_with_memory.py

用户: VPN连接失败怎么办？
→ [Agent] 调用 search_kb
→ [RAG] ChromaDB 检索 IT 知识库
→ [返回] 5步排查方案 ✅

用户: 查询工单 T-002
→ [Agent] 调用 query_ticket
→ [返回] 状态:处理中 / 处理人:李工程师 / 优先级:高 ✅

用户: 重置邮箱密码 zhangsan
→ [Agent] 调用 reset_password
→ [返回] 临时密码: Temp@789012 / 首次登录需修改 ✅

用户: 转人工
→ [Agent] 调用 escalate_human
→ [返回] 队列号: Q-15C1A3 / 预估等待: 3分钟 ✅

对话历史: 完整记录在 SQLite conversations.db ✅

helpdesk-mcp-server/
├── .cursorrules          # Cursor 项目约束定义
├── .gitignore            # Git 忽略规则
├── app.py                # Flask 健康检查接口
├── mcp_server.py         # 4 个 MCP Tool 实现
├── it_support_data.py    # 模拟 IT 知识库与工单数据
├── rag_engine.py         # ChromaDB 向量检索引擎
├── agent_with_memory.py  # LangGraph Agent + SQLite 记忆
├── requirements.txt      # Python 依赖
└── README.md             # 本文件