{"title":"Búsqueda de texto completo FTS5","slug":"fts5-search","category":"concepts","summary":"Cómo Synapse usa SQLite FTS5 para búsqueda de texto completo de memoria sub-milisegundo.","audience":["human","llm"],"tags":["concept","search","fts5","fulltext"],"difficulty":"advanced","updated":"2026-06-27","word_count":625,"read_minutes":3,"lang":"es","translated":true,"requested_lang":"es","content_markdown":"\n# Búsqueda de texto completo FTS5\n\nSynapse usa FTS5 (Full-Text Search 5) para búsqueda de memoria rápida y\nflexible. Esta página explica cómo funciona y cómo usarlo eficazmente.\n\n## ¿Qué es FTS5?\n\nFTS5 es una extensión de SQLite (también disponible en PostgreSQL vía\nextensiones) que proporciona capacidades de búsqueda de texto completo. Esta\npersona:\n\n- Indexa contenido de texto para búsqueda rápida por palabra clave\n- Admite operadores booleanos (AND, OR, NOT)\n- Admite coincidencia de frases con comillas\n- Admite coincidencia por prefijo con `*`\n- Ordena resultados por relevancia\n\nSynapse usa FTS5 para indexar todo el contenido de memoria, lo que habilita\nbúsqueda sub-milisegundo entre miles de memorias.\n\n## Cómo Synapse usa FTS5\n\nCuando hace `POST /memory`:\n\n1. El contenido de la memoria se almacena en la tabla `memories`\n2. El contenido también se inserta en la tabla virtual FTS5\n3. FTS5 tokeniza e indexa el contenido automáticamente\n\nCuando hace `GET /memory/search?q=...`:\n\n1. Synapse parsea la consulta usando la sintaxis FTS5\n2. Ejecuta un `MATCH` contra el índice FTS5\n3. Filtra por `mind_id` (aislamiento de tenant)\n4. Devuelve resultados ordenados por relevancia\n\n## Sintaxis de consulta\n\n### Búsqueda simple por palabra clave\n\n```\n?q=docker\n```\n\nDevuelve memorias que contienen \"docker\".\n\n### Múltiples palabras clave (AND implícito)\n\n```\n?q=docker+swarm\n?q=docker%20swarm\n```\n\nDevuelve memorias que contienen BOTH \"docker\" AND \"swarm\".\n\n### Coincidencia de frase\n\n```\n?q=\"docker+swarm\"\n?q=%22docker%20swarm%22\n```\n\nDevuelve memorias que contienen la frase exacta \"docker swarm\".\n\n### Coincidencia por prefijo\n\n```\n?q=docker*\n```\n\nDevuelve memorias que contienen palabras que comienzan por \"docker\" (p. ej.\n\"dockers\", \"dockerfile\", \"dockerize\").\n\n### OR booleano\n\n```\n?q=docker+OR+kubernetes\n```\n\nDevuelve memorias que contienen \"docker\" OR \"kubernetes\".\n\n### NOT booleano\n\n```\n?q=docker+-swarm\n?q=docker+NOT+swarm\n```\n\nDevuelve memorias que contienen \"docker\" pero NOT \"swarm\".\n\n### Agrupamiento\n\n```\n?q=(docker+OR+kubernetes)+-test\n```\n\nDevuelve memorias que contienen \"docker\" o \"kubernetes\", pero no \"test\".\n\n## Ejemplos prácticos\n\n### Buscar memorias sobre un proyecto\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=synapse+deployment\"\n```\n\n### Buscar frase exacta\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=%22docker+swarm%22\"\n```\n\n### Excluir memorias de test\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=production+-test\"\n```\n\n### Buscar por tecnología\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=(postgres+OR+sqlite)+-mysql\"\n```\n\n## Ranking\n\nFTS5 ordena los resultados por relevancia usando el algoritmo BM25. Factores:\n\n- Frecuencia del término (con qué frecuencia aparece)\n- Frecuencia inversa de documento (términos más raros obtienen mayor ranking)\n- Longitud del documento (documentos más cortos con el término suben)\n- Peso de columna (title > content)\n\nLos resultados se devuelven en orden de ranking (más relevantes primero).\n\n## Rendimiento\n\n| Operación | Latencia |\n|-----------|---------|\n| Search 100 memories | < 5ms |\n| Search 1,000 memories | < 10ms |\n| Search 10,000 memories | < 25ms |\n| Search 100,000 memories | < 100ms |\n\nFTS5 está altamente optimizado para cargas de trabajo con muchas lecturas.\n\n## Limitaciones\n\n### Stemming\n\nFTS5 no hace stemming por defecto. \"running\" y \"run\" son términos diferentes.\n\n**Workaround:** Use coincidencia por prefijo: `?q=run*`\n\n### Tolerancia a erratas\n\nFTS5 no admite coincidencia difusa. Una errata no devolverá resultados.\n\n**Workaround:** Use búsqueda semántica (`/memory/semantic-search`) para\ncoincidencia conceptual.\n\n### Stop words\n\nLas palabras comunes (the, a, an, is) se indexan pero pueden no ser útiles para\nla búsqueda. FTS5 lo gestiona automáticamente.\n\n## FTS5 vs Búsqueda semántica\n\n| Aspecto | FTS5 | Búsqueda semántica |\n|--------|------|-----------------|\n| Velocidad | Sub-milisegundo | 50-100ms |\n| Coincidencia | Palabras clave exactas | Conceptual |\n| Tolerancia a erratas | Ninguna | Alguna |\n| Stemming | Ninguno | Implícito |\n| Requiere embeddings | No | Sí |\n| Mejor para | Términos específicos | Conceptos |\n\nUse FTS5 cuando conozca las palabras clave. Use búsqueda semántica cuando quiera\n\"memorias sobre X\" donde X se describe de forma diferente.\n\n## Mejores prácticas\n\n> [!TIP]\n> - **Use términos específicos** — \"docker swarm\" vence a \"container orchestration\"\n> - **Encadene frases entre comillas** — `\"docker swarm\"` garantiza coincidencia de frase\n> - **Use prefijo para variaciones** — `deploy*` captura \"deploy\", \"deployment\", \"deploying\"\n> - **Excluya ruido** — `-test` filtra memorias de test\n> - **Combine con etiquetas** — `?q=docker&tag=production` acota resultados\n\n## Próximos pasos\n\n- [Búsqueda semántica](/docs/concepts/semantic-search)\n- [API de Memory](/docs/api/memory)\n- [Mejores prácticas de memoria](/docs/guides/memory-best-practices)\n","content_html":"

Búsqueda de texto completo FTS5

\n

Synapse usa FTS5 (Full-Text Search 5) para búsqueda de memoria rápida y\nflexible. Esta página explica cómo funciona y cómo usarlo eficazmente.

\n

¿Qué es FTS5?

\n

FTS5 es una extensión de SQLite (también disponible en PostgreSQL vía\nextensiones) que proporciona capacidades de búsqueda de texto completo. Esta\npersona:

\n\n

Synapse usa FTS5 para indexar todo el contenido de memoria, lo que habilita\nbúsqueda sub-milisegundo entre miles de memorias.

\n

Cómo Synapse usa FTS5

\n

Cuando hace POST /memory:

\n
    \n
  1. El contenido de la memoria se almacena en la tabla memories
    2. \n
  2. El contenido también se inserta en la tabla virtual FTS5
    3. \n
  3. FTS5 tokeniza e indexa el contenido automáticamente
    4. \n
\n

Cuando hace GET /memory/search?q=...:

\n
    \n
  1. Synapse parsea la consulta usando la sintaxis FTS5
    2. \n
  2. Ejecuta un MATCH contra el índice FTS5
    3. \n
  3. Filtra por mind_id (aislamiento de tenant)
    4. \n
  4. Devuelve resultados ordenados por relevancia
    5. \n
\n

Sintaxis de consulta

\n

Búsqueda simple por palabra clave

\n
?q=docker

Devuelve memorias que contienen "docker".

\n

Múltiples palabras clave (AND implícito)

\n
?q=docker+swarm\n?q=docker%20swarm

Devuelve memorias que contienen BOTH "docker" AND "swarm".

\n

Coincidencia de frase

\n
?q="docker+swarm"\n?q=%22docker%20swarm%22

Devuelve memorias que contienen la frase exacta "docker swarm".

\n

Coincidencia por prefijo

\n
?q=docker*

Devuelve memorias que contienen palabras que comienzan por "docker" (p. ej.\n"dockers", "dockerfile", "dockerize").

\n

OR booleano

\n
?q=docker+OR+kubernetes

Devuelve memorias que contienen "docker" OR "kubernetes".

\n

NOT booleano

\n
?q=docker+-swarm\n?q=docker+NOT+swarm

Devuelve memorias que contienen "docker" pero NOT "swarm".

\n

Agrupamiento

\n
?q=(docker+OR+kubernetes)+-test

Devuelve memorias que contienen "docker" o "kubernetes", pero no "test".

\n

Ejemplos prácticos

\n

Buscar memorias sobre un proyecto

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/search?q=synapse+deployment"

Buscar frase exacta

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/search?q=%22docker+swarm%22"

Excluir memorias de test

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/search?q=production+-test"

Buscar por tecnología

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/search?q=(postgres+OR+sqlite)+-mysql"

Ranking

\n

FTS5 ordena los resultados por relevancia usando el algoritmo BM25. Factores:

\n\n

Los resultados se devuelven en orden de ranking (más relevantes primero).

\n

Rendimiento

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
OperaciónLatencia
Search 100 memories< 5ms
Search 1,000 memories< 10ms
Search 10,000 memories< 25ms
Search 100,000 memories< 100ms
\n

FTS5 está altamente optimizado para cargas de trabajo con muchas lecturas.

\n

Limitaciones

\n

Stemming

\n

FTS5 no hace stemming por defecto. "running" y "run" son términos diferentes.

\n

Workaround: Use coincidencia por prefijo: ?q=run*

\n

Tolerancia a erratas

\n

FTS5 no admite coincidencia difusa. Una errata no devolverá resultados.

\n

Workaround: Use búsqueda semántica (/memory/semantic-search) para\ncoincidencia conceptual.

\n

Stop words

\n

Las palabras comunes (the, a, an, is) se indexan pero pueden no ser útiles para\nla búsqueda. FTS5 lo gestiona automáticamente.

\n

FTS5 vs Búsqueda semántica

\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
AspectoFTS5Búsqueda semántica
VelocidadSub-milisegundo50-100ms
CoincidenciaPalabras clave exactasConceptual
Tolerancia a erratasNingunaAlguna
StemmingNingunoImplícito
Requiere embeddingsNoSí
Mejor paraTérminos específicosConceptos
\n

Use FTS5 cuando conozca las palabras clave. Use búsqueda semántica cuando quiera\n"memorias sobre X" donde X se describe de forma diferente.

\n

Mejores prácticas

\n

Próximos pasos

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