{"title":"Mejores prácticas de memoria","slug":"memory-best-practices","category":"guides","summary":"Cómo estructurar memorias para un recall efectivo — categorías, claves, etiquetas, prioridades.","audience":["human","llm"],"tags":["guide","memory","best-practices","patterns"],"difficulty":"intermediate","updated":"2026-06-27","word_count":682,"read_minutes":3,"lang":"es","translated":true,"requested_lang":"es","content_markdown":"\n# Mejores prácticas de memoria\n\nLa forma en que estructure las memorias determina cuán útiles son. Esta guía\ncubre patrones para categorizar, etiquetar y priorizar memorias para que el LLM\npueda recuperar la información correcta en el momento adecuado.\n\n## Categorías: elija la más específica\n\n| Categoría | Usar para | Ejemplo |\n|----------|---------|---------|\n| `identity` | Nombre, rol, info de contacto | `\"user_name\": \"Michael Schäfer\"` |\n| `preference` | Gustos, disgustos, estilo de trabajo | `\"communication\": \"Prefers concise responses\"` |\n| `fact` | Hechos verificables | `\"office_location\": \"Berlin, Germany\"` |\n| `project` | Estado del proyecto, decisiones | `\"project_synapse\": \"v1.5.0 deployed\"` |\n| `skill` | Habilidades del usuario | `\"skill_python\": \"Advanced, 10+ years\"` |\n| `mistake` | Errores pasados a evitar | `\"mistake_npm_version\": \"Always bump version\"` |\n| `context` | Contexto relevante para la sesión | `\"current_focus\": \"Working on docs system\"` |\n| `note` | Notas varias | `\"note_idea\": \"Try Redis for caching\"` |\n\n> [!TIP]\n> En caso de duda, use `fact` para información verificable y `note` para todo\n> lo demás. No sobrecategorice — mejor un `fact` claro que un `context`\n> confuso.\n\n## Claves: identificadores significativos\n\nEl campo `key` es el identificador de la memoria. Use claves significativas y\nestables:\n\n**Buenas claves:**\n- `user_name`\n- `project_synapse_status`\n- `preference_communication_style`\n- `mistake_npm_version_bump`\n\n**Malas claves:**\n- `mem_001` (no significativa)\n- `temp` (no descriptiva)\n- `2026-06-27-note` (la fecha no ayuda al recall)\n\n### Convenciones de nomenclatura de claves\n\n- `snake_case` (minúsculas con guiones bajos)\n- Prefije con la categoría: `preference_*`, `project_*`, `mistake_*`\n- Use sustantivos descriptivos, no verbos\n- Mantenga por debajo de 50 caracteres\n\n## Etiquetas: para búsqueda y filtrado\n\nLas etiquetas permiten filtrado y búsqueda rápida. Añada 2-5 etiquetas por\nmemoria:\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### Patrones de etiquetado\n\n- **Nombres de proyecto**: `synapse`, `synapse-mcp`, `synapse-chat`\n- **Temas**: `deployment`, `ci`, `database`, `auth`\n- **Estado**: `active`, `completed`, `blocked`\n- **Indicadores de prioridad**: `urgent`, `long-term`\n\n> [!NOTE]\n> Las etiquetas son insensibles a mayúsculas/minúsculas. Use minúsculas para\n> consistencia.\n\n## Prioridades: sea realista\n\n| Prioridad | Usar para | % de memorias |\n|----------|---------|---------------|\n| `critical` | Identidad del usuario, info legal, decisiones irreversibles | ~5% |\n| `high` | Proyectos activos, preferencias importantes | ~20% |\n| `normal` | La mayoría de hechos, notas, contexto | ~65% |\n| `low` | Efímera, bueno saberlo | ~10% |\n\n> [!WARNING]\n> No marque todo como `critical`. Si todo es crítico, nada lo es. Reserve\n> `critical` para cosas que causarían un daño real si se olvidan.\n\n## Cuándo almacenar y cuándo no\n\n### Almacene siempre\n\n- Identidad del usuario (nombre, email, rol)\n- Preferencias a largo plazo\n- Decisiones del proyecto y su justificación\n- Errores pasados y lecciones aprendidas\n- Compromisos adquiridos con el usuario\n\n### No almacene\n\n- Estado transitorio (use variables en su lugar)\n- Historial de conversación literal (lo gestiona el sistema de chat)\n- Datos sensibles (contraseñas, API keys)\n- Hechos fácilmente derivables (fecha actual, contenidos de archivos)\n- Contexto efímero (use la categoría `context` con prioridad baja)\n\n## Actualizar memorias\n\nPOST `/memory` con la misma `category` + `key` actualiza la memoria existente:\n\n```python\n# Initial store\nstore(\"project\", \"project_synapse_status\", \"v1.4.0 deployed\", priority=\"high\")\n\n# Later: update with same key\nstore(\"project\", \"project_synapse_status\", \"v1.5.0 deployed. CI green.\", priority=\"high\")\n```\n\n> [!TIP]\n> Use claves estables para poder actualizar sin crear duplicados. El LLM debe\n> volver a hacer POST con la misma clave a medida que la información cambia, no\n> crear nuevas memorias.\n\n## Ciclo de vida de la memoria\n\n```\nCreate → Active → Stale → Archive → Delete\n```\n\n- **Create**: POST /memory con contexto completo\n- **Active**: Recall frecuente, actualizar según sea necesario\n- **Stale**: Aún relevante pero no usado activamente (¿bajar prioridad?)\n- **Archive**: Establecer prioridad a `low`, conservar como referencia histórica\n- **Delete**: DELETE /memory/:id cuando ya no sea relevante\n\n### Limpieza periódica\n\n```python\n# Find memories not updated in 90 days\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 # Either delete or lower priority\n if is_obsolete(mem):\n delete_memory(mem[\"id\"])\n else:\n update_memory(mem[\"id\"], priority=\"low\")\n```\n\n## Patrón: herencia de memoria\n\nPara contexto jerárquico (proyecto → subproyecto → tarea):\n\n```python\n# Parent project\nstore(\"project\", \"project_synapse\", \"Main Synapse project\", \n tags=[\"synapse\", \"parent\"], priority=\"high\")\n\n# Sub-project (tags link to parent)\nstore(\"project\", \"project_synapse_docs\", \"Docs system for Synapse\",\n tags=[\"synapse\", \"docs\", \"synapse-parent\"], priority=\"high\")\n\n# Specific task (tags link to sub-project)\nstore(\"project\", \"task_docs_loader\", \"Implement docs-loader.ts\",\n tags=[\"synapse\", \"docs\", \"task\"], priority=\"normal\")\n```\n\nEl LLM puede entonces buscar `q=synapse+docs` para encontrar todas las memorias\nrelacionadas.\n\n## Patrón: log de decisiones\n\nAlmacene decisiones con su justificación para que el LLM no las vuelva a\ncuestionar:\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## Patrón: evitar errores\n\nAlmacene errores con instrucciones específicas de prevención:\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## Antipatrones a evitar\n\n> [!WARNING]\n> - **Almacenar logs de conversación** — lo gestiona el sistema de chat\n> - **Almacenar archivos completos** — use script store o almacenamiento externo\n> - **Almacenar estado efímero** — use variables\n> - **Almacenar secretos** — use variables de entorno\n> - **Duplicar memorias** — use claves estables\n> - **Sobreetiquetar** — 2-5 etiquetas por memoria es lo ideal\n> - **Todo es crítico** — sea realista con las prioridades\n\n## Próximos pasos\n\n- [API de Memory](/docs/api/memory)\n- [Agente LLM persistente](/docs/guides/persistent-llm-agent)\n- [Estrategia de etiquetado de memoria](/docs/llm-cookbook/memory-tagging-strategy)\n","content_html":"

Mejores prácticas de memoria

\n

La forma en que estructure las memorias determina cuán útiles son. Esta guía\ncubre patrones para categorizar, etiquetar y priorizar memorias para que el LLM\npueda recuperar la información correcta en el momento adecuado.

\n

Categorías: elija la más específica

\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
CategoríaUsar paraEjemplo
identityNombre, rol, info de contacto"user_name": "Michael Schäfer"
preferenceGustos, disgustos, estilo de trabajo"communication": "Prefers concise responses"
factHechos verificables"office_location": "Berlin, Germany"
projectEstado del proyecto, decisiones"project_synapse": "v1.5.0 deployed"
skillHabilidades del usuario"skill_python": "Advanced, 10+ years"
mistakeErrores pasados a evitar"mistake_npm_version": "Always bump version"
contextContexto relevante para la sesión"current_focus": "Working on docs system"
noteNotas varias"note_idea": "Try Redis for caching"
\n
En caso de duda, use `fact` para información verificable y `note` para todo\nlo demás. No sobrecategorice — mejor un `fact` claro que un `context`\nconfuso.

Claves: identificadores significativos

\n

El campo key es el identificador de la memoria. Use claves significativas y\nestables:

\n

Buenas claves:

\n\n

Malas claves:

\n\n

Convenciones de nomenclatura de claves

\n\n

Etiquetas: para búsqueda y filtrado

\n

Las etiquetas permiten filtrado y búsqueda rápida. Añada 2-5 etiquetas por\nmemoria:

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

Patrones de etiquetado

\n\n
Las etiquetas son insensibles a mayúsculas/minúsculas. Use minúsculas para\nconsistencia.

Prioridades: sea realista

\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
PrioridadUsar para% de memorias
criticalIdentidad del usuario, info legal, decisiones irreversibles~5%
highProyectos activos, preferencias importantes~20%
normalLa mayoría de hechos, notas, contexto~65%
lowEfímera, bueno saberlo~10%
\n
No marque todo como `critical`. Si todo es crítico, nada lo es. Reserve\n`critical` para cosas que causarían un daño real si se olvidan.

Cuándo almacenar y cuándo no

\n

Almacene siempre

\n\n

No almacene

\n\n

Actualizar memorias

\n

POST /memory con la misma category + key actualiza la memoria existente:

\n
# Initial store\nstore("project", "project_synapse_status", "v1.4.0 deployed", priority="high")\n\n# Later: update with same key\nstore("project", "project_synapse_status", "v1.5.0 deployed. CI green.", priority="high")
Use claves estables para poder actualizar sin crear duplicados. El LLM debe\nvolver a hacer POST con la misma clave a medida que la información cambia, no\ncrear nuevas memorias.

Ciclo de vida de la memoria

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

Limpieza periódica

\n
# Find memories not updated in 90 days\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        # Either delete or lower priority\n        if is_obsolete(mem):\n            delete_memory(mem["id"])\n        else:\n            update_memory(mem["id"], priority="low")

Patrón: herencia de memoria

\n

Para contexto jerárquico (proyecto → subproyecto → tarea):

\n
# Parent project\nstore("project", "project_synapse", "Main Synapse project", \n      tags=["synapse", "parent"], priority="high")\n\n# Sub-project (tags link to parent)\nstore("project", "project_synapse_docs", "Docs system for Synapse",\n      tags=["synapse", "docs", "synapse-parent"], priority="high")\n\n# Specific task (tags link to sub-project)\nstore("project", "task_docs_loader", "Implement docs-loader.ts",\n      tags=["synapse", "docs", "task"], priority="normal")

El LLM puede entonces buscar q=synapse+docs para encontrar todas las memorias\nrelacionadas.

\n

Patrón: log de decisiones

\n

Almacene decisiones con su justificación para que el LLM no las vuelva a\ncuestionar:

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

Patrón: evitar errores

\n

Almacene errores con instrucciones específicas de prevención:

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

Antipatrones a evitar

\n

Próximos pasos

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