langgraph_multi-agent-rag-customer-support
基于LangGraph的多智能体RAG客服系统,一套代码搞定旅行预订、电商查询与人工审核全流程
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
基于LangGraph的多智能体RAG客服系统,一套代码搞定旅行预订、电商查询与人工审核全流程
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
## 1. 从"单兵作战"到"团队协作":多智能体架构设计传统AI助手像一个全科医生,什么都能看一点,但什么都做不到最精通。这个项目采用了完全不同的思路——专家会诊模式:一个主助手(Primary Assistant)作为前台接待,根据用户需求调度给最合适的专科助手。系统目前包含7个专科助手:- 航班预订助手:处理航班查询、改签、取消- 租车助手:管理租车订单和延期- 酒店预订助手:处理酒店预订、修改和取消- 行程推荐助手:根据偏好推荐旅行活动和景点- WooCommerce助手:对接电商系统,查询商品和订单- 表单提交助手:处理各类业务表单提交- 博客搜索助手:检索相关文章和知识库这种架构的优势在于:每个助手专注一个领域,主助手只需要理解用户意图并分发任务。具体实现上,委派机制通过 Pydantic BaseModel 定义每个转接命令(如 ToFlightBookingAssistant),主助手通过 llm.bind_tools() 绑定所有工具后,由 LangGraph 的状态路由决定调用哪个子智能体。## 2. RAG加持:让AI的回答有据可查仅有大语言模型是不够的——模型的知识有截止日期,企业政策也在不断变化。该项目引入了检索增强生成(RAG)机制来解决这个问题。图2:Qdrant向量数据库Schema
系统使用 Qdrant 作为向量数据库存储文档嵌入,配合 faq_documents 目录下的本地文件系统数据源(支持 .md、.pdf、.docx),按配置每24小时自动更新检索内容。当用户提问时,系统先从向量库中检索相关段落,再将检索结果作为上下文喂给 LLM 生成回答,确保答案基于真实企业政策而非模型幻觉。## 3. 部署体验:Docker一键启动,生产级配置图3:AWS架构图
该项目提供了完整的容器化部署方案。docker-compose.yml 包含两个核心服务:1. Qdrant 向量数据库:监听 6333 端口,负责向量存储和检索2. customer-support-chat:主应用服务,基于 Python 3.12-slim 镜像构建,依赖 Poetry 管理依赖Dockerfile 采用多阶段构建,使用 Poetry 安装依赖。硬件要求非常亲民:无需 GPU,4GB 内存 + 2GB 磁盘即可运行,普通云服务器即可承载。部署难度评为"中等",主要是 OPENAI_API_KEY(或其他LLM API Key)的获取和配置需要用户自行处理。## 4. 技术栈:LangGraph + LangChain + Qdrant- LangGraph:用状态图建模多智能体工作流,支持条件路由和状态持久化- LangChain:工具链抽象,集成 DuckDuckGo 搜索、向量检索- Qdrant:高性能向量数据库,支持实时增量和语义搜索- WooCommerce REST API:对接电商系统,查询商品/订单/博客- Poetry:Python 依赖管理,pyproject.toml 清晰列出所有依赖## 5. 安全机制:人工审核与越狱防护原框架的一个重大升级是引入了 GoHumanLoop 人工审核流程:当系统识别到高风险操作(如退款、大量订单查询)时,会暂停执行,等待人工确认。同时增加了越狱防护和查询相关性检查,防止恶意用户通过 prompt injection 绕过安全限制。## 6. 局限与挑战- API Key 硬依赖:系统默认使用 OpenAI API,切换到国产模型(如 Qwen、通义)需要修改代码中的模型配置- 中文文档较少:代码注释和技术实现文档不够完善,开发者上手需要一定时间- 缺少生产级监控:无 metrics 埋点、告警机制,大规模部署需要自行补充## 7. 行业意义2024-2025年是 AI Agent 元年,LangGraph 作为斯坦福系的核心框架,正在成为构建复杂 AI 应用的行业标准。这个项目展示了一个真实的 Agent 应用长什么样——不是玩具 demo,而是能处理真实业务(旅行、电商)的生产级系统。它的增长曲线(254 stars)说明市场对这类"AI + 行业知识库"的落地方案有强烈需求。如果你正在考虑构建企业级 AI 客服、或者想学习 LangGraph 的多智能体开发模式,这个项目是非常好的参考起点。