定期実行の AI エージェントや LLM ジョブを監視する
AI モデルを呼び出すスケジュールジョブが増えています。昨日のチケットを毎晩要約するジョブ、受信メールを仕分けるエージェント、新しい行の分類をモデルに依頼するスクリプトなどです。これらは無人で動くため、どれかが動かなくなっても、誰かが「レポートはどこ?」と尋ねるまで誰も気づきません。
AI ジョブが静かに失敗する理由
AI ジョブは、途中に壊れやすいステップを 1 つ含んだ普通のスケジュールスクリプトです。そのステップとは、モデルの API の呼び出しです。このステップは、スケジューラからは見えない形で失敗します。
- API が混雑している、または上限に達した。 モデルの提供元は「rate limit」(429)や「overloaded」(529、Claude API の場合)といったエラーを返します。多くのスクリプトはこのエラーを捕まえてログに記録し、正常終了してしまいます。
- クォータやクレジットが尽きた。 OpenAI と Claude API のドキュメントはどちらも、クレジットを追加するか上限を引き上げるまで、これらのエラーは失敗し続けると述べています。再試行しても解決しません。静かに再試行するジョブは、何週間も毎晩失敗し続けることがあります。
- 回答が空だった。 ある開発者は、クォータが尽きたときに終了コード 0 と空の応答を返したエージェントについて書いています。そのため周囲のすべてが、その実行を成功として扱いました(DEV Community、2026年)。
- ジョブが起動しなかった。 スケジューラの環境に API キーがない、シェルが違う、マシンがスリープしていた。SD Times はこれを最もよくあるケースだとし、「エージェントは失敗しているのではなく、動いていない」と表現しています(2026年)。
トレースツールや提供元のダッシュボードは、実際に行われた呼び出しを表示します。どちらも、行われなかった実行や、「成功」したのに何も生み出さなかった実行については教えてくれません。
ジョブ自身に実行を報告させる
スクリプトに数行を追加します。開始時の ping、終了時の ping、そしてモデルの呼び出し(あるいは他の何か)が失敗したときにエラーメッセージ付きで送る失敗の ping です。TaskBeacon はスケジュールを知っているので、ping がまったく届かないことにも気づきます。
# --- TaskBeacon: top of the script (standard library only) ---
import json, traceback, urllib.request
TB = "https://taskbeacon.io/ping/your-job-id"
def tb_ping(path="", data=None):
body = json.dumps(data).encode() if data else None
req = urllib.request.Request(TB + path, data=body, headers={"Content-Type": "application/json"})
try:
urllib.request.urlopen(req, timeout=10)
except Exception as e:
print("TaskBeacon ping failed:", e)
tb_ping("/start")
try:
# --- your code here ---
df = [1, 2, 3] # example data: replace with your own (e.g. pandas.read_csv)
except Exception as e:
# the error and the last 20 lines of the traceback go with the failure
tb_ping("/fail", {"error": f"{type(e).__name__}: {e}"[:200],
"log": "\n".join(traceback.format_exc().splitlines()[-20:])[-4000:]})
raise
# --- TaskBeacon: end of the script ---
tb_ping("", {"rows": len(df)})アプリでは、ジョブの Code(コード)タブに、your-job-id の代わりにそのジョブ自身のアドレスが入ったこのコードが表示されます。不要な部分はチェックを外せます。
次に、ジョブが仕事をしたことを示す数値を 1 つ追加します。たとえば、要約や分類をした件数、または回答の長さです。その数値にルールを設定すると、何も生み出さずに終わった実行が Odd data(異常データ)になります。空の回答や短すぎる回答のアラートを参照してください。
スクリプトを自分で編集したくない場合は? ジョブの Code(コード)タブで Copy prompt for your AI(AI 用のプロンプトをコピー)をクリックします。あなたのジョブ専用の行が入ったメッセージがコピーされます。それを ChatGPT、Claude または Copilot に貼り付け、最後にスクリプトを追加すると、アシスタントが ping を組み込んだスクリプトを返します。実行する前に結果を読んで確認してください。
得られるもの
- Failed(失敗): API の呼び出しが失敗し、スクリプトがそれを報告したとき、エラーテキスト付きで届きます。
- Missed(未実行): ジョブが予定の時刻に実行されなかったとき。まったく起動しなかった夜も含みます。
- Late(遅延): 実行が止まったままのとき。たとえば、応答が返ってこないモデル呼び出しなどです。
- Odd data(異常データ): 終了はしたものの、送った数値が 0 か、いつもよりずっと少ないとき。
TaskBeacon を使わない場合
ジョブがはっきりと失敗するようにします。API のエラーを握りつぶさず、モデルの呼び出しが失敗したときや回答が空のときは 0 以外のコードで終了し、スケジューラ自身のアラート機能に報告させます。使い切ったクォータに気づけるよう、提供元で利用額のアラートを設定します。それでも起動しなかった実行については、いつ実行されるべきだったかを知っている何かがジョブの外に必要です。これはスクリプトが自分ではできない部分です。
Claude や ChatGPT を TaskBeacon に接続していますか?「昨夜失敗したのは何で、原因は?」と聞けば、あなたのジョブをもとに答えてくれます。その仕組みをご覧ください。
関連ページ
- AI ジョブが空の回答や短すぎる回答を返したときにアラートを受け取る終了コード 0 でも回答が空なら、それは壊れた実行です。
- 定期ジョブがまったく実行されなかったことを知る行われなかった実行にはエラーがないため、アラートのきっかけがありません。
- Python の cron ジョブや定期スクリプトが失敗したときにアラートを受け取るcron が知らせるのは出力で、成功か失敗かではありません。Task Scheduler の 0x1 は誰も見ていません。
- 昨夜何が失敗したかを Claude や ChatGPT に質問する1 つの質問で、すべてのマシンのすべてのジョブがわかります。
TaskBeacon は無料で始められます。現在はすべての機能が使え、クレジットカードも不要です。ジョブを作成してコードを貼り付ければ、最初の ping がジョブのページに表示されます。
無料で始める ライブデモを見る出典
- Claude API ドキュメント:HTTP エラー(429 rate_limit_error、529 overloaded_error) (日付なし、2026年11月12日に確認)
- OpenAI API docs: Error codes(429 のレート制限とクォータ) (日付なし、2026年11月12日に確認)
- SD Times: Your agents aren't failing, they're not running (2026-08-03)
- DEV Community:モデルは動いたのに、cron ジョブが AI エージェントを止めかけた話 (2026-05-21)
このページは 2026年11月9日 に出典と照合しました。他社製品のメニューや制限は変わります。ここに書かれていることが合わなくなっていたら、support@taskbeacon.io までお知らせください。