{"title":"Стратегія тегування пам'яті","slug":"memory-tagging-strategy","category":"llm-cookbook","summary":"Як тегувати спогади для ефективного пошуку та фільтрації — система тегування, що масштабується.","audience":["llm"],"tags":["cookbook","tagging","memory","strategy"],"difficulty":"intermediate","updated":"2026-06-27","word_count":342,"read_minutes":2,"lang":"uk","translated":true,"requested_lang":"uk","content_markdown":"\n# Стратегія тегування пам'яті\n\nТеги — це секрет масштабованого отримання спогадів. Цей посібник показує, як\nтегувати спогади, щоб потрібні поверталися у потрібний момент.\n\n## Чому теги важливі\n\nБез тегів ви маєте плаский повнотекстовий пошук. Із тегами ви маєте структуровану\nнавігацію:\n\n```bash\n# Without tags: search everything\nGET /memory/search?q=docker\n\n# With tags: filter by project + technology\nGET /memory/search?q=deployment&tag=synapse&tag=docker\n```\n\nТеги дають змогу:\n\n- **Швидко фільтрувати** — `GET /memory/by-tag?tag=production`\n- **Обмежувати пошук** — `?q=auth&tag=project-x`\n- **Групувати** — знайти всі спогади типу «mistake» для проєкту\n- **Перехресно посилатися** — спогади зі спільними тегами пов'язані\n\n## Схема тегування\n\n### Теги проєктів\n\nВикористовуйте назви проєктів як теги:\n\n```\nsynapse, synapse-mcp, synapse-chat, synapse-sdk\n```\n\n### Теги технологій\n\nВикористовуйте назви технологій:\n\n```\ndocker, kubernetes, postgres, fastify, react, typescript\n```\n\n### Теги тем\n\nВикористовуйте тематичні категорії:\n\n```\ndeployment, ci-cd, auth, database, frontend, backend, security\n```\n\n### Теги статусу\n\nВикористовуйте індикатори стану:\n\n```\nactive, completed, blocked, deprecated\n```\n\n### Теги типу\n\nВикористовуйте індикатори типу:\n\n```\ndecision, mistake, pattern, reference, todo\n```\n\n## Правила тегування\n\n### Правило 1: 2–5 тегів на спогад\n\nЗамало тегів = слабка виявляємість. Забагато = шум.\n\n```json\n// Good: 3 relevant tags\n{ \"tags\": [\"synapse\", \"deployment\", \"docker\"] }\n\n// Bad: 1 tag (too narrow)\n{ \"tags\": [\"synapse\"] }\n\n// Bad: 10 tags (noise)\n{ \"tags\": [\"synapse\", \"deployment\", \"docker\", \"vps1\", \"2026\", \"june\", \"ssh\", \"git\", \"main\", \"production\"] }\n```\n\n### Правило 2: нижній регістр, через дефіс\n\n```\n✅ ci-cd, api-key, mind-key\n❌ CI-CD, APIKey, MindKey\n```\n\n### Правило 3: використовуйте послідовний словник\n\nУстановіть словник тегів і дотримуйтесь його:\n\n```\n# Project vocabulary\nsynapse, synapse-mcp, synapse-chat\n\n# NOT: synapse_project, synapseProject, SYNAPSE\n```\n\n### Правило 4: тегуйте з наміром пошуку\n\nЗапитайте себе: «Як я шукатиму цей спогад?»\n\n```json\n// Storing a deployment decision\n{\n \"content\": \"Decided to use Docker Swarm for Synapse deployment\",\n \"tags\": [\"synapse\", \"deployment\", \"docker\", \"swarm\", \"decision\"]\n}\n\n// You'll likely search: ?q=docker+swarm or ?tag=deployment\n```\n\n## Шаблони\n\n### Шаблон 1: проєкт + тема\n\n```json\n{ \"tags\": [\"synapse\", \"deployment\"] }\n{ \"tags\": [\"synapse\", \"auth\"] }\n{ \"tags\": [\"synapse-mcp\", \"tools\"] }\n```\n\nПошук: `?tag=synapse` (усі спогади проєкту Synapse)\nПошук: `?tag=synapse&q=deployment` (спогади про розгортання в Synapse)\n\n### Шаблон 2: тип + домен\n\n```json\n{ \"tags\": [\"mistake\", \"deployment\"] }\n{ \"tags\": [\"decision\", \"database\"] }\n{ \"tags\": [\"pattern\", \"auth\"] }\n```\n\nПошук: `?tag=mistake` (усі помилки)\nПошук: `?tag=mistake&q=deployment` (помилки розгортання)\n\n### Шаблон 3: ієрархічний\n\nДля підпроєктів у межах проєкту:\n\n```json\n{ \"tags\": [\"synapse\", \"synapse-docs\", \"markdown\"] }\n{ \"tags\": [\"synapse\", \"synapse-mcp\", \"mcp\"] }\n{ \"tags\": [\"synapse\", \"synapse-admin\", \"ui\"] }\n```\n\nПошук: `?tag=synapse` (увесь Synapse)\nПошук: `?tag=synapse-docs` (лише підпроєкт docs)\n\n### Шаблон 4: відстеження статусу\n\n```json\n// Active project\n{ \"tags\": [\"synapse\", \"active\"], \"priority\": \"high\" }\n\n// Completed project\n{ \"tags\": [\"synapse-v1\", \"completed\"], \"priority\": \"low\" }\n\n// Blocked\n{ \"tags\": [\"synapse-v2\", \"blocked\"], \"priority\": \"high\" }\n```\n\n## Типові випадки використання\n\n### Знайти всі рішення щодо проєкту\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=decision&tag=synapse\"\n```\n\n### Знайти всі помилки в домені\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=mistake&tag=deployment\"\n```\n\n### Знайти активну роботу\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/by-tag?tag=active\"\n```\n\n### Знайти спогади про технологію\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=postgres+performance&tag=database\"\n```\n\n## Супровід тегів\n\n### Періодичний перегляд\n\n```python\n# Find rarely-used tags (candidates for cleanup)\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### Об'єднання тегів\n\nЯкщо у вас непослідовні теги (`docker` і `Docker`), об'єднайте їх:\n\n```python\n# Find all memories with \"Docker\" tag\nmems = requests.get(f\"{URL}/memory/by-tag?tag=Docker\",\n headers={\"Authorization\": f\"Bearer {KEY}\"}).json()\n\n# Update each to use \"docker\" instead\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## Найкращі практики\n\n> [!TIP]\n> - **Установіть словник якомога раніше** — послідовні теги з першого дня\n> - **Тегуйте з наміром пошуку** — як ви знайдете це пізніше?\n> - **2–5 тегів — золота середина** — замало чи забагато — погано\n> - **Нижній регістр + дефіси** — `ci-cd`, а не `CI/CD`\n> - **Переглядайте періодично** — об'єднуйте дублікати, видаляйте невикористані\n\n## Наступні кроки\n\n- [Найкращі практики для пам'яті](/docs/guides/memory-best-practices)\n- [Пошук FTS5](/docs/concepts/fts5-search)\n- [Робочий процес на основі завдань](/docs/llm-cookbook/task-driven-workflow)\n","content_html":"

Стратегія тегування пам'яті

\n

Теги — це секрет масштабованого отримання спогадів. Цей посібник показує, як\nтегувати спогади, щоб потрібні поверталися у потрібний момент.

\n

Чому теги важливі

\n

Без тегів ви маєте плаский повнотекстовий пошук. Із тегами ви маєте структуровану\nнавігацію:

\n
# Without tags: search everything\nGET /memory/search?q=docker\n\n# With tags: filter by project + technology\nGET /memory/search?q=deployment&tag=synapse&tag=docker

Теги дають змогу:

\n\n

Схема тегування

\n

Теги проєктів

\n

Використовуйте назви проєктів як теги:

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

Теги технологій

\n

Використовуйте назви технологій:

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

Теги тем

\n

Використовуйте тематичні категорії:

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

Теги статусу

\n

Використовуйте індикатори стану:

\n
active, completed, blocked, deprecated

Теги типу

\n

Використовуйте індикатори типу:

\n
decision, mistake, pattern, reference, todo

Правила тегування

\n

Правило 1: 2–5 тегів на спогад

\n

Замало тегів = слабка виявляємість. Забагато = шум.

\n
// Good: 3 relevant tags\n{ "tags": ["synapse", "deployment", "docker"] }\n\n// Bad: 1 tag (too narrow)\n{ "tags": ["synapse"] }\n\n// Bad: 10 tags (noise)\n{ "tags": ["synapse", "deployment", "docker", "vps1", "2026", "june", "ssh", "git", "main", "production"] }

Правило 2: нижній регістр, через дефіс

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

Правило 3: використовуйте послідовний словник

\n

Установіть словник тегів і дотримуйтесь його:

\n
# Project vocabulary\nsynapse, synapse-mcp, synapse-chat\n\n# NOT: synapse_project, synapseProject, SYNAPSE

Правило 4: тегуйте з наміром пошуку

\n

Запитайте себе: «Як я шукатиму цей спогад?»

\n
// Storing a deployment decision\n{\n  "content": "Decided to use Docker Swarm for Synapse deployment",\n  "tags": ["synapse", "deployment", "docker", "swarm", "decision"]\n}\n\n// You'll likely search: ?q=docker+swarm or ?tag=deployment

Шаблони

\n

Шаблон 1: проєкт + тема

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

Пошук: ?tag=synapse (усі спогади проєкту Synapse)\nПошук: ?tag=synapse&q=deployment (спогади про розгортання в Synapse)

\n

Шаблон 2: тип + домен

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

Пошук: ?tag=mistake (усі помилки)\nПошук: ?tag=mistake&q=deployment (помилки розгортання)

\n

Шаблон 3: ієрархічний

\n

Для підпроєктів у межах проєкту:

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

Пошук: ?tag=synapse (увесь Synapse)\nПошук: ?tag=synapse-docs (лише підпроєкт docs)

\n

Шаблон 4: відстеження статусу

\n
// Active project\n{ "tags": ["synapse", "active"], "priority": "high" }\n\n// Completed project\n{ "tags": ["synapse-v1", "completed"], "priority": "low" }\n\n// Blocked\n{ "tags": ["synapse-v2", "blocked"], "priority": "high" }

Типові випадки використання

\n

Знайти всі рішення щодо проєкту

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

Знайти всі помилки в домені

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

Знайти активну роботу

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

Знайти спогади про технологію

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

Супровід тегів

\n

Періодичний перегляд

\n
# Find rarely-used tags (candidates for cleanup)\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

Якщо у вас непослідовні теги (docker і Docker), об'єднайте їх:

\n
# Find all memories with "Docker" tag\nmems = requests.get(f"{URL}/memory/by-tag?tag=Docker",\n    headers={"Authorization": f"Bearer {KEY}"}).json()\n\n# Update each to use "docker" instead\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","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"]}