agent-architecture-audit

Topics in the source

• エージェントアーキテクチャ監査
• 起動タイミング
• 12 層スタック
• 一般的な障害パターン
• 1. ラッパーリグレッション
• 2. メモリ汚染
• 3. ツール規律の失敗
• 4. レンダリング・トランスポート破損

ラッパー層、古いメモリ、リトライループ、トランスポート・レンダリングの変異の背後に失敗を隠すエージェントシステムのための診断ワークフロー。 必須の場合: エージェントまたは LLM を活用したアプリケーションを本番リリースする前 ツール呼び出し、メモリ、または多段階ワークフローを含む機能をリリースする前 ラッパー層を追加した後にエージェントの動作が低下する場合 ユーザーが「エージェントが悪化している」または「ツールが不安定」と報告する場合 同じモデルがプレイグラウンドでは動作するがラッパー内で壊れる場合 根本原因を見つけることなく 15 分以上エージェントの動作をデバッグしている場合 特に重要な場合: 新しいプロンプト層、ツール定義、またはメモリシステムを追加した場合 システム内の異なるエージェントが一貫性なく動作する場合 昨日は正常だったモデルが今日ハルシネーションを起こしている場合 応答をサイレントに変異させる隠れた修復・リトライループが疑われる場合 使用しない場合: 一般的なコードデバッグ — agent-introspection-debugging を使用 コードレビュー — 言語固有のレビューエージェントを使用 セキュリティスキャン — security-review または security-review/scan を使用 エージェントパフォーマンスのベンチマーク — agent-eval を使用 新機能の作成 — 適切なワークフロースキルを使用 すべてのエージェントシステムはこれらの層を持ちます。いずれも回答を破壊する可能性があります： | # | 層 | 問題の内容 | |---|-------|----------------| | 1 | システムプロンプト | 矛盾する指示、指示の肥大化 | | 2 | セッション履歴 | 前のターンからの古いコンテキスト注入 | | 3 | 長期メモリ | セッション間の汚染、新しい会話に古いトピックが混入 | | 4 | 蒸留 | 圧縮されたアーティファクトが疑似事実として再投入 | | 5 | アクティブリコール | コンテキストを無駄にする冗長な再要約層 | | 6 | ツール選択 | 誤ったツールルーティング、モデルが必要なツールをスキップ | | 7 | ツール実行 | ハルシネーションによる実行 — 呼び出したと主張するが実際には呼び出していない | | 8 | ツール解釈 | ツール出力の誤読または無視 | | 9 | 回答整形 | 最終応答でのフォーマット破損 | | 10 | プラットフォームレンダリング | トランスポート層の変異（UI、API、CLI が有効な回答を変異させる） | | 11 | 隠れた修復ループ | サイレントなフォールバック・リトライエージェントが 2 回目

This is an excerpt. Refer to the complete source and its current requirements.