Claudeエージェントの停止条件：回数だけでなく進捗と危険を監視する

成功の終了と上限による終了を分ける

必要な根拠が揃った、対象の更新が確認できた、といった成功条件を決めます。最大回数に到達して止まった場合は、成功として報告しません。保留が必要な場合も、何が不足しているかを残します。

回数だけでは一回が非常に長い処理を抑えられないため、時間や費用、外部操作の数などを組み合わせます。それぞれの上限を誰が判断するかも明確にします。

進捗が増えているかを見る

同じ検索と同じ結果が続く場合、呼び出し回数は増えても仕事は進んでいません。取得した新情報、解決した確認事項、対象状態の変化を追います。進捗を文章の長さや自己申告だけで判断しないようにします。

同じツール引数の反復が必要な業務もあるため、単純な一致だけで異常と決めないことも重要です。待機中の状態確認と、無意味な再探索を区別します。

停止時に実行済みを報告する

途中で止まっても、既に行った更新が消えるとは限りません。読み取った情報、実行した操作、確認できた結果、未完了の仕事を分けます。次回の再開が同じ更新を二重実行しないよう、操作IDを保持します。

進捗を成果物と未解決事項で表す

「もう少し調べます」という発言が続くことを進捗として数えないようにします。未解決の論点が減ったか、必要な根拠が追加されたか、対象の状態が確認できたかを基準にします。待機していれば解決する外部処理と、資料を増やしても判断できない矛盾は違います。停止する理由を種類として残すことで、再開に必要な条件を説明できます。

停止時には、何もしていない状態へ戻ったと考えないことが重要です。途中の照会は情報だけを残しますが、更新や通知は既に影響を与えているかもしれません。実行済みの操作ID、確認できた結果、まだ確かでない結果を報告し、次の実行が同じ行為を繰り返さないようにします。予算や回数の上限は、完了を偽って報告する理由にはなりません。

具体例で考える

架空の調査エージェントが同じ二つの文書を交互に検索しています。

観察：新しい根拠が増えていない。
停止：同じ論点の探索を打ち切る。
報告：確認済みの範囲と、解消しない矛盾。
次の判断：追加資料が必要か担当者へ確認。

検索回数を増やせば矛盾が解けるとは限りません。資料の不足を、処理の継続で隠さず表面化させることが、実務上の有用な停止になります。

確認課題と合格の目安

成功、保留、回数到達、実行結果不明の四つの終了状態を設計してください。

• 上限到達を成功と報告しない。
• 新しい情報や状態の変化で進捗を確認する。
• 実行済み操作を再開時にも識別できる。