なぜ見落とされるのか
エージェントはまだ動いています。ターミナルも動き続けています。しかし、同じことを5回繰り返してリクエストしています。活動していることは安心感を与えますが、セッションがループにはまっている場合でも同様です。
エージェントがGitのステータスを繰り返し確認するコーディングタスクを想像してください。1回は有用です。同一の呼び出しが5回続く場合、次のステップを見失っている可能性があります。複数のセッションにまたがると、同じ未完了タスクに戻るまでこのパターンは見逃されがちです。
ClawMetryが検出するもの
ClawMetryは同一の引数を持つ繰り返しのツール呼び出しと、短いツール名のサイクルを検索します。繰り返しが該当のしきい値を超えると、スタックループの警告を発します。検出結果にはパターン、ツール、繰り返し回数が含まれます。
検出結果を左右する違い
トリガーの例
同一の呼び出し5回
警告の検出結果
静かな比較例
8つの異なる引数
このディテクターの検出結果はありません。
確認した例では、同一のGitステータス呼び出し5回が警告を生成します。異なるファイル引数での8回の呼び出しは、このディテクターでは静かなままです。重要な違いは繰り返しのアクションです。しきい値はランタイムと学習済みベースラインを反映できるため、5回はあくまで例であり、普遍的なルールではありません。
ディテクターの結果を確認する
{
"kind": "stuck_loop",
"severity": "warning",
"evidence": {
"pattern": "identical",
"tool": "Bash",
"repeats": 5,
"total_tool_calls": 5,
"threshold": 3,
"threshold_source": "static"
}
}例の確認方法
これらの例は、作成されたイベントデータまたは使い捨ての設定ファイルを使って公開済みディテクターを評価します。動画はこれらの動作を説明しています。ライブエージェントや製品インターフェイスの録画ではありません。例のコマンドは実行されていません。
この結果はこれらの入力に対する動作を示すものです。ランタイムへの取り込み、防止、または実際の侵害を証明するものではありません。 固定されたソースコントラクトを確認する.
次に確認すること
繰り返されたステップとその結果を確認してください。エージェントは変化できない何かを待っていますか？不足している依存関係や明確な次のアクションが必要ですか？検出結果を使って自分でサイクルを断ち切り、有益な作業が再開されるか確認してください。
- 繰り返しのステップを確認する
- 何が不足しているか確認する
- 具体的な次のアクションを与える
このシグナルが示すもの
繰り返しが意図的な場合もあります。この検出結果は原因を特定したり、セッションを停止したり、支出を制限したりするものではありません。