AI ایجنٹس کے لیے سینڈباکس: ناقابل اعتماد کوڈ ایک سیکنڈ میں چلنے والے microVM میں چلائیں

ہر وہ ایجنٹ جو کوڈ لکھتا ہے، آخرکار اسے چلانا بھی پڑتا ہے۔ ایسے ایجنٹ کا مقصد ہی یہی ہے — اور پریشان کن حصہ بھی یہی۔ ماڈل نے ابھی ایک ایسا اسکرپٹ بنایا ہے جو اس نے خود کبھی نہیں چلایا: یہ ایسے پیکیجز انسٹال کرتا ہے جنہیں کسی نے نہیں جانچا اور ایسی فائلوں کو چھوتا ہے جن کی کسی نے فہرست نہیں بنائی۔ اسے اپنی SSH کیز اور پروڈکشن کی .env فائل کے ساتھ چلانا ایک جوا ہے جو آپ دن میں کئی بار کھیلتے ہیں۔

سینڈباکس اس جوئے کو سستا بنا دیتا ہے۔ کوڈ کو چند سیکنڈ یا منٹ کے لیے اپنی Linux مشین ملتی ہے، پھر مشین غائب ہو جاتی ہے۔

ایجنٹ کو کیا ملتا ہے

ہر سینڈباکس ایک Firecracker microVM ہے: اپنا کرنل، اپنا فائل سسٹم، اپنا نیٹ ورک نیم اسپیس۔ یہ نہ آپ کا کرنل شیئر کرنے والا کنٹینر ہے، نہ آپ کے سرور پر کوئی فولڈر۔ یہ تقریباً ایک سیکنڈ میں چالو ہوتا ہے، اور یہ تب اہم ہے جب ایجنٹ دن میں ایک کے بجائے ہر کام کے لیے ایک سینڈباکس بناتا ہے۔

اندر pip کے ساتھ Python 3.12، npm کے ساتھ Node.js 22، bash، git اور curl موجود ہیں۔ آؤٹ باؤنڈ انٹرنیٹ کام کرتا ہے — ایجنٹ pip install pandas چلا سکتا ہے یا کوئی ریپو کلون کر سکتا ہے۔ ان باؤنڈ نہیں: نہ کوئی کھلا پورٹ، نہ SSH۔ کمانڈز، فائلیں اور آؤٹ پٹ ہمارے API سے گزرتے ہیں، اور یہی واحد دروازہ ہے۔

رسائی کے تین طریقے:

• MCP — اگر آپ کا ایجنٹ Claude، Cursor، Cline یا MCP کو سپورٹ کرنے والے کسی اور کلائنٹ میں رہتا ہے تو اسے VPS ٹولز کے ساتھ سینڈباکس ٹولز بھی مل جاتے ہیں۔ آپ کی طرف سے کوئی کوڈ نہیں۔
• Python یا TypeScript SDK — pip install eqvps یا npm i @eqvps/sdk، پھر بنائیں، چلائیں، حذف کریں۔
• سادہ REST — سینڈباکس کی دستاویزات اور OpenAPI اسپیسفکیشن میں درج ہے۔

Python میں کم سے کم لوپ کچھ یوں دکھتا ہے:

from eqvps import Sandbox

with Sandbox.create(tariff="small") as sb:
    sb.upload("/root/task.py", agent_generated_code)
    result = sb.exec("python3 /root/task.py", timeout=55)
    print(result.exit_code, result.stdout[-2000:])
# the sandbox is deleted here, also if anything above raised

غیر صفر ایگزٹ کوڈ عام نتیجے کے طور پر واپس آتا ہے، استثنا (exception) کے طور پر نہیں۔ بالکل وہی جو چاہیے جب ایجنٹ کو traceback پڑھ کر دوبارہ کوشش کرنی ہو۔

خطرناک صورتیں اور ان کا انجام

نقصان دہ یا بس خراب پیکیج۔ یہ ایسی VM کے اندر چلتا ہے جس میں آپ کی کوئی چیز نہیں۔ سینڈباکس حذف کریں، یہ ختم۔

راز۔ اپنی مرکزی API کیز اس کوڈ میں نہ ڈالیں جو ایجنٹ لکھتا ہے۔ اگر کسی کام کو واقعی کی چاہیے تو اسے سینڈباکس کے انوائرنمنٹ ویری ایبل کے طور پر دیں: قدریں انکرپٹ ہو کر محفوظ ہوتی ہیں، لاگز میں کبھی نہیں جاتیں، اور API صرف ان کے نام واپس کرتا ہے۔

