AIエージェントの二重実行を防ぐ手順|鍵に日付を入れると翌日また登録

この記事でわかること
- 決めた時刻に動かす仕組みは、同じ回を2回起こすことがある。 Google Cloud Scheduler は「同じ回に対して複数回動くことがある」、Kubernetes は「2つ作られることも、1つも作られないこともある」と公式に書き、どちらも処理の側で二重を防ぐよう求めている。
- 架空の請求書2件の取り込みを、同じ時刻の起動として2つ同時に走らせた。鍵なしでは4行登録し、鍵を付けると2行のままだった。
- 鍵に日付を入れると、受信箱に残った同じ請求書を翌日もう一度登録した。 鍵は「何を1回だけにしたいか」で作る。請求書なら請求書の番号、日報なら日付。
- 途中で落ちた回の鍵は「開始」だけが残る。この鍵は自動でやり直さず、人が台帳を見て決める。
決めた時刻にAIエージェントを動かすと、同じ回が2回起動することがあります。AIの判断の誤りではなく、起動の仕組みの側の性質で、主な仕組みの公式ドキュメントは「2回届くことがある」前提で書かれています。
防ぎ方は3つです。仕事1件ごとに鍵を決める、始める前にその鍵を書き込む、終わったら完了を書く。架空の請求書の取り込みで試すと、同じ時刻の起動を2つ同時に走らせても、登録は2件のままでした。ただし、鍵に日付を入れると、受信箱に残っていた同じ請求書を翌日もう一度登録しました。 鍵の中身で、防げるものが変わります。
AIエージェントの二重実行は、起動の仕組みの側で起きる
定時の起動に使われる仕組みは、どれも「取りこぼすより、2回届くほうを選ぶ」作りです。
| 仕組み | 公式ドキュメントの記載 |
|---|---|
| Google Cloud Scheduler | 少なくとも1回届ける設計で、1回の予定に対して複数回動くことがある。処理する側は何度動いても結果が同じになるように作る |
| Kubernetes の CronJob | 予定1回につきおおよそ1回の処理を作るが、2つ作られることも、1つも作られないこともある。処理は冪等(何度やっても同じ結果)にする |
| Amazon EventBridge Scheduler | 少なくとも1回は届ける(at-least-once) |
Google Cloud Scheduler は、二重を見分ける手がかりとして、ジョブの名前と予定時刻を依頼に付けて送ると書いています。つまり「同じ回かどうか」は受け取る側で見分ける前提です。
前の回が終わらないうちに次の回が始まる「重なり」は、別の話です。重なりの防ぎ方はAIエージェントのスケジュール実行に書きました。この記事で扱うのは、同じ回が2回届いたときです。AIから見ると、2回目に来た請求書も未処理の請求書に見えます。だから防ぐのはAIへの指示ではなく、AIの外側の仕組みです。
準備|「1回だけ」にしたい単位を先に決める
最初に決めるのは、何を1回だけにしたいかです。ここを決めずに鍵を作ると、後で書くとおり、防いだつもりで防げていないことが起きます。
- 請求書の取り込み:1回だけにしたいのは請求書1通
- 毎朝の売上の集計:1回だけにしたいのは1日分の集計
- 取引先への定期の連絡:1回だけにしたいのはその月のその相手への1通
試すときの請求書や取引先は、架空のものにします。社内のどの情報をAIに渡してよいかの線引きは、生成AIの社内ルールの作り方にまとめています。
二重実行を防ぐ3つの手順
架空の請求書2通(架空商事 55,000円・サンプル工業 132,000円)を取り込む処理を Node.js で書き、9時の起動が2回届いた状況を、同じ予定時刻の処理を2つ同時に走らせて再現しました。AIが請求書を読む部分は固定の処理に置き換えています。二重を防ぐ仕組みはAIの外側にあるので、そこだけを試しました。
① 仕事1件ごとに鍵を決める。 試した鍵は invoice-import|2026-11-16T09:00:00+09:00|INV-001 の形で、処理の名前・予定時刻・請求書の番号をつないだものです。
② 処理を始める前に、鍵を書き込む。 書き込みは「まだ無ければ作る、あれば失敗する」形にします。2つの処理が同時に来ても、書き込めるのは片方だけです。書き込めなかった側は、その請求書を飛ばします。データベースなら、鍵の列に重複を許さない制約を付けると同じ働きになります。
③ 終わったら、同じ鍵に完了を書く。
結果は次のとおりです。
鍵なし
1回目: INV-001: 登録 / INV-002: 登録
2回目: INV-001: 登録 / INV-002: 登録
台帳の行数: 4
鍵あり
1回目: INV-001: 登録 / INV-002: 飛ばす(鍵あり=started)
2回目: INV-001: 飛ばす(鍵あり=started) / INV-002: 登録
台帳の行数: 2
鍵なしでは、2通の請求書が2行ずつ、4行登録されました。鍵ありでは、2つの処理が1通ずつを受け持つ形になり、台帳は2行のままです。
鍵に日付を入れると、翌日また登録した
①の鍵には予定時刻が入っています。同じ回が2回届く問題はこれで防げました。では、翌日の9時の回はどうか。受信箱から請求書を消し忘れて、同じ2通が残っていた場合で試しました。
鍵=日付+請求書番号
11/16: INV-001:登録 INV-002:登録 / 11/17: INV-001:登録 INV-002:登録 / 登録 4行
鍵=請求書番号だけ
11/16: INV-001:登録 INV-002:登録 / 11/17: INV-001:飛ばす INV-002:飛ばす / 登録 2行
日付の入った鍵は、翌日には別の鍵になります。だから同じ請求書をもう一度登録しました。請求書の取り込みで1回だけにしたいのは請求書1通なので、鍵は請求書の番号(送り主と番号の組)だけで作るのが合っています。 反対に、毎朝の集計のように「1日に1回」が単位の仕事なら、鍵は日付です。
鍵の中身は、準備で決めた「1回だけにしたい単位」をそのまま書いたものになります。
人が確かめる場所|開始だけで完了が無い鍵
もう1つ、1通目を登録した直後に処理が落ちた場合を試しました。
1回目: INV-001: 登録 / (ここで落ちた)
再実行: INV-001: 飛ばす(鍵あり=started) / INV-002: 登録
開始だけで完了が無い鍵: invoice-import|2026-11-16T09:00:00+09:00|INV-001
やり直した回は、開始の書かれた1通目を飛ばし、2通目だけを登録しました。二重にはなりません。ただ、1通目には開始だけが残り、完了がありません。 今回は登録が済んでいましたが、登録の前に落ちていれば、同じ形のまま未登録になります。鍵だけでは、どちらか分かりません。
私なら、ここを人が確かめる場所にします。開始から一定の時間がたっても完了の無い鍵を毎朝一覧にして担当者に知らせ、担当者が台帳を見て、登録済みなら完了を書き、未登録なら鍵を消して次の回に任せます。この鍵を自動でやり直させると、登録済みの請求書をもう一度登録する道が開きます。
判定表|鍵の作り方と、人が確かめるところ
| 仕事の例 | 1回だけにしたい単位 | 鍵 | 人が確かめるところ |
|---|---|---|---|
| 請求書の取り込み | 請求書1通 | 送り主+請求書の番号 | 開始だけで完了の無い鍵/番号の無い請求書 |
| 毎朝の売上の集計 | 1日分 | 処理の名前+日付 | 前日分の完了が無い朝 |
| 取引先への定期の連絡 | その月・その相手への1通 | 処理の名前+年月+相手 | 送る前の文面(送信は人が押す) |
| 受注メールの登録 | メール1通 | メールのID | 同じ注文が別のメールで2回来たとき |
最後の行は、鍵では防げない二重です。お客様が同じ注文を2回送ってきたら、メールのIDは別なので、鍵は2つとも通します。ここは仕組みではなく人が見る場所として残します。
自社で作るのが大変なときの頼み先
鍵の書き込みや完了の記録は、AIに指示するのではなく、AIを動かす仕組みの側に作り込む部分です。社内に作れる人がいなければ、AIエージェントを作る会社に頼むことになります。頼む先を選ぶときに、人が止める場所を公式サイトに書いているかを見比べた記事がAIエージェント開発会社おすすめ6選です。人が止める場所の置き方そのものは、AIエージェントの暴走を止める方法に書いています。
任せる業務ごとに「1回だけの単位」を書き出すところから
二重を防ぐ仕組みは、任せる業務ごとに鍵の中身が変わります。どの業務をAIエージェントに任せるか、それぞれの1回の単位は何か、人が確かめるのはどこか。この3つを業務ごとに書き出すのが、作り始める前の一歩です。株式会社AIエージェント の進め方と、業務の切り出し方の考え方はサービス資料にまとめています。
出典
- Google Cloud「Cloud Scheduler overview」(2026年11月16日閲覧)——少なくとも1回届ける設計・1回の予定で複数回動くことがある・処理は冪等にする・ジョブ名と予定時刻のヘッダで二重を見分ける
- Kubernetes「CronJob」(2026年11月16日閲覧)——2つ作られることも1つも作られないこともある・処理は冪等にする
- Amazon Web Services「What is Amazon EventBridge Scheduler?」(2026年11月16日閲覧)——at-least-once で届ける
よくある質問
- AIエージェントが同じ処理を2回するのはなぜですか?
- 起動の仕組みが「少なくとも1回は動かす」作りだからです。Google Cloud Scheduler は応答が遅いときや通信が途切れたときに同じ回の依頼が重なることがあると書き、Kubernetes の CronJob も1回の予定で2つの処理が作られることがあると書いています。AIの判断ではなく、起動の側で起きます。
- 二重実行はどうやって防げばいいですか?
- 仕事1件ごとに鍵を決め、処理を始める前にその鍵を書き込み、書き込めなかったら飛ばします。終わったら同じ鍵に完了を書きます。架空の請求書2件で同じ時刻の起動を2つ同時に走らせると、鍵なしでは4行、鍵ありでは2行の登録でした。
- 鍵には何を使えばいいですか?
- 何を1回だけにしたいかで決めます。請求書の取り込みなら請求書の番号、毎日の集計なら日付です。請求書の取り込みに日付と番号の組を使うと、受信箱に残った同じ請求書を翌日もう一度登録しました。
- 途中で止まった処理は、自動でやり直してよいですか?
- 私なら自動ではやり直しません。開始だけが書かれて完了が無い鍵は、登録が済んだのか済んでいないのか、鍵だけでは分からないからです。台帳を人が見て、済んでいれば完了を書き、済んでいなければ鍵を消してから次の回に任せます。
この記事は、旧サイト(www.stellacreation.com)にも同じ内容で掲載しています。旧サイトで読む