DispatchMail：AIを活用したローカルEメールアシスタント

DispatchMailはオープンソースのAIメールアシスタントで、ローカルコンピューター上で動作し、ユーザーのメール管理を支援する。 このプロジェクトは、AIが電子メールを処理する際の人間の共同パートナーとして機能することを念頭に設計されている。ユーザーのメールアカウント（現在はGmailがサポートされている）に接続し、ユーザーが設定したプロンプト（催促）に基づいてメールを監視・処理することでこれを実現する。DispatchMailの中核機能は、AI（現在はOpenAI APIを通じて）を使ってメールの分類、アーカイブ、下書きの生成などのタスクを自動化することだ。ローカルで動作するウェブインターフェースを提供し、ユーザーはそこでメールを管理し、AIが生成した下書きや指示を確認することができる。すべてのデータはローカルのSQLiteデータベースに保存され、ユーザーのプライバシーとデータの安全性を確保している。このプロジェクトは現在、初期のアルファ・プロトタイプの段階にあり、実験や修正を希望する開発者を対象としており、コミュニティからのフィードバックや貢献を歓迎している。

機能一覧

• AIメール処理OpenAIと連携することで、ユーザーが設定した指示に基づいてメールを自動処理します。
• ローカル・ウェブ・インターフェイス受信トレイ、下書き、AIコマンドを管理するためのローカルで動作するウェブアプリケーションを提供します。
• メールフィルタリングルールユーザーは、AIがアクセスし処理できるメールの範囲を正確に制御するために、ホワイトリストのルールをカスタマイズすることができます。
• 原稿の自動生成AIは、指示に基づいて電子メールの返信原稿を自動的に作成することができる。
• 自動メール処理:: メッセージに自動的にラベルを付けたり、アーカイブする機能。
• ローカル・データ・ストレージユーザーのメールコンテンツ、認証情報、設定はSQLiteデータベースにローカルに保存され、クラウドサービスには依存しません。
• 送信者深度分析大規模な言語モデルを使って、送信者の詳細な背景情報を調査することができます。

ヘルプの使用

DispatchMailは開発者向けの初期のプロトタイププロジェクトであり、インストールと実行を成功させるためにはある程度の技術的背景が必要です。以下はインストールと使用の詳細な手順です。

事前準備

インストールを開始する前に、システムが以下の条件を満たしていることを確認してください：

1. パイソンバージョン3.8以上が必要です。
2. Node.jsウェブインターフェースを実行するには、バージョン16以上が必要です。
3. GmailアカウントGmailアカウントは2段階認証（2FA）がオンになっている必要があります。
4. OpenAI APIキーAIの機能はOpenAIのアカウントとAPIキーの生成に依存します。

設置プロセス

1. コードベースのクローン:
   ターミナル（コマンドラインツール）を開いてgitコマンドを使って、プロジェクトのコードをGitHubからローカル・コンピューターにクローンする。

   git clone https://github.com/dbish/DispatchMail.git
   cd DispatchMail
   

2. インストール・スクリプトの実行:
   このプロジェクトは便利なインストールスクリプトを提供するsetup.pyセットアップのほとんどを自動で行ってくれる。

   python setup.py
   

   このスクリプトは以下のアクションを実行する：

   • Pythonバックエンドの依存関係をすべてインストールする。
   • ローカルのSQLiteデータベース(dmail.db).
   • 設定ファイルのサンプルを作成する。
   • アカウントの基本設定をご案内します。
3. コンフィギュレーション・バウチャー:
   • OpenAI API キーを設定するファイルを探して開く web-app/api/credentials.pyOpenAI API キーを入力してください。

     OPENAI_API_KEY = 'your-openai-api-key'
     

   • Gmailアプリケーションのパスワードを設定する2FAを有効にしている場合、Gmailのログインパスワードをそのまま使用することはできません。DispatchMail専用の「アプリケーションパスワード」を生成する必要があります。
     • Googleアカウントのセキュリティページにアクセスする： https://support.google.com/mail/answer/185833
     • Application Passwords "セクションで、アプリケーションとして "Mail "を選択し、デバイスとして "Other (custom name) "を選択し、名前を付けます（例："DispatchMail"）。"DispatchMail"）。
     • Googleが16桁のパスワードを生成しますので、すぐにコピーして大切に保管してください。このパスワードは次回以降のアカウント設定で使用されます。

サービス開始

DispatchMailはバックエンドのAPIとフロントエンドのインターフェイスから構成されており、別々に起動する必要があります。

• オプションA：スタートアップスクリプトを使用する（推奨）
  このプロジェクトはstart.pyスクリプトは、必要なすべてのサービスを一度に開始する。

  python start.py
  

