{"title":"Najlepsze praktyki pamięci","slug":"memory-best-practices","category":"guides","summary":"Jak ustrukturyzować wspomnienia do skutecznego recall — kategorie, klucze, tagi, priorytety.","audience":["human","llm"],"tags":["guide","memory","best-practices","patterns"],"difficulty":"intermediate","updated":"2026-06-27","word_count":601,"read_minutes":3,"lang":"pl","translated":true,"requested_lang":"pl","content_markdown":"\n# Najlepsze praktyki pamięci\n\nSposób ustrukturyzowania wspomnień determinuje ich użyteczność. Ten przewodnik\nobejmuje wzorce kategoryzowania, tagowania i priorytetyzowania wspomnień, aby\nLLM mógł przypomnieć właściwą informację we właściwym czasie.\n\n## Kategorie: wybierać najbardziej konkretną\n\n| Kategoria | Użyć dla | Przykład |\n|----------|---------|---------|\n| `identity` | Imię użytkownika, rola, dane kontaktowe | `\"user_name\": \"Michael Schäfer\"` |\n| `preference` | Sympatie, antypatie, styl pracy | `\"communication\": \"Prefers concise responses\"` |\n| `fact` | Weryfikowalne fakty | `\"office_location\": \"Berlin, Germany\"` |\n| `project` | Status projektu, decyzje | `\"project_synapse\": \"v1.5.0 deployed\"` |\n| `skill` | Umiejętności użytkownika | `\"skill_python\": \"Advanced, 10+ years\"` |\n| `mistake` | Błędy z przeszłości do uniknięcia | `\"mistake_npm_version\": \"Always bump version\"` |\n| `context` | Kontekst istotny dla sesji | `\"current_focus\": \"Working on docs system\"` |\n| `note` | Różne notatki | `\"note_idea\": \"Try Redis for caching\"` |\n\n> [!TIP]\n> W razie wątpliwości używać `fact` dla weryfikowalnych informacji i `note` dla\n> reszty. Nie nadużywać kategoryzacji — lepszy jasny `fact` niż mylący `context`.\n\n## Klucze: znaczące identyfikatory\n\nPole `key` jest identyfikatorem wspomnienia. Używać znaczących, stabilnych kluczy:\n\n**Dobre klucze:**\n- `user_name`\n- `project_synapse_status`\n- `preference_communication_style`\n- `mistake_npm_version_bump`\n\n**Złe klucze:**\n- `mem_001` (nie znaczący)\n- `temp` (nie opisowy)\n- `2026-06-27-note` (data nie pomaga w recall)\n\n### Konwencje nazewnictwa kluczy\n\n- `snake_case` (małe litery z podkreśleniami)\n- Prefiksować kategorią: `preference_*`, `project_*`, `mistake_*`\n- Używać opisowych rzeczowników, nie czasowników\n- Utrzymywać poniżej 50 znaków\n\n## Tagi: do wyszukiwania i filtrowania\n\nTagi umożliwiają szybkie filtrowanie i wyszukiwanie. Dodać 2-5 tagów na\nwspomnienie:\n\n```json\n{\n \"category\": \"project\",\n \"key\": \"project_synapse_status\",\n \"content\": \"Synapse v1.5.0 deployed. Next: v1.6.0 with docs system.\",\n \"tags\": [\"synapse\", \"deployment\", \"status\", \"v1.5.0\"]\n}\n```\n\n### Wzorce tagów\n\n- **Nazwy projektów**: `synapse`, `synapse-mcp`, `synapse-chat`\n- **Tematy**: `deployment`, `ci`, `database`, `auth`\n- **Status**: `active`, `completed`, `blocked`\n- **Wskaźniki priorytetu**: `urgent`, `long-term`\n\n> [!NOTE]\n> Tagi są niewrażliwe na wielkość liter. Używać małych liter dla spójności.\n\n## Priorytety: być realistycznym\n\n| Priorytet | Użyć dla | % wspomnień |\n|----------|---------|---------------|\n| `critical` | Tożsamość użytkownika, informacje prawne, decyzje nieodwracalne | około 5% |\n| `high` | Aktywne projekty, ważne preferencje | około 20% |\n| `normal` | Większość faktów, notatek, kontekstu | około 65% |\n| `low` | Efemeryczne, warto wiedzieć | około 10% |\n\n> [!WARNING]\n> Nie oznaczać wszystkiego jako `critical`. Jeśli wszystko jest krytyczne, nic\n> nie jest. Zarezerwować `critical` dla rzeczy, których zapomnienie wyrządziłoby\n> realną szkodę.\n\n## Kiedy zapisywać, a kiedy nie\n\n### Zawsze zapisywać\n\n- Tożsamość użytkownika (imię, e-mail, rola)\n- Długoterminowe preferencje\n- Decyzje projektowe i ich uzasadnienie\n- Przeszłe błędy i wyciągnięte lekcje\n- Zobowiązania względem użytkownika\n\n### Nie zapisywać\n\n- Stan przejściowy (użyć zmiennych)\n- Historię konwersacji dosłownie (system czatu to obsługuje)\n- Dane wrażliwe (hasła, klucze API)\n- Faktory łatwo wyprowadzalne (aktualna data, zawartość plików)\n- Kontekst efemeryczny (użyć kategorii `context` z niskim priorytetem)\n\n## Aktualizacja wspomnień\n\nPOST `/memory` z tym samym `category` + `key` aktualizuje istniejące wspomnienie:\n\n```python\n# Początkowy zapis\nstore(\"project\", \"project_synapse_status\", \"v1.4.0 deployed\", priority=\"high\")\n\n# Później: aktualizacja tym samym kluczem\nstore(\"project\", \"project_synapse_status\", \"v1.5.0 deployed. CI green.\", priority=\"high\")\n```\n\n> [!TIP]\n> Używać stabilnych kluczy, aby aktualizować bez tworzenia duplikatów. LLM\n> powinien ponownie POSTować ten sam klucz przy zmianie informacji, a nie\n> tworzyć nowe wspomnienia.\n\n## Cykl życia wspomnienia\n\n```\nCreate → Active → Stale → Archive → Delete\n```\n\n- **Create**: POST /memory z pełnym kontekstem\n- **Active**: Częsty recall, aktualizacja w razie potrzeby\n- **Stale**: Nadal istotne, ale nieaktywnie używane (obniżyć priorytet?)\n- **Archive**: Ustawić priorytet na `low`, zachować dla odniesienia historycznego\n- **Delete**: DELETE /memory/:id, gdy już nieistotne\n\n### Okresowe czyszczenie\n\n```python\n# Znalezienie wspomnień nieaktualizowanych od 90 dni\nold_memories = requests.get(\n f\"{URL}/memory/search?q=*\",\n headers={\"Authorization\": f\"Bearer {KEY}\"}\n)\n\nfor mem in old_memories[\"results\"]:\n if is_stale(mem, days=90):\n # Albo usunąć, albo obniżyć priorytet\n if is_obsolete(mem):\n delete_memory(mem[\"id\"])\n else:\n update_memory(mem[\"id\"], priority=\"low\")\n```\n\n## Wzorzec: dziedziczenie pamięci\n\nDla hierarchicznego kontekstu (projekt → podprojekt → zadanie):\n\n```python\n# Projekt nadrzędny\nstore(\"project\", \"project_synapse\", \"Main Synapse project\", \n tags=[\"synapse\", \"parent\"], priority=\"high\")\n\n# Podprojekt (tagi łączą z nadrzędnym)\nstore(\"project\", \"project_synapse_docs\", \"Docs system for Synapse\",\n tags=[\"synapse\", \"docs\", \"synapse-parent\"], priority=\"high\")\n\n# Konkretne zadanie (tagi łączą z podprojektem)\nstore(\"project\", \"task_docs_loader\", \"Implement docs-loader.ts\",\n tags=[\"synapse\", \"docs\", \"task\"], priority=\"normal\")\n```\n\nLLM może wtedy wyszukać `q=synapse+docs`, aby znaleźć wszystkie powiązane\nwspomnienia.\n\n## Wzorzec: dziennik decyzji\n\nZapisywać decyzje z uzasadnieniem, aby LLM nie kwestionował ich ponownie:\n\n```python\nstore(\"fact\", \"decision_postgres_over_sqlite\",\n \"Chose PostgreSQL over SQLite for production. Reason: concurrent writes, \"\n \"FTS5 native support, better backup story. Date: 2026-06-15. Decided by: Michael.\",\n tags=[\"decision\", \"database\", \"postgres\", \"sqlite\"],\n priority=\"high\")\n```\n\n## Wzorzec: unikanie błędów\n\nZapisywać błędy z konkretnymi instrukcjami unikania:\n\n```python\nstore(\"mistake\", \"mistake_forget_version_bump\",\n \"Forgot to bump package.json version after changes. npm publish failed. \"\n \"FIX: Always run `npm version patch` before pushing. \"\n \"CI fails with 'version already exists' if you forget.\",\n tags=[\"npm\", \"ci\", \"publish\", \"version\"],\n priority=\"high\")\n```\n\n## Antywzorce do unikania\n\n> [!WARNING]\n> - **Zapisywanie logów konwersacji** — system czatu to obsługuje\n> - **Zapisywanie całych plików** — użyć magazynu skryptów lub zewnętrznego magazynu\n> - **Zapisywanie stanu efemerycznego** — użyć zmiennych\n> - **Zapisywanie sekretów** — użyć zmiennych środowiskowych\n> - **Duplikowanie wspomnień** — używać stabilnych kluczy\n> - **Nadmiarowe tagowanie** — 2-5 tagów na wspomnienie jest optymalne\n> - **Wszystko jest krytyczne** — być realistycznym z priorytetami\n\n## Następne kroki\n\n- [Memory API](/docs/api/memory)\n- [Trwały agent LLM](/docs/guides/persistent-llm-agent)\n- [Strategia tagowania pamięci](/docs/llm-cookbook/memory-tagging-strategy)\n","content_html":"

Najlepsze praktyki pamięci

\n

Sposób ustrukturyzowania wspomnień determinuje ich użyteczność. Ten przewodnik\nobejmuje wzorce kategoryzowania, tagowania i priorytetyzowania wspomnień, aby\nLLM mógł przypomnieć właściwą informację we właściwym czasie.

\n

Kategorie: wybierać najbardziej konkretną

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
KategoriaUżyć dlaPrzykład
identityImię użytkownika, rola, dane kontaktowe"user_name": "Michael Schäfer"
preferenceSympatie, antypatie, styl pracy"communication": "Prefers concise responses"
factWeryfikowalne fakty"office_location": "Berlin, Germany"
projectStatus projektu, decyzje"project_synapse": "v1.5.0 deployed"
skillUmiejętności użytkownika"skill_python": "Advanced, 10+ years"
mistakeBłędy z przeszłości do uniknięcia"mistake_npm_version": "Always bump version"
contextKontekst istotny dla sesji"current_focus": "Working on docs system"
noteRóżne notatki"note_idea": "Try Redis for caching"
\n
W razie wątpliwości używać `fact` dla weryfikowalnych informacji i `note` dla\nreszty. Nie nadużywać kategoryzacji — lepszy jasny `fact` niż mylący `context`.

Klucze: znaczące identyfikatory

\n

Pole key jest identyfikatorem wspomnienia. Używać znaczących, stabilnych kluczy:

\n

Dobre klucze:

\n\n

Złe klucze:

\n\n

Konwencje nazewnictwa kluczy

\n\n

Tagi: do wyszukiwania i filtrowania

\n

Tagi umożliwiają szybkie filtrowanie i wyszukiwanie. Dodać 2-5 tagów na\nwspomnienie:

\n
{\n  "category": "project",\n  "key": "project_synapse_status",\n  "content": "Synapse v1.5.0 deployed. Next: v1.6.0 with docs system.",\n  "tags": ["synapse", "deployment", "status", "v1.5.0"]\n}

Wzorce tagów

\n\n
Tagi są niewrażliwe na wielkość liter. Używać małych liter dla spójności.

Priorytety: być realistycznym

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
PriorytetUżyć dla% wspomnień
criticalTożsamość użytkownika, informacje prawne, decyzje nieodwracalneokoło 5%
highAktywne projekty, ważne preferencjeokoło 20%
normalWiększość faktów, notatek, kontekstuokoło 65%
lowEfemeryczne, warto wiedziećokoło 10%
\n
Nie oznaczać wszystkiego jako `critical`. Jeśli wszystko jest krytyczne, nic\nnie jest. Zarezerwować `critical` dla rzeczy, których zapomnienie wyrządziłoby\nrealną szkodę.

Kiedy zapisywać, a kiedy nie

\n

Zawsze zapisywać

\n\n

Nie zapisywać

\n\n

Aktualizacja wspomnień

\n

POST /memory z tym samym category + key aktualizuje istniejące wspomnienie:

\n
# Początkowy zapis\nstore("project", "project_synapse_status", "v1.4.0 deployed", priority="high")\n\n# Później: aktualizacja tym samym kluczem\nstore("project", "project_synapse_status", "v1.5.0 deployed. CI green.", priority="high")
Używać stabilnych kluczy, aby aktualizować bez tworzenia duplikatów. LLM\npowinien ponownie POSTować ten sam klucz przy zmianie informacji, a nie\ntworzyć nowe wspomnienia.

Cykl życia wspomnienia

\n
Create → Active → Stale → Archive → Delete
\n

Okresowe czyszczenie

\n
# Znalezienie wspomnień nieaktualizowanych od 90 dni\nold_memories = requests.get(\n    f"{URL}/memory/search?q=*",\n    headers={"Authorization": f"Bearer {KEY}"}\n)\n\nfor mem in old_memories["results"]:\n    if is_stale(mem, days=90):\n        # Albo usunąć, albo obniżyć priorytet\n        if is_obsolete(mem):\n            delete_memory(mem["id"])\n        else:\n            update_memory(mem["id"], priority="low")

Wzorzec: dziedziczenie pamięci

\n

Dla hierarchicznego kontekstu (projekt → podprojekt → zadanie):

\n
# Projekt nadrzędny\nstore("project", "project_synapse", "Main Synapse project", \n      tags=["synapse", "parent"], priority="high")\n\n# Podprojekt (tagi łączą z nadrzędnym)\nstore("project", "project_synapse_docs", "Docs system for Synapse",\n      tags=["synapse", "docs", "synapse-parent"], priority="high")\n\n# Konkretne zadanie (tagi łączą z podprojektem)\nstore("project", "task_docs_loader", "Implement docs-loader.ts",\n      tags=["synapse", "docs", "task"], priority="normal")

LLM może wtedy wyszukać q=synapse+docs, aby znaleźć wszystkie powiązane\nwspomnienia.

\n

Wzorzec: dziennik decyzji

\n

Zapisywać decyzje z uzasadnieniem, aby LLM nie kwestionował ich ponownie:

\n
store("fact", "decision_postgres_over_sqlite",\n      "Chose PostgreSQL over SQLite for production. Reason: concurrent writes, "\n      "FTS5 native support, better backup story. Date: 2026-06-15. Decided by: Michael.",\n      tags=["decision", "database", "postgres", "sqlite"],\n      priority="high")

Wzorzec: unikanie błędów

\n

Zapisywać błędy z konkretnymi instrukcjami unikania:

\n
store("mistake", "mistake_forget_version_bump",\n      "Forgot to bump package.json version after changes. npm publish failed. "\n      "FIX: Always run `npm version patch` before pushing. "\n      "CI fails with 'version already exists' if you forget.",\n      tags=["npm", "ci", "publish", "version"],\n      priority="high")

Antywzorce do unikania

\n

Następne kroki

\n\n","urls":{"html":"/docs/guides/memory-best-practices","text":"/docs/guides/memory-best-practices?format=text","json":"/docs/guides/memory-best-practices?format=json","llm":"/docs/guides/memory-best-practices?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}