{"title":"Strategia tagowania pamięci","slug":"memory-tagging-strategy","category":"llm-cookbook","summary":"Jak tagować wspomnienia do skutecznego wyszukiwania i filtrowania — system tagowania, który się skaluje.","audience":["llm"],"tags":["cookbook","tagging","memory","strategy"],"difficulty":"intermediate","updated":"2026-06-27","word_count":337,"read_minutes":2,"lang":"pl","translated":true,"requested_lang":"pl","content_markdown":"\n# Strategia tagowania pamięci\n\nTagi są sekretem skalowalnego pobierania wspomnień. Ten przewodnik pokazuje, jak\ntagować wspomnienia, aby właściwe wracały we właściwym czasie.\n\n## Dlaczego tagi mają znaczenie\n\nBez tagów ma się płaskie wyszukiwanie pełnotekstowe. Z tagami ma się\nustrukturyzowaną nawigację:\n\n```bash\n# Bez tagów: przeszukiwanie wszystkiego\nGET /memory/search?q=docker\n\n# Z tagami: filtrowanie po projekcie i technologii\nGET /memory/search?q=deployment&tag=synapse&tag=docker\n```\n\nTagi umożliwiają:\n\n- **Szybkie filtrowanie** — `GET /memory/by-tag?tag=production`\n- **Wyszukiwanie w zakresie** — `?q=auth&tag=project-x`\n- **Grupowanie** — znalezienie wszystkich wspomnień „mistake\" dla projektu\n- **Odsyłanie krzyżowe** — wspomnienia współdzielące tagi są powiązane\n\n## Schemat tagowania\n\n### Tagi projektów\n\nUżywać nazw projektów jako tagów:\n\n```\nsynapse, synapse-mcp, synapse-chat, synapse-sdk\n```\n\n### Tagi technologii\n\nUżywać nazw technologii:\n\n```\ndocker, kubernetes, postgres, fastify, react, typescript\n```\n\n### Tagi tematyczne\n\nUżywać kategorii tematycznych:\n\n```\ndeployment, ci-cd, auth, database, frontend, backend, security\n```\n\n### Tagi statusu\n\nUżywać wskaźników statusu:\n\n```\nactive, completed, blocked, deprecated\n```\n\n### Tagi typów\n\nUżywać wskaźników typów:\n\n```\ndecision, mistake, pattern, reference, todo\n```\n\n## Zasady tagowania\n\n### Zasada 1: 2-5 tagów na wspomnienie\n\nZbyt mało tagów = słaba wykrywalność. Zbyt wiele = szum.\n\n```json\n// Dobrze: 3 istotne tagi\n{ \"tags\": [\"synapse\", \"deployment\", \"docker\"] }\n\n// Źle: 1 tag (zbyt wąsko)\n{ \"tags\": [\"synapse\"] }\n\n// Źle: 10 tagów (szum)\n{ \"tags\": [\"synapse\", \"deployment\", \"docker\", \"vps1\", \"2026\", \"june\", \"ssh\", \"git\", \"main\", \"production\"] }\n```\n\n### Zasada 2: małe litery, z myślnikami\n\n```\n✅ ci-cd, api-key, mind-key\n❌ CI-CD, APIKey, MindKey\n```\n\n### Zasada 3: używać spójnego słownictwa\n\nUstanowić słownik tagowania i się go trzymać:\n\n```\n# Słownik projektów\nsynapse, synapse-mcp, synapse-chat\n\n# NIE: synapse_project, synapseProject, SYNAPSE\n```\n\n### Zasada 4: tagować z intencją wyszukiwania\n\nZapytać: „Jak będę szukać tego wspomnienia?\"\n\n```json\n// Zapis decyzji wdrożeniowej\n{\n \"content\": \"Decided to use Docker Swarm for Synapse deployment\",\n \"tags\": [\"synapse\", \"deployment\", \"docker\", \"swarm\", \"decision\"]\n}\n\n// Prawdopodobne wyszukiwania: ?q=docker+swarm lub ?tag=deployment\n```\n\n## Wzorce\n\n### Wzorzec 1: projekt + temat\n\n```json\n{ \"tags\": [\"synapse\", \"deployment\"] }\n{ \"tags\": [\"synapse\", \"auth\"] }\n{ \"tags\": [\"synapse-mcp\", \"tools\"] }\n```\n\nWyszukiwanie: `?tag=synapse` (wszystkie wspomnienia projektu Synapse)\nWyszukiwanie: `?tag=synapse&q=deployment` (wspomnienia wdrożeniowe w Synapse)\n\n### Wzorzec 2: typ + domena\n\n```json\n{ \"tags\": [\"mistake\", \"deployment\"] }\n{ \"tags\": [\"decision\", \"database\"] }\n{ \"tags\": [\"pattern\", \"auth\"] }\n```\n\nWyszukiwanie: `?tag=mistake` (wszystkie błędy)\nWyszukiwanie: `?tag=mistake&q=deployment` (błędy wdrożeniowe)\n\n### Wzorzec 3: hierarchiczny\n\nDla podprojektów w projekcie:\n\n```json\n{ \"tags\": [\"synapse\", \"synapse-docs\", \"markdown\"] }\n{ \"tags\": [\"synapse\", \"synapse-mcp\", \"mcp\"] }\n{ \"tags\": [\"synapse\", \"synapse-admin\", \"ui\"] }\n```\n\nWyszukiwanie: `?tag=synapse` (cały Synapse)\nWyszukiwanie: `?tag=synapse-docs` (tylko podprojekt dokumentów)\n\n### Wzorzec 4: śledzenie statusu\n\n```json\n// Aktywny projekt\n{ \"tags\": [\"synapse\", \"active\"], \"priority\": \"high\" }\n\n// Ukończony projekt\n{ \"tags\": [\"synapse-v1\", \"completed\"], \"priority\": \"low\" }\n\n// Zablokowany\n{ \"tags\": [\"synapse-v2\", \"blocked\"], \"priority\": \"high\" }\n```\n\n## Typowe przypadki użycia\n\n### Znalezienie wszystkich decyzji o projekcie\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=decision&tag=synapse\"\n```\n\n### Znalezienie wszystkich błędów w domenie\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=mistake&tag=deployment\"\n```\n\n### Znalezienie aktywnej pracy\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/by-tag?tag=active\"\n```\n\n### Znalezienie wspomnień o technologii\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=postgres+performance&tag=database\"\n```\n\n## Utrzymanie tagów\n\n### Okresowy przegląd\n\n```python\n# Znalezienie rzadko używanych tagów (kandydatów do czyszczenia)\ntags = requests.get(f\"{URL}/memory/tags\",\n headers={\"Authorization\": f\"Bearer {KEY}\"}).json()\n\nfor tag, count in tags.items():\n if count < 2:\n print(f\"Rare tag: {tag} ({count} memories)\")\n```\n\n### Scalanie tagów\n\nJeśli istnieją niespójne tagi (`docker` i `Docker`), scalić je:\n\n```python\n# Znalezienie wszystkich wspomnień z tagiem „Docker\"\nmems = requests.get(f\"{URL}/memory/by-tag?tag=Docker\",\n headers={\"Authorization\": f\"Bearer {KEY}\"}).json()\n\n# Aktualizacja każdego na „docker\"\nfor mem in mems[\"results\"]:\n tags = [t.lower() for t in mem[\"tags\"]]\n update_memory(mem[\"id\"], tags=list(set(tags)))\n```\n\n## Najlepsze praktyki\n\n> [!TIP]\n> - **Ustanowić słownik wcześnie** — spójne tagi od pierwszego dnia\n> - **Tagować z intencją wyszukiwania** — jak to znajdziesz później?\n> - **2-5 tagów to złoty środek** — zbyt mało lub zbyt wiele jest złe\n> - **Małe litery + myślniki** — `ci-cd`, nie `CI/CD`\n> - **Przeglądać okresowo** — scalać duplikaty, usuwać nieużywane\n\n## Następne kroki\n\n- [Najlepsze praktyki pamięci](/docs/guides/memory-best-practices)\n- [Wyszukiwanie FTS5](/docs/concepts/fts5-search)\n- [Przepływ oparty na zadaniach](/docs/llm-cookbook/task-driven-workflow)\n","content_html":"

Strategia tagowania pamięci

\n

Tagi są sekretem skalowalnego pobierania wspomnień. Ten przewodnik pokazuje, jak\ntagować wspomnienia, aby właściwe wracały we właściwym czasie.

\n

Dlaczego tagi mają znaczenie

\n

Bez tagów ma się płaskie wyszukiwanie pełnotekstowe. Z tagami ma się\nustrukturyzowaną nawigację:

\n
# Bez tagów: przeszukiwanie wszystkiego\nGET /memory/search?q=docker\n\n# Z tagami: filtrowanie po projekcie i technologii\nGET /memory/search?q=deployment&tag=synapse&tag=docker

Tagi umożliwiają:

\n\n

Schemat tagowania

\n

Tagi projektów

\n

Używać nazw projektów jako tagów:

\n
synapse, synapse-mcp, synapse-chat, synapse-sdk

Tagi technologii

\n

Używać nazw technologii:

\n
docker, kubernetes, postgres, fastify, react, typescript

Tagi tematyczne

\n

Używać kategorii tematycznych:

\n
deployment, ci-cd, auth, database, frontend, backend, security

Tagi statusu

\n

Używać wskaźników statusu:

\n
active, completed, blocked, deprecated

Tagi typów

\n

Używać wskaźników typów:

\n
decision, mistake, pattern, reference, todo

Zasady tagowania

\n

Zasada 1: 2-5 tagów na wspomnienie

\n

Zbyt mało tagów = słaba wykrywalność. Zbyt wiele = szum.

\n
// Dobrze: 3 istotne tagi\n{ "tags": ["synapse", "deployment", "docker"] }\n\n// Źle: 1 tag (zbyt wąsko)\n{ "tags": ["synapse"] }\n\n// Źle: 10 tagów (szum)\n{ "tags": ["synapse", "deployment", "docker", "vps1", "2026", "june", "ssh", "git", "main", "production"] }

Zasada 2: małe litery, z myślnikami

\n
✅ ci-cd, api-key, mind-key\n❌ CI-CD, APIKey, MindKey

Zasada 3: używać spójnego słownictwa

\n

Ustanowić słownik tagowania i się go trzymać:

\n
# Słownik projektów\nsynapse, synapse-mcp, synapse-chat\n\n# NIE: synapse_project, synapseProject, SYNAPSE

Zasada 4: tagować z intencją wyszukiwania

\n

Zapytać: „Jak będę szukać tego wspomnienia?"

\n
// Zapis decyzji wdrożeniowej\n{\n  "content": "Decided to use Docker Swarm for Synapse deployment",\n  "tags": ["synapse", "deployment", "docker", "swarm", "decision"]\n}\n\n// Prawdopodobne wyszukiwania: ?q=docker+swarm lub ?tag=deployment

Wzorce

\n

Wzorzec 1: projekt + temat

\n
{ "tags": ["synapse", "deployment"] }\n{ "tags": ["synapse", "auth"] }\n{ "tags": ["synapse-mcp", "tools"] }

Wyszukiwanie: ?tag=synapse (wszystkie wspomnienia projektu Synapse)\nWyszukiwanie: ?tag=synapse&q=deployment (wspomnienia wdrożeniowe w Synapse)

\n

Wzorzec 2: typ + domena

\n
{ "tags": ["mistake", "deployment"] }\n{ "tags": ["decision", "database"] }\n{ "tags": ["pattern", "auth"] }

Wyszukiwanie: ?tag=mistake (wszystkie błędy)\nWyszukiwanie: ?tag=mistake&q=deployment (błędy wdrożeniowe)

\n

Wzorzec 3: hierarchiczny

\n

Dla podprojektów w projekcie:

\n
{ "tags": ["synapse", "synapse-docs", "markdown"] }\n{ "tags": ["synapse", "synapse-mcp", "mcp"] }\n{ "tags": ["synapse", "synapse-admin", "ui"] }

Wyszukiwanie: ?tag=synapse (cały Synapse)\nWyszukiwanie: ?tag=synapse-docs (tylko podprojekt dokumentów)

\n

Wzorzec 4: śledzenie statusu

\n
// Aktywny projekt\n{ "tags": ["synapse", "active"], "priority": "high" }\n\n// Ukończony projekt\n{ "tags": ["synapse-v1", "completed"], "priority": "low" }\n\n// Zablokowany\n{ "tags": ["synapse-v2", "blocked"], "priority": "high" }

Typowe przypadki użycia

\n

Znalezienie wszystkich decyzji o projekcie

\n
curl -H "Authorization: Bearer $KEY" \\\n     ".../memory/search?q=decision&tag=synapse"

Znalezienie wszystkich błędów w domenie

\n
curl -H "Authorization: Bearer $KEY" \\\n     ".../memory/search?q=mistake&tag=deployment"

Znalezienie aktywnej pracy

\n
curl -H "Authorization: Bearer $KEY" \\\n     ".../memory/by-tag?tag=active"

Znalezienie wspomnień o technologii

\n
curl -H "Authorization: Bearer $KEY" \\\n     ".../memory/search?q=postgres+performance&tag=database"

Utrzymanie tagów

\n

Okresowy przegląd

\n
# Znalezienie rzadko używanych tagów (kandydatów do czyszczenia)\ntags = requests.get(f"{URL}/memory/tags",\n    headers={"Authorization": f"Bearer {KEY}"}).json()\n\nfor tag, count in tags.items():\n    if count < 2:\n        print(f"Rare tag: {tag} ({count} memories)")

Scalanie tagów

\n

Jeśli istnieją niespójne tagi (docker i Docker), scalić je:

\n
# Znalezienie wszystkich wspomnień z tagiem „Docker"\nmems = requests.get(f"{URL}/memory/by-tag?tag=Docker",\n    headers={"Authorization": f"Bearer {KEY}"}).json()\n\n# Aktualizacja każdego na „docker"\nfor mem in mems["results"]:\n    tags = [t.lower() for t in mem["tags"]]\n    update_memory(mem["id"], tags=list(set(tags)))

Najlepsze praktyki

\n

Następne kroki

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