Native AI
Native AI op Postgres: NL2SQL, RAG & Agents
NL2SQL en RAG zijn rechtstreeks in de Aurabase-backend ingebouwd – geen externe connectoren die achteraf zijn toegevoegd. We leggen precies uit wat ‘native’ betekent, vermogen per vermogen.
Aurabase-insluitingen NL2SQL (natuurlijke taal naar SQL, gevalideerd en begrensd) en RAG (pgvector search, HNSW embeddings) rechtstreeks in de backend, met 3 native LLM-providers (OpenAI, Antropisch/Claude, Gemini). Mistral, Scaleway AI en Ollama blijven toegankelijk via een OpenAI-compatibel eindpunt, in plaats van een op maat gemaakte native client.
NL2SQL — een prompt in natuurlijke taal, veilige SQL-uitvoer
De NL2SQL-engine van Aurabase valideert elke gegenereerde query vóór uitvoering: AST-parsing via sqlparser, een strikte toelatingslijst voor SQL-functies en een bounded LIMIET toegepast op elke uitgevoerde query. Dit is geen onbeperkte LLM-aanroep – het is een strikte syntaxisvalidator die alles ontkent dat verder gaat dan een simpele SELECTEER.
De validator wijst expliciet CTE's/WITH-clausules, subquery's, UNION-instructies en niet-op de witte lijst geplaatste functies af (tellen, som, gem, min, maximaal, lager, bovenste, samenvloeien, datum_trunc, nu), en eventuele toegang tot de systeemcatalogus. Het rijplafond kan aan de serverzijde worden geconfigureerd en kan per zoekopdracht worden beperkt; het kan nooit verder worden uitgebreid dan de tenantlimiet.
Native RAG en pgvector — nul externe afhankelijkheden
vector 0.8.6 is vooraf geïnstalleerd in elke Postgres-image van Aurabase-tenant, gekoppeld aan een opnamepijplijn met automatische netwerkpogingen en HNSW-vectorzoekopdrachten in drie dimensieklassen (768, 1536 en 3072) — ruim binnen de limiet van pgvector van 16.000 dimensies.
Geen extra stappen om pgvector te "installeren": de extensie is ingebakken in de standaard tenantimage. De opnamepijplijn zelf is een mogelijkheid op applicatieniveau die rechtstreeks in Aurabase is ontwikkeld.
Opslag is gestructureerd op naamruimte: elk opgenomen document (POST /v1/ai/ /rag/ingest) is gesegmenteerd, ingebed en toegewezen aan de overeenkomende vectordimensiekolom. Het query-eindpunt (POST /v1/ai/ /rag/query) combineert ophalen en genereren; een speciaal eindpunt (GET /v1/ai/ /zoeken) stelt het zoeken naar vectorovereenkomsten zelfstandig bloot, zonder een LLM-oproep te activeren. Als u van inbeddingsmodel wisselt, wordt uw dataset nooit beschadigd: een naamruimte kan opnieuw worden geïndexeerd (POST /v1/ai/ /rag/ /reindex) onder een nieuw model zonder documenten opnieuw te uploaden.
Technische nuance wordt zelden elders gedocumenteerd: buiten 2000 dimensies kan HNSW de standaard van pgvector niet indexeren vector typ. Voor 3072 dimensies maakt Aurabase automatisch gebruik van halfvec(3072) (verminderde precisie, indexeerbaar) in plaats van zoekopdrachten stilletjes te degraderen tot volledige tabelscans. Standaard retourneert het ophalen 5 passages (top_k) boven een gelijkheidsdrempel van 0,3: beide parameters kunnen per zoekopdracht worden overschreven.
3 native providers, en wat "native" uitsluit
OpenAI, Anthropic (Claude) en Google Gemini hebben speciale native clientintegraties binnen de Aurabase-codebase. Mistral, Scaleway AI en Ollama blijven toegankelijk via een OpenAI-compatibel eindpunt – een belangrijk operationeel onderscheid als uw stack afhankelijk is van op maat gemaakte providerprimitieven.
| Aanbieder | Integratie | Impact |
|---|---|---|
| OpenAI | Dedicated native client | Direct project API key configuration |
| Antropisch (Claude) | Dedicated native client | Direct project API key configuration |
| Google Tweelingen | Dedicated native client | Direct project API key configuration |
| Mistral | OpenAI-compatible endpoint | Functional via standard endpoint, without custom client |
| Scaleway-AI | OpenAI-compatible endpoint | Functional via standard endpoint, without custom client |
| Ollama (zelf gehost) | OpenAI-compatible endpoint | Ideaal voor lokale LLM's of implementaties op locatie |
Waarom Supabase inzet op connectoren in plaats van native NL2SQL
Supabase lanceerde in februari 2026 een officiële Claude-connector, gevolgd door een ChatGPT-integratie. Beide maken het mogelijk om een Supabase-database te bevragen vanuit een chatinterface van derden – een extern orkestratiepatroon, duidelijk verschillend van een NL2SQL-engine die rechtstreeks in de backend zelf is ingebed. Zie ook onze uitgebreide Aurabase versus Supabase-vergelijking.
Wat weerhoudt een LLM ervan willekeurige of destructieve zoekopdrachten uit te voeren
Voorafgaand aan elke uitvoering zijn drie veiligheidsbarrières van toepassing: strikte syntaxisvalidatie (alleen SELECT, functie-toelatingslijst), begrensde resultaatlimiet via LIMIT en isolatie van het doelschema voor alleen het aanroepende project. Het geïntrospecteerde schema wordt nooit door de klant aangeleverd; het is afkomstig uit de projectdatabase, de enige gezaghebbende bron.
SELECTEER vragen. Elke poging tot INVOEGEN, UPDATE, VERWIJDEREN, DALEN, CREËREN, of ALTER die door het model wordt uitgezonden, wordt afgewezen op het AST-niveau – vóór uitvoering, en niet alleen via een promptinstructie.Naast de beperkingen die alleen voor SELECT gelden, blokkeert de validator ook CTE's/WITH, subquery's, UNION/INTERSECT/EXCEPT-instructies, tabelwaardefuncties (genereer_serie, pg_slaap...), vensterfuncties, dollarquotes en vergrendelingsclausules (VOOR UPDATE). Een grondige beveiligingswandeling doorloopt de gehele abstracte syntaxisboom – inclusief DISTINCT ON, OFFSET, FETCH en aggregatieclausules – zodat geen verboden functie door een niet-geïnspecteerd AST-knooppunt glipt.
AI-agents op Postgres – functieaanroepen, geen onbeperkte SQL
Agenten die zijn gebouwd met raamwerken zoals LangChain of LlamaIndex kunnen Aurabase REST-eindpunten (NL2SQL, RAG, databasequery's) aanroepen als native tools die worden aangeroepen vanuit hun eigen functieaanroeplus. NL2SQL speelt een precieze rol: het transformeren van de subquery van de agent in gevalideerde, veilige SQL, in plaats van de agent onbeperkte SQL-uitvoering te verlenen.
In de praktijk verpakt de tool die aan de agent wordt blootgesteld een standaard HTTP-aanroep naar het NL2SQL-eindpunt: de SDK voert het verzoek uit zonder dat er aangepaste framework-plug-ins nodig zijn:
Veelgestelde vragen
NEEM DE VOLGENDE STAP
Verbind NL2SQL en native RAG rechtstreeks met uw Postgres-database.
Geen loodgieterswerk van derden, rechtstreeks ingebouwd in de backend-engine.
Geen creditcard vereist · 500 MB gratis · 50.000 MAU