إجابات راسخة.

Structured Query AI — أداة البيانات المنظَّمة للقراءة فحسب، المُحكَمة، لوكلاء الذكاء الاصطناعي. يتحوّل السؤال إلى خطة مكتوبة بأنواع وخاضعة للسياسة؛ تعمل الخطة على محرك حتمي؛ وتعود الإجابة مع هاشات تُعيد تشغيلها.

تغطي واجهة واحدة الملفات وقواعد البيانات الحية إلى جانب 4,778 قدرة حسابية للقراءة فحسب عبر 445 وحدة — من الوسيط إلى تسعير الخيارات.

stats.median · finance.npv · option_pricing.black_scholes_call

لا بداية باردة لكل استعلام. تعمل طبقة الاستعلام داخل العملية — أقل من ميلي ثانية على الملفات النمطية.

يُهيَّأ الحساب مرة واحدة: أول استدعاء على الإطلاق يُنزّل بيئة التشغيل الموقَّعة ويُهيّئها في نحو 110 ثوانٍ. بعد ذلك يبقى الخادم دافئًا ومقيمًا، ويقيس استدعاء الحساب الدافئ 0.83–0.93 ms.

finance.npv = 0.83–0.93 ms (warm) · first provision ≈ 110 s

تُشحن بيئة التشغيل الموقَّعة لـ macOS بمعالج Apple Silicon وLinux بمعمارية x64. على Windows، يُعيد استدعاء الحساب المُدار خطأً منظَّمًا ومسمًّى بدلًا من التعطّل.

تعمل طبقة الاستعلام في أي مكان. وكذلك وضعا الاستضافة الذاتية والمستضافة، إذ يُرسَل الحساب إلى محرك بعيد. Node 20 أو أحدث؛ Python 3.10 أو أحدث.

darwin-arm64 · linux-x64 · node ≥ 20 · python ≥ 3.10

نعم. يُثبّت SQAI افتراضيًا الحزمة المثبَّتة التي تغطي السطح المكشوف بالكامل. سمِّ الوحدات التي تحتاجها فحسب وتُصرف خدمة البناء حزمة موقَّعة مثبَّتة بـ sha256 لتلك المجموعة الفرعية، مخزَّنة مؤقتًا بهاش الفلتر.

تحصل الخوادم المُصفَّاة على مقبسها ومنفذها الخاص، فلا تتعارض أبدًا مع الكاملة.

SQAI_RUNTIME_MODULES → POST /v1/runtime/build · sha256-pinned

لا تُطلق أدوات الوكيل استثناءات قط. تعود الأخطاء كمخرج منظَّم بحالة ورمز يُسمّي السبب — رفض سياسة، أو قدرة مجهولة، أو بذرة مفقودة.

لكل ما دون الأدوات، أمر واحد يفحص التثبيت وبيئة التشغيل والتكافؤ بين اللغات في تمريرة واحدة.

output.status === "error" · sqai doctor --parity --json

نعم — بالبناء، لا بالصلاحية. يُؤلّف النموذج نيّة مكتوبة بأنواع، لا SQL؛ يتحقق SQAI منها مقابل عقد قدرة مثبَّت بهاش، ويُطبّق سياستك، ثم يُنفّذ فحسب.

من 4,778 قدرة، 4,574 مكشوفة: تلك التي للقراءة فحسب وحتمية، أو حتمية عند التبذير. الـ 204 التي تفشل الاختبار — بما فيها كل عمليات الكتابة — غائبة عن السطح المُحزَّم. لا إعداد يصل إلى ما لم يُشحن قط.

read_only && (deterministic || deterministic_when_seeded)

سجّل مصادرك في الكود وسلّم النموذج مجموعة الأدوات — ثلاث أدوات بالضبط. واحدة تُدرج ما هو موجود، وواحدة تعرض الخطة دون تشغيلها، وواحدة تُنفّذ على السطح للقراءة فحسب.

دور قاعدة بيانات للقراءة فحسب إعداد يمكن لأحدهم تعطيله. سطح مُصرَّف بلا قدرات كتابة ليس كذلك.

sqai.tools() → listSources · explainQuery · queryData

لا تُصفّي SQL. أوقف توليده.

فلاتر النصوص وأعلام القراءة فحسب تحرس لغة قادرة دائمًا على التعبير عن الكتابة — وSQL المُحقَن بالموجّه يصل في مخرج النموذج، متجاوزًا مُعقّم المدخلات. يكتب نموذج SQAI خطة مكتوبة بأنواع في قواعد نحو لا أشكال كتابة فيها: DELETE لا يُرفض، بل لا يمكن كتابته.

kind: "query" | "computation" · version: "1"

لا. السياسة ثابتة في الكود عند إنشاء العميل وتُفحص داخل العملية قبل كل تنفيذ. لا تحمل مخططات الأدوات أي حقل قائمة سماح من أي نوع، فلا شيء يصله الموجّه.

قائمة السماح الصريحة لا تستطيع إلا التضييق. تسمية قدرة خارج السطح المؤهَّل تفشل على أي حال — السطح المُحزَّم هو السقف.

policy_denied_source · policy_denied_field · policy_denied_function

نعم — للبشر، لا للنماذج قط. تقع بيئة التشغيل غير المحمية خلف استيراد منفصل يتجاوز العقد والسياسة وفحوص البذرة، ولا تُكشف أبدًا لمجموعة أدوات الوكيل.

