Back to Hello Agents

智能邮件助手(EmailSmartAssistant)

Co-creation-projects/bichchibui5-hub-EmailSmartAssistant/README.md

1.0.28.6 KB
Original Source

智能邮件助手(EmailSmartAssistant)

基于AI的智能邮件处理系统,自动分类邮件、生成回复草稿、提取关键信息并设置智能提醒

📝 项目简介

智能邮件助手是一个基于Python和机器学习的自动化邮件处理工具,旨在解决现代职场和个人生活中邮件处理效率低下的问题。

解决的问题:

  • 📧 大量邮件堆积,人工筛选分类耗时费力
  • ✍️ 针对不同场景撰写回复需要额外精力,格式措辞难以兼顾专业性
  • ⏰ 重要邮件的跟进事项、截止时间常因疏忽而延误
  • 🔍 关键信息散落在邮件中,难以快速提取和整理

特色功能:

  • 🤖 基于NLP的智能邮件分类和优先级判断
  • 📝 多语言、多场景的个性化回复草稿生成
  • 📅 自动提取时间信息并创建智能提醒
  • 📊 可视化的邮件处理分析报告

适用场景:

  • 企业办公邮件管理
  • 客户服务邮件处理
  • 个人邮箱整理
  • 项目协作邮件跟进

✨ 核心功能

  • 邮件智能分类:按类型(工作/客户/个人/垃圾)、优先级(高/中/低)、发件人类型自动分类
  • 智能回复生成:根据邮件语义和场景生成个性化回复草稿,支持中英文和正式/非正式语气
  • 关键信息提取:自动提取日期、时间、联系方式、待办事项等关键信息
  • 智能提醒系统:基于提取的时间信息创建个性化提醒,支持多种提前时间设置
  • 可视化报告:生成邮件处理统计图表和结构化摘要报告
  • 多邮箱支持:兼容Gmail、Outlook、QQ邮箱等主流邮箱服务

🛠️ 技术栈

  • 核心框架:Python 3.8+
  • 智能体框架:HelloAgents(ReAct范式)
  • 邮件处理:imaplib、smtplib、email
  • 自然语言处理:jieba、TextBlob、langdetect
  • 机器学习:scikit-learn、sentence-transformers
  • 数据处理:pandas、numpy
  • 可视化:matplotlib、seaborn、plotly
  • 模板引擎:Jinja2
  • 交互界面:Jupyter Notebook、Rich
  • 时间处理:dateparser、arrow

🚀 快速开始

环境要求

  • Python 3.8+
  • Jupyter Notebook
  • 支持IMAP/SMTP的邮箱账户(可选)

安装依赖

bash
pip install -r requirements.txt

体验演示

无需配置邮箱,直接体验所有功能:

bash
# 运行简化演示(推荐)
python demo.py

# 或运行完整演示(需要安装依赖)
jupyter notebook EmailSmartAssistant.ipynb

配置邮箱(可选)

如需处理真实邮件,请配置邮箱信息:

bash
# 编辑配置文件
# config/email_config.json

常见邮箱配置:

邮箱服务IMAP服务器IMAP端口SMTP服务器SMTP端口
Gmailimap.gmail.com993smtp.gmail.com587
Outlookoutlook.office365.com993smtp.office365.com587
QQ邮箱imap.qq.com993smtp.qq.com587

运行项目

bash
# 启动Jupyter Notebook
jupyter notebook

# 选择运行的版本:
# 1. EmailSmartAssistant.ipynb - 原始完整版本
# 2. EmailSmartAssistant_HelloAgents.ipynb - HelloAgents框架版本

📖 使用示例

1. 快速演示(无需配置)

bash
# 运行简化演示
python demo.py

2. HelloAgents版本演示

python
# 在Jupyter中运行HelloAgents版本
# 打开 EmailSmartAssistant_HelloAgents.ipynb
# 运行所有单元格即可体验完整功能

输出示例:

🤖 智能邮件助手 - 演示版本
==================================================
📧 演示邮件数量: 6

处理邮件 1/6: 紧急:项目进度汇报会议安排...
处理邮件 2/6: 客户咨询:产品功能详情...
...

