Logo de Camilo BooCamilo Boo
Sistema propioDocumentación, conocimiento y sistemas internos

VektorRAG: arquitectura RAG documental con PostgreSQL y pgvector

Componente reutilizable para ingerir, segmentar, vectorizar y recuperar documentación propia con PostgreSQL y pgvector.

Tipo: Infraestructura RAGAlcance: Ingesta documental, chunking, embeddings, pgvector, recuperación semántica y flujos automatizadosAño: 2026
Vista representativa del caso VektorRAG: arquitectura RAG documental con PostgreSQL y pgvector

Valor comercial

Qué demuestra este caso

Demuestra dominio de la capa documental que necesita una solución RAG fiable antes de generar respuestas.

  • Ingesta y segmentación controladas.
  • Metadatos y fuentes conservados durante la recuperación.
  • Búsqueda semántica sobre PostgreSQL y pgvector.
  • Base reutilizable para distintos dominios documentales.

Criterio

La decisión de diseño que ordenó el proyecto

Separar recuperación, fuentes y generación para poder evaluar cada parte del sistema.

La documentación queda preparada para recuperar fragmentos relevantes y trazables antes de generar una respuesta.

Contexto

Qué estaba ocurriendo antes

Muchas organizaciones tienen documentación valiosa, pero poco explotable: PDFs, manuales, contratos, normativa, artículos, expedientes o conocimiento interno. El valor no está solo en almacenar esos documentos, sino en poder consultarlos, clasificarlos y reutilizarlos con precisión.

Problema

El cuello de botella real

Sin una arquitectura clara de ingesta, chunking, embeddings y recuperación, los sistemas de IA documental se vuelven frágiles: recuperan mal, mezclan contexto, generan costes innecesarios o dependen de procesos manuales difíciles de repetir.

Transformación

Antes y después del sistema

Antes

  • Documentos útiles pero difíciles de consultar y explotar de forma sistemática.
  • Procesos manuales para revisar, clasificar o localizar información relevante.
  • Riesgo de montar soluciones IA poco reutilizables, sin separación clara de fases.
  • Dificultad para medir y ajustar calidad de recuperación.

Después

  • Pipeline documental reutilizable y preparado para distintos corpus.
  • Búsqueda semántica sobre documentos vectorizados.
  • Arquitectura con PostgreSQL y pgvector para almacenar y recuperar embeddings.
  • Base preparada para clasificación, análisis y generación asistida.

Enfoque

Cómo se planteó la solución

El enfoque fue construir una base RAG reutilizable, separando bien las fases: ingesta, limpieza, fragmentación, embeddings, almacenamiento vectorial, búsqueda semántica y generación asistida.

Se desarrolló una arquitectura basada en Python, PostgreSQL, pgvector y APIs de IA, con pipeline de ingesta, chunking, generación de embeddings, almacenamiento y recuperación semántica.

01

Ingesta documental

Se preparan documentos de entrada para procesarlos, normalizarlos y convertirlos en una base explotable.

02

Chunking y metadatos

Se fragmenta el contenido en unidades recuperables y se conservan referencias necesarias para contexto y trazabilidad.

03

Embeddings y almacenamiento

Se generan embeddings y se almacenan en PostgreSQL con pgvector para permitir búsqueda semántica.

04

Recuperación y generación

Se construyen consultas en lenguaje natural, recuperación contextual y flujos de análisis o generación asistida.

Control

Qué sigue dependiendo de una persona

La calidad se valida con documentos, consultas y respuestas esperadas del dominio concreto.

Resultado

Qué cambia de forma observable

La documentación queda preparada para recuperar fragmentos relevantes y trazables antes de generar una respuesta.

El resultado es una base documental reutilizable para construir buscadores semánticos, asistentes internos, clasificadores, sistemas de consulta y soluciones RAG especializadas sobre documentación propia.

Patrones reutilizables

Qué puede trasladarse a otros procesos

RAG como infraestructura

Un buen sistema RAG no es solo un prompt. Es una arquitectura de datos, recuperación, contexto y evaluación.

Separar ingesta de consulta

Preparar bien documentos, fragmentos, metadatos y embeddings mejora la calidad posterior de recuperación.

Reutilización por diseño

Una arquitectura modular permite aplicar el mismo patrón a normativa, manuales, expedientes o conocimiento interno.

Sistema propio

Sistema técnico desarrollado como capacidad reutilizable

La prueba está en el sistema construido, su arquitectura y el problema técnico que resuelve. El valor para una empresa está en adaptar ese patrón a sus datos y procesos.

  • Arquitectura y flujo funcional.
  • Problema técnico resuelto.
  • Componentes reutilizables.
  • Aplicaciones posibles en otros procesos.

Tecnología

Piezas utilizadas en este caso

PythonPostgreSQLpgvectorOpenAI APIEmbeddings

La selección técnica es consecuencia del proceso, el nivel de riesgo, los datos disponibles y la forma de mantener el sistema.

Aplicación a tu empresa

No hace falta copiar este sistema. Hay que identificar qué patrón encaja en tu proceso.

Describe la entrada, las decisiones, las excepciones y el resultado que necesitas. La valoración inicial permite comprobar alcance, riesgo y retorno antes de construir.

Valorar una base RAG documental