PRODPlataforma BaaS europeia soberanaAbra o painel →

IA nativa

IA nativa no Postgres: NL2SQL, RAG e agentes

NL2SQL e RAG integrados diretamente no backend do Aurabase – e não conectores externos adicionados posteriormente. Dividindo precisamente o que significa “nativo”, capacidade por capacidade.

Principais conclusões

Incorporações Aurabase NL2SQL (linguagem natural para SQL, validada e limitada) e pano (pesquisa pgvector, embeddings HNSW) diretamente no backend, com 3 provedores nativos de LLM (OpenAI, Antrópico/Claude, Gêmeos). Mistral, Scaleway AI e Ollama permanecem acessíveis por meio de um endpoint compatível com OpenAI, em vez de um cliente nativo personalizado.

#
Linguagem Natural para SQL

NL2SQL — um prompt em linguagem natural, saída SQL segura

O mecanismo NL2SQL do Aurabase valida cada consulta gerada antes da execução: análise AST via sqlparser, uma lista de permissões de função SQL estrita e um limite LIMITE aplicado em cada consulta executada. Esta não é uma chamada LLM irrestrita - é um validador de sintaxe estrito que nega qualquer coisa além de um simples SELECIONAR.

01
Alerta
Natural language query, e.g. "Monthly revenue by tier"
02
LLM nativo
OpenAI, Anthropic, or Gemini translates into SQL
03
Validação AST
sqlparser: SELECT only, function allowlist
04
LIMITE limitado
Configurable ceiling, never silently uncapped
05
Execução
Read-only, schema-isolated per project

O validador rejeita explicitamente cláusulas CTEs/WITH, subconsultas, instruções UNION, funções não incluídas na lista de permissões (contar, soma, média, min, máx., inferior, superior, coalescer, data_trunc, agora) e qualquer acesso ao catálogo do sistema. O limite máximo de linhas é configurável no lado do servidor e pode ser restrito por consulta — nunca expandido além do limite do locatário.

#
Pesquisa vetorial

RAG nativo e pgvector — zero dependências externas

vetor pg 0.8.6 está pré-instalado em cada imagem Postgres de locatário do Aurabase, juntamente com um pipeline de ingestão com novas tentativas automáticas de rede e pesquisa de vetor HNSW em 3 classes de dimensão (768, 1536 e 3072) - bem dentro do limite de 16.000 dimensões do pgvector.

01
Ingestão
Project documents with automated network retries
02
Incorporações
768 / 1536 / 3072 dimensions matching the model
03
Armazenamento pgvector
Built directly into tenant Postgres image
04
Pesquisa HNSW
Ultra-fast approximate vector similarity search
05
Contexto LLM
Relevant document passages injected into prompt

Nenhuma etapa extra para "instalar" o pgvector: a extensão é incorporada à imagem do locatário padrão. O pipeline de ingestão em si é um recurso de nível de aplicativo projetado diretamente no Aurabase.

O armazenamento é estruturado por namespace: cada documento ingerido (POST /v1/ai/ /rag/ingerir) é fragmentado, incorporado e mapeado para a coluna de dimensão vetorial correspondente. O ponto final da consulta (POST /v1/ai/ /rag/query) combina recuperação e geração; um terminal dedicado (OBTER /v1/ai/ /pesquisar) expõe a pesquisa por similaridade vetorial por si só, sem acionar uma chamada LLM. A troca de modelos de incorporação nunca quebra seu conjunto de dados: um namespace pode ser reindexado (POST /v1/ai/ /rag/ /reindex) sob um novo modelo sem recarregar documentos.

Nuance técnica raramente documentada em outro lugar: além de 2.000 dimensões, o HNSW não pode indexar o padrão do pgvector vetor tipo. Para dimensões 3072, o Aurabase aproveita automaticamente meiovec(3072) (precisão reduzida, indexável) em vez de degradar silenciosamente as consultas em varreduras completas de tabela. Por padrão, a recuperação retorna 5 passagens (top_k) acima de um limite de similaridade de 0,3 — ambos os parâmetros podem ser substituídos por consulta.

#
Provedores de LLM

3 provedores nativos e o que "nativo" exclui

OpenAI, Anthropic (Claude) e Google Gemini dedicaram integrações de clientes nativos dentro da base de código Aurabase. Mistral, Scaleway AI e Ollama permanecem acessíveis por meio de um endpoint compatível com OpenAI — uma distinção operacional importante se sua pilha depende de primitivos de provedor personalizados.

