কীভাবে AgentKit ব্যবহার করবেন: এআই এজেন্ট তৈরির জন্য একটি ব্যবহারিক, এন্ড-টু-এন্ড গাইড
আপনি যদি “AgentKit” নিয়ে গুঞ্জন শুনে থাকেন এবং কীভাবে এটিকে কাজে লাগাবেন তা জানতে চান, তাহলে আপনি সঠিক জায়গায় আছেন। এখানে একটা বিষয় আছে: AgentKit কোনো একক প্রোডাক্ট নয়। এই নামটি একাধিক ইকোসিস্টেম ব্যবহার করে—যেমন Coinbase-এর AgentKit অন-চেইন/Web3 অ্যাকশনের জন্য, Inngest-এর AgentKit এজেন্ট নেটওয়ার্ক পরিচালনা করার জন্য, এবং OpenAI Agents SDK-এর সাথে Coinbase-এর কিট ব্যবহার করে বিভিন্ন টিউটোরিয়াল। এই গাইডটিতে প্রতিটি AgentKit কী, কেন আপনি একটির চেয়ে অন্যটিকে বেছে নেবেন, এবং কীভাবে ধাপে ধাপে এটি সেট আপ করবেন, সেই সাথে প্রো টিপস এবং বাস্তব-বিশ্বের প্যাটার্নগুলি যা আপনি পুনরায় ব্যবহার করতে পারেন, তা খোলাসা করে বলা হয়েছে।
আমরা একটি ব্যবহারিক এবং সমাধান-ভিত্তিক অ্যাপ্রোচ নেব: দ্রুত তুলনা, স্পষ্ট সেটআপ, রান করা যায় এমন উদাহরণ এবং এড়িয়ে যাওয়ার মতো বিষয়গুলো।
আপনি কোন “AgentKit” নিয়ে কথা বলছেন?
- Coinbase AgentKit (CDP/Onchain): AI এজেন্টদের ওয়ালেট পরিচালনা করতে, অন-চেইন লেনদেন পাঠাতে, টোকেন স্থাপন করতে এবং আরও অনেক কিছু করতে দেয়। এটি Web3-নেটিভ এজেন্ট (যেমন, টিপিং বট, টোকেন ডিপ্লয়ার, NFT ডিস্ট্রিবিউটর) তৈরির জন্য আদর্শ। দ্রুত শুরু করার গাইড এবং ওয়ার্কশপগুলি ব্যাপকভাবে উপলব্ধ।
- Inngest AgentKit: এজেন্ট, টুলস সংজ্ঞায়িত করতে এবং নেটওয়ার্কের মধ্যে সেগুলোকে চালাতে একটি ফ্রেমওয়ার্ক, যা স্কেলেবল, ইভেন্ট-চালিত এক্সিকিউশনের উপর দৃষ্টি নিবদ্ধ করে। একাধিক এজেন্ট, পুনরায় চেষ্টা করার লজিক এবং ব্যাকগ্রাউন্ড ওয়ার্কফ্লো পরিচালনার জন্য চমৎকার।
- Safe/Protocol Kits (প্রসঙ্গ): আপনার এজেন্টের যদি স্মার্ট অ্যাকাউন্ট নিয়ন্ত্রণের (মাল্টিসিগ, পলিসি, ব্যাচড কল) প্রয়োজন হয়, তাহলে সুরক্ষিত এক্সিকিউশনের জন্য Safe-এর Protocol Kit প্রায়শই অন-চেইন এজেন্টদের সাথে যুক্ত করা হয়।
যদি আপনার লক্ষ্য দ্রুত একটি অন-চেইন AI এজেন্ট তৈরি করা হয়, তাহলে Coinbase AgentKit দিয়ে শুরু করুন। যদি আপনার একটি শক্তিশালী, মাল্টি-এজেন্ট আর্কিটেকচার এবং শিডিউলিংয়ের প্রয়োজন হয়, তাহলে Inngest AgentKit একটি শক্তিশালী পছন্দ। অনেক দল উভয়কেই মিশিয়ে ব্যবহার করে: রিজনিংয়ের জন্য OpenAI Agents + অন-চেইন অ্যাকশনের জন্য Coinbase AgentKit + ব্যবস্থাপনার জন্য Inngest।
: দ্রুত সিদ্ধান্ত নেওয়ার গাইড
- আপনি যদি এমন একটি Web3 এজেন্ট চান যা তহবিল স্থানান্তর করতে, টোকেন স্থাপন করতে বা dApp-এর সাথে ইন্টারঅ্যাক্ট করতে পারে → Coinbase AgentKit ব্যবহার করুন।
- একাধিক এজেন্ট/টুলসকে পুনরায় চেষ্টা এবং স্টেটসহ পরিচালনা করার জন্য আপনার যদি একটি টেকসই, ইভেন্ট-চালিত সিস্টেমের প্রয়োজন হয় → Inngest AgentKit ব্যবহার করুন।
- আপনার এজেন্টের জন্য এন্টারপ্রাইজ-গ্রেড ওয়ালেট সুরক্ষা বা মাল্টিসিগ গভর্নেন্স প্রয়োজন হলে → আপনার এজেন্টের পাশাপাশি Safe-এর Protocol Kit ইন্টিগ্রেট করুন।
পার্ট ১: কীভাবে Coinbase AgentKit ব্যবহার করবেন (অন-চেইন এজেন্ট)
Coinbase AgentKit কেন
- তৈরি করার সময় থেকেই অন-চেইন টাস্কের জন্য তৈরি (ওয়ালেট অপস, ট্রান্সফার, টোকেন ম্যানেজমেন্ট)
- পরিষ্কার ডেভেলপার অভিজ্ঞতা এবং দ্রুত শুরু করার সরঞ্জাম
- সোশ্যাল মিডিয়ায় (যেমন, X) ব্যবহারকারীদের সাথে ইন্টারফেস করা এবং অন-চেইনে অ্যাকশন সেটেল করার জন্য বট/এজেন্টদের জন্য আদর্শ
সেটআপ ওভারভিউ
- CLI এবং SDK ইনস্টল করুন (কুইকস্টার্ট অনুযায়ী) এবং নেটওয়ার্ক, কী এবং RPC এন্ডপয়েন্টের জন্য এনভায়রনমেন্ট ভেরিয়েবল কনফিগার করুন।
- একটি প্রোজেক্ট শুরু করুন এবং আপনার প্রয়োজনীয় অন-চেইন ক্ষমতাগুলি বেছে নিন।
- আপনার এজেন্টের সাথে টুলস (যেমন, ওয়ালেট অপস, টোকেন ডিপ্লয়মেন্ট) বাঁধুন।
- কখন টুল কল করতে হবে তা সিদ্ধান্ত নিতে এজেন্টকে একটি রিজনিং মডেলের (OpenAI বা অনুরূপ) সাথে সংযুক্ত করুন।
কয়েক মিনিটের মধ্যে শুরু করতে অফিসিয়াল কুইকস্টার্ট অনুসরণ করুন। ওয়ালেট পরিচালনা করে এবং Twitter/X-এ ইন্টারঅ্যাক্ট করে এমন একটি Web3 AI এজেন্ট তৈরির বিষয়ে হাতে-কলমে টিউটোরিয়ালের জন্য, QuickNode ওয়াকথ্রু এবং AgentKit Twitter বট তৈরির একটি ভিডিও ডেমো দেখুন।
উদাহরণ আর্কিটেকচার
- রিজনিং লেয়ার: ফাংশন/টুল কলিং সহ LLM
- অ্যাকশন লেয়ার: Coinbase AgentKit টুলস (ট্রান্সফার, টোকেন ডিপ্লয়)
- পারসিস্টেন্স: একটি ডাটাবেসে এজেন্টের মেমরি/লক্ষ্যগুলি স্টোর করুন
- ফ্রন্ট এন্ড: ব্যবহারকারীর প্রম্পটের জন্য চ্যাট UI বা সোশ্যাল বট (X)
সেরা অনুশীলন
- কম প্রিভিলেজের নীতি: এজেন্টের কীগুলিকে প্রয়োজনীয় সুযোগ এবং ছোট ব্যালেন্সের মধ্যে সীমাবদ্ধ রাখুন
- পলিসি প্রম্পট: অন-চেইন অ্যাকশনগুলির অনুমতি কখন দেওয়া হবে সে সম্পর্কে সুস্পষ্ট নিয়ম সংজ্ঞায়িত করুন
- গার্ডরেল: লেনদেন প্রিভিউ/কনফার্মেশন, প্রতি সময় উইন্ডোতে সীমা প্রয়োগ করুন
- পর্যবেক্ষণযোগ্যতা: নিরীক্ষণের জন্য টুল কল, লেনদেন এবং মডেল আউটপুট লগ করুন
সাধারণ ভুলগুলি
- দুর্বল কী ম্যানেজমেন্ট: কখনওই সিক্রেট হার্ডকোড করবেন না; ভল্ট ব্যবহার করুন
- সীমাহীন অ্যাকশন: বড় মানের স্থানান্তরের জন্য নিশ্চিতকরণের প্রয়োজন
- রেট লিমিট নেই: RPC এন্ডপয়েন্ট এবং সোশ্যাল API রক্ষা করুন
পার্ট ২: কীভাবে Inngest AgentKit ব্যবহার করবেন (এজেন্ট নেটওয়ার্ক এবং অর্কেস্ট্রেশন)
Inngest AgentKit কেন
- এজেন্টরা হল প্রথম শ্রেণীর, স্ট্যাটলেস কর্মী যাদের লক্ষ্য এবং টুলসেট রয়েছে
- জটিল ওয়ার্কফ্লোয়ের জন্য একাধিক এজেন্টকে সমন্বিত করার জন্য নেটওয়ার্ক
- পুনরায় চেষ্টা এবং টেকসই এক্সিকিউশন সহ ইভেন্ট-চালিত ডিজাইন
আপনার প্রথম এজেন্ট তৈরি করতে এবং নেটওয়ার্কের মধ্যে চালাতে কুইকস্টার্ট দিয়ে শুরু করুন। বিজনেস লজিক লেখার আগে মূল ধারণাগুলি—এজেন্ট, টুলস, নেটওয়ার্ক—পড়ে নিন।
সেটআপ করার ধাপ
- আপনার এজেন্টের লক্ষ্য এবং উপলব্ধ সরঞ্জামগুলি সংজ্ঞায়িত করুন (API, অভ্যন্তরীণ পরিষেবা, অন-চেইন কিট)।
- একটি নেটওয়ার্ক তৈরি করুন এবং এজেন্টদের রেজিস্টার করুন।
- এজেন্টদের ট্রিগার করতে ইভেন্টগুলি নির্গত করুন; স্থিতিস্থাপকতার জন্য পুনরায় চেষ্টা এবং ব্যাকঅফ ব্যবহার করুন।
- পর্যবেক্ষণযোগ্যতা যোগ করুন: লগ, ট্রেস, ফলাফল।
অর্কেস্ট্রেশন প্যাটার্ন
- সুপারভাইজার-ওয়ার্কার: একজন প্ল্যানার এজেন্ট বিশেষজ্ঞ এজেন্টদের কাছে কাজ অর্পণ করে
- ইভেন্ট-সোর্সিং: স্টেটের পরিবর্তন এজেন্টদের প্রতিক্রিয়া জানাতে ট্রিগার করে (যেমন, payment_received → fulfillment_agent)
- মানুষ-ইন-দ্য-লুপ: ঝুঁকিপূর্ণ কাজের জন্য অনুমোদন, বিরতি/পুনরায় শুরু করার সুবিধা সহ
টিপস
- এজেন্টদের স্ট্যাটলেস রাখুন; ইভেন্ট/স্টেট স্টোরের মাধ্যমে প্রসঙ্গ পাস করুন
- সময়ের সাথে কর্মক্ষমতা ট্র্যাক করতে সরঞ্জাম এবং প্রম্পটগুলির সংস্করণ তৈরি করুন
- ব্যর্থতার মোডগুলি অনুকরণ করুন; বাহ্যিক কলের জন্য আইডিম্পোটেন্সি যাচাই করুন
পার্ট ৩: Safe-এর সাথে সুরক্ষিত এক্সিকিউশন (ঐচ্ছিক কিন্তু প্রস্তাবিত)
যদি আপনার এজেন্ট তহবিল পরিচালনা করে বা অ্যাডমিন অপারেশন সম্পাদন করে, তাহলে গভর্নেন্স সহ স্মার্ট অ্যাকাউন্টগুলি ইন্টিগ্রেট করুন। Safe-এর Protocol Kit স্মার্ট অ্যাকাউন্ট এবং মাল্টিসিগ ফ্লো-এর জন্য তৈরি, কনফিগারেশন এবং এক্সিকিউশন সরবরাহ করে।
- ব্যবহারের ক্ষেত্র: একটি অন-চেইন এজেন্ট লেনদেন জমা দেয়, যেখানে মালিকরা (মানুষ বা সুপারভাইজার এজেন্ট) সহ-স্বাক্ষর করে
- সুবিধা: পলিসি কন্ট্রোল, স্পেন্ডিং লিমিট এবং সুরক্ষিত রিকভারি
- প্যাটার্ন: এজেন্ট লেনদেনের প্রস্তাব করে; একটি পলিসি ইঞ্জিন (বা মানুষ) স্বাক্ষর করে এবং সম্পাদন করে
ধাপে ধাপে: একটি মিনিমাল অন-চেইন এজেন্ট তৈরি করা
নিচে একটি ধারণাগত ফ্লো দেওয়া হল যা আপনি মানিয়ে নিতে পারেন (ভাষা-অ্যাগনস্টিক, সিউডোকোড-স্টাইল)। কার্যকরী কোড এবং CLI কম্যান্ডের জন্য Coinbase কুইকস্টার্ট দেখুন।
- প্রোজেক্ট শুরু করুন এবং নির্ভরতা ইনস্টল করুন
- একটি প্রোজেক্ট ডিরেক্টরি তৈরি করুন এবং AgentKit SDK এবং আপনার LLM ক্লায়েন্ট ইনস্টল করুন
- এনভায়রনমেন্ট ভেরিয়েবল সেট করুন: RPC URL, প্রাইভেট কী বা ম্যানেজড ওয়ালেট, নেটওয়ার্ক
- টুলস এবং ক্ষমতা সংজ্ঞায়িত করুন
- ওয়ালেট:
get_balance, transfer(to, amount)
- টোকেন:
deploy_erc20(name, symbol, supply)
- প্রয়োজন অনুযায়ী কন্ট্রাক্ট কল পড়ুন/লিখুন
- একটি সিস্টেম প্রম্পট সরবরাহ করুন যা লক্ষ্য এবং সীমাবদ্ধতা সংজ্ঞায়িত করে
- নিরাপদ ফাংশন কলিংয়ের জন্য স্কিমার সাথে টুলস রেজিস্টার করুন
- নিরাপত্তা এবং পলিসি যোগ করুন
- থ্রেশহোল্ডের উপরে স্থানান্তরের জন্য নিশ্চিতকরণ প্রয়োগ করুন
- দৈনিক খরচ সীমিত করুন, প্রোডাকশনের জন্য প্রাপক ঠিকানাগুলি অ্যালও লিস্ট করুন
- একটি বেসিক ইন্টারফেস তৈরি করুন
- CLI:
agent ask "Send 0.01 ETH to 0x..."
- ওয়েব/চ্যাট: টাস্ক জমা দিতে এবং রসিদ প্রদর্শনের জন্য মিনিমাল UI
- প্রথমে একটি টেস্টনেটে পরীক্ষা করুন
- ফসেট তহবিল; অ্যাকশন লগ এবং লেনদেন হ্যাশ যাচাই করুন
- পর্যবেক্ষণযোগ্যতার সাথে প্রোডাকশনে যান
- টেলিম্যাট্রি ক্যাপচার করুন, ব্যর্থ লেনদেনের সতর্কতা এবং মডেল আচরণের বিচ্যুতি নিরীক্ষণ করুন
প্যাটার্ন যা প্রোডাকশনে কাজ করে
- প্ল্যান-দেন-অ্যাক্ট: টুল ব্যবহারের আগে ধাপগুলি বর্ণনা করতে মডেল ব্যবহার করুন
- ড্রাই-রান মোড: লেনদেন প্রিভিউ করুন এবং অনুমোদনের জন্য জিজ্ঞাসা করুন
- বাজেট এনভেলপ: প্রতিটি টাস্ককে একটি স্পেন্ড ক্যাপ এবং টুল টাইমআউট দিন
- সিনথেটিক মনিটরিং: নির্ধারিত টাস্ক এজেন্টের স্বাস্থ্য এবং RPC সংযোগ যাচাই করে
বাস্তব-বিশ্বের উদাহরণ পরিস্থিতি
- কমিউনিটি টিপিং বট: ব্যবহারকারীরা X-এ বটটির উল্লেখ করে; এজেন্ট যাচাইকৃত ওয়ালেটগুলিকে অন-চেইনে টিপ দেয়
- গ্রাহক পুরস্কার: এজেন্ট অন-চেইন অ্যাকশন ট্র্যাক করে এবং সাপ্তাহিক পুরস্কার টোকেন পাঠায়
- DAO অপারেশন: এজেন্ট প্রস্তাবনার জন্য Safe লেনদেন ড্রাফট করে; মাল্টিসিগ পর্যালোচনার পরে স্বাক্ষর করে
- মার্কেটপ্লেস সহকারী: এজেন্ট NFT তালিকাভুক্ত করে এবং ব্যবহারকারীর প্রশ্নের উত্তর দেয়, নিশ্চিতকরণের পরে ট্রেড সম্পাদন করে
একটি গাইডেড Web3 এজেন্ট তৈরির জন্য, Agents SDK + AgentKit ইন্টিগ্রেশনের মাধ্যমে QuickNode টিউটোরিয়াল এবং Coinbase-এর ওয়ার্কশপ দেখুন।
সমস্যা সমাধান: দ্রুত সমাধান
- আমার এজেন্ট লেনদেন পাঠাতে পারছে না: নেটওয়ার্ক, গ্যাস সেটিংস এবং কী অনুমতি পরীক্ষা করুন; প্রথমে একটি টেস্টনেট চেষ্টা করুন
- টুল কলগুলি অনিয়মিত: টুলের স্কিমা এবং ভ্যালিডেশন আরও কঠোর করুন; প্রি-চেক প্রম্পট যোগ করুন
- রানগুলি ফ্ল্যাকি: ব্যাকঅফ সহ পুনরায় চেষ্টা যোগ করুন; RPC রেট লিমিট এবং স্ট্যাটাস কোড নিরীক্ষণ করুন
- নিরাপত্তা উদ্বেগ: কীগুলি ঘোরান, তহবিল কোয়ারেন্টাইন করুন, Safe-ভিত্তিক অনুমোদনে যান
উপরে উল্লিখিত: Sider.AI এর মাধ্যমে আপনার ওয়ার্কফ্লোকে আরও দ্রুত করুন
উল্লেখ করার মতো—আপনি যদি প্রম্পট, গ্লু কোড এবং ডক্সের উপর পুনরাবৃত্তি করেন, তাহলে একটি সাইডকিক সাহায্য করতে পারে। Sider.AI এর মাধ্যমে, আপনি আপনার এডিটরের পাশাপাশি গবেষণা, কোড স্নিপেট এবং পরীক্ষার লগগুলি গুছিয়ে রাখতে পারেন, যা এজেন্টদের জন্য বিল্ড-মেজার-লার্ন লুপকে দ্রুত করে। এটি এখানে দেখুন: মূল বিষয়গুলি
- “AgentKit” সাধারণত Coinbase-এর অন-চেইন টুলকিট এবং Inngest-এর অর্কেস্ট্রেশন কিটকে বোঝায়—অন-চেইন অ্যাকশন বনাম মাল্টি-এজেন্ট সমন্বয়ের জন্য আপনার প্রয়োজন অনুযায়ী বেছে নিন।
- ছোট করে শুরু করুন: টেস্টনেট, মিনিমাল টুলস, কঠোর পলিসি; ধীরে ধীরে ক্ষমতা যোগ করুন।
- আর্থিক বা প্রশাসনিক কর্তৃত্বের জন্য, গভর্নেন্স এবং নিরাপত্তার জন্য Safe ইন্টিগ্রেট করুন।
- এজেন্টকে প্রোডাকশন সফ্টওয়্যারের মতো বিবেচনা করুন: লগিং, সতর্কতা, সীমা এবং মানুষের অনুমোদন।
আরও জানার জন্য
- Coinbase AgentKit কুইকস্টার্ট এবং CLI
- ওয়ার্কশপ: Coinbase AgentKit সহ OpenAI Agents SDK
- একটি Web3 AI এজেন্ট ওয়াকথ্রু তৈরি করুন (QuickNode)
- Inngest AgentKit কুইকস্টার্ট এবং ধারণা,
- নিরাপদ স্মার্ট অ্যাকাউন্টের জন্য Safe Protocol Kit
FAQ
প্রশ্ন ১: AgentKit কী, এবং আমার কোনটি ব্যবহার করা উচিত?
AgentKit সাধারণত অন-চেইন অ্যাকশনের জন্য Coinbase AgentKit এবং এজেন্টদের পরিচালনা করার জন্য Inngest AgentKit কে বোঝায়। Web3 টাস্কের (ওয়ালেট, টোকেন) জন্য Coinbase এবং মাল্টি-এজেন্ট, ইভেন্ট-চালিত ওয়ার্কফ্লোয়ের জন্য Inngest বেছে নিন।
প্রশ্ন ২: আমি কীভাবে নিরাপদে একটি AI এজেন্টকে অন-চেইনে তহবিল স্থানান্তর করতে দেব?
ছোট ব্যালেন্স, কঠোর টুলের স্কিমা এবং ঝুঁকিপূর্ণ কাজের জন্য নিশ্চিতকরণ প্রম্পট ব্যবহার করুন। প্রোডাকশনের জন্য, Safe স্মার্ট অ্যাকাউন্টগুলি ইন্টিগ্রেট করুন এবং মাল্টিসিগ বা পলিসি অনুমোদনের প্রয়োজন করুন।
প্রশ্ন ৩: আমি কি Coinbase AgentKit এর সাথে OpenAI AgentsCombine করতে পারি?
হ্যাঁ। আপনার রিজনিং লেয়ার (OpenAI Agents/ফাংশন কলিং) কে Coinbase AgentKit টুলের সাথে সংযুক্ত করুন। অনেক ডেভেলপার অর্কেস্ট্রেশন এবং পুনরায় চেষ্টার জন্য Inngest যোগ করে।
প্রশ্ন ৪: AgentKit ব্যবহার করার সময় সাধারণ ভুলগুলি কী কী?
হার্ডকোডিং কী, টেস্টনেট বাদ দেওয়া এবং সীমাহীন অ্যাকশনের অনুমতি দেওয়া হল বড় ভুল। নিরাপদ থাকতে রেট লিমিট, স্পেন্ড ক্যাপ এবং শক্তিশালী পর্যবেক্ষণযোগ্যতা যোগ করুন।
প্রশ্ন ৫: Web3 AI এজেন্ট তৈরি করার জন্য আমি কোথায় একটি কুইকস্টার্ট খুঁজে পেতে পারি?
সেটআপ এবং উদাহরণের জন্য Coinbase-এর AgentKit কুইকস্টার্ট, QuickNode থেকে টিউটোরিয়াল এবং এন্ড-টু-এন্ড গাইডের জন্য ওয়ার্কশপ ভিডিও দিয়ে শুরু করুন।