Prólogo · La biblioteca cerrada

Hubo un día, no hace mucho, en que el corpus estuvo terminado. No "casi terminado" ni "terminado salvo detalles": terminado. Los dominios acotados, el Bronce capturado, el Silver curado y clasificado, el Gold sintetizado y firmado por expertos, el dataset áureo en verde con un Quality Score del 96 por ciento. El Rack —esa estantería limpia donde cada píldora de información duerme junto a su doble campo, su texto para leer y su vector para buscar— estaba en producción, idempotente, versionado en Git, replicado en cada despliegue. Después de meses de arar, el granero estaba lleno.

La primera consulta real llegó a las nueve y veinte de la mañana. La planteó un usuario cualquiera, sin ceremonia, porque los usuarios reales nunca tienen ceremonia: "¿La empresa cuántos días tiene para notificar un despido objetivo?". El sistema devolvió cinco píldoras. Cuatro hablaban de despidos. Ninguna respondía a la pregunta. Una citaba un convenio de otra provincia, otra era un fragmento de sentencia sobre salarios de tramitación, otra mencionaba el plazo correcto, de pasada, enterrado en el inciso de un párrafo sobre otra cosa. El modelo de lenguaje, cortés como siempre, redactó una respuesta fluida a partir de nada. Fluida y equivocada.

Ese día aprendimos la lección que da origen a este libro: un corpus excelente con un acceso mediocre es una biblioteca cerrada con llave. Todo el conocimiento está dentro, perfectamente ordenado, y sin embargo la pregunta no encuentra respuesta. Peor aún: con coincidencias mediocres, con la confianza del necio, el sistema responde, responde rápido y responde con soltura, nadie sospecha que está respondiendo desde la suposición y la información mediocre, y no desde el conocimiento de la píldora concreta. La información estaba ahí, no supimos sacarla.

El 20 por ciento donde todo se cobra

En el primer libro defendimos una tesis incómoda: el 80 por ciento del éxito de un sistema RAG ocurre antes del prompt. Nadie enseña qué se le da a comer a la IA; todos enseñan qué pedirle. Ese libro fue el relato de ese 80 por ciento: cómo convertir documentos dispersos, PDF imposibles y saber tácito de un despacho laboral en un corpus validado, dominio a dominio, con método en lugar de fe.

Pero hay un 20 por ciento restante, y no es el sobrante: es el momento de la verdad. Es el 20 por ciento donde el usuario formula su pregunta, donde el motor decide qué píldoras entran en escena y cuáles se quedan fuera, y donde el modelo redacta la respuesta. Si el 80 por ciento anterior construyó la cosecha, este 20 es el que la reparte. Y un mal reparto —píldoras irrelevantes, documentos caducados que se cuelan, la evidencia clave en el puesto doce cuando solo caben cinco— arruina una cosecha impecable.

Este libro es el relato de ese reparto. Del momento en que llega la pregunta al momento en que el contexto queda ensamblado. A ese tramo entero lo llamamos el acceso al conocimiento, y aunque ocupa menos pantalla que la construcción del corpus, tiene la misma densidad de decisiones de arquitectura: qué facetas trazan el mapa, cuándo filtrar antes de buscar y cuándo después, por qué combinar dos motores mediocres produce uno excelente, cómo elegir el tope de resultados como se elige una política y no como se copia un parámetro, y qué hace realmente un reranker cuando reordena el mundo.

Qué van a encontrar — y qué no

Como en la primera entrega, aquí no hay código. No habrá snippets de Python, ni llamadas a APIs, ni configuraciones de motor vectorial que copiar y pegar. Quien busque eso tiene la documentación de una docena de productos a un clic. Aquí hay algo más escaso: método, criterio y plantillas. Qué decisiones hay que tomar, en qué orden, con qué criterios, cómo comprobar que se han tomado bien y cómo detectar que el cambio de la semana pasada rompió algo que nadie miraba.

Sí habrá, en cambio, conceptos bien explicados. Cada técnica del libro —el pre-filtrado, el híbrido, el rerank, las métricas de recuperación— se presenta igual: qué hace, por qué existe, qué aporta cuando se usa bien y qué rompe cuando se usa mal. Porque las técnicas no son piezas de catálogo: son respuestas a fallos concretos, y solo entendiendo el fallo se elige bien la respuesta.

