Iسوالات کا دفتر
تحریری جوابات۔
وہ سب کچھ جو teams SQAI کو کسی agent کے حوالے کرنے سے پہلے پوچھتی ہیں — یہ کیا نہیں کر سکتا، مشین سے کیا باہر جاتا ہے، replay کیا ثابت کرتی ہے، اور لاگت کیا ہے۔ مختصر جوابات، حقیقی اعداد، اور وہ صفحات جہاں پوری تفصیل موجود ہے۔
IIیہ کیا ہے، کتنا تیز، کہاں چلتا ہے
پروڈکٹ
Q01SQAI کیا ہے؟
Structured Query AI — AI agents کے لیے governed، read-only structured-data tool۔ ایک سوال ایک typed، policy-checked plan بنتا ہے؛ plan ایک deterministic engine پر چلتا ہے؛ جواب ایسے hashes کے ساتھ آتا ہے جو اسے replay کر سکیں۔
ایک واحد سطح 445 modules میں 4,778 read-only compute capabilities کے ساتھ files اور live databases کا احاطہ کرتی ہے — medians سے options pricing تک۔
stats.median · finance.npv · option_pricing.black_scholes_call
Q02کیا یہ تیز ہے؟
فی query کوئی cold start نہیں۔ Query plane in-process چلتا ہے — عام files پر sub-millisecond۔
Compute ایک بار provision ہوتا ہے: پہلی کال signed runtime کو تقریباً 110 سیکنڈ میں download اور initialize کرتی ہے۔ اس کے بعد daemon گرم اور فعال رہتا ہے، اور ایک warm compute call 0.83–0.93 ms ناپتی ہے۔
finance.npv = 0.83–0.93 ms (warm) · first provision ≈ 110 s
Q03کون سے platforms سپورٹ ہیں؟
Signed runtime Apple-silicon macOS اور x64 Linux کے لیے آتا ہے۔ Windows پر، managed-compute call crash کرنے کے بجائے ایک structured، named error لوٹاتی ہے۔
Query plane کہیں بھی چلتا ہے۔ Self-hosted اور hosted modes بھی، کیونکہ compute ایک remote engine کو بھیجا جاتا ہے۔ Node 20 یا جدید؛ Python 3.10 یا جدید۔
darwin-arm64 · linux-x64 · node ≥ 20 · python ≥ 3.10
Q04کیا میں چھوٹا runtime بھیج سکتا ہوں؟
ہاں۔ بطور ڈیفالٹ SQAI پوری exposed surface کا احاطہ کرنے والا pinned bundle install کرتا ہے۔ صرف وہ modules نام لیں جن کی آپ کو ضرورت ہے اور build service اس subset کے لیے ایک signed، sha256-pinned bundle compile کرتی ہے، جو filter hash سے cache ہوتا ہے۔
Filtered daemons کا اپنا socket اور port ہوتا ہے، اس لیے وہ کبھی full daemon سے نہیں ٹکراتے۔
SQAI_RUNTIME_MODULES → POST /v1/runtime/build · sha256-pinned
Q05کچھ ناکام ہو گیا۔ میں اسے کیسے debug کروں؟
Agent tools کبھی throw نہیں کرتے۔ Errors ایک status اور ایک code کے ساتھ structured output کے طور پر آتی ہیں جو انکار کی وجہ بتاتا ہے — policy denial، نامعلوم capability، یا غائب seed۔
Tools کے نیچے ہر چیز کے لیے، ایک command install، runtime، اور cross-language parity کو ایک ہی pass میں جانچتی ہے۔
output.status === "error" · sqai doctor --parity --json
IIIبنیادی ڈھانچے سے read-only، flag سے نہیں
حفاظت
Q06کیا یہ واقعی read-only ہے؟
ہاں — بنیادی ڈھانچے سے، اجازت سے نہیں۔ ماڈل typed intent لکھتا ہے، کبھی SQL نہیں؛ SQAI اسے hash-pinned capability contract کے خلاف validate کرتا ہے، آپ کی policy لاگو کرتا ہے، اور تبھی execute کرتا ہے۔
4,778 capabilities میں سے 4,574 exposed ہیں: صرف وہ جو read-only اور deterministic ہیں، یا seeded ہونے پر deterministic۔ وہ 204 جو یہ معیار پورا نہیں کرتیں — ہر write سمیت — packaged surface سے غائب ہیں۔ کوئی setting اس تک نہیں پہنچ سکتی جو کبھی ship ہی نہیں ہوئی۔
read_only && (deterministic || deterministic_when_seeded)
Q07میں کسی agent کو اپنے ڈیٹا تک read-only رسائی کیسے دوں؟
اپنے sources کو code میں register کریں اور ماڈل کو tool set دیں — بالکل تین tools۔ ایک بتاتا ہے کیا موجود ہے، ایک plan کو چلائے بغیر preview کرتا ہے، اور ایک read-only surface کے خلاف execute کرتا ہے۔
Read-only database role ایک flag ہے جسے کوئی unset کر سکتا ہے۔ Write capabilities کے بغیر compile کی گئی surface نہیں۔
sqai.tools() → listSources · explainQuery · queryData
Q08میں LLM-generated SQL میں DELETE یا DROP کو کیسے روکوں؟
آپ SQL کو filter نہیں کرتے۔ آپ اسے generate کرنا بند کر دیتے ہیں۔
String filters اور read-only flags ایک ایسی زبان کی حفاظت کرتے ہیں جو ہمیشہ write express کر سکتی ہے — اور prompt-injected SQL ماڈل کے آؤٹ پٹ میں آتی ہے، آپ کے input sanitizer سے آگے۔ SQAI کا ماڈل ایک ایسی grammar میں typed plan لکھتا ہے جس میں کوئی write form نہیں: DELETE مسترد نہیں ہوتا، یہ لکھا ہی نہیں جا سکتا۔
kind: "query" | "computation" · version: "1"
Q09کیا ماڈل میری policy کو وسیع کر سکتا ہے؟
نہیں۔ Policy اس وقت code میں طے ہوتی ہے جب آپ client بناتے ہیں اور ہر execution سے پہلے in-process جانچی جاتی ہے۔ Tool schemas میں کسی قسم کا کوئی allow-list field نہیں، لہٰذا کوئی prompt کچھ reach نہیں کر سکتا۔
ایک explicit allow-list صرف تنگ کر سکتی ہے۔ Eligible surface سے باہر کسی capability کا نام لینا پھر بھی ناکام ہوتا ہے — packaged surface ہی حد ہے۔
policy_denied_source · policy_denied_field · policy_denied_function
Q10کیا کوئی escape hatch ہے؟
ہاں — انسانوں کے لیے، models کے لیے کبھی نہیں۔ Unguarded runtime ایک الگ import کے پیچھے ہے جو contract، policy، اور seed checks کو bypass کرتا ہے، اور یہ کبھی agent tool set کو expose نہیں ہوتا۔
ایک engineer جان بوجھ کر opt out کر سکتا ہے۔ کوئی agent کسی بھی input سے اس تک نہیں پہنچ سکتا۔
import { getUnsafeRuntime } from "@thyn-ai/sqai/unsafe"
IVکیا جاتا ہے، کیا جڑتا ہے، کیا سیکھتا ہے
ڈیٹا
Q11میری مشین سے کون سا ڈیٹا باہر جاتا ہے؟
ڈیفالٹ لوکل موڈ میں، کچھ نہیں۔ کوئری پلین عمل کے اندر ہی حل ہوتا ہے اور کمپیوٹ رن ٹائم آپ کی مشین پر ایک دستخط شدہ ڈیمن ہے۔ واحد خارجی کال پہلی بار استعمال پر رن ٹائم بنڈل کا ڈاؤن لوڈ ہے — انجن کوڈ، آپ کی قطاریں نہیں۔
ایک ماحولیاتی متغیر کو سیلف ہوسٹڈ یا ہوسٹڈ انجن کی طرف موڑیں تو پلان وہاں بھیجے جاتے ہیں — اسناد خفیہ کاری کے ساتھ، ڈیٹا کی کوئی نقل نہیں۔
local: in-process · self_hosted: SQAI_ENGINE_URL · api: SQAI_API_KEY
Q12میں کون سے ڈیٹا سورسز کو کوئری کر سکتا ہوں؟
بغیر کلید کے، عمل کے اندر: CSV، TSV، JSON، ان-میموری قطاریں، اور SQLite — Python میں Excel اور Parquet بھی۔ انجن کے ذریعے: 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 }
Q13کیا SQAI میرے اسکیما یا ڈیٹا پر تربیت کرتا ہے؟
ہرگز نہیں۔ SQAI کوئی ماڈل نہیں ہے اور کچھ بھی نہیں سیکھتا — کوئی لرننگ لوپ موجود ہی نہیں۔ لوکل موڈ میں آپ کی قطاریں مشین سے باہر جاتی ہی نہیں۔
لوپ میں واحد ماڈل وہ ہے جو آپ لاتے ہیں، اور وہ زیادہ سے زیادہ 25 قطاریں فی نتیجہ دیکھتا ہے۔ اس سے بڑا ڈیٹا کاٹا جاتا ہے — اعلانیہ، کبھی خاموشی سے نہیں — اور مکمل قدر ایک مبہم نتیجہ id کے تحت محفوظ رہتی ہے جو 15 منٹ بعد ختم ہو جاتی ہے۔
maxRowsToModel 25 · maxCellsToModel 250 · maxBytesToModel 32,000
Vایک ہی سوال، ایک ہی بائٹس
یکسانیت
Q14یہ یکساں کیسے ہے — اور TypeScript اور Python میں یکساں کیسے؟
اعلان کردہ ایگزیکیوشن اسکوپ کے اندر یکساں — 64-bit فلوٹس، ایک تھریڈ، ایک پِنڈ رن ٹائم — اور ہر نتیجہ اس اسکوپ کو ریکارڈ کرتا ہے، بڑھا چڑھا کر نہیں بتاتا۔
کینونیکل سیریلائزر دونوں SDKs میں کنفارمنس-لاکڈ ہے، اس لیے ایک ہی کمپیوٹیشن TypeScript اور Python میں ایک ہی عدد اور بائٹ-یکساں ہیش لوٹاتی ہے۔
finance.npv(0.1, [-1000, 300, 420, 560, 680]) = 505.020148896933computation_hash b74f67d0… · TS ≡ PY
Q15آپ LLM کو من گھڑت اعداد بنانے سے کیسے روکتے ہیں؟
اسے حساب کرنے ہی نہ دے کر۔ کسی ماڈل سے 200 قطاروں کا مجموعہ مانگیں تو ایک قابلِ یقین عدد ملتا ہے — غلط ہونے کا کوئی اشارہ نہیں۔
SQAI کے ساتھ ماڈل صرف کمپیوٹیشن چنتا ہے؛ انجن اسے انجام دیتا ہے۔ ہمارے درستگی A/B میں، اسی ماڈل نے مقداری سوالات پر جیسے ہی انجن نے حساب کیا، 16 میں سے 0 سے 16 میں سے 16 تک چھلانگ لگائی۔
accuracy A/B: 0/16 → 16/16
Q16کیا آپ دوبارہ چلا سکتے ہیں کہ ایجنٹ نے کیا جواب دیا تھا؟
ہاں — یہی ہیشز کا مقصد ہے۔ ہر نتیجے میں ایک پلان ہیش، ایگزیکیوشن سے پہلے معلوم انووکیشن ہیش، بعد میں معلوم کمپیوٹیشن ہیش، اور رن ٹائم ورژن، پلیٹ فارم، پریسیژن، اور سیڈ ریکارڈ کرنے والا ڈیٹرمنزم انویلپ شامل ہوتا ہے۔
مہینوں بعد اسی اسکوپ میں انووکیشن دوبارہ چلائیں تو ہیش بائٹ بہ بائٹ ملتا ہے۔ اگر بنیادی اسکیما بدل گیا ہو تو خاموشی سے مختلف اعداد کی بجائے ایک نامی اسکیما-ریویژن مسمیچ ملتا ہے۔
run1 b74f67d0d7a594aa7ac91f6291612452aa8ccdf603351ebc8d801a6fddd91bc8run2 b74f67d0d7a594aa7ac91f6291612452aa8ccdf603351ebc8d801a6fddd91bc8identical: true
VIکیا مفت ہے، کیا محدود ہے
قیمت
Q17کیا مجھے API کلید یا اکاؤنٹ چاہیے؟
نہیں۔ لوکل موڈ زیرو-کنفگ ہے — نہ کلید، نہ اکاؤنٹ، نہ کارڈ۔ رن ٹائم پہلی کمپیوٹ کال پر خود کو تیار کر لیتا ہے۔
سائن ان اختیاری ہے اور ڈیوائس کوڈ استعمال کرتا ہے؛ یہ ایک آف لائن لائسنس جاری کرتا ہے جو ایک دستخط شدہ ٹوکن منتقل کرتا ہے، آپ کا ڈیٹا نہیں۔ کلیدیں صرف کسی مختلف انجن کی طرف اشارہ کرنے کے لیے ہوتی ہیں۔
sqai login → RFC 8628 device code · WDJB-MJHT
Q18کیا SQAI مفت ہے یا بامعاوضہ؟
لوکل ڈویلپمنٹ اور منیجڈ کمپیوٹ مفت ہیں — SDK میں کہیں بھی لائسنس چیک نہیں ہے۔
بامعاوضہ درجے مشینوں، نشستوں، اور تجارتی حقوق کو محدود کرتے ہیں، کمپیوٹ فیچرز کو نہیں۔ Developer: مفت، ایک ڈیوائس، غیر تجارتی۔ Pro: $25 ماہانہ، تین ڈیوائسز، تجارتی استعمال، async جابز، ویب ہکس، آڈٹ ٹریل۔ Team: $99 ماہانہ، دس ڈیوائسز، RBAC اور نشستیں شامل۔
Developer $0 · Pro $25/mo · Team $99/mo
VIIایک اور سوال
براہِ راست پوچھیں۔
اگر اوپر جواب نہیں ملا، تو یہ ایک حقیقی جواب کا مستحق ہے — کسی انسان سے۔