AIエージェントによるメールの二重送信を防ぐ方法
再試行は避けられません。MCPEmailsのべき等性キーが、AIエージェントによる送信、返信、転送、下書きの送信、予約送信の重複をどう防ぐかを解説します。
タイムアウトは、必ずしもメールの送信失敗を意味しません。接続が切れる直前に、プロバイダーがメッセージを受け付けていることもあります。エージェントが何も考えずに再試行すれば、1人の顧客に同じメールが2通届くことになります。どんなワークフローでも気まずい結果ですし、営業、サポート、請求の場面では深刻な問題です。
MCPEmailsは送信系の操作でべき等性キー(idempotency key)に対応しています。論理的に1回の送信に一意のキーを付けておけば、同じキーでの再試行は「もう一度送る許可」ではなく「同じリクエスト」として認識されます。
べき等性を普通の言葉で言うと
べき等性とは、要するに再試行しても安全ということです。送ろうとするメッセージに短い一意の値を添えます。クライアントがまったく同じ操作を再試行する必要があるときは、同じ値をもう一度送ります。これでMCPEmailsは、「すでに始めた送信を再試行してほしい」と「別のメールを送ってほしい」を区別できます。
これは新規メール、返信、転送、保存した下書きの送信、予約送信の作成に適用されます。リクエストがタイムアウトしたり、再起動したり、複数回配送されたりしうる環境でエージェントが動いているときに、特に価値があります。
エージェントのワークフローでの正しいパターン
べき等性キーは、ネットワークの試行ごとではなく、ユーザーから見える操作1つにつき1つ作ります。たとえば次のようにです。
- エージェントが特定のサポートチケットへの返信を用意する。
- ワークフローがその返信に一意のべき等性キーを1つ与える。
- 最初のリクエストが正常に完了すれば、送信は完了。
- 明確な結果を受け取れず再試行が必要になったら、同じキーと変更していないメッセージ内容で再試行する。
修正したメッセージにキーを使い回さないでください。件名、本文、宛先など意味のある部分を変えたなら、それは新しい論理的な操作として扱い、新しいキーを使います。こうすれば、再試行の安全を保ちながら、更新したメッセージを意図して送ることもできます。
再試行時に何が起きるか
MCPEmailsは送信リクエストの状態を24時間記憶します。べき等性の記録にメール本文を保存するのではなく、保護されたダイジェストを使います。同じキーと同じ内容の繰り返しのリクエストは、完了済み、または処理中として認識されます。
同じキーに異なるメッセージ内容が組み合わされた場合、MCPEmailsはどちらの版を意図したか推測せず、競合(conflict)を返します。そしてプロバイダー側の結果が本当に不確かなときも、製品は慎重な側に倒します。不確かさを2通目の送信に変えることはしません。
これが正しいトレードオフです。ワークフローは必要なときに人の判断を仰げばよいのであって、誰かに2回メールを送ることで不確かさを「解決」すべきではありません。
べき等性と人の承認は補い合う
べき等性は意図しない重複を防ぎます。承認は、慎重に扱うべきメッセージがそもそも受信トレイから出てよいかを制御します。別々の問題を解決するもので、組み合わせるとうまく働きます。
たとえば営業アシスタントは、フォローアップを下書きして人の承認に回し、リクエストが処理される間も再試行に安全な同じ識別子を保ち続けられます。確認する人が見るのは、提案された1通のメッセージであって、重複した試行の山ではありません。
信頼性は受信者に見せない
受信者は、エージェントがリクエストを再試行したことを知る必要はまったくありません。見るべきなのは、正しいスレッドに、正しいタイミングで届いた、よく考えられた1通のメッセージだけです。MCPEmailsは返信のスレッドも維持するので、返信は並行した別のメールの連鎖を生むのではなく、元の会話に留まります。
小さな製品上の細部ですが、信頼への見返りは大きいものです。一時的なネットワークの不調のたびに新しい運用の負担を抱え込むことなく、AIエージェントを本物の受信トレイの仕事に使えます。
最初の送信ワークフローを作っているなら、下書きと確認のステップから始めてください。メッセージの重要度が高いなら、その受信トレイで承認必須の送信を有効にします。再試行の安全は、ワークフローが必要とするときにはすでにそこにあります。重複防止のためのツールを別に揃える必要はありません。