agentmemory-architecture

agentmemory は、コーディングエージェント向けのメモリサーバーです。ローカルで動作し、観察内容を記録してハイブリッド検索用にインデックス化し、REST と MCP を介して提供します。Worker Compose は、固定バージョンの iii エンジンを AgentMemory とともに実行し、レジストリの state ワーカーと http ワーカーを使用します。state ワーカーはデフォルトでファイルベースの KV ストアを使用し、設定によって Redis も利用できます。SQLite ではありません。

iii のプリミティブ

iii エンジン上では、すべてが関数、トリガー、またはワーカーの状態です。独立したプラグインシステムはなく、ワーカーが関数（mem::*）と HTTP トリガー（api::*）を登録し、エンジンが呼び出しをルーティングします。agentmemory が iii を迂回することはありません。新しい機能は、新しい関数とトリガーで実現します。

検索モデル

リコールでは、BM25 によるキーワード検索を、設定済みのベクトル類似度検索とグラフ展開と組み合わせます。埋め込みプロバイダーを設定していないクリーンインストールでは、API キーなしで BM25 を使用します。デバイス上での埋め込みを有効にするには EMBEDDING_PROVIDER=local を設定します。この場合、モデルがダウンロードされることがあります。または、リモートプロバイダーを設定してください。LLM による圧縮と要約には、プロバイダーの設定と関連オプションが必要です。

ストレージとライフサイクル

メモリには、内容、概念、ファイル、重要度、タイムスタンプが含まれ、セッションごとにまとめられ、必要に応じてコミットにリンクされます。記録、圧縮、統合、忘却というライフサイクルによって、ストアが際限なく大きくなるのを防ぎ、長期にわたって有用な状態を保ちます。

ポート

REST のデフォルトポートは 3111、ビューアーは 3113、内部エンジンの WebSocket は 49134 です。別のローカルランタイムを選択するには、--port <N> または --instance <N> を使用します。

ビューアー

http://localhost:3113 にあるリアルタイムの Web ビューアーでは、セッションの実行に伴うメモリの構築を確認できます。REST ポート経由で、認証済みの SSE 更新を受信します。デモや、記録が正しく動作していることの確認に便利です。

関連項目

• 各インターフェースについては、agentmemory-mcp-tools と agentmemory-rest-api を参照してください。
• 自動記録については、agentmemory-hooks を参照してください。
• ポートと機能フラグについては、agentmemory-config を参照してください。