API'si/AI Gateway/Doğal Dilden SQL'e

Doğal Dilden SQL'e

POST/v1/ai/{project_id}/nl2sql

Doğal dili, Soyut Sözdizimi Ağacı (AST) ayrıştırıcısı tarafından kontrol edilen güvenli, salt okunur PostgreSQL sorgularına dönüştürür.

Bu sayfa otomatik olarak çevrildi. İngilizce versiyonu yetkilidir.

nl2sql.tstypescript

const { data, error } = await aura.ai.nl2sql(
  'What are the 10 most recent user registrations?',
  { dialect: 'postgresql', limit: 10 }
)
console.log('Safe SQL Query:', data?.sql)
console.log('Injected Limit:', data?.limit, 'Confidence:', data?.confidence)

200.jsonjson

{
  "data": {
    "sql": "SELECT id, email, created_at FROM users ORDER BY created_at DESC LIMIT 10;",
    "explanation": "Retrieves the latest 10 users ordered by creation timestamp.",
    "confidence": 0.96,
    "limit_injected": false,
    "limit": 10
  }
}

Talep

Parametreler

Parametre	Tür	Gerekli	Açıklama
`question`	`string`	evet	Projenin verileriyle ilgili doğal dil sorusu.
`dialect`	`string`	hayır	Veritabanı lehçesi. `'postgresql'` veya `'postgres'` kabul edilir.
`examples`	`object[]`	hayır	İsteğe bağlı birkaç örnek, sorgu oluşturmayı yönlendiren `[{ question, sql }]`.
`limit`	`number`	hayır	Model tarafından atlanırsa eklenen maksimum satır sınırı (varsayılan `100`, maksimum `1000`).

Güvenlik

AST Mutasyon Muhafızları

Bilgi

Sunucu, oluşturulan SQL'i döndürmeden önce Soyut Sözdizimi Ağacı (AST) motoruyla ayrıştırır:

SELECT olmayan herhangi bir mutasyon ifadesi (INSERT, UPDATE, DELETE, DROP, ALTER, TRUNCATE), HTTP 400 ile hemen reddedilir.
Sistem kataloğu tablolarına (pg_catalog, information_schema) kesinlikle izin verilmez.
Model bir LIMIT yan tümcesini atlarsa, sunucu LIMIT 100 (1000 sınırıyla) enjekte eder ve limit_injected: true olarak işaretler.

v1.0 · revize edildi 31 Eki 2026
↗ OpenAPI spesifikasyonu↗ GitHub

← ÖNCEKİ

RAG query & ingest