nullpointexception-i/agent-sphere

This project is an AI Agent orchestration platform. It uses an LLM-driven decision engine, combined with capabilities (built-in tools, MCP protocol, CLI execution, browser operations, etc.), to achieve a basic closed loop from perception → planning → execution → feedback.本项目是一个面向 AI Agent 编排平台。它通过 LLM 驱动的决策引擎，结合能力（内置工具、MCP 协议、CLI 执行、浏览器操作等）

What it solves

AgentSphere は AI エージェントオーケストレーションプラットフォームで、LLM が単なるチャットを超えて、認知・計画・実行・フィードバックの閉ループに統合されます。Web ブラウザ、コマンドラインインターフェース、外部 API などの実世界ツールや環境に LLM を接続し、自治タスク完了に必要な複雑な状態、メモリ、エラーハンドリングを管理する課題を解決します。

How it works

プラットフォームは ReAct（Reasoning + Acting） エンジン SessionRunner を使用します。このエンジンは、LLM が目標を推論し、実行するツールを選択し、結果を観測し、その観測から学習して次のステップを計画するループを管理します。

主な技術コンポーネントは次のとおりです：

  • Capability Layer：エージェントを MCP（Model Context Protocol）サーバー、組み込み Java ツール、ブラウザ自動化用 Chrome 拡張機能、シェル実行用 CLI に接続するモジュラーシステム。
  • Multi-level Memory：高速インメモリキャッシュから永続的な PostgreSQL レコードまでの階層型ストレージシステムで、コンテキスト組み立てと長い会話履歴の自動「圧縮」（トークン上限内に収める）を処理します。
  • Model Routing：フォールトトレラントなシステムで、OpenAI、DeepSeek、智譜 AI など複数プロバイダー間でリクエストをルーティングし、自動フェイルオーバー機構を備えています。
  • Human-in-the-Loop：エージェントが実行を一時停止し、ユーザーに確認や不足情報を尋ねることができる「User Clarification」メカニズム。

Who it’s for

  • 開発者：Web やローカルシステムと対話できる複雑な AI エージェントを構築したい方。
  • エンタープライズユーザー：複数の LLM プロバイダーとツール統合を管理するオーケストレーション層が必要な方。
  • システムアーキテクト：堅牢なメモリ管理と可観測性を備えた ReAct パターンの実装に関心がある方。

Highlights

  • Browser Automation：DOM 操作とリアルタイム視覚フィードバックを提供する統合 Chrome 拡張機能。
  • MCP Support：Jira、GitHub、Slack などのツールへの接続を容易にする Model Context Protocol に対応。
  • Context Compaction：トークン予算に基づくインテリジェントなツール結果と履歴の圧縮で LLM 入力を最適化。
  • High Concurrency：Java 21 バーチャルスレッドを使用し、数百の同時ストリーミング LLM セッションを効率的に処理。
  • Observability：SSE によるリアルタイムイベントストリーミングで推論ステップとツール実行ステータスを追跡。