IA nativa en Postgres: NL2SQL, RAG y agentes

El validador rechaza explícitamente cláusulas CTE/WITH, subconsultas, declaraciones UNION y funciones no incluidas en la lista blanca (contar, suma, promedio, mín., máximo, inferior, superior, fusionarse, fecha_trunc, ahora) y cualquier acceso al catálogo del sistema. El límite de filas se puede configurar en el lado del servidor y se puede restringir por consulta, nunca expandirse más allá del límite de inquilinos.

No hay pasos adicionales para "instalar" pgvector: la extensión está integrada en la imagen estándar del inquilino. La canalización de ingesta en sí es una capacidad a nivel de aplicación diseñada directamente en Aurabase.

El almacenamiento está estructurado por espacio de nombres: cada documento ingerido (POST /v1/ai/ /rag/ingest) se fragmenta, se incrusta y se asigna a la columna de dimensión vectorial coincidente. El punto final de la consulta (POST /v1/ai/ /rag/query) combina recuperación y generación; un punto final dedicado (OBTENER /v1/ai/ /búsqueda) expone la búsqueda de similitud de vectores por sí sola, sin activar una llamada LLM. Cambiar los modelos de incrustación nunca rompe su conjunto de datos: un espacio de nombres se puede volver a indexar (POST /v1/ai/ /rag/ /reindexar) bajo un nuevo modelo sin volver a cargar documentos.

Matices técnicos rara vez documentados en otros lugares: más allá de 2000 dimensiones, HNSW no puede indexar el estándar de pgvector vector tipo. Para 3072 dimensiones, Aurabase aprovecha automáticamente mediovec(3072) (precisión reducida, indexable) en lugar de degradar silenciosamente las consultas en escaneos completos de la tabla. De forma predeterminada, la recuperación devuelve 5 pasajes (top_k) por encima de un umbral de similitud de 0,3: ambos parámetros se pueden anular por consulta.

Más allá de las restricciones de solo SELECT, el validador también bloquea CTE/WITH, subconsultas, declaraciones UNION/INTERSECT/EXCEPT y funciones con valores de tabla (generar_series, pg_dormir…), funciones de ventana, cotización en dólares y cláusulas de bloqueo (PARA ACTUALIZAR). Un exhaustivo recorrido de seguridad recorre todo el árbol de sintaxis abstracta, incluidas DISTINCT ON, OFFSET, FETCH y cláusulas agregadas, para garantizar que ninguna función prohibida se escape a través de un nodo AST no inspeccionado.

En la práctica, la herramienta expuesta al agente envuelve una llamada HTTP estándar al punto final NL2SQL: el SDK ejecuta la solicitud sin requerir complementos de marco personalizados:

// Custom tool called by your agent's function calling loop
export async function nl2sqlTool(question: string) {
  const { data, error } = await aura.ai.nl2sql(question, undefined, { limit: 20 })
  if (error) throw error
  return { sql: data.sql, tables: data.tables }
}