AIに「実行失敗」と表示されたら、なぜそのまま再試行してはいけないのか?

AIツールのタイムアウトは、操作が未実行である証拠ではありません。冪等性、結果確認、対象別の記録から安全な再開を考えます。

AIに記事の保存を頼み、しばらく待つと、画面に「リクエストがタイムアウトしました」と表示されました。あなたはそのまま「もう一度試して」と返します。

2回目は順調に終わりました。しかし管理画面を開くと、同じ内容の下書きが2件できています。

これは仮定の場面ですが、実際の技術的な問題に対応しています。ツールが結果を受け取れなかったことは、リモート側で処理が実行されなかったことを意味しません。 AIがウェブサイトを操作し、APIを呼び出し、リソースを作成するようになると、この違いが結果に直接影響します。

前回の「AIに渡すコンテキストは、多ければ多いほど回答がよくなるのか?」では、長いタスクをどう引き継ぐかを取り上げました。今回はその続きとして、引き継ぎ記録に「失敗」とあったとき、引き継いだAIはやり直すべきなのか、それとも先に確認すべきなのかを考えます。

タイムアウトからわかるのは、こちら側が結果を待ちきれなかったことだけ

下書きの保存には、少なくともいくつかの段階があります。クライアントがリクエストを送り、プラットフォームが受け取って処理し、結果を返し、クライアントがそれを受け取って記録します。

「リクエストがタイムアウトしました」は、異なる段階で起こりえます。リクエストがそもそも届いていなければ、何も作成されていないかもしれません。一方で、下書きは保存されたものの、応答が戻る途中で接続が切れた可能性もあります。処理がまだ続いているのに、クライアントが待つのをやめた場合もあります。

この表示だけでは、どの場合なのか区別できません。

AWSは安全な再試行の説明で、クラウドインスタンスの作成を例に挙げています。呼び出し側が応答を受け取れないと、インスタンスが作成済みか判断できません。そのまま再試行すると複数のインスタンスができる可能性があるため、実際の状態を確認するか、APIが提供する冪等性を利用する必要があります。[1]

AIツールでも同じです。画面に表示された赤いエラーは、通信、結果の解析、待機中の問題を示しているだけで、業務上の操作がどうなったかを完全に表しているとは限りません。

そのため、私は記録を次のように分けて考えます。

得られている証拠 判断できること 次の対応
ローカルの検証で拒否され、未送信と明確にわかる 今回のリクエストは実行されていない 入力を修正して再送信する
リモート側が失敗を返し、変更が発生していないと明示している 今回は目標を達成していない エラーの原因に応じて対処する
タイムアウトや接続断で、リモート側の状態がわからない 結果は不明 既存の結果を照会するか、APIの取り決めに従って復旧する
オブジェクトのIDは返ったが、読み返していない 作成の応答は得ている IDを使ってオブジェクトと状態を確認する
オブジェクトを読み返し、本文と状態が想定どおり 該当する手順は完了している 結果を記録し、次の手順に進む

具体的なAPIには、部分的な成功や非同期ジョブなどの状態もありえます。その扱いは各APIのドキュメントに従ってください。この表の要点は、「結果不明」のための場所を設け、急いで「失敗」に分類しないことです。

「もう一度」が2つ目のオブジェクトを作ることもある

記事をもう一度読み取っても、通常は記事が増えません。しかし「下書きを作成」を繰り返すと、そのたびに新しいオブジェクトができる可能性があります。

技術的には、同じ操作を繰り返しても新たな業務上の副作用が生じない性質を「冪等性」と呼びます。ここで問題にしているのは最終的な影響であり、毎回の応答文が完全に同じである必要はありません。[1]

ただし、AIが「重複を避けます」と言っただけで、プラットフォームにその能力があると判断してはいけません。

冪等キーに対応したAPIもあります。呼び出し側が1回の業務操作に対して識別子を生成し、再試行時にも同じものを使うことで、サーバー側は「先ほどと同じ操作だ」と識別できます。StripeのAPIドキュメントにもこの仕組みが説明されています。接続エラーの後、冪等キーを使って作成や更新のリクエストを再試行することで、意図しない重複操作を避けられます。[2]

重要なのは、同じ操作の再試行には同じ識別子を使うことです。再試行のたびに新しいキーを生成すると、サーバー側は別々のリクエストとみなす可能性があります。逆に、ユーザーが同じ内容の下書きを本当に2件作りたい場合、本文が同じだからといって勝手に1件にまとめることもできません。AWSも、パラメーターが同じでも業務上の意図まで同じとは限らないと指摘しています。[1]

こうした保証には適用範囲と期限もあります。Stripe API v1を例にすると、ドキュメントでは、キーは少なくとも24時間保存された後に削除される場合があり、削除後に元のキーを再利用すると新たなリクエストとして処理される可能性があると説明されています。同じキーに対応するパラメーターも比較されます。再試行結果の扱いはv1とv2で異なるため、一方のバージョンの動作をすべてのAPIに共通するルールと考えることはできません。[2]

確認すべきなのは、対象のAPIが冪等性に対応しているか、どの操作に適用されるか、識別子がどれほど保持されるか、エラー後にどう復旧すべきかです。

冪等なAPIがなくても、まず結果を確認できる

管理画面をウェブ上で操作するしかない場合や、重複防止の仕組みが公開されていない場合も少なくありません。その場合は、再試行する前に、前回の結果をできるだけ探します。

