dsh-superagent কী?
dsh-superagent হলো একটি সক্রিয়ভাবে কাজ করা কোডিং এজেন্ট, যা একটি GitHub রিপোজিটরির সঙ্গে কাজ করার জন্য তৈরি। এটি DeepSeek Harness-এর জন্য একটি বান্ডেল হিসেবে বিতরণ করা হয় এবং GitHub ও ঐচ্ছিকভাবে Feishu থেকে আসা অনুরোধ শোনে।
অনুমোদিত কোনো ব্যবহারকারী কাজ করতে বললে, সিস্টেম একটি কাজের আইটেম খোলে, এজেন্টের জন্য আলাদা সেশন ও ডিরেক্টরি তৈরি করে, কাজটি সম্পন্ন করে এবং মূল কথোপকথনেই উত্তর দেয়। ফলাফলের মধ্যে একটি pull request থাকতে পারে। একটি ওয়েব প্যানেলে এমন আইটেম দেখানো হয়, যেগুলোর জন্য কোনো ব্যক্তির মনোযোগ প্রয়োজন।
dsh-superagent একটি গবেষণামূলক প্রোটোটাইপ, রেফারেন্সের জন্য; এটি কোনো অফিসিয়াল DeepSeek পণ্য বা উৎপাদন-প্রস্তুত সিস্টেম নয়।
প্রকাশিত রিপোজিটরিটি দলের অভ্যন্তরীণ সংস্করণ এবং Exploring Super-agent Design: Towards a More Autonomous Agent System-এ আলোচিত বাস্তবায়ন থেকে ভিন্ন। ওই নিবন্ধের কিছু ধারণা ভবিষ্যৎ দিকনির্দেশনা বর্ণনা করে এবং এই প্রোটোটাইপে সেগুলো বাস্তবায়িত হয়নি।
মূল নকশার নীতি
প্রকল্পটির লক্ষ্য হলো যতটা সম্ভব কম মানুষের মনোযোগ নিয়ে যতটা সম্ভব বেশি মূল্য প্রদান করা। দলজুড়ে ব্যবহৃত একটি এজেন্টও দলের মনোযোগ ব্যয় করতে পারে। তাই dsh-superagent দুটি গুরুত্বপূর্ণ সীমাবদ্ধতা অনুসরণ করে:
- কেউ কাজ করতে বললে অথবা দলের নির্ধারিত কোনো নিয়ম কাজটি অনুমোদন করলে তবেই এটি কাজ করে।
- কাউকে কোনো পদক্ষেপ নিতে হলে অথবা সম্পন্ন ফলাফল ব্যবহার করতে পারলে তবেই এটি কথা বলে।
এজেন্টটি স্থাপন করার আগে দর্শন নথিটি পড়ুন। এতে এই পরিচালন নীতি এবং সিস্টেম চালানো ব্যক্তির দায়িত্ব ব্যাখ্যা করা হয়েছে।
প্রধান বৈশিষ্ট্য
- একক-রিপোজিটরি কেন্দ্রিকতা: প্রতিটি স্থাপনা একটি GitHub রিপোজিটরির সঙ্গে কাজ করে।
- GitHub সংযোগ: এজেন্ট GitHub থেকে আসা অনুমোদিত অনুরোধ শোনে।
- ঐচ্ছিক Feishu সংযোগ: দলগুলো অনুরোধের উৎস হিসেবে Feishu-ও ব্যবহার করতে পারে।
- কাজের আইটেম ট্র্যাকিং: গৃহীত অনুরোধ একটি কাজের আইটেমে পরিণত হয়।
- বিচ্ছিন্নভাবে সম্পাদন: প্রতিটি কাজ নিজস্ব এজেন্ট সেশন ও ডিরেক্টরিতে চলে।
- কথোপকথন-সচেতন উত্তর: যে কথোপকথন থেকে অনুরোধ এসেছে, ফলাফল সেখানেই ফেরত দেওয়া হয়।
- মানব-মনোযোগ প্যানেল: কোনো ব্যক্তির সম্পৃক্ততা প্রয়োজন এমন কাজ ওয়েব প্যানেল শনাক্ত করে।
- নিয়ম-নিয়ন্ত্রিত আচরণ: কোনো অনুরোধ বা দলের স্পষ্ট নিয়মের প্রতিক্রিয়াতেই এজেন্ট কাজ করে।
ইনস্টল করার আগে
রিপোজিটরিটিকে গবেষণামূলক কোড হিসেবে বিবেচনা করুন। এতে বাগ, অসামঞ্জস্যপূর্ণ কোডিং স্টাইল বা আপনার পরিবেশের জন্য অনুপযুক্ত প্রকৌশলগত সিদ্ধান্ত থাকতে পারে। এর ওপর নির্ভর করার আগে বাস্তবায়নটি পর্যালোচনা করে প্রয়োজন অনুযায়ী মানিয়ে নিন।
সেটআপে অনেকগুলো ধাপ রয়েছে। তাই প্রয়োজনীয় কনফিগারেশন নিজে অনুমান করে করার বদলে কোনো কোডিং এজেন্টের সঙ্গে সহযোগিতামূলকভাবে সেটআপ সম্পন্ন করার পরামর্শ প্রকল্পটি দেয়।
নির্দেশিত ইনস্টলেশন ও সেটআপ
ধাপ ১: কোডিং এজেন্ট দিয়ে রিপোজিটরি খুলুন
ক্লোন করা বা চেক-আউট করা রিপোজিটরিটি আপনার কোডিং এজেন্টের জন্য উপলভ্য করুন। এরপর প্রকল্পের সুপারিশ করা সেটআপ নির্দেশনাটি দিন:
Read SETUP.md in this repository and set up dsh-superagent with me.কোডিং এজেন্টের সত্যের একমাত্র উৎস হিসেবে SETUP.md অনুসরণ করা উচিত।
ধাপ ২: সেটআপের প্রশ্নগুলোর উত্তর দিন
সেটআপ প্রবাহটি একবারে একটি সংক্ষিপ্ত প্রশ্ন করার জন্য তৈরি। আপনার রিপোজিটরি, সংযোগ এবং পরিবেশ সম্পর্কে চাওয়া তথ্য দিন। প্রক্রিয়াটি এজেন্ট-সহায়িত হওয়ার কারণে পর্যালোচনার ধাপগুলো এড়িয়ে যাবেন না।
ধাপ ৩: সম্পূর্ণ পরিকল্পনা পর্যালোচনা করুন
প্রয়োজনীয় তথ্য সংগ্রহের পর কোডিং এজেন্ট একবারে সম্পূর্ণ পরিকল্পনাটি উপস্থাপন করবে। ইনস্টলেশন বা কনফিগারেশনে পরিবর্তনের অনুমতি দেওয়ার আগে পরিকল্পনাটি সতর্কতার সঙ্গে পর্যালোচনা করুন। বিশেষভাবে নিশ্চিত করুন যে পরিকল্পনাটি আপনি যে রিপোজিটরি এজেন্টকে পরিচালনা করতে দেবেন এবং যে অনুরোধের উৎসগুলো সক্রিয় করতে চান, তার সঙ্গে সামঞ্জস্যপূর্ণ।
ধাপ ৪: এজেন্টকে প্রকল্প ইনস্টল ও কনফিগার করতে দিন
পরিকল্পনায় অনুমোদন দেওয়ার পর কোডিং এজেন্ট SETUP.md অনুযায়ী সিস্টেমটি ইনস্টল ও কনফিগার করবে। README বিস্তারিত সেটআপ প্রক্রিয়াটি ওই ফাইলে নির্ধারণ করে দিয়েছে। তাই নথিভুক্ত নয় এমন কমান্ডের ওপর নির্ভর না করে ফাইলটির বর্তমান নির্দেশনা অনুসরণ করুন।
ধাপ ৫: প্রকল্প যাচাই করুন
ডেভেলপমেন্ট যাচাইয়ের জন্য চালান:
pnpm checkএই কমান্ডটি টাইপচেক, পরীক্ষা এবং বিল্ড চালায়। সফলভাবে সম্পন্ন হলে প্রকল্পের টাইপ, টেস্ট স্যুট এবং বিল্ড প্রক্রিয়ার সম্মিলিত যাচাই হয়।
এজেন্ট পরিচালনার আগে নথিপত্র বুঝে নিন
ক্রমসংখ্যাযুক্ত নথিগুলো ইচ্ছাকৃতভাবে ধারাবাহিকভাবে সাজানো। এগুলো ক্রমানুসারে পড়ুন, কারণ প্রতিটি নথি তার আগের নথিতে পরিচয় করানো বিষয়বস্তুর ওপর নির্ভর করে:
- 000 দর্শন: মনোযোগ-হ্রাসকারী পরিচালন নীতি এবং অপারেটরের দায়িত্ব বুঝুন।
- 001 ডোমেইন মডেল: প্রকল্পের মূল ধারণাগুলো এবং তাদের পারস্পরিক সম্পর্ক শিখুন।
- 002 অনুমোদন: এজেন্টকে কাজ সম্পাদনের অনুরোধ করার অনুমতি কার আছে তা নির্ধারণ করুন।
- 003 সম্পাদন: গৃহীত কাজগুলো কীভাবে সম্পাদিত হয় তা বুঝুন।
- 004 প্রম্পট: এজেন্টের আচরণ নির্দেশকারী প্রম্পটগুলো পর্যালোচনা করুন।
- 005 প্যানেল: মানুষের মনোযোগ প্রয়োজন এমন বিষয়গুলো ওয়েব প্যানেলে কীভাবে উপস্থাপিত হয় তা শিখুন।
- 006 ডিপ্লয়মেন্ট: ম্যানুয়াল সেটআপ, কনফিগারেশন, আপগ্রেড এবং সমস্যা সমাধানের নির্দেশনা অনুসরণ করুন।
- 007 আর্কিটেকচার: সিস্টেমের প্রযুক্তিগত কাঠামো অধ্যয়ন করুন।
- 008 কুকবুক: একটি Source কীভাবে যোগ করতে হয় তা শিখুন।
মৌলিক ব্যবহার
অনুমোদিত অনুরোধ জমা দিন
সেটআপের পর, কোনো অনুমোদিত ব্যবহারকারী GitHub-এর মাধ্যমে, অথবা ঐচ্ছিক ইন্টিগ্রেশন সক্রিয় থাকলে Feishu-এর মাধ্যমে, এজেন্টকে রিপোজিটরিতে কাজ করার অনুরোধ করতে পারেন। একটি সাধারণ অনুরোধে কাঙ্ক্ষিত রিপোজিটরি পরিবর্তন এবং প্রাসঙ্গিক গ্রহণযোগ্যতার মানদণ্ড উল্লেখ করা উচিত।
উদাহরণস্বরূপ, কোনো অনুমোদিত ব্যবহারকারী এজেন্টকে রিপোজিটরির একটি সমস্যা তদন্ত করতে, উপযুক্ত কোড পরিবর্তন করতে এবং ফলাফল জানাতে বলতে পারেন। সঠিক অনুরোধ পদ্ধতি এবং অনুমোদিত ব্যবহারকারীরা আপনার কনফিগার করা Source ও অনুমোদন-নিয়মের ওপর নির্ভর করে।
এজেন্টকে কাজের আইটেম তৈরি ও সম্পাদন করতে দিন
অনুরোধ গৃহীত হলে, dsh-superagent একটি কাজের আইটেম খোলে এবং নিজস্ব এজেন্ট সেশন ও ডিরেক্টরিতে কাজটি সম্পাদন করে। এই সম্পাদন মডেল কাজটির কার্যপ্রেক্ষাপট আলাদা রাখে।
প্রাসঙ্গিক স্থানে ফলাফল পান
এজেন্ট আলাদা কোনো চ্যানেলে ফলাফল খুঁজতে বাধ্য না করে মূল কথোপকথনেই উত্তর দেয়। সম্পাদিত কাজের ধরন অনুযায়ী, উত্তরে একটি pull request থাকতে পারে।
মানবীয় অনুসরণের জন্য প্যানেল ব্যবহার করুন
যে কাজগুলোর জন্য কোনো ব্যক্তির পদক্ষেপ প্রয়োজন, সেগুলোর জন্য ওয়েব প্যানেল দেখুন। প্রতিটি অভ্যন্তরীণ ধাপ নিয়ে অপ্রয়োজনীয় যোগাযোগ তৈরি না করে মানুষের পদক্ষেপ প্রয়োজন এমন বিষয়গুলো সামনে এনে প্যানেলটি প্রকল্পের মনোযোগ-ব্যবস্থাপনা লক্ষ্যকে সমর্থন করে।
অনুমোদন ও নিরাপদ পরিচালনা
অনুমোদন এই নকশার কেন্দ্রে রয়েছে। একটি দলের রিপোজিটরিতে কাজ করতে সক্ষম সক্রিয় এজেন্টের যেকোনো অনুরোধ গ্রহণ করা উচিত নয়। কারা কাজ শুরু করতে পারবে এবং কোন শর্তে পারবে তা নির্ধারণ করতে অনুমোদন সংক্রান্ত ডকুমেন্টেশন ব্যবহার করুন।
- অনুরোধকারীদের সীমাবদ্ধ রাখুন: কেবল নির্ধারিত ব্যক্তি বা সিস্টেমকে কার্যকর অনুরোধ তৈরি করতে দিন।
- দলের নিয়ম পর্যালোচনা করুন: নিশ্চিত করুন যে স্বয়ংক্রিয় পদক্ষেপগুলো কেবল দলের স্পষ্টভাবে লিখিত নিয়মের অধীনেই ঘটে।
- মানবীয় পর্যালোচনা বজায় রাখুন: এজেন্ট-তৈরি পরিবর্তনকে এমন কাজ হিসেবে বিবেচনা করুন, যার পরিদর্শন ও অভিযোজন প্রয়োজন হতে পারে।
- বিস্তৃত ব্যবহারের আগে পরীক্ষা করুন: উন্নয়ন পরিবর্তনের পর
pnpm checkচালান এবং আপনার পরিবেশে আচরণ যাচাই করুন।
উন্নত পরামর্শ
ম্যানুয়াল কার্যক্রমের জন্য ডিপ্লয়মেন্ট গাইড ব্যবহার করুন
ম্যানুয়ালি সেটআপ করতে, কনফিগারেশন পরিবর্তন করতে, প্রকল্প আপগ্রেড করতে বা সমস্যা সমাধান করতে হলে 006 ডিপ্লয়মেন্ট দেখুন। README এই ডকুমেন্টটিকে এসব পরিচালন পদ্ধতির বিস্তারিত উৎস হিসেবে চিহ্নিত করেছে।
আচরণ সূক্ষ্মভাবে সামঞ্জস্য করার সময় প্রম্পট পর্যালোচনা করুন
এজেন্ট কাজের ব্যাখ্যা বা সম্পাদন কীভাবে করে তা পরিবর্তনের আগে 004 প্রম্পট পড়ুন। প্রম্পট পরিবর্তনের ফলে এজেন্ট কখন যোগাযোগ করবে, কীভাবে কাজের কাছে যাবে এবং প্রকল্পের মনোযোগ-হ্রাসকারী দর্শন কতটা ঘনিষ্ঠভাবে অনুসরণ করবে তা প্রভাবিত হতে পারে।
কাজের বিচ্ছিন্নতা পরিবর্তনের আগে সম্পাদন অধ্যয়ন করুন
সিস্টেম প্রতিটি কাজের আইটেমকে নিজস্ব এজেন্ট সেশন ও ডিরেক্টরি দেয়। এই আচরণ পরিবর্তনের আগে 003 সম্পাদন এবং 007 আর্কিটেকচার পর্যালোচনা করুন, যাতে পরিবর্তনগুলো প্রকল্পের সম্পাদন ও সিস্টেম মডেলের সঙ্গে সামঞ্জস্যপূর্ণ থাকে।
সতর্কতার সঙ্গে নতুন Source যোগ করুন
Source হলো এমন একটি ইন্টিগ্রেশন, যার মাধ্যমে সিস্টেম কাজ গ্রহণ করতে পারে। প্রদত্ত GitHub এবং ঐচ্ছিক Feishu পথের বাইরে আরেকটি যোগ করতে চাইলে 008 কুকবুক অনুসরণ করুন। নতুন অনুরোধ চ্যানেল চালু করার সময় অনুমোদন মডেল এড়িয়ে যাবেন না।
উপযোগী নীরবতাকে অগ্রাধিকার দিন
সিস্টেম সামঞ্জস্য করার সময় কোনো পদক্ষেপের মূল্য এবং তার বিজ্ঞপ্তির কারণে সৃষ্ট মনোযোগের খরচ দুটোই মূল্যায়ন করুন। কোনো ব্যক্তির পদক্ষেপ প্রয়োজন হলে বা ব্যবহারযোগ্য ফলাফল প্রস্তুত হলে যোগাযোগকে অগ্রাধিকার দিন। এতে এক্সটেনশন ও পরিচালন নিয়মগুলো প্রকল্পের কেন্দ্রীয় দর্শনের সঙ্গে সামঞ্জস্যপূর্ণ থাকে।
ডেভেলপমেন্ট ওয়ার্কফ্লো
কোড পরিবর্তনের পর প্রকল্পের সম্মিলিত যাচাইকরণ কমান্ড ব্যবহার করুন:
pnpm checkএটি টাইপচেকিং, পরীক্ষা এবং বিল্ড চালায়, তাই পরিবর্তন শেয়ার বা ডিপ্লয় করার আগে এটি নিয়মিত যাচাইকরণ ধাপ হওয়া উচিত। এই কমান্ড সফল হলেও গবেষণা-প্রোটোটাইপটি উৎপাদন-উপযোগী হয়ে যায় না; আপনাকে এখনও এর আচরণ, নিরাপত্তা-অনুমান, অনুমোদন এবং আপনার পরিবেশের উপযোগিতা পর্যালোচনা করতে হবে।
উপসংহার
dsh-superagent মানুষের মনোযোগের চাহিদা কমিয়ে একটি GitHub রিপোজিটরিতে কাজ অর্পণের জন্য গবেষণামুখী একটি মডেল প্রদান করে। নির্দেশিত SETUP.md ওয়ার্কফ্লো দিয়ে শুরু করুন, ক্রমানুসারে নম্বরযুক্ত ডকুমেন্টেশন পড়ুন, সতর্কতার সঙ্গে অনুমোদন কনফিগার করুন, pnpm check দিয়ে পরিবর্তন যাচাই করুন এবং যেখানে সত্যিই প্রয়োজন সেখানে মানুষের প্রচেষ্টা কেন্দ্রীভূত করতে প্যানেল ব্যবহার করুন।