BroadRouter
شروع کریں

کوڈنگ ایجنٹس کو رات بھر بغیر نگرانی محفوظ طریقے سے کیسے چلائیں

BroadNet Inference ٹیم · 5 منٹ کی پڑھائی · شائع شدہ · اپ ڈیٹ

ایجنٹ کو ایسے کنٹینر یا VM میں چلائیں جس میں صرف ریپوزیٹری ماؤنٹ ہو، اس کی اپنی git برانچ پر، اور ہر مکمل مرحلے کے بعد commit کرتے ہوئے۔ اسے لکھی ہوئی ٹاسک فائل، مراحل کی حد اور گھڑی کے حساب سے ڈیڈ لائن دیں، پھر صبح برانچ کا جائزہ لیں۔ مقررہ قیمت پلان سیشن، جیسے BroadNet کا $60 والا Full Moon، بدترین صورت کا بل طے کر دیتا ہے۔

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

یہ اسے سیٹ اپ کرنے کی چیک لسٹ ہے۔

1. بغیر نگرانی والے ایجنٹ کو سینڈ باکس کیسے کریں؟

بغیر نگرانی والا ایجنٹ ایسی شیل کمانڈز چلاتا ہے جنہیں کوئی منظور نہیں کرتا۔ فرض کر کے چلیں کہ آخرکار وہ کچھ ایسا چلائے گا جو آپ نہ چلاتے: غلط ڈائریکٹری ڈیلیٹ کرنا، کوئی پیکیج انسٹال کرنا، کسی ریموٹ پر push کرنا۔ اسے محدود رکھیں۔

  • کنٹینر یا VM، آپ کے لیپ ٹاپ کا مرکزی یوزر اکاؤنٹ نہیں۔ Docker کی سکیورٹی دستاویزات کنٹرولز بتاتی ہیں؛ کم از کم non-root یوزر کے طور پر چلائیں اور جن capabilities کی ضرورت نہیں، انہیں ہٹا دیں۔
  • صرف ریپوزیٹری ماؤنٹ کریں۔ کوئی ہوم ڈائریکٹری نہیں، کوئی SSH کلید نہیں، کوئی کلاؤڈ کریڈنشل نہیں، ٹوکنز سے بھرا کوئی ~/.config نہیں۔
  • کوئی پروڈکشن سیکرٹ نہیں۔ ٹیسٹ ڈیٹا بیس اور فرضی API کلیدیں استعمال کریں۔ اگر ایجنٹ کو کوئی اصل سروس چاہیے تو اسے محدود دائرے والی، منسوخ کی جا سکنے والی کلید دیں۔
  • نیٹ ورک محدود کریں۔ ایجنٹ کو ماڈل API اور شاید ایک پیکیج رجسٹری چاہیے۔ اس کے علاوہ اسے شاذ و نادر ہی کچھ چاہیے۔
  • push کا حق نہیں۔ اسے لوکل commit کرنے دیں۔ جائزے کے بعد push آپ کریں۔

ماڈل API کلید وہ اکیلا کریڈنشل ہے جو ایجنٹ کے پاس ہونا ہی چاہیے۔ اسی مقصد کے لیے بنی کلید استعمال کریں، اور اگر آپ کا فراہم کنندہ سپورٹ کرے تو اسے سینڈ باکس کے باہر جانے والے IP تک محدود کریں۔ BroadNet کی کلیدیں 32 اندراجات تک کی IP allow-lists سپورٹ کرتی ہیں، اس لیے لیک ہوئی کلید کہیں اور سے بیکار ہے۔

2. ہر ایجنٹ کو اپنی برانچ کیوں دیں؟

ایک الگ برانچ پر کام کریں، کبھی main پر نہیں۔ اگر آپ ایک سے زیادہ ایجنٹس چلاتے ہیں تو ہر ایک کو git worktree سے اپنی ورکنگ ڈائریکٹری دیں:

git worktree add ../agent-tests-api -b agent/tests-api
git worktree add ../agent-lint-fixes -b agent/lint-fixes

