电商AI客服桌面应用程序,基于 PyQt6 构建,支持多平台渠道集成,集成 AI 大模型实现智能自动回复。

• 多渠道支持:目前支持拼多多平台 WebSocket 实时消息接收
• AI 智能回复:基于自研 Agent 框架(不依赖 Agno),多轮工具调用 + 会话上下文管理
• AI 主动推荐:客服代理可主动获取商品列表、发送商品卡片给用户
• 双知识库体系:产品知识库 + 客服知识库,分别检索商品信息与售后/物流/退款等政策
• 商品知识自动同步:从拼多多 API 拉取商品列表,调用多模态 LLM 提取产品知识入库
• 关键词转人工:自动识别用户意图,支持关键词触发转人工服务
• 消息队列处理:异步消息队列 + 处理器链,支持高并发场景
• 自动重连机制:WebSocket 连接支持断线自动重连和心跳检测

• Python >= 3.11
• Windows 操作系统(打包为 exe 后可在 Windows 上独立运行)

# 安装依赖
uv sync

python app.py

首次运行后会在项目根目录生成 config.json 配置文件,主要配置项:

1. 先用 curl 或 Python 脚本测试接口,确认真实请求参数、请求头、响应结构
2. 根据实际响应结构修改解析代码,不要凭猜测写字段名
3. 修改后用 mock 数据或真实调用验证解析逻辑

例如:修改 product_manager.py 的商品列表接口时,先用 curl 测试接口,确认数据在 result.onSaleGoods 字段而非 result.goodsList,字段名为驼峰 goodsId 而非下划线 goods_id,价格单位是"分"需除以 100 转换为"元"

在 Windows 上运行:

python scripts/build_win_exe.py --clean

打包产物位于 dist/AgentCustomer/ 目录。

text
Agent-Customer/
├── Agent/ # AI 代理模块(自研 Agent 框架)
│ └── CustomerAgent/
│ ├── custom/ # 自研实现:LLM 客户端、会话管理、工具执行器
│ └── tools/ # Agent 工具集(商品/知识/转人工)
├── Channel/ # 渠道集成
│ └── pinduoduo/
│ ├── core/ # 连接、生命周期、状态、消息处理拆分模块
│ └── utils/API/ # 拼多多 API 封装
├── Message/ # 消息处理(队列 + 处理器链)
│ ├── core/ # consumer / handlers / queue
│ └── handlers/ # 预处理器、AI、关键词处理器
├── bridge/ # 桥接模块(Context/Reply)
├── core/ # 核心服务(DI 容器、缓存、连接状态)
├── database/ # 数据库(SQLAlchemy + 知识服务 + 商品同步)
├── ui/ # PyQt6 用户界面
├── utils/ # 工具模块(日志、路径等)
├── scripts/ # 构建脚本
└── app.py # 应用入口

MIT