oxbshw/LLM-Agents-Ecosystem-Handbook

何を解決するか

このプロジェクトは、現代のLLMエージェントシステムの構築と配信に向けた包括的でプロダクション指向のオペレーティングマニュアルを提供します。単なるプロンプトやツールを越え、エージェントをアイデンティティ、メモリ、スキル、セキュリティ、観測性を備えた完全なシステムとして扱います。

仕組み

ハンドブックはエージェントライフサイクル全体をカバーするモジュール式スタックとして構成されています：

• プロバイダーエコシステム： 24以上のLLMプロバイダー（最先端モデル、高速推論、ローカルランタイムなど）をサポートする抽象化レイヤー（LLMProvider）とルーター。エージェントコードを変更せずにモデルを切り替えることが可能。
• エージェントOS概念： エージェントのアイデンティティ、メモリ、および標準化されたツール統合のためのModel Context Protocol（MCP）を含む構造化アプローチ。
• スキルとメモリ： 再利用可能なマルチステップワークフロー（スキル）とセッション間で持続する状態（メモリ）を構築するための分類と成熟モデル。
• エンジニアリング実践： エージェント固有のプロンプト工学、安全ガードレール（リスクレベル別承認）、観測性（トレーシングと評価）に関する専用ガイド。
• 設計とデプロイ： 機械可読な設計仕様（DESIGN.md）、アーキテクチャ意思決定記録（ADRs）、プロダクション準備チェックリスト。

対象ユーザー

プロダクション品質のAIエージェントを構築している開発者やアーキテクト。エージェントのアイデンティティ、ツール、プロバイダー戦略を標準化された方法で整理したい人、またCursorやClaude Codeなどのコードエージェントを使ってコードベースを管理している人。

主な特徴

• マルチプロバイダールーター： 24以上のLLMプロバイダーに対応する統一インターフェースとフォールバックチェーン。
• 包括的なテンプレート： システムプロンプト、エージェントアイデンティティ（SOUL.md）、メモリインデックス（MEMORY.md）用のコピー＆ペースト可能なテンプレート。
• コードエージェント最適化： llms.txt と特定のプロンプトを含み、リポジトリ自体をAIコードツールが簡単にナビゲートできるように設計。
• フレームワーク比較： LangGraph、CrewAI、Pydantic AIなどの人気エージェントフレームワークを詳細に比較するマトリクス。
• リスクレベル別セキュリティ： リスクレベル（低から重大）に基づいたツール権限管理の構造化フレームワーク。