• オプションB：手動でサービスを開始する
  より良いコントロールやデバッグが必要な場合は、手動で起動することができる。ターミナル・ウィンドウを2つ開く必要がある。
  • ターミナル1：バックエンドAPIの起動

    cd web-app
    python api/api.py
    

    デフォルトでは、バックエンドAPIは http://localhost:5000.

  • ターミナル 2: フロントエンド・インターフェースの起動

    cd web-app
    npm run dev
    

    フロントエンド開発サーバーは http://localhost:5173.

使用方法

1. メールボックスアカウントの設定:
   サービス開始後 http://localhost:5173.設定画面が表示されるので、Gmailアドレス、IMAPサーバーアドレス(imap.gmail.com)と、先ほど生成した16桁のアプリパスワードを入力します。
2. メールフィルタリングルールの設定:
   ウェブインターフェースの設定エリアでは、AIが処理できるメールを決定するホワイトリストを設定できます。これにより、AIがすべてのメールを処理することを防ぎ、プライバシーを保護します。送信者のアドレス、メールの件名に含まれるキーワード、または自然言語（「同僚からのメールのみ処理する」など）に基づいてルールを設定できます。
3. カスタムAIプロンプト（プロンプト）:
   これはDispatchMailの最も中心的な部分です。AIにメールをどのように分析し、処理するかを指示する必要があります。
   • リーディング・プロンプトAIにメールの読み方を指示する。例えば、AIにメールの緊急度を判断させたり、メールの要点を要約させたり、メール内のタスクを抽出させたりすることができる。
   • 草稿プロンプトAIにどのように返信の草稿を作成するかを指示する。例えば、「そのメールが会議への招待であれば、招待を受け入れる丁寧な返事を作成する。
4. 郵便物の処理:
   設定が完了すると、システムは自動的にGmailアカウントから新しいメールを取得します。ホワイトリストのルールを満たしたメールは、処理のためにOpenAIに送信されます。処理後、AIが生成したラベル、サマリー、返信草稿をウェブインターフェースで見ることができます。これらの下書きを確認、修正、送信することができます。

アプリケーションシナリオ

1. 郵便物の自動仕分けと要約
   毎日大量のメールを受信するユーザーのために、DispatchMailを設定することで、すべての新しいメールを読み、内容（例えば、プロジェクト名、送信者との関係）に基づいたタグを自動的に追加し、長いメールには1文の要約を生成することで、ユーザーがメールの核となる内容を素早く理解し、処理の優先順位を決めることができます。
2. 初動対応の自動化
   カスタマーサポートや営業チームに対しては、AIが一般的な顧客からの問い合わせに自動的に対応できるようにルールを設定することができる。例えば、商品の価格に関するメールを受信した場合、AIはあらかじめ設定されたプロンプトワードに基づき、価格リストへのリンクを含む下書きメールを自動生成し、手動によるレビューを待って、ワンクリックで送信することができます。
3. タスクと情報抽出
   研究者や学生は、DispatchMailを使って、購読している学術通知メールを監視することができる。AIコマンドを設定することで、メールから締切日、学会会場、論文題目などの重要な情報を抽出し、ユーザーが統一した記録を残せるように一定のフォーマットに整理するよう要求することができる。
4. 開発者としてのAI実験プラットフォーム
   AIエージェントアプリケーションを学びたい開発者のために、DispatchMailは完全なローカルランタイム環境を提供します。開発者はagent.pyドキュメントを作成したり、さまざまな言語モデルを試したり、Chain-of-thoughtをAIに適応させたり、新しいツールを統合したり、AIアプリケーション開発の理想的なテスト場として利用できる。

品質保証

1. このプログラムは無料ですか？
   DispatchMailプロジェクト自体はオープンソースで無料です。ただし、AI機能を提供するためにOpenAIのAPIに依存しているため、OpenAIのAPIを使用することで発生するコストを支払う必要があります。
2. 私のEメールデータは安全ですか？
   このプロジェクトの大きな特徴のひとつは、Eメールの内容やアカウント認証情報を含むすべてのデータが、ローカル・コンピューター上のSQLiteデータベースに保存されることだ。データはサードパーティのクラウドサーバーにはアップロードされないため、プライバシーとセキュリティが確保される。ただし、ローカルに保存されたcredentials.pyファイルおよびデータベース・ファイル。
3. なぜGmailのパスワードではなく「アプリパスワード」を使う必要があるのですか？
   これは、Gmailアカウントのセキュリティ対策である2段階認証（2FA）がオンになっているためです。アプリパスワードは、非公式アプリでアカウントにサインインする必要があるユーザーにグーグルが提供するワンタイムパスワードで、マスターパスワードを明かすことなくアプリがデータにアクセスできるため、セキュリティが向上する。
4. プロジェクトは現在どの段階にあるのか？日々の生産環境で使用できますか？
   このプロジェクトは現在、初期のアルファ・プロトタイプの段階にある。このプロジェクトは主に、物事を弄ぶのが好きな開発者向けに設計されており、機能は不安定で、重要な本番環境で直接使用することは推奨されないかもしれません。