ProvedorIntegraçãoImpacto
OpenAIDedicated native clientDirect project API key configuration
Antrópico (Claude)Dedicated native clientDirect project API key configuration
Google GêmeosDedicated native clientDirect project API key configuration
MistralOpenAI-compatible endpointFunctional via standard endpoint, without custom client
IA escalonadaOpenAI-compatible endpointFunctional via standard endpoint, without custom client
Ollama (auto-hospedado)OpenAI-compatible endpointIdeal para LLMs locais ou implantações locais
#
Comparação

Por que a Supabase aposta em conectores em vez de NL2SQL nativo

Supabase lançou um conector Claude oficial em fevereiro de 2026, seguido por uma integração ChatGPT. Ambos permitem consultar um banco de dados Supabase a partir de uma interface de chat de terceiros – um padrão de orquestração externo, distintamente diferente de um mecanismo NL2SQL incorporado diretamente no próprio backend. Veja também nosso comparação abrangente entre Aurabase e Supabase.

#
Segurança

O que impede um LLM de executar consultas arbitrárias ou destrutivas

Três proteções de segurança se aplicam antes de qualquer execução: validação de sintaxe estrita (somente SELECT, lista de permissões de funções), limite de resultado limitado via LIMIT e isolamento do esquema de destino apenas para o projeto de chamada. O esquema introspectado nunca é fornecido pelo cliente — ele se origina do banco de dados do projeto, a única fonte autorizada.

Acesso restrito somente leitura
O validador só aceita SELECIONAR consultas. Qualquer tentativa de INSERIR, ATUALIZAÇÃO, EXCLUIR, QUEDA, CRIAR, ou ALTERAR emitido pelo modelo é rejeitado no nível AST - antes da execução, não apenas por meio de uma instrução imediata.

Além das restrições somente SELECT, o validador também bloqueia CTEs/WITH, subconsultas, instruções UNION/INTERSECT/EXCEPT, funções com valor de tabela (gerar_series, pg_sleep…), funções de janela, cotação de dólar e cláusulas de bloqueio (PARA ATUALIZAÇÃO). Uma caminhada de segurança completa percorre toda a árvore de sintaxe abstrata — incluindo DISTINCT ON, OFFSET, FETCH e cláusulas agregadas — garantindo que nenhuma função proibida passe por um nó AST não inspecionado.

#
Agentes

Agentes de IA no Postgres – chamada de função, não SQL irrestrito

Agentes construídos com estruturas como LangChain ou LlamaIndex podem chamar endpoints REST do Aurabase — NL2SQL, RAG, consultas de banco de dados — como ferramentas nativas invocadas a partir de seu próprio loop de chamada de função. O NL2SQL desempenha um papel preciso: transformar a subconsulta do agente em SQL validado e seguro, em vez de conceder ao agente a execução SQL irrestrita.

Na prática, a ferramenta exposta ao agente envolve uma chamada HTTP padrão para o endpoint NL2SQL — o SDK executa a solicitação sem exigir plug-ins de estrutura personalizados:

tools/nl2sql-tool.ts
TYPESCRIPT
// 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 }
}
Integração direta da API HTTP
Aurabase integra-se perfeitamente por meio de API HTTP padrão e endpoints TypeScript SDK, fornecendo desempenho previsível sem envolver múltiplas camadas de abstração.
#
Perguntas frequentes

Perguntas frequentes

NL2SQL pode modificar dados (UPDATE, DELETE)?+
Não. O validador AST permite apenas consultas SELECT: qualquer instrução INSERT, UPDATE, DELETE, DROP, CREATE ou ALTER produzida pelo modelo é rejeitada no nível da árvore de sintaxe antes da execução - não apenas por meio de instruções de prompt.
pgvector é suficiente ou é necessário um banco de dados vetorial dedicado?+
De acordo com benchmarks do setor, pgvector corresponde ou supera armazenamentos de vetores dedicados abaixo de aproximadamente 10 milhões de vetores; a divergência só se torna significativa além de 50 milhões de vetores. Para a grande maioria das cargas de trabalho de aplicativos RAG, o pgvector nativo fornece desempenho superior e consistência de transação sem operar um cluster separado.
O servidor Aurabase MCP está pronto para produção para agentes autônomos de IA?+
Sim. O servidor Aurabase MCP é construído diretamente no protocolo JSON-RPC padrão sobre SSE e stdio, com introspecções de esquema nativo, consultas parametrizadas e isolamento estrito de locatário de segurança em nível de linha.

DÊ O PRÓXIMO PASSO

Conecte NL2SQL e RAG nativo diretamente ao seu banco de dados Postgres.

Nenhum encanamento de terceiros, integrado diretamente no mecanismo de back-end.

Não é necessário cartão de crédito · 500 MB grátis · 50.000 MAU