Ajay150313/agentsre

何を解決するか

従来の観測ツール（Datadog や CloudWatch など）はインフラの健全性（HTTP 200、レイテンシ、稼働時間）を監視しますが、「意味的失敗（semantic failures）」を検出できません。これは、AIエージェントが技術的には動作しているものの、誤った意思決定をし、人間へのタスクの過剰なエスカレーション、または非効率化している状況です。agentsre は、アジェントの「意味的層」に特化したサイト信頼性工学（SRE）インストルメンテーションを提供し、『エージェントの過剰展開（agent sprawl）』や行動の変化（behavioral drift）によって引き起こされる本番障害を防ぎます。

動作方法

このライブラリは、エージェントの行動を監視するための専用のサービスレベル指標（SLI）とガバナンスツールを実装しています。

• 意味的 SLI：決定品質率（DQR）、ツール呼び出し効率（TIE）、人間エスカレーション率（HER）、承認キュー深度の変化（AQDD）を追跡し、システム障害が発生する前に劣化を検出します。
• A2A 検証：エージェント間（A2A）の意味的境界検証により、1つのエージェントの出力が次のエージェントに渡される前に意味的に正しいことを保証します。
• 回路ブレーカー：検証成功率が特定のしきい値を下回ると、自動的にトリップし、リクエストを劣化モードハンドラにルーティングします。
• ファルエットガバナンス：モデルバージョン、SLO所有者、廃止日を追跡するインベントリシステムと、行動の変化が検出された場合にエージェントフレームワーク（例：LangChain）のアップグレードを防ぐフレームワークカニバリズムフレームワークを提供します。
• 自律性制約：SLI違反に基づき、エージェントの自律性（例：自律的書き込みから人間承認のみ）を自動的に低下させる「制約の階段（constraint ladder）」を実装します。

対象ユーザー

複数モデル・複数フレームワークのアジェントAIシステムを本番環境に展開するSREおよびAIエンジニア。インフラ監視にとどまらず、行動の信頼性を確保したい方々に最適です。

主な特徴

• 4つのコア意味的 SLI：標準的な健全性チェックでは検出できない失敗を特定するように設計されています。
• AWS統合：AWS CloudWatchカスタムメトリクス用の組み込みパブリッシャーを備えています。
• エージェントの過剰展開の抑制：ファルエットインベントリとフレームワークアップグレードカニバリズムツールを提供します。
• 意味的ガードレール：HTTPステータスコードではなく、意思決定品質に基づいて動作するA2A検証と回路ブレーカーを実装しています。
• コスト追跡：エージェントおよびタスクごとのリアルタイムコスト追跡モジュールを提供します。