ለAI ወኪሎች sandbox፦ የማይታመን ኮድን በአንድ ሰከንድ በሚነሳ microVM ውስጥ ያሂዱ

ኮድ የሚጽፍ ማንኛውም ኤጀንት ይዋል ይደር እንጂ ማስኬድ አለበት። የዚህ ዓይነት ኤጀንት ዋና ዓላማ ይህ ነው — የማይመቸውም ክፍል ይኸው ነው። ሞዴሉ ራሱ ፈጽሞ ያላስኬደውን ስክሪፕት አሁን አወጣ፦ ማንም ያልመረመራቸውን ጥቅሎች ይጭናል፣ ማንም ያልዘረዘራቸውን ፋይሎች ይነካል። ይህን ከSSH ቁልፎችዎና ከምርት .env ፋይልዎ አጠገብ ማስኬድ በቀን ብዙ ጊዜ የሚያደርጉት ቁማር ነው።

Sandbox ያንን ቁማር ርካሽ ያደርገዋል። ኮዱ ለጥቂት ሰከንዶች ወይም ደቂቃዎች የራሱን Linux ማሽን ያገኛል፣ ከዚያ ማሽኑ ይጠፋል።

ኤጀንቱ የሚያገኘው

እያንዳንዱ sandbox Firecracker microVM ነው፦ የራሱ kernel፣ የራሱ የፋይል ሥርዓት፣ የራሱ የአውታረ መረብ namespace። ከእርስዎ kernel ጋር የሚጋራ container አይደለም፣ በሰርቨርዎ ላይ ያለ አቃፊም አይደለም። በአንድ ሰከንድ ገደማ ይነሳል፤ ኤጀንት በቀን አንድ ሳይሆን ለእያንዳንዱ ተግባር አንድ ሲከፍት ይህ ትልቅ ነገር ነው።

ውስጥ Python 3.12 ከpip ጋር፣ Node.js 22 ከnpm ጋር፣ bash፣ git እና curl አሉ። ወጪ ኢንተርኔት ይሰራል — ኤጀንቱ pip install pandas ማስኬድ ወይም repo መቅዳት ይችላል። ገቢው አይሰራም፦ ክፍት ፖርት የለም፣ SSH የለም። ትዕዛዞች፣ ፋይሎችና ውጤቶች በእኛ API በኩል ያልፋሉ፣ ያም ብቸኛው በር ነው።

ሦስት የመግቢያ መንገዶች፦

• MCP — ኤጀንትዎ በClaude፣ በCursor፣ በCline ወይም MCP በሚደግፍ ሌላ ደንበኛ ውስጥ ከሆነ፣ የsandbox መሣሪያዎችን ከVPS መሣሪያዎች አጠገብ ያገኛል። ከእርስዎ በኩል ኮድ አያስፈልግም።
• SDK ለPython ወይም TypeScript — pip install eqvps ወይም npm i @eqvps/sdk፣ ከዚያ ፍጠር፣ አስኪድ፣ ሰርዝ።
• ቀላል REST — በsandbox ሰነዶች እና በOpenAPI ዝርዝር ውስጥ ተገልጿል።

በPython ዝቅተኛው loop ይህን ይመስላል፦

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 የአካባቢ ተለዋዋጭ ያስተላልፉት፦ እሴቶቹ ተመስጥረው ይቀመጣሉ፣ በlog ውስጥ ፈጽሞ አይገቡም፣ API ደግሞ ስሞቻቸውን ብቻ ይመልሳል።

ማብቂያ የሌላቸው loopዎች። እንደ ዳራ ተግባር ካልጀመሩት በስተቀር እያንዳንዱ ትዕዛዝ በ55 ሰከንድ ይቆማል። ሥራ ፈት የሆነ ጊዜያዊ sandbox ከሥራ ፈትነት ጊዜ ገደቡ በኋላ ራሱን ይሰርዛል (በነባሪ 5 ደቂቃ)። የዕለት ወይም የወር የወጪ ገደብ ኤጀንቱ ለዕለቱ በቂ ሲያወጣ አዳዲስ sandboxዎችን ያቆማል።

