د AI اجنټانو لپاره sandbox: بې‌باوره کوډ په یو داسې microVM کې وچلوئ چې په یوه ثانیه کې چالانېږي

هر اجنټ چې کوډ لیکي، وروسته یا ژر باید هغه وچلوي. د داسې اجنټ ټوله موخه همدا ده — او ناخوښه برخه یې هم همدا. ماډل همدا اوس یو سکرېپټ جوړ کړ چې پخپله یې هېڅکله نه دی چلولی: داسې کڅوړې نصبوي چې هېچا نه دي کتلې او داسې فایلونو ته لاس وروړي چې هېچا یې لیست نه دی جوړ کړی. دا ستاسو د SSH کیلیو او د تولید .env فایل ترڅنګ چلول یو قمار دی چې په ورځ کې څو ځله یې کوئ.

Sandbox دا قمار ارزانه کوي. کوډ د څو ثانیو یا دقیقو لپاره خپل Linux ماشین ترلاسه کوي، بیا ماشین ورک شي.

اجنټ څه ترلاسه کوي

هر sandbox یو Firecracker microVM دی: خپل کرنل، خپل فایل سیسټم، خپل د شبکې نوم‌ځای. دا نه داسې کانټینر دی چې ستاسو کرنل شریکوي، نه ستاسو په سرور کې یو فولډر. شاوخوا په یوه ثانیه کې پیلېږي، او دا هغه وخت مهم دی چې اجنټ د ورځې یو نه، بلکې د هرې دندې لپاره یو sandbox جوړوي.

دننه Python 3.12 له pip سره، Node.js 22 له npm سره، bash، git او curl شته. وتونکی انټرنېټ کار کوي — اجنټ کولی شي pip install pandas وچلوي یا یو ریپو کلون کړي. ننوتونکی نه: هېڅ پرانیستی پورټ نشته، SSH نشته. کمانډونه، فایلونه او پایلې زموږ له API څخه تېرېږي، او همدا یوازینۍ دروازه ده.

د لاسرسي درې لارې:

• MCP — که ستاسو اجنټ په Claude، Cursor، Cline یا بل داسې پیرودونکي کې اوسېږي چې MCP ملاتړ کوي، د sandbox وسیلې به د VPS وسیلو ترڅنګ ترلاسه کړي. ستاسو له خوا کوډ ته اړتیا نشته.
• د Python یا TypeScript SDK — pip install eqvps یا npm i @eqvps/sdk، بیا جوړول، چلول، ړنګول.
• ساده REST — په د sandbox اسنادو او د 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 کې چلېږي چې ستاسو هېڅ شی پکې نشته. sandbox ړنګ کړئ، هغه هم ورک شي.

رازونه. خپلې اصلي API کیلي هغه کوډ ته مه اچوئ چې اجنټ یې لیکي. که یوه دنده رښتیا کیلي ته اړتیا لري، د sandbox د چاپېریال متغیر په توګه یې ورکړئ: ارزښتونه کوډ شوي ساتل کېږي، هېڅکله په لاګونو کې نه لیکل کېږي، او API یوازې د هغو نومونه بېرته ورکوي.

نه ختمېدونکي لوپونه. هره کمانډ له 55 ثانیو وروسته درېږي، مګر دا چې تاسو یې د شالید دندې په توګه پیل کړې وي. بېکاره لنډمهاله sandbox د خپل بېکارۍ وخت له تېرېدو وروسته ځان ړنګوي (په ډیفالټ ډول 5 دقیقې). ورځنی یا میاشتنی د لګښت حد نوي sandboxونه دروي کله چې اجنټ د هغې ورځې لپاره بس لګښت کړی وي.

د معلوماتو وتل. دلته باید ښکاره خبره وکړو: وتونکی انټرنېټ پرانیستی دی، ځکه چې پرته له هغه pip install کار نه کوي. Sandbox ستاسو ماشین ساتي؛ خو کوډ له دې نه منع کوي چې هر هغه څه چې د sandbox دننه لوستلی شي انټرنېټ ته ولېږي. نو قاعده ساده ده: sandbox ته یوازې هغه څه واچوئ چې له لاسه ورکول یې درته مهم نه وي.

د تعرفې ټاکل

بلینګ په ثانیه دی، لږ تر لږه 60 ثانیې، له هماغه مخکې ورکړل شوي بیلانس څخه چې زموږ د VPS لپاره دی. د اجنټ یوه عادي دنده — جوړول، دوه کڅوړې نصبول، چلول، ړنګول — په small کې تر یوې دقیقې کم وخت نیسي، نو د 60 ثانیو لږترلږه حسابېږي: شاوخوا $0.0006. په رښتیا، د هغه اجنټ لپاره چې په ورځ کې څو سوه ځله کوډ چلوي، د sandbox بل په بودیجه کې تر ټولو کوچنۍ کرښه ده؛ د LLM ټوکنونه ډېر ګران پرېوځي.

sandbox کله سمه وسیله نه ده

که اجنټ باید یو شی خدمت کړي — ویب اپلیکیشن، د webhook ترلاسه کوونکی، یو بوټ چې پیغامونو ته غوږ نیسي — sandbox به کار ونه کړي، ځکه چې له بهر هېڅ شی ورته نه رسېږي. هماغه خبره د هغه خدمت ده چې باید میاشتې وچلېږي. دا د VPS کار دی: د AI اجنټانو لپاره VPS وګورئ. یو عام وېش: اجنټ په یوه کوچني VPS اوسېږي او د هرې هغې کوډ ټوټې لپاره sandbox جوړوي چې لومړی ځل یې ویني.

بل حد دوامداره دروند محاسبه ده. هغه sandbox چې CPU له 15 دقیقو زیات په بشپړ ظرفیت وساتي ناوړه کارونه ګڼل کېږي، نو اوږدې محاسبې باید په میاشتني کرایه شوي سرور ترسره شي.

پیل

حساب جوړ کړئ، ټوکن واخلئ او لومړی sandbox وچلوئ — د نښلولو لارښود هر ګام تشریح کوي، او نوي حسابونه د ازموینې لپاره $1 د sandbox وخت ترلاسه کوي. بیا اجنټ د sandbox پاڼې یا MCP وسیلو ته ورسوئ، او پرېږدئ چې شیان هلته مات کړي چېرې چې ماتول وړیا دي.

ګام په ګام: په sandbox کې ستاسو د اجنټ لومړۍ دنده. اړوند: جلا شوې د CI ازموینې، د LLM ارزونه او د کوډ کتنه او د PR ازموینې.