集成 Microsoft Word 和 Gmail 的数学代理

一个基于 Python 的数学代理，它使用各种数学工具迭代地解决问题，并使用 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 GMAIL_USER=your.email@gmail.com
export GMAIL_APP_PASSWORD=your16digitpassword

选项 2：创建一个 .env 文件：

GEMINI_API_KEY=your_api_key_here
GMAIL_USER=your.email@gmail.com
GMAIL_APP_PASSWORD=your16digitpassword

用法

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

python math_agent_client.py

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

1. 启动 MCP 服务器：

# 终端 1
python math_agent_server.py

# 终端 2
python math_agent_client.py

代理将：

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

示例查询

- 查找 INDIA 中字符的 ASCII 值，然后返回这些值的指数和
- 计算 5 的阶乘
- 查找前 10 个斐波那契数的总和

架构

• 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 访问