ہر worktree اسی ریپوزیٹری کا الگ checkout ہے، اس لیے ایجنٹس ایک دوسرے کی فائلیں نہیں لکھتے، اور ہر برانچ ٹھیک ٹھیک دکھاتی ہے کہ ایک ایجنٹ نے کیا کیا۔

پھر ہر مکمل مرحلے کے بعد commit کریں۔ Aider بطور ڈیفالٹ یہ کرتا ہے۔ دوسرے ایجنٹس کے لیے اسے ہدایات میں شامل کریں، یا لوپ کو ایسے لپیٹیں کہ ٹیسٹ پاس ہونے پر commit ہو جائے۔ چھوٹے commits کی تاریخ “ایجنٹ نے رات 3 بجے کچھ توڑ دیا” کو “commit 14 نے توڑا؛ 1 سے 13 رکھو” میں بدل دیتی ہے۔

3. ٹاسک فائل میں کیا لکھیں؟

جو ایک سطری پرامپٹ انٹرایکٹو طریقے سے کام کرتا ہے، وہ رات کو ناکام ہوتا ہے، کیونکہ ایجنٹ کے پہلے سوال کا جواب دینے والا کوئی نہیں ہوتا۔ ایک ٹاسک فائل لکھیں:

# Task: add unit tests to src/billing/

## Goal
Every public function in src/billing/ has at least one unit test.

## Done when
- `pytest tests/billing` passes
- coverage for src/billing/ is reported (no target)
- no changes outside tests/billing/ except fixing obvious bugs, each in its own commit

## Rules
- Do not change public function signatures.
- If a function is untestable without a refactor, list it in NOTES.md and move on.
- Run `pytest tests/billing -x` after each new test file.

## Notes
Append decisions and skipped items to NOTES.md as you go.

“done when” والا حصہ سب سے اہم ہے۔ یہ ایجنٹ کو جاننے کا طریقہ دیتا ہے کہ کام مکمل ہوا، اور آپ کو جانچنے کا طریقہ۔ اگر رن دوبارہ شروع ہو یا کانٹیکسٹ کمپیکٹ ہو، تو نوٹس فائل یادداشت کا کام بھی کرتی ہے؛ دیکھیں لمبے چلنے والے ایجنٹس کے لیے کانٹیکسٹ مینجمنٹ۔

4. کون سے گارڈز اٹکے ہوئے ایجنٹ کو روکتے ہیں؟

بغیر نگرانی کا مطلب ہے کہ اٹکے ایجنٹ پر صبح تک کسی کی نظر نہیں جاتی۔ چار گارڈز:

  1. مراحل کی حد۔ ہر ٹاسک کے لیے ماڈل کالز کی ایک مقررہ زیادہ سے زیادہ تعداد۔
  2. ڈیڈ لائن۔ گھڑی کے ایک مقررہ وقت پر روکیں، مثلاً صبح 07:00، حالت چاہے جو ہو۔
  3. دہراؤ کی شناخت۔ جب ایک ہی ٹول کال تین بار ایک ہی نتیجہ لوٹائے، یا مقررہ تعداد کے مراحل تک کوئی فائل نہ بدلے، تو روکیں۔
  4. ہر ٹول کا ٹائم آؤٹ۔ لٹکا ہوا ٹیسٹ سوٹ پوری رات کو نہیں لٹکانا چاہیے۔

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

Aider کو اس طرح چلانا آسان ہے: اس کی اسکرپٹنگ دستاویزات ایک ہدایت چلا کر باہر نکلنے کے لیے --message آپشن اور سوالات خودکار طور پر قبول کرنے کے لیے --yes-always دکھاتی ہیں۔ اسے ٹاسک فہرست پر چلنے والے شیل لوپ میں لپیٹیں، ہر رن کے گرد timeout کے ساتھ، اور آپ کے پاس رات بھر کی ایک سادہ قطار ہے۔

5. رات بھر کے لیے پلان سیشن سستا ہے یا فی ٹوکن بلنگ؟

