agentmail

agentmail

目的

このスキルを使うと、AI エージェントが AI による自動化を活用して、メールの分類、返信文の作成、送信予約など、メールを自律的に効率よく管理できます。

使用する場面

大量のメールを扱う受信トレイ、自動化されたカスタマーサポート、個人の生産性向上ワークフロー、または手動での介入を減らすためにメール関連タスクをより広範な AI エージェントの運用に組み込む場合に、このスキルを使用します。

主な機能

• 機械学習モデルを使って、内容、送信者、キーワードに基づいてメールを分類します。
• カスタマイズ可能なテンプレートやトーン調整を使って、返信メールを作成します。
• ユーザー定義のルールやカレンダー連携に基づいて、メールの送信やフォローアップを予約します。
• 基準に基づいて要約、優先順位付け、アーカイブを行い、メールスレッドを管理します。
• API を介してメールプロバイダーと連携し、リアルタイムで操作します。

使用パターン

agentmail を使用するには、CLI または API 呼び出しで起動し、メール ID や内容などの必要なパラメーターを渡します。API キーは必ず環境変数 $AGENTMAIL_API_KEY に設定してください。CLI では、認証フラグをコマンドの先頭に付けます。使用例：メールを取得して分類し、返信を作成した後、必要に応じて送信を予約します。スクリプト内でコマンドを連結して自動化できます。

主なコマンド／API

CLI コマンドには Node.js 環境が必要です。npm install agentmail-cli でインストールしてください。API エンドポイントは https://api.openclaw.com/agentmail/v1 配下にあります。

• メールを分類する:
  CLI: agentmail classify --email-id 12345 --key $AGENTMAIL_API_KEY
  API: JSON ボディを指定して POST /api/agentmail/classify を呼び出します：{"email_id": "12345", "api_key": "$AGENTMAIL_API_KEY"}
  コードスニペット：

  curl -X POST https://api.openclaw.com/agentmail/v1/classify \
  -H "Content-Type: application/json" \
  -d '{"email_id": "12345", "api_key": "'$AGENTMAIL_API_KEY'"}'
  

• 返信を作成する:
  CLI: agentmail draft --email-id 12345 --tone professional --key $AGENTMAIL_API_KEY
  API: ボディを指定して POST /api/agentmail/draft を呼び出します：{"email_id": "12345", "tone": "professional", "api_key": "$AGENTMAIL_API_KEY"}
  コードスニペット：

  const response = await fetch('https://api.openclaw.com/agentmail/v1/draft', {
    method: 'POST',
    headers: {'Content-Type': 'application/json'},
    body: JSON.stringify({email_id: '12345', tone: 'professional', api_key: process.env.AGENTMAIL_API_KEY})
  });
  

• メールの送信を予約する:
  CLI: agentmail schedule --email-content "Reply text" --send-at "2023-10-01T10:00:00Z" --key $AGENTMAIL_API_KEY
  API: ボディを指定して POST /api/agentmail/schedule を呼び出します：{"email_content": "Reply text", "send_at": "2023-10-01T10:00:00Z", "api_key": "$AGENTMAIL_API_KEY"}
  設定形式：送信予約のルールには JSON を使用します。例：{"rules": [{"condition": "priority>high", "action": "schedule in 2 hours"}]}。

連携に関する注意事項

設定ファイル（例：config.json: {"provider": "gmail", "token": "$GMAIL_TOKEN"}）で OAuth トークンを指定して、Gmail や Outlook などのメールサービスと agentmail を連携します。AI エージェントのワークフローでは、ウェブフックを使って新着メールをトリガーにします（例：POST to /api/agentmail/webhook）。API バージョンを合わせて互換性を確保し、Node.js v14+ などの依存関係にも対応してください。他のスキルと組み合わせるには、結果を JSON として出力し、次のコマンドに渡します。例：agentmail classify ... | jq '.category' | other-skill-process。

エラー処理

HTTP ステータスコードを確認してください。認証エラーは 401（$AGENTMAIL_API_KEY を使って再試行）、メールが見つからない場合は 404（記録してスキップ）、サーバーエラーは 500（指数バックオフ）です。CLI では --verbose フラグを使うと、詳細なログを確認できます。429 応答の後に 5 秒間スリープするなど、遅延を追加してレート制限などの一般的な問題に対処してください。呼び出し前に入力を検証します。たとえば、正規表現でメール ID が文字列であることを確認します：if (!emailId.match(/^\d+$/)) throw new Error('Invalid email ID');。スクリプトでは try-catch を使って、適切に復旧できるようにします。

具体的な使用例

1. サポートチケットのメールを分類して返信する： まず分類します：agentmail classify --email-id 67890 --key $AGENTMAIL_API_KEY。「support」と分類された場合は、下書きを作成します：agentmail draft --email-id 67890 --tone helpful --key $AGENTMAIL_API_KEY。次に送信を予約します：agentmail schedule --email-content $(cat response.txt) --send-at now --key $AGENTMAIL_API_KEY。これにより、ヘルプデスクのワークフローでチケットへの返信を自動化できます。

2. 個人メールの送信スケジュールを管理する： API 経由で未読メールを取得し、分類します：curl -X POST https://api.openclaw.com/agentmail/v1/classify -d '{"email_id": "54321", "api_key": "'$AGENTMAIL_API_KEY'"}'。優先度が高い場合は、下書きを作成して送信を予約します：agentmail draft --email-id 54321 --tone formal --key $AGENTMAIL_API_KEY; agentmail schedule --email-content "Follow up" --send-at "tomorrow" --key $AGENTMAIL_API_KEY。毎日のスクリプトで使用すれば、受信トレイをゼロに保てます。

グラフ上の関係

• 関連項目：email（直接）、ai（クラスター）、agent（クラスター）、automation（タグ）。
• 接続されたクラスター：community（このスキルと同じ）。
• 依存関係：入力の前処理には「email-parser」などのスキル、高度なタイミング設定には「scheduler」などのスキルが必要になる場合があります。