Memgpt Agent

🚀 MemGPT 示例プロジェクト

このプロジェクトは、MemGPT の研究論文に記載されている概念を簡略化し、縮小して実装した概念実証です。エージェントの形式で実装され、簡単な REST サービスまたは MCP サーバーとしての統合方法を示します。

🚀 クイックスタート

このプロジェクトでは、Spring Boot と Spring AI を使用して MemGPT の概念を実装し、簡単な REST インターフェースと MCP サーバーを介してその機能を公開しています。また、コマンドラインベースの ChatBot アプリケーションが含まれており、REST または MCP インターフェースと統合することができます。

✨ 主な機能

• このプロジェクトは以下のサブプロジェクトで構成されています：
  • core - agent：MemGPT インターフェースを定義し、実装します。設定 API も含まれます。
  • restful - agent - app：エージェントをラップしたサービスで、簡単な REST インターフェースを介してその機能を公開します。
  • memgpt - mcp - server：エージェントをラップしたサービスで、MCP サーバーとしてその機能を公開します。
  • simple - chat - bot - app：コマンドラインベースのチャットアプリケーションで、REST または MCP インターフェースを介してエージェントと通信できます。

📦 インストール

前提条件

• Java 17 以上
• Gradle
• OpenAI API キー

🔧 技術詳細

コアエージェント

コアエージェントは、MemGPT インターフェースと実装を含むコンポーネントです。エージェントの設定と状態を維持する責任があり、以下が含まれます：

• システムプロンプト
• ツール
• コアメモリ
• アーカイブメモリ
• メッセージの永続化（コンテキストウィンドウ外のメッセージも含む）

また、以下のコアエージェント機能を担当します：

• メッセージのコンパイル
• LLM 通信
• ツール呼び出し
• メモリ管理（コンテキストウィンドウの自己編集を含む）
• メッセージの検索とアーカイブ
• メッセージの要約

外部から見ると、エージェントは以下の 3 つの主要なインターフェースを介してその機能を公開します：

• AgentManager：エージェントインスタンスの設定と維持。
• AgentLoader：エージェントインスタンスの作成。
• Agent：コアエージェントのチャット機能を定義。

💻 使用例

アプリケーションの実行

簡単なチャットボットアプリケーションは、restful - agent - app または memgpt - mcp - server と通信します。チャットボットアプリケーションが使用するサーバーアプリケーションを選択し、そのアプリケーションを構成して実行します。次に、ChatBot アプリケーションを構成して、選択したサーバーアプリケーションを使用するように設定し、実行します。

サーバーアプリケーション

MCP サーバーと REST サーバーの両方が、コンテキストウィンドウとエージェントロジックを処理する責任があります。以下は 2 つの主要な実装です：

1. MCP サーバー（REST ベース）

   • ModelContextProtocol インターフェースを実装します。
   • /api/v1/chat/completions エンドポイントを提供します。
   • OpenAI の API との互換性をサポートします。

   ./gradlew :memgpt - mcp - server:run
   

   • 起動後、デフォルトで http://localhost:8080 で実行されます。
   • 設定ファイルを使用してポートやその他の設定を変更できます。

2. REST サーバー

   • ChatMessageStore と ChatContext を実装します。
   • REST ベースのインターフェースを提供して、チャットセッションとコンテキストを管理します。

   ./gradlew :restful - agent - app:run
   

   • 起動後、デフォルトで http://localhost:9090 で実行されます。
   • エージェント管理用の REST インターフェースを提供します。

ChatBot アプリケーションの実行

1. アプリケーションのビルド

   ./gradlew :simple - chat - bot - app:build
   

2. ChatBot アプリケーションの実行

   java - jar ./simple - chat - bot - app/build/libs/simple - chat - bot - app - 0.0.1 - SNAPSHOT.jar
   

   • 起動後、ユーザー ID の入力を求められます。
   • ユーザー ID はチャットセッションを識別するために使用され、任意の文字列にすることができます。

以上の手順に従うことで、MemGPT サンプルプロジェクトを簡単に実行し、その機能と統合方法を体験することができます。