نہ ختم ہونے والے لوپ۔ ہر کمانڈ 55 سیکنڈ بعد رک جاتی ہے، الا یہ کہ آپ نے اسے بیک گراؤنڈ ٹاسک کے طور پر چلایا ہو۔ بیکار پڑا عارضی سینڈباکس اپنی idle ٹائم آؤٹ کے بعد خود کو حذف کر دیتا ہے (ڈیفالٹ 5 منٹ)۔ روزانہ یا ماہانہ خرچ کی حد نئے سینڈباکس روک دیتی ہے جب ایجنٹ اس دن کے لیے کافی خرچ کر چکا ہو۔

ڈیٹا کا باہر جانا۔ یہاں صاف بات کرنی ضروری ہے: آؤٹ باؤنڈ انٹرنیٹ کھلا ہے، کیونکہ اس کے بغیر pip install کام نہیں کرتا۔ سینڈباکس آپ کی مشین کو بچاتا ہے؛ یہ کوڈ کو اس سے نہیں روکتا کہ سینڈباکس کے اندر جو کچھ وہ پڑھ سکے، انٹرنیٹ پر بھیج دے۔ اس لیے اصول سادہ ہے: سینڈباکس میں صرف وہی رکھیں جس کے کھو جانے کی آپ کو پروا نہ ہو۔

ٹیرف کا انتخاب

بلنگ فی سیکنڈ ہے، کم از کم 60 سیکنڈ، اسی پری پیڈ بیلنس سے جو ہمارے VPS کے لیے ہے۔ ایجنٹ کا ایک عام کام — بنانا، دو پیکیجز انسٹال کرنا، چلانا، حذف کرنا — small پر ایک منٹ سے کم لیتا ہے، اس لیے کم از کم 60 سیکنڈ کا بل بنتا ہے: تقریباً $0.0006۔ سچ کہیں تو جو ایجنٹ دن میں چند سو بار کوڈ چلاتا ہے، اس کے لیے سینڈباکس کا بل بجٹ کی سب سے چھوٹی لائن ہے؛ LLM ٹوکنز کہیں زیادہ مہنگے پڑتے ہیں۔

سینڈباکس کب درست ٹول نہیں

اگر ایجنٹ کو کچھ سرو کرنا ہے — ویب ایپ، webhook وصول کرنے والا، پیغامات سننے والا بوٹ — تو سینڈباکس کام نہیں آئے گا، کیونکہ باہر سے کوئی اس تک نہیں پہنچ سکتا۔ یہی حال اس سروس کا ہے جسے مہینوں چلنا ہو۔ یہ VPS کا کام ہے: AI ایجنٹس کے لیے VPS دیکھیں۔ عام تقسیم یہ ہے کہ ایجنٹ ایک چھوٹے VPS پر رہتا ہے اور ہر اس کوڈ کے ٹکڑے کے لیے سینڈباکس بناتا ہے جو وہ پہلی بار دیکھ رہا ہو۔

دوسری حد مسلسل بھاری حساب کتاب ہے۔ جو سینڈباکس 15 منٹ سے زیادہ CPU کو پوری طاقت پر رکھے، اسے غلط استعمال سمجھا جاتا ہے، اس لیے لمبے حسابات ماہانہ کرائے کے سرور پر ہونے چاہییں۔

شروعات

اکاؤنٹ بنائیں، ٹوکن لیں اور پہلا سینڈباکس چلائیں — کنکشن گائیڈ ہر قدم سمجھاتی ہے، اور نئے اکاؤنٹس کو آزمانے کے لیے $1 کا سینڈباکس ٹائم ملتا ہے۔ پھر ایجنٹ کو سینڈباکس کے صفحے یا MCP ٹولز کی طرف بھیجیں، اور اسے وہاں چیزیں توڑنے دیں جہاں توڑنا مفت ہے۔

مرحلہ وار: سینڈباکس میں آپ کا پہلا ایجنٹ ٹاسک. متعلقہ: الگ تھلگ CI ٹیسٹ رنز، LLM کی جانچ اور کوڈ ریویو اور PR چیکس.