የውሂብ መውጣት። እዚህ ግልጽ መሆን አለብን፦ ወጪ ኢንተርኔት ክፍት ነው፣ ምክንያቱም ያለ እሱ pip install አይሰራም። Sandbox የእርስዎን ማሽን ይጠብቃል፤ ኮዱ በsandbox ውስጥ ማንበብ የሚችለውን ሁሉ ወደ ኢንተርኔት እንዳይልክ ግን አይከለክልም። ስለዚህ ደንቡ ቀላል ነው፦ ቢጠፋ የማይቆጭዎትን ብቻ በsandbox ውስጥ ያስቀምጡ።

ታሪፍ መምረጥ

ክፍያው በሰከንድ ነው፣ ቢያንስ 60 ሰከንድ፣ ከVPSዎቻችን ጋር ከአንድ ዓይነት ቅድመ ክፍያ ቀሪ ሂሳብ። የተለመደ የኤጀንት ተግባር — መፍጠር፣ ሁለት ጥቅሎች መጫን፣ ማስኬድ፣ መሰረዝ — በsmall ላይ ከአንድ ደቂቃ በታች ይወስዳል፣ ስለዚህ የ60 ሰከንድ ዝቅተኛው ይከፈላል፦ ወደ $0.0006 ገደማ። በእውነቱ፣ በቀን ጥቂት መቶ ጊዜ ኮድ ለሚያስኬድ ኤጀንት የsandbox ሂሳብ በበጀቱ ውስጥ ትንሹ መስመር ነው፤ የLLM tokenዎች እጅግ ይወደዳሉ።

sandbox ትክክለኛው መሣሪያ የማይሆንበት ጊዜ

ኤጀንቱ አንድ ነገር ማገልገል ካለበት — የድር መተግበሪያ፣ የwebhook ተቀባይ፣ መልእክቶችን የሚያዳምጥ bot — sandbox አይሆንም፣ ምክንያቱም ከውጭ ምንም ሊደርስበት አይችልም። ለወራት መሄድ ያለበት አገልግሎትም እንዲሁ። ይህ የVPS ሥራ ነው፦ VPS ለAI ኤጀንቶች ይመልከቱ። የተለመደ ክፍፍል፦ ኤጀንቱ በትንሽ VPS ላይ ይኖራል፣ ከዚህ በፊት ላላየው ለእያንዳንዱ የኮድ ቁራጭ sandbox ይፈጥራል።

ሌላው ገደብ ረጅምና ከባድ ስሌት ነው። CPUን ከ15 ደቂቃ በላይ ሙሉ በሙሉ የሚይዝ sandbox እንደ አላግባብ መጠቀም ይቆጠራል፣ ስለዚህ ረጅም ስሌቶች በወር በሚከራይ ሰርቨር ላይ መሆን አለባቸው።

መጀመር

መለያ ይክፈቱ፣ token ይውሰዱ፣ የመጀመሪያውን sandbox ያስኪዱ — የግንኙነት መመሪያው እያንዳንዱን ደረጃ ያሳያል፣ አዳዲስ መለያዎችም ለሙከራ $1 የsandbox ጊዜ ያገኛሉ። ከዚያ ኤጀንቱን ወደ የsandbox ገጽ ወይም ወደ MCP መሣሪያዎች ይጠቁሙት፣ መስበር ነጻ በሆነበት ቦታ ነገሮችን እንዲሰብር ይተዉት።

ደረጃ በደረጃ፦ በsandbox ውስጥ የመጀመሪያው የወኪል ተግባርዎ. ተዛማጅ፦ የተገለሉ የCI ሙከራዎች፣ የLLM ግምገማ እና የኮድ ግምገማ እና የPR ፍተሻ.