ツールのエラー処理

約5分

ツールが失敗したときにAIが暴走したり黙って進んだりする問題を防ぎたい方

ツールは必ず失敗します。エラー処理を設計していないと、AIは失敗に気づかずに進むか、同じ実行を延々と繰り返します。

エラーメッセージは次の行動の手がかりにする

AIにとってエラーメッセージは、次に何をするかを決める入力です。原因だけでなく、取れる選択肢まで含めます。

# 手がかりのない例
Error: failed

# 手がかりのある例
Error: ファイル 'config/settings.json' が見つかりません。
パスを確認するか、list_files でディレクトリの内容を確認してください。

内部のスタックトレースをそのまま返すのは避けます。情報量は多くても、次の行動につながりません。

もっとも危険なのは、失敗したのに正常な形の結果を返す設計です。

設計	AIの解釈	結果
失敗時に空配列を返す	「該当なし」と判断する	誤った結論のまま進む
失敗時にエラーを返す	失敗を認識する	再試行または人へ引き渡す

「見つからなかった」と「取得に失敗した」は別の状態です。区別できる形で返します。

すべてのエラーがリトライで解決するわけではありません。

権限不足を何度も再試行しても結果は変わりません。リトライして意味があるのは一時的な障害だけです。

リトライ回数には上限を設け、超えたら自動で続けずに人へ引き渡します。上限がないと、自己修正のループと組み合わさって、同じ失敗を長時間繰り返すことがあります。