رات بھر کے رنز لاگت کا سوال بدل دیتے ہیں۔ میٹر کوئی نہیں دیکھ رہا، اور اٹکا ہوا ایجنٹ گھنٹوں لوپ میں گھوم سکتا ہے۔

فی ٹوکن کلید پر، لاگت اس پر منحصر ہے کہ ایجنٹ کتنا بھیجتا ہے۔ ایجنٹس ہر مرحلے پر کانٹیکسٹ دوبارہ بھیجتے ہیں، اس لیے آٹھ گھنٹے کا رن جمع ہوتا جاتا ہے۔ پرامپٹ کیشنگ بہت مدد کرتی ہے (DeepSeek V4.1 Flash پر کیش شدہ ان پٹ $0.0055 فی دس لاکھ ٹوکن ہے، جبکہ نیا ان پٹ $0.175)، مگر آؤٹ پٹ اور ریزننگ ٹوکنز کا پورا بل بنتا ہے۔ آپ کو ہر رن کا ٹوکن بجٹ اور اکاؤنٹ پر خرچ کی حد چاہیے۔

پلان سیشن پر، کوئی ٹوکن میٹر نہیں۔ Full Moon سیشن لامحدود DeepSeek V4.1 Flash کے لیے $60 ماہانہ ہے، اور یہی بالائی حد ہے، ایجنٹ چاہے جتنی دیر چلے یا جتنا لوپ کرے۔ رات بھر کے کام کے لیے یہی بنیادی کشش ہے: بدترین صورت کا بل سونے سے پہلے معلوم ہوتا ہے۔

فی ٹوکن کلید پلان سیشن
اٹکی ہوئی رات کی بدترین لاگت ٹوکنز کے ساتھ بڑھتی ہے پلان کی قیمت پر مقرر
متوازی ایجنٹس ہر استعمال کے مطابق ادائیگی والی کلید پر بیک وقت 4 درخواستوں تک ہر سیشن پر ایک وقت میں ایک درخواست
ماڈلز تمام چیٹ ماڈلز صرف DeepSeek V4.1 Flash
کیا گارڈز پھر بھی چاہییں ہاں، لاگت اور وقت کے لیے ہاں، وقت کے لیے

سیشنز پر دو عملی باتیں۔ ایک سیشن ایک وقت میں ایک درخواست چلاتا ہے، اس لیے ایک سیشن شیئر کرنے والے دو ایجنٹس باری باری چلتے ہیں؛ ایک سیشن پر ٹاسک ترتیب سے چلتے ہیں، جو رات کو اکثر ٹھیک ہے۔ اگر آپ ایجنٹس ساتھ ساتھ چلانا چاہتے ہیں تو ہر ایجنٹ کے لیے ایک سیشن خریدیں۔ مقررہ قیمت API پر متوازی ایجنٹس اس کا حساب بتاتا ہے۔

تقریباً 100 ٹوکن فی سیکنڈ کی عام رفتار پر، ایک سیشن مسلسل استعمال کے ایک مہینے میں تقریباً 259 ملین آؤٹ پٹ ٹوکن بنا سکتا ہے۔ آپ کے لیے یہ فی ٹوکن قیمت سے بہتر ہے یا نہیں، یہ حجم پر منحصر ہے؛ BroadNet کی کل وقتی کوڈنگ ایجنٹ والی مثال میں استعمال کے مطابق ادائیگی پر یہ تقریباً $65.40 ماہانہ بنتا ہے۔ اپنے اعداد مقررہ قیمت بمقابلہ فی ٹوکن کیلکولیٹر میں چلائیں۔ لمبے بغیر نگرانی رنز کو کانٹیکسٹ کا نظم و ضبط اور کریش کے بعد بھی قائم رہنے والی دوبارہ کوششیں چاہییں: دیکھیں ٹائم آؤٹس، دوبارہ کوششیں اور چیک پوائنٹس۔

6. صبح رن کا جائزہ کیسے لیں؟

