AI ジョブが空の回答や短すぎる回答を返したときにアラートを受け取る
モデルの呼び出しは返ってきて、スクリプトは 0 で終了したのに、今朝の要約は空でした。あるいは、いつもは 1 ページあるのに 1 行だけでした。何も失敗していないので、アラートも出ません。対処法は 0 行のロードと同じです。実行のたびに数値を送り、いつもの値と比べます。
空の回答が成功に見える理由
- クォータやクレジットが尽きると、ツールやラッパーによってはエラーではなく、終了コード 0 で空の回答を返します。ある開発者のエージェントはまさにそうなりました(DEV Community、2026年)。
- 夜中にクラッシュするより空のレポートのほうがましだと考えて、スクリプトが API のエラーを捕まえ、空のファイルを書いて処理を続けます。
- プロンプトへの入力が空だった(新しいチケットがない、エクスポートが空)ため、モデルには要約するものがなく、1 行でそう答えました。
- 回答が途中で切れたかフィルタされ、スクリプトは返ってきたものをそのまま保存しました。
使い切ったクォータは、再試行しても解決しません。OpenAI と Claude の API ドキュメントはどちらも、こうしたエラーは上限やクレジットが変わるまで失敗し続けると書いています。
回答の長さを送る
回答の文字数を、終了時の ping で独自の数値として送ります。下の Python コードはそれを chars として送ります(answer はあなたの変数に置き換えてください)。
# --- 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 ---
from datetime import date
df = [{}] # 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("", {"chars": float(len(answer))})アプリでは、ジョブの Code(コード)タブに、your-job-id の代わりにそのジョブ自身のアドレスが入ったこのコードが表示されます。不要な部分はチェックを外せます。
次に、ジョブのページでルールを 2 つ追加します。
- chars is below X(chars が X 未満)で X = 1:空の回答はすぐに Odd data(異常データ)になります。
- chars drops more than X% below the recent average(chars が最近の平均より X% 以上下がる)で、たとえば 60%:いつもの 1 ページではなく 1 行だけの回答を捕まえます。
代わりに、あるいは併せて、別の数値を送ることもできます。ジョブが処理した件数、分類した行数、書き出したファイルのサイズなどです。独自の数値に対するルールは Pro の機能です(現在は誰でも利用できます)。独自の数値をご覧ください。
ジョブの Code(コード)タブにある Copy prompt for your AI(AI 用のプロンプトをコピー)を使うと、ChatGPT、Claude、Copilot 向けに、これらの行をスクリプトに追加するメッセージがそのまま手に入ります。実行する前に結果を確認してください。
TaskBeacon を使わない場合
ジョブの中で回答をチェックします。空か、決めた最小値より短ければ 0 以外のコードで終了し、スケジューラーに失敗として報告させます。固定の最小値は簡単です。「いつもよりずっと短い」を判断するには、過去の長さをどこかに保存して平均を出す必要があり、さらに知らせてくれる仕組みも必要です。関連:失敗する実行や始まらない実行については定期実行の AI エージェントを監視するをご覧ください。
Claude や ChatGPT を TaskBeacon に接続していますか?「昨夜失敗したのは何で、原因は?」と聞けば、あなたのジョブをもとに答えてくれます。その仕組みをご覧ください。
関連ページ
- 定期実行の AI エージェントや LLM ジョブを監視するAI ジョブは「成功」しても何もしていないことがあります。
- ジョブの読み込みが 0 行、または通常よりはるかに少ないときにアラートを受け取る終了コード 0 は、何行届いたかについて何も語りません。
- 日次のテーブルやファイルが新しいことを確認する「成功」したのに、昨日のデータをもう一度読み込んだだけの処理。
TaskBeacon は無料で始められます。現在はすべての機能が使え、クレジットカードも不要です。ジョブを作成してコードを貼り付ければ、最初の ping がジョブのページに表示されます。
無料で始める ライブデモを見る出典
- DEV Community:モデルは動いたのに、cron ジョブが AI エージェントを止めかけた話(終了コード 0 で空の回答) (2026-05-21)
- OpenAI API ドキュメント:エラーコード(クォータやクレジットのエラーは再試行しても直らない) (日付なし、2026年11月12日に確認)
- Claude API ドキュメント:HTTP エラー(利用上限による 429 は、アクセスが再開されるまで失敗し続ける) (日付なし、2026年11月12日に確認)
このページは 2026年11月9日 に出典と照合しました。他社製品のメニューや制限は変わります。ここに書かれていることが合わなくなっていたら、support@taskbeacon.io までお知らせください。