يستطيع المهندس الانسحاب عمدًا. لا يصل إليها وكيل بأي مدخل.

import { getUnsafeRuntime } from "@thyn-ai/sqai/unsafe"

في الوضع المحلي الافتراضي، لا شيء. تُحلَّل طبقة الاستعلام داخل العملية، والبيئة الحسابية عبارة عن خدمة موقَّعة على جهازك. الاتصال الخارجي الوحيد هو تنزيل حزمة البيئة عند الاستخدام الأول — كود المحرك، لا صفوف بياناتك.

أشِر بمتغير بيئة إلى محرك مستضاف ذاتيًا أو خارجيًا، وستُرسَل الخطط إليه بدلًا من ذلك، مع تشفير بيانات الاعتماد وعدم نسخ أي بيانات.

local: in-process · self_hosted: SQAI_ENGINE_URL · api: SQAI_API_KEY

داخل العملية بدون مفتاح: CSV وTSV وJSON والصفوف في الذاكرة وSQLite — إضافةً إلى Excel وParquet في Python. عبر محرك: PostgreSQL وMySQL وOracle بمشغّل Thin-mode مدمج وSQL Server وSnowflake وBigQuery وClickHouse وRedshift ومخازن الكائنات وRedis وNeo4j وElasticsearch وواجهات REST APIs ومستودعات Git.

كل مصدر يقدّم الشكل المكتوب ذاته، فلا يستطيع الكود اللاحق التمييز بين CSV وSnowflake. المصادر غير قابلة للتعديل بعد تسجيلها.

SqaiSource { fields, typed_fields, row_count, schema_revision }

أبدًا. SQAI ليس نموذجًا ولا يتدرب على شيء — لا توجد حلقة تعلم لتغذيتها. في الوضع المحلي، لا تغادر صفوف بياناتك الجهاز قط.

النموذج الوحيد في الحلقة هو ما تحضره أنت، ويرى 25 صفًا كحد أقصى لكل نتيجة. أي شيء أكبر يُقتطع — بإعلان صريح، لا بصمت — مع الاحتفاظ بالقيمة الكاملة تحت معرّف نتيجة معتم ينتهي صلاحيته بعد 15 دقيقة.

maxRowsToModel 25 · maxCellsToModel 250 · maxBytesToModel 32,000

حتمية ضمن نطاق التنفيذ المُعلَن — أعداد عشرية 64-بت، خيط واحد، بيئة تشغيل مثبّتة — وكل نتيجة تسجّل ذلك النطاق بدلًا من الادعاء بأكثر منه.

المُسلسِل القانوني مقيّد بالمطابقة عبر كلا SDK، فالحساب ذاته يُعيد العدد ذاته وتجزئات متطابقة بايتًا ببايت في TypeScript وPython.

finance.npv(0.1, [-1000, 300, 420, 560, 680]) = 505.020148896933computation_hash b74f67d0… · TS ≡ PY

بعدم السماح له بإجراء الحساب أصلًا. اطلب من نموذج مجموع 200 صف وستحصل على رقم معقول — دون أي إشارة إلى خطئه.

مع SQAI يختار النموذج الحساب فحسب؛ المحرك هو من ينفّذه. في اختبار الدقة A/B لدينا، انتقل النموذج ذاته من 0 من 16 إلى 16 من 16 في الأسئلة الكمية لحظة أن تولّى المحرك الحساب.

accuracy A/B: 0/16 → 16/16

نعم — هذا ما التجزئات موجودة من أجله. كل نتيجة تحمل تجزئة خطة، وتجزئة استدعاء معروفة قبل التنفيذ، وتجزئة حساب معروفة بعده، وغلاف حتمية يسجّل إصدار البيئة والمنصة والدقة والبذرة.

أعِد تشغيل الاستدعاء ضمن النطاق ذاته بعد أشهر، وستتطابق التجزئة بايتًا ببايت. إن تغيّر المخطط الأساسي، تحصل على عدم تطابق مُسمَّى لمراجعة المخطط بدلًا من أرقام مختلفة بصمت.

run1 b74f67d0d7a594aa7ac91f6291612452aa8ccdf603351ebc8d801a6fddd91bc8run2 b74f67d0d7a594aa7ac91f6291612452aa8ccdf603351ebc8d801a6fddd91bc8identical: true

لا. الوضع المحلي لا يحتاج إعدادًا — لا مفتاح، لا حساب، لا بطاقة. تُهيّئ البيئة نفسها عند أول استدعاء حسابي.

تسجيل الدخول اختياري ويستخدم رمز جهاز؛ يُصدر ترخيصًا غير متصل ينقل رمزًا موقَّعًا، لا بياناتك. المفاتيح موجودة فقط للإشارة إلى محرك مختلف.

sqai login → RFC 8628 device code · WDJB-MJHT

التطوير المحلي والحوسبة المُدارة مجانيان — لا يوجد فحص ترخيص في أي مكان بالـ SDK.

الخطط المدفوعة تُقيّد الأجهزة والمقاعد والحقوق التجارية، لا ميزات الحوسبة. Developer: مجاني، جهاز واحد، غير تجاري. Pro: 25 دولارًا شهريًا، ثلاثة أجهزة، استخدام تجاري، وظائف غير متزامنة، webhooks، سجل تدقيق. Team: 99 دولارًا شهريًا، عشرة أجهزة، يضيف RBAC والمقاعد.

Developer $0 · Pro $25/mo · Team $99/mo