رات بھر کے رن کا فائدہ صرف جائزے کے وقت ملتا ہے۔ اسے تیز بنائیں:

  1. پہلے NOTES.md پڑھیں۔ ایجنٹ نے کیا مکمل کیا، کیا چھوڑا اور کہاں اٹکا؟
  2. رکنے کی وجہ دیکھیں۔ مکمل ہوا، مراحل کی حد، ڈیڈ لائن یا دہراؤ؟
  3. ٹیسٹ خود چلائیں۔ ٹیسٹ سبز ہونے کی ایجنٹ کی رپورٹ پر بھروسہ نہ کریں۔
  4. diff کو commit کے حساب سے پڑھیں۔ چھوٹے commits غلط تبدیلیاں پہچاننا اور ہٹانا آسان بناتے ہیں۔
  5. جو رکھنا ہے اسے squash یا rebase کریں، پھر ایک عام pull request کھولیں۔

زیادہ تر صبح آپ زیادہ تر کام رکھیں گے اور چند commits ہاتھ سے ٹھیک کریں گے۔ بری صبح آپ ایک برانچ ڈیلیٹ کر دیں گے۔ دونوں صورتوں میں، آپ کے بغیر main کو کچھ نہیں چھوتا۔

پہلی رات اسے محفوظ طریقے سے کیسے آزمائیں؟

ایک واضح طور پر متعین ٹاسک، ایک ایجنٹ اور ایک سیشن سے شروع کریں۔ رات بھر کچھ بھی چلتا چھوڑنے سے پہلے یہ جانچنے کے لیے کہ سینڈ باکس، برانچ اور گارڈز کا سیٹ اپ کام کرتا ہے، ایک Meteor گھنٹہ ($1) کافی ہے۔ ایجنٹ کے لیے، Aider گائیڈ میں درست کنکشن سیٹنگز ہیں، کوڈنگ ایجنٹس کے لیے بہترین اوپن ماڈل ماڈل چننے میں مدد کرتا ہے، اور پلان سیشنز کیسے کام کرتے ہیں کلیدوں اور سیشنز کا احاطہ کرتا ہے۔

عام سوالات

کیا ایجنٹ کو بغیر نگرانی شیل کمانڈز چلانے دینا محفوظ ہے؟

صرف ایسے سینڈ باکس کے اندر جسے آپ بخوشی پھینک سکیں۔ ریپوزیٹری ماؤنٹ کریں، سیکرٹس اور پروڈکشن کریڈنشلز باہر رکھیں، اور نیٹ ورک رسائی اتنی ہی دیں جتنی ٹاسک کو چاہیے۔

ایک پلان سیشن رات بھر میں کتنے ٹاسک سنبھال سکتا ہے؟

ایک سیشن ایک وقت میں ایک درخواست چلاتا ہے، اس لیے ایک سیشن پر ٹاسک ایک کے بعد ایک چلتے ہیں۔ انہیں ایک سیشن پر ترتیب سے قطار میں لگائیں، یا جتنے ایجنٹس متوازی چلانے ہیں، ہر ایک کے لیے الگ سیشن خریدیں۔

اگر ایجنٹ رات میں بلڈ توڑ دے تو؟

جائزے کے بغیر کچھ بھی آپ کی main برانچ تک نہیں پہنچتا۔ ہر مرحلے کے commit سے آپ ٹھیک ٹھیک دیکھ سکتے ہیں کہ کہاں غلطی ہوئی، اور اس سے پہلے کے اچھے commits رکھ سکتے ہیں۔

کون سے ٹاسک رات بھر کے رنز کے لیے موزوں ہیں؟

واضح طور پر متعین اور قابلِ ٹیسٹ کام، جیسے کال سائٹس کو نئے API پر منتقل کرنا، بغیر ٹیسٹ والے ماڈیولز میں ٹیسٹ شامل کرنا، پورے کوڈ بیس میں lint ٹھیک کرنا، dependencies اپ گریڈ کرنا۔ کھلا ڈیزائن کا کام کسی انسان کی شمولیت سے بہتر ہوتا ہے۔

Markdown میں پڑھیںChatGPT سے پوچھیںClaude سے پوچھیںPerplexity سے پوچھیں