واجهة برمجة التطبيقات/AI Gateway/اللغة الطبيعية إلى SQL

اللغة الطبيعية إلى SQL

POST/v1/ai/{project_id}/nl2sql

يحول اللغة الطبيعية إلى استعلامات PostgreSQL آمنة للقراءة فقط ويتم فحصها بواسطة محلل شجرة Syntax Tree المجردة (AST).

تمت ترجمة هذه الصفحة تلقائيًا. النسخة الإنجليزية موثوقة.

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

طلب

المعلمات

المعلمة	اكتب	مطلوب	الوصف
`question`	`string`	نعم	سؤال باللغة الطبيعية حول بيانات المشروع.
`dialect`	`string`	لا	لهجة قاعدة البيانات. يقبل `'postgresql'` أو `'postgres'`.
`examples`	`object[]`	لا	أمثلة اختيارية قليلة `[{ question, sql }]` لتوجيه إنشاء الاستعلام.
`limit`	`number`	لا	تم إدخال الحد الأقصى للصف إذا تم حذفه بواسطة النموذج (الافتراضي `100`، الحد الأقصى `1000`).

الأمن

AST حراس الطفرة

معلومات

يقوم الخادم بتوزيع SQL الذي تم إنشاؤه باستخدام محرك Abstract Syntax Tree (AST) قبل إعادته:

يتم رفض أي بيان طفرة غير محدد (INSERT, UPDATE, DELETE, DROP, ALTER, TRUNCATE) على الفور مع HTTP 400.
جداول كتالوج النظام (pg_catalog, information_schema) غير مسموح بها تمامًا.
إذا أغفل النموذج جملة LIMIT، يقوم الخادم بإدخال LIMIT 100 (بحد أقصى 1000) ويضع علامة limit_injected: true.

v1.0 · منقحة 31‏/10‏/2026
↗ مواصفات OpenAPI↗ جيثب

← السابق

RAG query & ingest