Agentmemory

AGENTMEMORY: Kompleksowa Warstwa Pamięci, Której Potrzebuje Twój Agent Kodujący

AGENTMEMORY to rewolucyjne rozwiązanie w dziedzinie sztucznej inteligencji, zaprojektowane jako brakująca warstwa pamięci dla agentów kodujących. Od pierwszego dnia pracy z AI, programiści borykali się z problemem utraty kontekstu między sesjami. AGENTMEMORY rozwiązuje ten problem, oferując system, który rejestruje każdą sesję, przywołuje informacje w milisekundach i działa całkowicie lokalnie, bez konieczności konfigurowania złożonej infrastruktury.

Zbudowany na silniku III engine, system AGENTMEMORY sprawia, że każda operacja pamięciowa staje się funkcją, triggerem lub workerem. Zapomnij o uciążliwej konfiguracji Redis, Kafka czy Postgres – cały runtime AGENTMEMORY to jeden proces, który działa tam, gdzie Ty.

Czym jest AGENTMEMORY?

AGENTMEMORY nie jest zwykłą biblioteką ani prostym magazynem wektorowym. To kompletne środowisko uruchomieniowe pamięci (Memory Runtime), które obejmuje przechwytywanie (capture), przywoływanie (recall), konsolidację (consolidate), obserwację (observe) oraz federację (federate) danych.

W świecie, gdzie agenci tacy jak Claude Code czy Cursor stają się standardem, AGENTMEMORY dostarcza im strukturalnej wiedzy o Twoich poprzednich działaniach, decyzjach projektowych i błędach, których udało się uniknąć. Dzięki temu Twój agent staje się mądrzejszy z każdą napisaną linią kodu.

Kluczowe Funkcje AGENTMEMORY

System AGENTMEMORY został wyposażony w szereg zaawansowanych funkcji, które czynią go liderem w swojej kategorii. Oto najważniejsze z nich:

1. Trzy Filary Systemu (The Stack)

Mechanizm działania AGENTMEMORY opiera się na trzech prymitywach, które eliminują tzw. "podatek od frameworka":

• Hooks (Haki): 12 automatycznych haków przechwytujących, które integrują się z każdym agentem. Każde wywołanie narzędzia, każdy monit i każde zatrzymanie sesji staje się skompresowaną obserwacją.
• Recall (Przywoływanie): Potrójne strumieniowe wyszukiwanie łączące BM25, wyszukiwanie wektorowe oraz graf wiedzy. Ranking odbywa się bezpośrednio na urządzeniu, osiągając opóźnienie P50 poniżej 20 ms na zwykłym laptopie.
• Consolidate (Konsolidacja): Cogodzinne przebiegi systemu kompresują surowe obserwacje w pamięci semantyczne. Duplikaty są scalane, a nieaktualne dane ulegają degradacji, co pozwala na zachowanie czystości i trafności bazy wiedzy.

2. Zaawansowane Przechwytywanie i Narzędzia

• 12 Auto-Hooks: Przechwytuj wszystko bez pisania dodatkowego kodu. Od PreToolUse po SessionStart – wszystko trafia do rurociągu pamięci automatycznie.
• 51 Narzędzi MCP: Natywna obsługa Model Context Protocol (MCP) z pełną gamą funkcji, takich jak memory_save, memory_recall, memory_smart_search, czy governance.
• 121 Endpointów REST: Każde narzędzie MCP posiada swój bliźniaczy punkt końcowy HTTP, co pozwala na integrację z dowolnego miejsca za pomocą cURL lub przeglądarki.

3. Hybrydowe Wyszukiwanie i Graf Wiedzy

AGENTMEMORY oferuje skuteczność na poziomie 95.2% R@5 w benchmarku LongMemEval-S. Wykorzystuje do tego:

• Triple-Stream Recall: Połączenie wyników leksykalnych, semantycznych i relacyjnych.
• Ekstrakcja Grafu: Automatyczne wyodrębnianie encji i relacji, które można wizualizować i przeszukiwać przez /agentmemory/graph.
• Obsidian Export: Możliwość eksportu pamięci do notatek Markdown w formacie przyjaznym dla programu Obsidian, wraz z tagami frontmatter.