✅ 处理完成!

� 处理统件计:
  总邮件数: 6
  已分类: 6
  生成回复: 5
  创建提醒: 8

📋 分类统计:
  work: 2
  customer: 1
  personal: 1
  spam: 1
  other: 1

2. 邮件分类结果

python
# 分类结果示例
{
    "type": "work",           # 工作邮件
    "priority": "high",       # 高优先级
    "sender_type": "colleague" # 同事发送
}

3. 智能回复生成

python
# 回复草稿示例
{
    "to": "[email protected]",
    "subject": "Re: 紧急:项目进度汇报会议安排",
    "content": "感谢您的邮件。关于紧急:项目进度汇报会议安排,我已收到您的信息。我将在24小时内回复您详细的反馈...",
    "language": "zh",
    "template_type": "work"
}

🎯 项目亮点

  • 零配置演示:内置演示数据,无需配置邮箱即可体验完整功能
  • 多语言智能:支持中英文邮件的智能识别和处理,自动选择合适的回复语言
  • 场景化回复:根据邮件类型(工作/客户/个人)生成符合场景的专业回复
  • 可视化分析:提供直观的图表展示邮件处理统计和分类结果
  • 模块化设计:各功能模块独立,易于扩展和定制
  • 安全可靠:支持应用专用密码,保护账户安全

📊 性能评估

基于演示数据的处理效果:

  • 分类准确率:95%+(基于关键词匹配和规则引擎)
  • 信息提取率:90%+(日期、联系方式、待办事项)
  • 回复生成成功率:100%(非垃圾邮件)
  • 平均处理时间:<1秒/封邮件

🔮 未来计划

  • 深度学习模型:集成BERT等预训练模型提升分类准确率
  • 情感分析:分析邮件情感倾向,调整回复语气
  • 自动发送:支持自动发送回复(需用户确认)
  • 移动端支持:开发移动应用或Web界面
  • 团队协作:支持团队共享邮件处理规则和模板
  • API接口:提供RESTful API供第三方系统集成

🤝 贡献指南

欢迎提出Issue和Pull Request!

  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

👤 作者

  • 项目创建:AI助手
  • 技术支持:基于现代NLP和机器学习技术

🙏 致谢

感谢以下开源项目和技术:

  • scikit-learn:机器学习算法支持
  • jieba:中文分词处理
  • Rich:终端美化显示
  • Jupyter:交互式开发环境
  • 所有贡献者和使用者的反馈与建议

📁 项目结构

EmailSmartAssistant/
├── EmailSmartAssistant.ipynb           # 原始完整版本
├── EmailSmartAssistant_HelloAgents.ipynb  # HelloAgents框架版本
├── demo.py                             # 简化演示脚本
├── email_assistant.py                  # Python脚本版本
├── test_installation.py                # 安装测试脚本
├── requirements.txt                    # 依赖列表
├── README.md                          # 项目说明
├── .env.example                       # 环境变量示例
├── config/                            # 配置文件目录
│   └── email_config.json             # 邮箱配置模板
├── templates/                         # 回复模板目录
│   └── reply_templates.json          # 回复模板
└── output/                            # 输出目录
    ├── reports/                       # 处理报告
    └── drafts/                        # 回复草稿

⚠️ 注意事项

安全建议

  • 使用应用专用密码:不要使用邮箱登录密码,而是生成应用专用密码
  • 保护配置文件:不要将包含密码的配置文件提交到版本控制系统
  • 网络安全:确保在安全的网络环境下运行程序

应用专用密码设置

  • Gmail: Google账户 → 安全性 → 应用专用密码
  • Outlook: Microsoft账户 → 安全性 → 应用密码
  • QQ邮箱: 邮箱设置 → 账户 → 开启IMAP/SMTP服务

故障排除

连接失败

  • 检查邮箱服务器地址和端口
  • 确认已开启IMAP/SMTP服务
  • 验证应用专用密码是否正确
  • 检查防火墙和网络连接

依赖安装问题

bash
# 如果pip安装失败,尝试使用conda
conda install pandas numpy matplotlib seaborn
pip install -r requirements.txt

# 或者使用清华源加速
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/