Mail Agent

Gmail向けAI自動返信システム - Google Apps Script + OpenAI API

概要

このプロジェクトは、Gmailで受信したメールに対してOpenAI APIを使用して自動で返信を生成・送信するシステムです。TypeScriptとGoogle Apps Scriptを使用して実装されています。

主な機能

• メール受信の自動検知
• OpenAI APIを使用した返信文の生成
• Google Spreadsheetへのログ記録
• Webダッシュボード（開発予定）

技術スタック

• Google Apps Script (GAS)
• TypeScript
• clasp (Google Apps Script CLI)
• OpenAI API
• Google Spreadsheet

セットアップ

1. 必要なパッケージのインストール bash npm install

bash clasp login clasp create --type standalone --title "Mail Agent" --rootDir ./dist

3. 環境設定

• Google Apps Scriptのプロジェクト設定で必要なスコープを有効化
• スクリプトプロパティに必要な設定値を追加

Google Apps Scriptのプロジェクト設定

1. Google Apps Scriptでプロジェクトを開く

2. 左メニューの「プロジェクトの設定」をクリック

3. 「スクリプトプロパティ」セクションで以下の値を設定:

   • EMAIL_ADDRESS: メールアドレス
   • EMAIL_PASSWORD: メールパスワード
   • SPREADSHEET_URL: スプレッドシートのURL
   • OPENAI_API_KEY: OpenAI APIキー
   • OPENAI_MODEL: 使用するモデル名（例: o3-mini）

4. デプロイ

bash npm run deploy

5. 初期設定の実行

• Google Apps Scriptエディタでsetup()関数を実行

プロジェクト構成

mail-agent/ ├── src/ # ソースコード │ ├── Code.ts # メインスクリプト │ ├── Config.ts # 設定管理 │ ├── EmailService.ts # メール処理 │ └── OpenAIService.ts # OpenAI API連携 ├── docs/ # ドキュメント ├── dist/ # ビルド出力 └── package.json # npm設定

ドキュメント

詳細な仕様や設計については、docsディレクトリを参照してください。

ライセンス

MIT

作者

tsubouchi