4. Zero Zewnętrznych Baz Danych

To, co wyróżnia AGENTMEMORY, to brak zależności. Nie potrzebujesz Redis, Kafka, Postgres, Qdrant czy Neo4j. Wszystkie stany są przechowywane na dysku w formacie JSON, a cały system działa jako pojedynczy proces Node.

Przypadki Użycia (Use Case)

AGENTMEMORY znajduje zastosowanie wszędzie tam, gdzie praca z AI wymaga ciągłości i głębokiego kontekstu:

• Agenci Kodujący (Claude Code, Cursor): Automatyczne dostarczanie kontekstu poprzednich sesji, co pozwala na redukcję tokenów wejściowych o 92%.
• Replay Sesji: Importowanie transkrypcji z Claude Code w formacie JSONL w celu odtworzenia pełnej osi czasu zdarzeń i obserwacji.
• Federacja Pamięci (Mesh Federation): Synchronizacja pamięci między różnymi węzłami AGENTMEMORY przez uwierzytelniony protokół HTTPS (Peer-to-Peer).
• Analityka i Observability: Dzięki integracji z OpenTelemetry (OTEL), każda operacja generuje ślady (traces), które można analizować w Jaegerze lub Honeycomb.

Jak używać AGENTMEMORY?

Rozpoczęcie pracy z AGENTMEMORY jest niezwykle proste i sprowadza się do kilku kroków w terminalu.

Instalacja

Zalecanym sposobem jest globalna instalacja przez NPM:

npm install -g @agentmemory/agentmemory

Możesz również skorzystać z trybu zero-install przy użyciu npx:

npx @agentmemory/agentmemory

Uruchomienie Serwera

Aby wystartować serwer pamięci na porcie 3111 oraz przeglądarkę (Viewer) na porcie 3113, wpisz:

agentmemory

Aby przetestować działanie i zobaczyć hybrydowe wyszukiwanie w akcji, użyj komendy demo:

agentmemory demo

Integracja z Agentami (Universal MCP JSON)

Aby połączyć AGENTMEMORY z programami takimi jak Claude Desktop, Cursor czy Windsurf, dodaj poniższą konfigurację do swojego pliku konfiguracyjnego MCP:

{
  "mcpServers": {
    "agentmemory": {
      "command": "npx",
      "args": ["-y", "@agentmemory/mcp"],
      "env": {
        "AGENTMEMORY_URL": "http://localhost:3111"
      }
    }
  }
}

Porównanie: AGENTMEMORY vs Konkurencja

| Cecha | AGENTMEMORY | Mem0 | Letta | Cognee | | :--- | :--- | :--- | :--- | :--- | | Retrieval R@5 | 95.2% | 81.4% | 73.8% | 78.1% | | Zewn. Bazy Danych | 0 | 2 (Qdrant, Neo4j) | 1 (Postgres) | 1 (Neo4j) | | Narzędzia MCP | 51 | 12 | 18 | 9 | | Auto-Hooks | 12 | 0 | 0 | 0 | | Open Source | TAK (Apache-2.0) | TAK | TAK | TAK |

FAQ - Najczęściej Zadawane Pytania

Czy AGENTMEMORY wymaga płatnej subskrypcji bazy danych? Nie. AGENTMEMORY działa całkowicie lokalnie i przechowuje dane na Twoim dysku w formacie JSON. Nie wymaga zewnętrznych baz danych takich jak Postgres czy Redis.

Z jakimi modelami LLM współpracuje system? Domyślnie system wspiera subskrypcję Claude, ale możesz również skonfigurować Anthropic API, Gemini, MiniMax lub OpenRouter poprzez zmienne środowiskowe.

Gdzie mogę przeglądać zapisane wspomnienia? AGENTMEMORY automatycznie uruchamia Real-Time Viewer na porcie 3113. Możesz tam przeglądać strumień obserwacji na żywo, eksplorować sesje oraz wizualizować graf wiedzy.

Czy moje dane są bezpieczne? Tak, dane pozostają na Twojej maszynie. Nawet w przypadku korzystania z Mesh Federation, synchronizacja wymaga tokenów Bearer i odbywa się przez uwierzytelnione połączenia HTTPS.