dsh-superagent کیا ہے؟
dsh-superagent ایک فعال کوڈنگ ایجنٹ ہے جو ایک GitHub ریپوزٹری کے ساتھ کام کرنے کے لیے بنایا گیا ہے۔ اسے DeepSeek Harness کے لیے ایک بنڈل کے طور پر تقسیم کیا جاتا ہے اور یہ GitHub اور اختیاری طور پر Feishu سے آنے والی درخواستوں کو سنتا ہے۔
جب کوئی مجاز صارف اس سے کام کرنے کو کہتا ہے تو نظام ایک ورک آئٹم کھولتا ہے، ایجنٹ کا مخصوص سیشن اور ڈائریکٹری بناتا ہے، کام مکمل کرتا ہے اور اصل گفتگو میں جواب دیتا ہے۔ نتیجے میں پل ریکویسٹ شامل ہو سکتی ہے۔ ایک ویب پینل ان آئٹمز کو دکھاتا ہے جن پر کسی شخص کی توجہ درکار ہوتی ہے۔
dsh-superagent تحقیق کے لیے ایک پروٹوٹائپ ہے، حوالہ کے طور پر؛ یہ DeepSeek کی کوئی سرکاری پروڈکٹ یا پروڈکشن کے لیے تیار نظام نہیں ہے۔
شائع شدہ ریپوزٹری ٹیم کے اندرونی ورژن اور Exploring Super-agent Design: Towards a More Autonomous Agent System میں زیرِ بحث نفاذ سے مختلف ہے۔ اس مضمون میں بیان کردہ بعض خیالات مستقبل کی سمتوں کی وضاحت کرتے ہیں اور اس پروٹوٹائپ میں نافذ نہیں ہیں۔
بنیادی ڈیزائن اصول
اس منصوبے کا مقصد زیادہ سے زیادہ قدر فراہم کرتے ہوئے انسانی توجہ کی کم سے کم ضرورت رکھنا ہے۔ چونکہ ٹیم کے لیے بنایا گیا ایجنٹ ٹیم کی توجہ بھی صرف کر سکتا ہے، اس لیے dsh-superagent دو اہم پابندیوں پر عمل کرتا ہے:
- یہ صرف اس وقت کارروائی کرتا ہے جب کوئی اس سے کارروائی کرنے کو کہے یا ٹیم کا متعین کردہ اصول اس کارروائی کی اجازت دے۔
- یہ صرف اس وقت بات کرتا ہے جب کسی کو کارروائی کرنا ضروری ہو یا کوئی مکمل شدہ نتیجہ استعمال کر سکے۔
ایجنٹ کو تعینات کرنے سے پہلے فلسفے کی دستاویز پڑھیں۔ یہ اصولِ کار اور نظام چلانے والے شخص کی ذمہ داریوں کی وضاحت کرتی ہے۔
اہم خصوصیات
- ایک ریپوزٹری پر توجہ: ہر تعیناتی ایک GitHub ریپوزٹری کے ساتھ کام کرتی ہے۔
- GitHub انضمام: ایجنٹ GitHub سے آنے والی مجاز درخواستوں کو سنتا ہے۔
- اختیاری Feishu انضمام: ٹیمیں درخواستوں کے ماخذ کے طور پر Feishu بھی استعمال کر سکتی ہیں۔
- ورک آئٹم کی نگرانی: منظور شدہ درخواست ورک آئٹم بن جاتی ہے۔
- الگ تھلگ نفاذ: ہر کام اپنے ایجنٹ سیشن اور ڈائریکٹری میں چلتا ہے۔
- گفتگو سے باخبر جوابات: نتائج اسی گفتگو میں واپس بھیجے جاتے ہیں جہاں سے درخواست آئی تھی۔
- انسانی توجہ کا پینل: ایک ویب پینل اس کام کی نشان دہی کرتا ہے جس میں کسی شخص کی شمولیت درکار ہو۔
- اصول کے زیرِ کنٹرول رویہ: ایجنٹ صرف درخواست یا ٹیم کے واضح اصول کے جواب میں کارروائی کرتا ہے۔
انسٹال کرنے سے پہلے
ریپوزٹری کو تحقیقی کوڈ سمجھیں۔ اس میں بگز، غیر یکساں کوڈنگ اسٹائل یا ایسے انجینئرنگ فیصلے شامل ہو سکتے ہیں جو آپ کے ماحول کے لیے موزوں نہ ہوں۔ اس پر انحصار کرنے سے پہلے نفاذ کا جائزہ لیں اور اسے اپنے ماحول کے مطابق ڈھالیں۔
سیٹ اپ میں کئی مراحل شامل ہیں، اس لیے منصوبہ تجویز کرتا ہے کہ مطلوبہ ترتیب کا دستی اندازہ لگانے کے بجائے اسے کسی کوڈنگ ایجنٹ کے ساتھ مل کر مکمل کیا جائے۔
رہنمائی کے ساتھ انسٹالیشن اور سیٹ اپ
مرحلہ 1: ریپوزٹری کو اپنے کوڈنگ ایجنٹ کے ساتھ کھولیں
کلون کی گئی یا چیک آؤٹ کی گئی ریپوزٹری اپنے کوڈنگ ایجنٹ کے لیے دستیاب کریں۔ پھر اسے منصوبے کی تجویز کردہ سیٹ اپ ہدایت دیں:
Read SETUP.md in this repository and set up dsh-superagent with me.کوڈنگ ایجنٹ کو اپنی بنیادی رہنمائی کے طور پر SETUP.md کی پیروی کرنی چاہیے۔
مرحلہ 2: سیٹ اپ کے سوالات کے جواب دیں
سیٹ اپ کا عمل اس طرح بنایا گیا ہے کہ ایک وقت میں ایک مختصر سوال پوچھا جائے۔ اپنی ریپوزٹری، انضمامات اور ماحول سے متعلق مطلوبہ معلومات فراہم کریں۔ صرف اس وجہ سے جائزے کے مراحل نہ چھوڑیں کہ یہ عمل ایجنٹ کی مدد سے ہو رہا ہے۔
مرحلہ 3: مکمل منصوبے کا جائزہ لیں
مطلوبہ معلومات جمع کرنے کے بعد کوڈنگ ایجنٹ ایک بار مکمل منصوبہ پیش کرے گا۔ انسٹالیشن یا ترتیب میں تبدیلیوں کی اجازت دینے سے پہلے اس کا احتیاط سے جائزہ لیں۔ خاص طور پر تصدیق کریں کہ منصوبہ اس ریپوزٹری سے مطابقت رکھتا ہے جسے آپ ایجنٹ کے زیرِ انتظام دینا چاہتے ہیں اور ان درخواست کے ماخذ سے بھی جنہیں آپ فعال کرنا چاہتے ہیں۔
مرحلہ 4: ایجنٹ کو منصوبہ انسٹال اور ترتیب دینے دیں
منصوبہ منظور کرنے کے بعد کوڈنگ ایجنٹ SETUP.md کے مطابق نظام کو انسٹال اور ترتیب دیتا ہے۔ چونکہ README تفصیلی سیٹ اپ کا طریقۂ کار اسی فائل کے حوالے کرتی ہے، اس لیے غیر دستاویزی کمانڈز پر انحصار کرنے کے بجائے اس کی موجودہ ہدایات پر عمل کریں۔
مرحلہ 5: منصوبے کی توثیق کریں
ترقیاتی توثیق کے لیے چلائیں:
pnpm checkیہ کمانڈ ٹائپ چیک، ٹیسٹس اور بلڈ چلاتی ہے۔ کامیاب عمل منصوبے کی اقسام، ٹیسٹ سوٹ اور بلڈ کے عمل کی مشترکہ جانچ فراہم کرتا ہے۔
ایجنٹ چلانے سے پہلے دستاویزات کو سمجھیں
نمبر والی دستاویزات جان بوجھ کر باہم مربوط ترتیب میں ہیں۔ انہیں اسی ترتیب سے پڑھیں کیونکہ ہر دستاویز میں صرف اس مواد کو مفروضہ بنایا گیا ہے جو اس سے پہلے متعارف کرایا گیا ہے:
- 000 فلسفہ: توجہ کو کم سے کم رکھنے والے عملی اصول اور آپریٹر کی ذمہ داریوں کو سمجھیں۔
- 001 ڈومین ماڈل: منصوبے کے بنیادی تصورات اور ان کے باہمی تعلق کو جانیں۔
- 002 اجازت کاری: یہ طے کریں کہ ایجنٹ سے کام کروانے کی درخواست کرنے کی اجازت کس کو ہے۔
- 003 نفاذ: سمجھیں کہ منظور شدہ کام کیسے انجام دیے جاتے ہیں۔
- 004 پرامپٹس: ایجنٹ کے رویے کی رہنمائی کرنے والے پرامپٹس کا جائزہ لیں۔
- 005 پینل: جانیں کہ ویب پینل انسانی توجہ کے متقاضی آئٹمز کو کیسے پیش کرتا ہے۔
- 006 تعیناتی: دستی سیٹ اپ، تشکیل، اپ گریڈ اور خرابیوں کے ازالے کی ہدایات پر عمل کریں۔
- 007 ساخت: نظام کی تکنیکی ساخت کا مطالعہ کریں۔
- 008 کک بک: Source شامل کرنے کا طریقہ جانیں۔
بنیادی استعمال
مجاز درخواست جمع کریں
سیٹ اپ کے بعد، کوئی مجاز صارف GitHub کے ذریعے، یا اختیاری انضمام فعال ہونے کی صورت میں Feishu کے ذریعے، ایجنٹ سے ریپوزٹری کا کام کروانے کو کہہ سکتا ہے۔ ایک عام درخواست میں مطلوبہ ریپوزٹری تبدیلی اور متعلقہ قبولیت کے معیار درج ہونے چاہییں۔
مثال کے طور پر، کوئی مجاز صارف ایجنٹ سے ریپوزٹری کے مسئلے کی تحقیق کرنے، مناسب کوڈ تبدیلی کرنے اور نتیجہ واپس کرنے کو کہہ سکتا ہے۔ درخواست کا درست طریقہ اور مجاز صارفین آپ کی تشکیل کردہ Source اور اجازت کے قواعد پر منحصر ہیں۔
ایجنٹ کو کام کا آئٹم بنانے اور انجام دینے دیں
درخواست منظور ہونے پر، dsh-superagent ایک work item کھولتا ہے اور یہ کام اپنے ایجنٹ سیشن اور ڈائریکٹری میں انجام دیتا ہے۔ یہ نفاذی ماڈل کام کے سیاق و سباق کو الگ رکھتا ہے۔
نتیجہ اسی سیاق و سباق میں حاصل کریں
ایجنٹ اصل گفتگو میں جواب دیتا ہے، بجائے اس کے کہ صارفین کو نتائج کسی الگ چینل میں تلاش کرنے پر مجبور کیا جائے۔ انجام دیے گئے کام کے لحاظ سے جواب میں pull request شامل ہو سکتی ہے۔
انسانی فالو اپ کے لیے پینل استعمال کریں
ان کاموں کے لیے ویب پینل دیکھیں جن میں کسی شخص کی ضرورت ہو۔ پینل ہر اندرونی مرحلے کے بارے میں غیر ضروری مواصلت پیدا کرنے کے بجائے انسانی کارروائی کے متقاضی آئٹمز سامنے لا کر منصوبے کے توجہ کے انتظام کے مقصد کی حمایت کرتا ہے۔
اجازت کاری اور محفوظ آپریشن
اجازت کاری اس ڈیزائن کا مرکزی حصہ ہے۔ کسی ٹیم کی ریپوزٹری میں کارروائی کرنے کی صلاحیت رکھنے والے فعال ایجنٹ کو من مانی درخواستیں قبول نہیں کرنی چاہییں۔ اجازت کاری کی دستاویزات استعمال کرکے طے کریں کہ کون کام شروع کر سکتا ہے اور کن شرائط کے تحت۔
- درخواست کنندگان محدود کریں: صرف مطلوبہ افراد یا نظاموں کو قابلِ کارروائی درخواستیں بنانے کی اجازت دیں۔
- ٹیم کے قواعد کا جائزہ لیں: یقینی بنائیں کہ خودکار کارروائیاں صرف ان قواعد کے تحت ہوں جو ٹیم نے واضح طور پر تحریر کیے ہیں۔
- انسانی جائزہ برقرار رکھیں: ایجنٹ کی تیار کردہ تبدیلیوں کو ایسا کام سمجھیں جس کے معائنے اور موافقت کی ضرورت ہو سکتی ہے۔
- وسیع استعمال سے پہلے جانچ کریں: ترقیاتی تبدیلیوں کے بعد
pnpm checkچلائیں اور اپنے ماحول میں رویے کی توثیق کریں۔
اعلیٰ درجے کی تجاویز
دستی کارروائیوں کے لیے تعیناتی گائیڈ استعمال کریں
اگر آپ کو دستی طور پر سیٹ اپ کرنا ہو، تشکیل تبدیل کرنی ہو، منصوبہ اپ گریڈ کرنا ہو یا خرابی دور کرنی ہو تو 006 تعیناتی سے رجوع کریں۔ README اس دستاویز کو ان عملی طریقہ کار کا تفصیلی ماخذ قرار دیتا ہے۔
رویے کو بہتر بناتے وقت پرامپٹس کا جائزہ لیں
ایجنٹ کے کام کو سمجھنے یا انجام دینے کے طریقے میں تبدیلی سے پہلے 004 پرامپٹس پڑھیں۔ پرامپٹ کی تبدیلیاں اس بات پر اثر انداز ہو سکتی ہیں کہ ایجنٹ کب گفتگو کرتا ہے، کاموں سے کیسے نمٹتا ہے اور منصوبے کے توجہ کو کم سے کم رکھنے والے فلسفے کی کتنی پابندی کرتا ہے۔
کام کی علیحدگی میں ترمیم سے پہلے نفاذ کا مطالعہ کریں
نظام ہر work item کو اپنا ایجنٹ سیشن اور ڈائریکٹری دیتا ہے۔ اس رویے میں تبدیلی سے پہلے 003 نفاذ اور 007 ساخت کا جائزہ لیں تاکہ تبدیلیاں منصوبے کے نفاذی اور نظامی ماڈلز سے ہم آہنگ رہیں۔
نئی Source احتیاط سے شامل کریں
Source ایک ایسا انضمام ہے جس کے ذریعے نظام کام وصول کر سکتا ہے۔ اگر آپ فراہم کردہ GitHub اور اختیاری Feishu راستوں کے علاوہ کوئی Source شامل کرنا چاہتے ہیں تو 008 کک بک پر عمل کریں۔ نیا درخواست چینل متعارف کراتے وقت اجازت کاری ماڈل کو نظرانداز نہ کریں۔
مفید خاموشی کو ترجیح دیں
نظام میں تبدیلی کرتے وقت کسی کارروائی کی قدر اور اس کی اطلاعات سے پیدا ہونے والی توجہ کی لاگت، دونوں کا جائزہ لیں۔ مواصلت کو اس وقت ترجیح دیں جب کسی شخص کو کارروائی کرنا ہو یا قابلِ استعمال نتیجہ تیار ہو۔ اس طرح توسیعات اور عملی قواعد منصوبے کے مرکزی فلسفے سے ہم آہنگ رہتے ہیں۔
ترقیاتی ورک فلو
کوڈ میں ترمیم کے بعد، منصوبے کی مشترکہ توثیقی کمانڈ استعمال کریں:
pnpm checkچونکہ یہ ٹائپ چیکنگ، ٹیسٹس اور build چلاتی ہے، اس لیے تبدیلیاں شیئر یا تعینات کرنے سے پہلے اسے معمول کے پڑاؤ کے طور پر استعمال کرنا چاہیے۔ اس کمانڈ کا کامیاب ہونا اس تحقیقی پروٹوٹائپ کو production-ready نہیں بناتا؛ آپ کو اب بھی اس کے رویے، سکیورٹی کے مفروضوں، اجازت کاری اور اپنے ماحول کے لیے موزونیت کا جائزہ لینا ہوگا۔
اختتامیہ
dsh-superagent انسانی توجہ کے تقاضوں کو کم سے کم رکھتے ہوئے ایک ہی GitHub ریپوزٹری پر کام سونپنے کا تحقیقی ماڈل فراہم کرتا ہے۔ رہنمائی والے SETUP.md ورک فلو سے آغاز کریں، نمبر شدہ دستاویزات کو ترتیب سے پڑھیں، اجازت کاری کو محتاط انداز میں تشکیل دیں، pnpm check سے تبدیلیوں کی توثیق کریں اور انسانی کوشش کو وہاں مرکوز کرنے کے لیے پینل استعمال کریں جہاں اس کی واقعی ضرورت ہو۔