Skip to content

JC0v0/Customer-Agent

Repository files navigation

🤖 拼多多智能客服系统

系统配置界面

拼多多智能客服系统 - 提升客服效率的智能化解决方案

📖 项目简介

拼多多智能客服系统是一个专为电商平台设计的综合性客户服务管理工具。本系统通过AI技术和自动化流程,显著提高客服工作效率,实现智能回复的同时保留人工介入的灵活性,为商家提供完整的客服解决方案。

✨ 主要功能

🔐 账号管理

  • 商家账号管理(支持多账号)
  • 自动登录获取cookies
  • 账号状态实时监控
账号管理界面

账号管理 - 管理您的拼多多商家账号

💬 智能消息处理

  • 实时消息监控与自动回复
  • 集成AI (Coze API) 生成智能回复内容
  • 支持自定义回复模板和关键词识别
自动回复界面

智能回复 - 自动回复客户消息

🔄 智能转接系统

  • 基于关键词智能识别客户需求
  • 自动将复杂问题转接给人工客服
  • 无缝衔接确保服务质量
关键词管理界面

关键词管理 - 智能识别转接需求

📊 系统监控

  • 实时日志记录
  • 系统运行状态监控
  • 详细的操作记录和统计
日志界面

日志界面 - 实时监控系统运行状态

🚀 快速开始

环境要求

  • Python 3.11+
  • Windows 10/11 (推荐)
  • 网络连接稳定

安装步骤

  1. 克隆项目

    git clone https://github.com/JC0v0/Customer-Agent.git
    cd Customer-Agent
  2. 安装依赖

    ##使用uv进行环境配置
    ##安装uv
    pip install uv
    
    uv venv
    uv sync
  3. 安装浏览器驱动

    uv run playwright install chrome

📱 使用指南

启动系统

python app.py

配置流程

  1. 配置商家账号

    • 在账号管理界面配置您的拼多多商家账号
    • 系统将自动获取并保存登录凭证
  2. 设置关键词规则

    • 配置需要人工转接的关键词
    • 设置自动回复的话术模板
  3. 配置Coze API

    • 在设置界面配置Coze API
    • 设置Coze API
  4. 启动系统

    • 在账号管理界面启动系统
    • 系统将根据配置自动处理消息
  5. 监控日志

    • 在日志管理界面查看系统运行日志

🛠️ 技术架构

  • 前端界面: qfluentwidgets
  • 后端逻辑: Python
  • AI集成: Coze API
  • 数据存储: SQLite + JSON
  • 浏览器自动化: Playwright

📁 项目结构

Customer-Agent/
├── Agent/              # AI智能代理模块
│   ├── bot_factory.py      # 机器人工厂
│   ├── bot.py             # 机器人基类
│   └── CozeAgent/         # Coze AI代理
│       ├── bot.py
│       ├── conversation_manager.py
│       └── user_session.py
├── Channel/            # 渠道接口模块
│   ├── channel.py         # 渠道基类
│   └── pinduoduo/        # 拼多多渠道
│       ├── pdd_chnnel.py
│       ├── pdd_login.py
│       ├── pdd_message.py
│       └── utils/        # 拼多多API工具
├── Message/            # 消息处理模块
│   ├── message_consumer.py   # 消息消费者
│   ├── message_handler.py    # 消息处理器
│   ├── message_queue.py      # 消息队列
│   └── message.py           # 消息基类
├── bridge/             # 桥接模块
│   ├── bridge.py          # 桥接器
│   ├── context.py         # 上下文管理
│   └── reply.py           # 回复处理
├── database/           # 数据库模块
│   ├── db_manager.py      # 数据库管理器
│   └── models.py          # 数据模型
├── ui/                 # 用户界面模块
│   ├── main_ui.py         # 主界面
│   ├── auto_reply_ui.py   # 自动回复界面
│   ├── keyword_ui.py      # 关键词管理界面
│   ├── log_ui.py          # 日志界面
│   ├── setting_ui.py      # 设置界面
│   └── user_ui.py         # 用户管理界面
├── utils/              # 工具函数
│   └── logger.py          # 日志工具
├── docs/               # 文档和截图
├── icon/               # 图标资源
├── logs/               # 日志文件
├── app.py              # 应用程序入口
├── config.py           # 配置管理
├── pyproject.toml      # 项目配置
└── uv.lock             # 依赖锁定文件

🤝 贡献指南

我们欢迎所有形式的贡献!如果您想参与项目开发:

  1. Fork 本仓库
  2. 创建您的特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交您的更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启一个 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 详情请见 LICENSE 文件。

📞 联系我们

  • 问题反馈: GitHub Issues
  • 功能建议: 欢迎通过 Issues 提出您的想法
  • 技术交流:
频道二维码

频道二维码

💖 支持项目

如果这个项目对您有帮助,您可以通过以下方式支持我们:

赞赏码

您的支持是我们前进的动力


⭐ 如果这个项目对您有帮助,请给我们一个星标!

Made with ❤️ by JC0v0

About

电商智能客服系统,支持AI客服回复,关键词转人工

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages