IA nativa su Postgres: NL2SQL, RAG e agenti

Il validatore rifiuta esplicitamente clausole CTE/WITH, sottoquery, istruzioni UNION, funzioni non incluse nella whitelist (contare, somma, media, min, massimo, inferiore, superiore, coalizzarsi, data_trunc, ora) e qualsiasi accesso al catalogo di sistema. Il limite massimo delle righe è configurabile lato server e può essere limitato per query, mai espanso oltre il limite del tenant.

Nessun passaggio aggiuntivo per "installare" pgvettor: l'estensione è integrata nell'immagine del tenant standard. La stessa pipeline di acquisizione è una funzionalità a livello di applicazione progettata direttamente in Aurabase.

L'archiviazione è strutturata per spazio dei nomi: ogni documento acquisito (POST /v1/ai/ /rag/ingest) viene suddiviso in blocchi, incorporato e mappato alla colonna della dimensione vettoriale corrispondente. L'endpoint della query (POST /v1/ai/ /rag/query) combina il recupero e la generazione; un endpoint dedicato (OTTIENI /v1/ai/ /search) espone autonomamente la ricerca per similarità dei vettori, senza attivare una chiamata LLM. Il cambio dei modelli di incorporamento non interrompe mai il set di dati: uno spazio dei nomi può essere reindicizzato (POST /v1/ai/ /rag/ /reindex) con un nuovo modello senza ricaricare i documenti.

Sfumature tecniche raramente documentate altrove: oltre le 2.000 dimensioni, HNSW non può indicizzare lo standard di pgvector vettore tipo. Per 3072 dimensioni, Aurabase utilizza automaticamente la leva finanziaria halfvec(3072) (precisione ridotta, indicizzabile) anziché ridurre silenziosamente le query in scansioni di tabelle complete. Per impostazione predefinita, il recupero restituisce 5 passaggi (top_k) sopra una soglia di somiglianza di 0,3: entrambi i parametri possono essere sovrascritti per query.

Oltre alle restrizioni solo SELECT, il validatore blocca anche CTE/WITH, sottoquery, istruzioni UNION/INTERSECT/EXCEPT, funzioni con valori di tabella (generare_serie, pg_sonno…), funzioni finestra, quotazioni in dollari e clausole di blocco (PER AGGIORNAMENTO). Un'accurata passeggiata sulla sicurezza attraversa l'intero albero della sintassi astratta, comprese le clausole DISTINCT ON, OFFSET, FETCH e aggregate, garantendo che nessuna funzione vietata passi attraverso un nodo AST non ispezionato.

In pratica, lo strumento esposto all'agente esegue il wrapper di una chiamata HTTP standard all'endpoint NL2SQL: l'SDK esegue la richiesta senza richiedere plug-in del framework personalizzato:

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