El laboratorio, otra vez, es real. Todo lo que cuenta este libro se destiló mientras el RAG del despacho pasaba de demo a producción: sus convenios, sus sentencias, sus urgencias de viernes a las seis de la tarde. Cuando aparezcan ejemplos —y aparecerán muchos— son preguntas que alguien hizo de verdad, filtros que de verdad vaciaron resultados, topes que de verdad cortaron la evidencia clave. No hay credenciales ni código del cliente en estas páginas; hay lecciones.

Y una advertencia heredada: este libro no es un manual de la herramienta de moda. Los motores cambian cada trimestre; los principios, no. El que entienda por qué un filtro posterior puede vaciar una búsqueda y un filtro previo no, sabrá configurar cualquier motor presente o futuro. El que aprenda solo los botones, tendrá que reaprender cada temporada.

La brújula, segunda edición

El primer libro viajó con una brújula de siete pasos para construir el corpus. Este libro trae la suya, para interrogarlo: entender la pregunta, trazar el mapa de facetas, filtrar el espacio, recuperar, reranquear y ensamblar, medir, y observar hasta cerrar el ciclo. Cada parte del libro corresponde a un tramo del viaje, y cada capítulo se cierra con un criterio de salida: la prueba concreta de que ese tramo está dominado antes de pasar al siguiente. La tabla completa está en la portada; el apéndice D la trae en versión imprimible, para quien la quiera clavada en la pared.

Hay una buena noticia que conviene decir pronto: si leyó el primer libro, la mitad de este ya lo sabe de oídas. La clasificación facetada que etiquetó el Silver es exactamente el sistema de coordenadas sobre el que hoy filtraremos. La píldora de información y su doble campo son la unidad que la búsqueda recuperará y el rerank reordenará. El dataset áureo que validó el corpus se convertirá aquí en el conjunto de consultas que evaluará el acceso. No es que este libro repita al anterior: es que ambos son las dos mitades de una sola historia. Aquel libro terminaba manteniendo el corpus vivo. Este termina conectando las preguntas reales con ese mantenimiento, cerrando lo que llamaremos el ciclo del conocimiento: un corpus que mejora el acceso, un acceso que delata al corpus.

Para el que llega sin haber leído el primero

Este libro se lee solo, con una condición: hay que aceptar sobre fe un puñado de conceptos del corpus —píldora, doble campo, dataset áureo, Bronce, Silver, Gold, el Rack— que el primer libro justifica a fondo. La versión corta: el corpus es una biblioteca construida en tres calidades de material (crudo, depurado, sintetizado), donde la unidad mínima es una píldora de información autocontenida que guarda su texto legible y su vector de búsqueda en dos campos hermanos, y donde un conjunto de preguntas con respuesta conocida —el dataset áureo— certifica que lo almacenado es verdadero. Con eso basta para leer este libro sin ahogarse. Para construir su propio granero, el otro sigue ahí, en la misma web, con la misma licencia.

El plano

La primera parte mira la pregunta: qué hay dentro de una consulta real, qué significa responder bien y qué contrato une al corpus con quien pregunta. La segunda traza el mapa: los metadatos, los dominios y las facetas que convierten un montón de vectores en un territorio navegable. La tercera filtra: antes, después y el caso especial —importante— del filtro que protege. La cuarta recupera: la búsqueda vectorial desnuda, el híbrido, el tope y la diversidad. La quinta reranquea y ensambla: el segundo filtro, el LLM como juez, y la construcción final del contexto. Y la sexta mide: evaluación, regresión, observabilidad y el bucle de retorno que cierra el círculo con el primer libro.

Una nota sobre el tono, porque la serie lo debe: este libro se escribió a cuatro manos —humanas y de máquina— y lo declara en los créditos sin disimulo. El método es del arquitecto; la prosa, de los dos. Si en alguna página la anécdota parece demasiado exacta para ser inventada, es porque lo es: este libro se pagó con los errores que se cometieron, trabajos que se repitieron por cambio de criterio, piedras, muchas piedras en el camino.

Empieza el acceso. La biblioteca está llena; ahora toca abrir las puertas correctas.

Somos bibliotecarios ahora. La cosecha ya está guardada; nuestro trabajo es que cada pregunta encuentre su estantería.