{"title":"Estrategia de etiquetado de memoria","slug":"memory-tagging-strategy","category":"llm-cookbook","summary":"Cómo etiquetar memorias para una búsqueda y filtrado efectivos — el sistema de etiquetado que escala.","audience":["llm"],"tags":["cookbook","tagging","memory","strategy"],"difficulty":"intermediate","updated":"2026-06-27","word_count":382,"read_minutes":2,"lang":"es","translated":true,"requested_lang":"es","content_markdown":"\n# Estrategia de etiquetado de memoria\n\nLas etiquetas son el secreto de la recuperación de memoria escalable. Esta\nguía muestra cómo etiquetar memorias para que las correctas vuelvan en el\nmomento adecuado.\n\n## Por qué importan las etiquetas\n\nSin etiquetas, tiene una búsqueda plana de texto completo. Con etiquetas, tiene\nnavegación estructurada:\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\nLas etiquetas habilitan:\n\n- **Filtrado rápido** — `GET /memory/by-tag?tag=production`\n- **Búsqueda acotada** — `?q=auth&tag=project-x`\n- **Agrupación** — encuentra todas las memorias \"mistake\" de un proyecto\n- **Referencias cruzadas** — memorias que comparten etiquetas están relacionadas\n\n## Esquema de etiquetado\n\n### Etiquetas de proyecto\n\nUse nombres de proyecto como etiquetas:\n\n```\nsynapse, synapse-mcp, synapse-chat, synapse-sdk\n```\n\n### Etiquetas de tecnología\n\nUse nombres de tecnología:\n\n```\ndocker, kubernetes, postgres, fastify, react, typescript\n```\n\n### Etiquetas de tema\n\nUse categorías de tema:\n\n```\ndeployment, ci-cd, auth, database, frontend, backend, security\n```\n\n### Etiquetas de estado\n\nUse indicadores de estado:\n\n```\nactive, completed, blocked, deprecated\n```\n\n### Etiquetas de tipo\n\nUse indicadores de tipo:\n\n```\ndecision, mistake, pattern, reference, todo\n```\n\n## Reglas de etiquetado\n\n### Regla 1: 2-5 etiquetas por memoria\n\nMuy pocas etiquetas = poca descubribilidad. Demasiadas = ruido.\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### Regla 2: Minúsculas, con guiones\n\n```\n✅ ci-cd, api-key, mind-key\n❌ CI-CD, APIKey, MindKey\n```\n\n### Regla 3: Use vocabulario consistente\n\nEstablezca un vocabulario de etiquetado y manténgalo:\n\n```\n# Project vocabulary\nsynapse, synapse-mcp, synapse-chat\n\n# NOT: synapse_project, synapseProject, SYNAPSE\n```\n\n### Regla 4: Etiquete con intención de búsqueda\n\nPregúntese: \"¿Cómo buscaré esta memoria?\"\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## Patrones\n\n### Patrón 1: Proyecto + Tema\n\n```json\n{ \"tags\": [\"synapse\", \"deployment\"] }\n{ \"tags\": [\"synapse\", \"auth\"] }\n{ \"tags\": [\"synapse-mcp\", \"tools\"] }\n```\n\nBúsqueda: `?tag=synapse` (todas las memorias del proyecto Synapse)\nBúsqueda: `?tag=synapse&q=deployment` (memorias de deployment en Synapse)\n\n### Patrón 2: Tipo + Dominio\n\n```json\n{ \"tags\": [\"mistake\", \"deployment\"] }\n{ \"tags\": [\"decision\", \"database\"] }\n{ \"tags\": [\"pattern\", \"auth\"] }\n```\n\nBúsqueda: `?tag=mistake` (todos los errores)\nBúsqueda: `?tag=mistake&q=deployment` (errores de deployment)\n\n### Patrón 3: Jerárquico\n\nPara subproyectos dentro de un proyecto:\n\n```json\n{ \"tags\": [\"synapse\", \"synapse-docs\", \"markdown\"] }\n{ \"tags\": [\"synapse\", \"synapse-mcp\", \"mcp\"] }\n{ \"tags\": [\"synapse\", \"synapse-admin\", \"ui\"] }\n```\n\nBúsqueda: `?tag=synapse` (todo Synapse)\nBúsqueda: `?tag=synapse-docs` (solo el subproyecto de docs)\n\n### Patrón 4: Seguimiento de estado\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## Casos de uso comunes\n\n### Encontrar todas las decisiones de un proyecto\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=decision&tag=synapse\"\n```\n\n### Encontrar todos los errores de un dominio\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=mistake&tag=deployment\"\n```\n\n### Encontrar trabajo activo\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/by-tag?tag=active\"\n```\n\n### Encontrar memorias sobre una tecnología\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=postgres+performance&tag=database\"\n```\n\n## Mantenimiento de etiquetas\n\n### Revisión periódica\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### Fusionar etiquetas\n\nSi tiene etiquetas inconsistentes (`docker` y `Docker`), fúndalas:\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## Mejores prácticas\n\n> [!TIP]\n> - **Establezca el vocabulario temprano** — etiquetas consistentes desde el día 1\n> - **Etiquete con intención de búsqueda** — ¿cómo encontrará esto después?\n> - **2-5 etiquetas es el punto óptimo** — muy pocas o demasiadas es malo\n> - **Minúsculas + guiones** — `ci-cd` no `CI/CD`\n> - **Revise periódicamente** — fusione duplicados, elimine las no usadas\n\n## Próximos pasos\n\n- [Mejores prácticas de memoria](/docs/guides/memory-best-practices)\n- [Búsqueda FTS5](/docs/concepts/fts5-search)\n- [Workflow basado en tareas](/docs/llm-cookbook/task-driven-workflow)\n","content_html":"

Estrategia de etiquetado de memoria

\n

Las etiquetas son el secreto de la recuperación de memoria escalable. Esta\nguía muestra cómo etiquetar memorias para que las correctas vuelvan en el\nmomento adecuado.

\n

Por qué importan las etiquetas

\n

Sin etiquetas, tiene una búsqueda plana de texto completo. Con etiquetas, tiene\nnavegación estructurada:

\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

Las etiquetas habilitan:

\n\n

Esquema de etiquetado

\n

Etiquetas de proyecto

\n

Use nombres de proyecto como etiquetas:

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

Etiquetas de tecnología

\n

Use nombres de tecnología:

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

Etiquetas de tema

\n

Use categorías de tema:

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

Etiquetas de estado

\n

Use indicadores de estado:

\n
active, completed, blocked, deprecated

Etiquetas de tipo

\n

Use indicadores de tipo:

\n
decision, mistake, pattern, reference, todo

Reglas de etiquetado

\n

Regla 1: 2-5 etiquetas por memoria

\n

Muy pocas etiquetas = poca descubribilidad. Demasiadas = ruido.

\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"] }

Regla 2: Minúsculas, con guiones

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

Regla 3: Use vocabulario consistente

\n

Establezca un vocabulario de etiquetado y manténgalo:

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

Regla 4: Etiquete con intención de búsqueda

\n

Pregúntese: "¿Cómo buscaré esta memoria?"

\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

Patrones

\n

Patrón 1: Proyecto + Tema

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

Búsqueda: ?tag=synapse (todas las memorias del proyecto Synapse)\nBúsqueda: ?tag=synapse&q=deployment (memorias de deployment en Synapse)

\n

Patrón 2: Tipo + Dominio

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

Búsqueda: ?tag=mistake (todos los errores)\nBúsqueda: ?tag=mistake&q=deployment (errores de deployment)

\n

Patrón 3: Jerárquico

\n

Para subproyectos dentro de un proyecto:

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

Búsqueda: ?tag=synapse (todo Synapse)\nBúsqueda: ?tag=synapse-docs (solo el subproyecto de docs)

\n

Patrón 4: Seguimiento de estado

\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" }

Casos de uso comunes

\n

Encontrar todas las decisiones de un proyecto

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

Encontrar todos los errores de un dominio

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

Encontrar trabajo activo

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

Encontrar memorias sobre una tecnología

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

Mantenimiento de etiquetas

\n

Revisión periódica

\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)")

Fusionar etiquetas

\n

Si tiene etiquetas inconsistentes (docker y Docker), fúndalas:

\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)))

Mejores prácticas

\n

Próximos pasos

\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"]}