Math Agent with Microsoft Word and Gmail Integration

使用 Microsoft Word 和 Gmail 集成的数学 Agent

一个基于 Python 的数学 Agent，可使用各种数学工具迭代求解问题，并通过 Microsoft Word 和 Gmail 可视化结果。

功能

• 数学运算

  • 基本算术运算（加、减、乘、除）
  • 高级运算（乘方、平方根、立方根）
  • 三角函数（sin、cos、tan）
  • 对数计算
  • 阶乘计算
  • 生成斐波那契数列
  • ASCII 值转换
  • 指数和计算

• AI 集成

  • 使用 Google Gemini Pro 模型智能求解问题
  • 采用迭代式问题求解方法
  • 自动选择并执行工具

• 增强型日志记录

  • 详细的执行日志
  • 工具操作的调试信息
  • 错误跟踪与报告
  • 包含执行历史记录的完整电子邮件报告

• 邮件集成

  • 完成后自动发送电子邮件报告
  • 在邮件正文中提供详细的执行日志
  • 最终结果摘要
  • Gmail SMTP 集成

• Word 集成

  • 自动创建 Word 文档
  • 绘制包含结果的矩形
  • 自动可视化结果
  • 可配置文本位置

先决条件

• Python 3.7+
• 适用于 macOS 的 Microsoft Word
• macOS 10.15 或更高版本
• Google Cloud API 密钥（用于 Gemini Pro）

安装

1. 克隆代码库
2. 安装依赖项：

pip3 install -r requirements.txt

3. 设置环境变量：

选项 1：在终端中导出（推荐用于测试）：

export GEMINI_API_KEY=your_api_key_here
export [email protected]
export GMAIL_APP_PASSWORD=your16digitpassword

选项 2：创建 .env 文件：

GEMINI_API_KEY=your_api_key_here
[email protected]
GMAIL_APP_PASSWORD=your16digitpassword

用法

推荐方法：运行客户端（会自动启动服务）：

python math_agent_client.py

替代方法（用于调试）：分别运行服务和客户端：

1. 启动 MCP 服务：

# Terminal 1
python math_agent_server.py

# Terminal 2
python math_agent_client.py

Agent 将会：

• 在内部启动 MCP 服务
• 使用 Gemini AI 处理数学查询
• 使用可用工具执行计算
• 创建包含结果的 Word 文档
• 绘制包含最终答案的矩形
• 发送包含执行日志的电子邮件报告

示例查询

- Find the ASCII values of characters in INDIA and then return sum of exponentials of those values
- Calculate the factorial of 5
- Find the sum of first 10 Fibonacci numbers

架构

• math_agent_client.py ：处理以下内容的主客户端：

  • Gemini AI 集成
  • 查询处理
  • 工具执行
  • Word 可视化

• math_agent_server.py ：提供以下内容的服务：

  • 数学工具
  • Word 集成工具
  • 资源处理程序

错误处理

• 为 AI 生成提供超时保护
• 对工具执行进行稳健的错误处理
• 自动重置状态
• 调试日志记录

日志记录

• 所有操作都会记录时间戳
• 日志级别：INFO、DEBUG、ERROR
• 日志会包含在电子邮件报告中
• 通过控制台输出进行实时监控

故障排除

邮件配置

• 确保 GMAIL_USER 是完整的电子邮件地址
• GMAIL_APP_PASSWORD 必须是 16 个字符的应用专用密码
• 在 Google 帐户中启用两步验证
• 查看执行日志中的详细错误消息

Word 集成

• 确保已安装并运行 Microsoft Word
• 如果出现提示，请允许自动化权限
• 查看执行日志中的自动化错误

常见问题

• 如果未检测到环境变量，请尝试重启终端
• 如果遇到 Word 自动化问题，请确保 Word 未处于全屏模式
• 查看控制台输出中的详细错误消息和堆栈跟踪

限制

• 需要 macOS 环境
• 必须安装适用于 macOS 的 Microsoft Word
• 每个问题最多迭代 8 次
• 需要访问 Google Cloud API