下書きのIDが得られていれば、そのIDで読み取ります。ジョブのIDだけが残っていれば、ジョブの進捗を照会します。どちらもない場合に、アカウント、タイトル、作成時刻、本文、目的の状態を組み合わせて探します。

タイトルだけでは不十分です。同じ記事に旧版と改訂版があるかもしれませんし、最初から下書きが2件必要だったのかもしれません。同名のオブジェクトが見つかっても、それは手がかりにすぎず、直前に作成したものだとは断定できません。

同様に、一覧にまだ表示されないからといって、送信が失敗したとすぐに判断することもできません。リクエストが処理中かもしれず、照会画面に最新の結果がまだ反映されていない可能性もあります。「作成」を繰り返し押すのではなく、プラットフォームの説明に従って待つか、ジョブの状態を確認するべきです。

ここには見落としやすい境界もあります。「先に探し、なければ作成する」ことは、厳密な重複防止にはなりません。 2つの実行者が同時に「ない」と確認し、それぞれ1件ずつ作成する可能性があります。同じ対象への送信を複数のタスクが同時に行うことは、できる限り避けるべきです。システムとして保証する必要があるなら、サーバー側の冪等性、ユニーク制約、その他の調整手段に頼る必要があります。

最後まで確認できず、信頼できる重複防止の取り決めもないなら、その手順は「結果不明」のままにし、何を確認したかを記録します。不確かな状態で止めるほうが、2件目を作ってからどちらを削除すべきか推測するより対処しやすくなります。

複数プラットフォームのタスクでは、対象ごとに進捗を記録する

ウェブサイトに記事を正式公開し、WeChat公式アカウントと知乎(Zhihu)にそれぞれ下書きを1件保存するタスクを想定してください。

ウェブサイトでの公開が完了し、WeChat公式アカウントへの保存も成功した後、知乎への送信中に接続が切れました。ここで一連の処理を最初から実行すると、完了済みの2つの手順まで繰り返す可能性があります。

私は実行記録を対象ごとに分けます。ウェブサイトには記事のURLと公開ページの確認結果、WeChat公式アカウントには下書きのIDと読み返した結果、知乎には今回の送信状況と確認待ちの事項を記録します。それぞれに対応する記事の版も明記し、旧版の本文に対する応答を新版の証拠として扱わないようにします。

「保存成功」も具体的な目標に結びつける必要があります。ユーザーが下書きを求めたなら、下書きが存在し、内容が正しく、下書きの状態にあることを確認します。公開を求めたなら、公開ページやプラットフォーム上の正式な公開状態を確認します。保存の成功を、そのまま公開の成功とみなすことはできません。

こうした記録は、実行中に適宜保存するのが望ましいでしょう。タスク全体の終了後に「すべて完了」とだけ書く方法では、途中で中断したとき、復旧に最も必要な情報が残りません。

ただし、ローカルのログ自体も絶対的な保証ではありません。リモート側で成功してからローカルへの記録が完了するまでの間にも、中断は起こりえます。復旧時にはログとリモート側の状態を併せて確認し、ローカルに1行の記録がないというだけで、リモート側でも実行されていないと判断してはいけません。

タスクを再開するときは、指示をより具体的にできる

中断が起きたら、次のように伝えられます。

まず既存の実行記録を読み、各項目についてリモート側の状態を確認してください。完了と検証が済んだ手順は飛ばしてください。タイムアウトした手順や応答が残っていない手順は、先に結果を照会してください。未実行と確認できた場合、またはAPIが安全な再試行に明確に対応している場合に限り、再送信してください。最後に、完了・失敗・結果不明の項目をそれぞれ列挙してください。

この指示は処理の順序を明確にしますが、重複を防ぐ技術的な保証ではありません。ツールには状態を照会する能力が必要で、実行記録も保持されなければならず、API側の制約も残ります。

AIツールを開発しているなら、テスト環境で、リモート側で保存した後に応答が失われる場合、応答を受け取る前に終了する場合、2つの実行者が同じタスクを同時に復旧する場合を、個別に模擬できます。確認すべきなのは、オブジェクトが余分に作られないか、元の結果を識別できるか、報告が正確かです。この記事ではこうした障害テストを実施しておらず、特定のツールで重複操作が起こらないと保証するものでもありません。

利用者にとって最も大切な変化は小さなものです。「失敗」を見たら、まずどこで失敗したのかを確認すること。すでに完了した手順には、確認だけが残っている場合もあります。

参考資料

資料の確認日:2026年11月11日。本文中の下書きの場面、記録方法、指示文は設計上の例です。APIの動作については、該当する製品とバージョンのドキュメントに従ってください。

  1. AWS Builders’ Library:Making retries safe with idempotent APIs。応答の欠落、重複による副作用、呼び出し側のリクエスト識別子、パラメーターの変更、保持期間についての設計上の議論。
  2. Stripe API Reference:Idempotent requests。冪等キー、パラメーターの検証、API v1におけるキーの削除、v1とv2の動作の違いについての説明。

AI生成の概念図です。実測写真やネットワーク構成図ではありません。

コメント・議論

質問や実践の経験をお寄せください。コメントは承認後に表示されます。メールアドレスは公開されません。 コメントのプライバシー

コメントを読み込み中…