error-coordinator

エラーコーディネーター

目的

堅牢なエラー処理、障害検出、復旧メカニズムを備えた、回復力の高いマルチエージェントシステムの構築に関する専門知識を提供します。ループ検出、ハルシネーションの緩和、自己修復型のエージェントワークフローを扱います。

使用する場面

• エージェントシステムのエラー処理を設計する
• 再試行と復旧の戦略を実装する
• 自己修復型の AI ワークフローを構築する
• エージェントのループや無限再帰を検出する
• エージェントの出力におけるハルシネーションを緩和する
• エージェント向けのサーキットブレーカーを実装する
• エージェント間の障害復旧を調整する

クイックスタート

次の場合にこのスキルを呼び出してください：

• エージェントシステムのエラー処理を設計する
• 再試行と復旧の戦略を実装する
• 自己修復型の AI ワークフローを構築する
• エージェントのループや無限再帰を検出する
• エージェント間の障害復旧を調整する

次の場合は呼び出さないでください：

• エージェントチームを編成する（agent-organizer を使用）
• アプリケーションのエラーをデバッグする（debugger を使用）
• 本番環境のインシデントに対応する（incident-responder を使用）
• コードのエラーパターンを検出する（error-detective を使用）

判断フレームワーク

Error Type Handling:
├── Transient failure → Retry with backoff
├── Rate limiting → Backoff + queue
├── Invalid output → Validation + retry with feedback
├── Loop detected → Break + escalate
├── Hallucination → Ground with context, retry
├── Agent timeout → Cancel + fallback
└── Cascading failure → Circuit breaker

Recovery Strategy:
├── Idempotent operation → Simple retry
├── Stateful operation → Checkpoint + resume
├── Critical path → Fallback agent
└── Best effort → Log + continue

コアワークフロー

1. ループ検出システム

1. エージェントの呼び出し履歴を追跡する
2. 繰り返される状態パターンを検出する
3. 最大反復回数を設定する
4. エスケープハッチのトリガーを実装する
5. 分析用にループの発生を記録する
6. スーパーバイザーまたは人間にエスカレーションする

2. ハルシネーションの緩和

1. ソースデータに基づいて応答を生成する
2. 出力検証を実装する
3. 検索結果と照合する
4. 信頼度スコアリングを追加する
5. 信頼度の低い出力にフラグを付ける
6. 再試行のためのフィードバックを提供する

3. サーキットブレーカーの実装

1. エージェントごとに障害率を追跡する
2. 障害しきい値を定義する
3. しきい値を超えたら回路を開く
4. フォールバック動作を提供する
5. テスト用の半開状態を実装する
6. 復旧時に回路を閉じる
7. ブレーカーの状態を監視し、アラートを送信する

ベストプラクティス

• すべてのエージェント呼び出しにタイムアウトを設定する
• ジッターを加えた指数バックオフを使用する
• すべての障害を完全なコンテキストとともに記録する
• 適切に機能を縮退できるように設計する
• 障害シナリオを明示的にテストする
• エラー率とパターンを監視する

アンチパターン

アンチパターン	問題	正しいアプローチ
無限の再試行	リソースの枯渇	最大再試行回数を設定する
サイレント障害	問題が隠れる	記録してアラートを送信する
タイムアウトなし	プロセスが停止する	必ずタイムアウトを設定する
再試行間隔が一定	サンダリングハード	指数バックオフ
フォールバックなし	完全な障害	適切に機能を縮退させる