Math Agent with Microsoft Word and Gmail Integration

Microsoft Word および Gmail 連携機能を備えた数学エージェント

さまざまな数学ツールを使用して問題を反復的に解き、Microsoft Word と Gmail を使って結果を可視化する Python ベースの数学エージェントです。

機能

• 数学演算

  • 基本的な算術（加算、減算、乗算、除算）
  • 高度な演算（べき乗、平方根、立方根）
  • 三角関数（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

エージェントは次の処理を行います：

• 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 アカウントで 2 段階認証を有効にしてください
• 詳細なエラーメッセージを確認するには、実行ログを確認してください

Word 連携

• Microsoft Word がインストールされ、起動していることを確認してください
• 求められた場合は、自動化のアクセス許可を与えてください
• 自動化エラーが発生していないか、実行ログを確認してください

よくある問題

• 環境変数が検出されない場合は、ターミナルを再起動してみてください
• Word の自動化に問題がある場合は、Word が全画面表示になっていないことを確認してください
• 詳細なエラーメッセージとスタックトレースについては、コンソール出力を確認してください

制限事項

• macOS 環境が必要です
• macOS 用 Microsoft Word がインストールされている必要があります
• 1 つの問題につき最大 8 回まで反復します
• Google Cloud API へのアクセスが必要です