এআই স্টুডিও প্লেগ্রাউন্ডে এজেন্ট

গুগল এআই স্টুডিও প্লেগ্রাউন্ড এপিআই কল তৈরি ও লেখার ঝামেলা ছাড়াই ম্যানেজড এজেন্ট প্রোটোটাইপ করতে এবং তা তৈরির পদ্ধতি শেখার জন্য একটি ভিজ্যুয়াল ইন্টারফেস প্রদান করে।

শুরু করার জন্য, Google AI Studio-এর নেভিগেশন প্যানেলে থাকা প্লেগ্রাউন্ড ট্যাবে যান এবং টগলটি এজেন্টস -এ পরিবর্তন করুন।

পূর্ব-নির্মিত টেমপ্লেট

এজেন্টস ট্যাবে বেশ কিছু টেমপ্লেট রয়েছে, যা টুল এবং এনভায়রনমেন্ট কনফিগারেশন সেট করার মাধ্যমে বেস অ্যান্টিগ্র্যাভিটি এজেন্টকে আগে থেকেই কনফিগার করে রাখে। সমস্ত টেমপ্লেটই ওপেন-সোর্স এবং google-gemini/gemini-managed-agents-templates রিপোজিটরির অধীনে প্রকাশিত। এই টেমপ্লেটগুলো খতিয়ে দেখা আপনার নিজের ম্যানেজড এজেন্ট তৈরি ও তার কাঠামো গঠন করার পদ্ধতি শেখার একটি চমৎকার উপায়।

উদাহরণস্বরূপ, যখন আপনি এআই রেডিও টেমপ্লেটটি বেছে নেন, তখন এটি সমস্ত অনুমোদিত টুল সক্রিয় করে এবং রেডিও শো তৈরির জন্য একটি বিশেষায়িত AGENTS.md ফাইল ও স্কিল লিঙ্ক করে। আপনি প্লেগ্রাউন্ড UI-এর এনভায়রনমেন্ট সেকশনে সোর্সেস বাটনে ক্লিক করে এই সেটিংসগুলো দেখতে পারেন।

টুল কনফিগারেশন

প্লেগ্রাউন্ডের এজেন্ট সেটিংসে, আপনি নিম্নলিখিত বিল্ট-ইন টুলগুলিতে অ্যাক্সেস চালু বা বন্ধ করতে পারেন:

• গুগল সার্চ: তাৎক্ষণিক তথ্য উপলব্ধির জন্য উন্মুক্ত ওয়েব ব্যবহার করুন।
• ইউআরএল কনটেক্সট: নির্দিষ্ট ওয়েব পেজ ইউআরএল-এর টেক্সট কন্টেন্ট ফেচ এবং পার্স করা।
• কোড এক্সিকিউশন: বিচ্ছিন্ন স্যান্ডবক্স পরিবেশে সরাসরি ব্যাশ এবং পাইথন কমান্ড চালান।
• ফাইলসিস্টেম টুলস: ওয়ার্কস্পেসের ভেতরের ফাইলগুলো পড়ুন, লিখুন, তালিকাভুক্ত করুন এবং মুছে ফেলুন।

পরিবেশ কনফিগারেশন

ম্যানেজড এজেন্টগুলো একটি সুরক্ষিত, ক্ষণস্থায়ী লিনাক্স স্যান্ডবক্সের (এনভায়রনমেন্ট) মধ্যে চলে, যা তাদের কাজ করার জন্য প্রয়োজনীয় ওয়ার্কস্পেস ও টুলস সরবরাহ করে। আরও জানতে, ম্যানেজড এজেন্ট এনভায়রনমেন্ট গাইডটি দেখুন।

নিয়ন্ত্রণকারী এজেন্টের আচরণ

এজেন্টের আচরণ, ব্যক্তিত্ব এবং সক্ষমতা মূলত তার পরিবেশে উপস্থিত ফাইলগুলো দ্বারা নির্ধারিত হয়। এজেন্ট স্বয়ংক্রিয়ভাবে একটি বিশেষ .agents ফোল্ডার থেকে কনফিগারেশন শনাক্ত ও লোড করে:

• AGENTS.md : সিস্টেমের নির্দেশাবলী এবং ব্যক্তিত্ব নির্ধারণের জন্য এজেন্টের কনটেক্সটে আগে থেকেই লোড করা থাকে।
• SKILL.md : নির্দিষ্ট সক্ষমতা এবং কর্মপ্রবাহ নির্ধারণ করার জন্য এটি নিজ নিজ স্কিল ফোল্ডারের অধীনে অবস্থিত (যেমন, .agents/skills/my-skill/SKILL.md )।

পরিবেশের জোগান

একটি সেশন শুরু করার আগে এনভায়রনমেন্টে ফাইল মাউন্ট করে আপনি এজেন্টের ব্যবহারের জন্য এনভায়রনমেন্টটি কনফিগার করতে পারেন। আপনি সোর্স মাউন্ট করে একটি নতুন এনভায়রনমেন্ট তৈরি করতে পারেন, অথবা আগেরটি পুনরুদ্ধার করতে পারেন:

• নতুন এনভায়রনমেন্ট তৈরি করতে , এনভায়রনমেন্ট সেটিংস প্যানেলে 'অ্যাড সোর্সেস'- এ ক্লিক করুন এবং নিম্নলিখিত সোর্স টাইপগুলো থেকে বেছে নিন:

• পূর্ববর্তী এনভায়রনমেন্ট পুনরুদ্ধার করতে , আপনি একটি বিদ্যমান এনভায়রনমেন্ট আইডি পুনরায় ব্যবহার করে সেটির হুবহু অবস্থা ক্লোন ও ফোর্ক করতে পারেন।

বিদ্যমান পরিবেশ আইডি পুনরায় ব্যবহার করা

আপনি যদি ইতিমধ্যেই একটি স্যান্ডবক্স পরিবেশ তৈরি করতে সময় ব্যয় করে থাকেন, তবে আপনাকে প্রথম থেকে শুরু করতে হবে না। একটি বিদ্যমান পরিবেশ ব্যবহার করতে:

1. AI Studio-এর Environments প্যানেলে যান এবং Type-কে Existing- এ টগল করুন।
2. এনভায়রনমেন্ট আইডি লিখুন (যেমন, env_abc123 )

আরও তথ্যের জন্য, ‘পরিবেশ কনফিগার করুন’ দেখুন। এছাড়াও আপনি UI-এর ‘পরিবেশ’ ট্যাব থেকে বর্তমান সেশনের ‘পরিবেশ আইডি’ পেতে পারেন।

একবার আপনি এজেন্টের কাছে আপনার প্রথম বার্তা পাঠালে, সেই সেশনের জন্য পরিবেশ কনফিগারেশনটি স্থির হয়ে যায়। ইন্টারঅ্যাকশনটি সক্রিয়ভাবে চলমান থাকা অবস্থায় আপনি নতুন সোর্স মাউন্ট করতে বা নেটওয়ার্ক অ্যালাওলিস্ট পরিবর্তন করতে পারবেন না।

পরিবেশ ডাউনলোড করুন

একবার একটি এনভায়রনমেন্ট তৈরি হয়ে গেলে, আপনি AI Studio Playground-এর এনভায়রনমেন্ট সেটিংসে থাকা ডাউনলোড বোতামটি ব্যবহার করে যেকোনো সময় এনভায়রনমেন্ট স্ন্যাপশটটি ডাউনলোড করতে পারেন এবং এনভায়রনমেন্ট ফাইলগুলোকে একটি টারবল (tarball) হিসেবে সংগ্রহ করতে পারেন।

নিরাপত্তা ও ব্যয় ব্যবস্থাপনা

টোকেন ব্যবহার পরিচালনা

একটি সাধারণ চ্যাট অনুরোধের মতো নয়, যা কেবল একটি আউটপুট তৈরি করে, অ্যান্টিগ্র্যাভিটি এজেন্ট একটি স্বায়ত্তশাসিত কর্মপ্রবাহ সম্পাদন করে। এটি পরিকল্পনা করে, কোড চালায়, ফলাফল পর্যবেক্ষণ করে এবং পুনরাবৃত্তি করে। এর মানে হলো, একটিমাত্র অনুরোধের ফলে সীমাহীন টোকেন খরচ হতে পারে।

খরচ ব্যবস্থাপনার জন্য, আপনার নির্দেশনায় কাজ শেষ করার সুস্পষ্ট শর্তাবলী উল্লেখ করুন এবং এজেন্টের জন্য কাজের পরিধি সীমিত রাখুন । এর একটি ভালো উদাহরণ হতে পারে এই ধরনের নির্দেশনা : পুল রিকোয়েস্টটি পর্যালোচনা করুন এবং মার্কডাউন সামারি তৈরি হয়ে গেলেই থেমে যান। নিজে থেকে সমাধানটি লেখার চেষ্টা করবেন না ।

অতিরিক্ত খরচ

ডিফল্টরূপে, প্লেগ্রাউন্ডের সমস্ত এজেন্ট টেমপ্লেটের জেমিনি এপিআই পরিষেবাতে অ্যাক্সেস থাকে এবং অনুরোধ পূরণের জন্য তারা এনভায়রনমেন্ট থেকে এপিআই কল করতে পারে। এর জন্য অতিরিক্ত খরচ হতে পারে, যা টোকেন খরচে প্রতিফলিত হবে না।

একইভাবে, আপনি যদি অন্য কোনো বাহ্যিক পরিষেবা যোগ করেন, তাহলে এজেন্ট আপনার পক্ষ থেকে সেই পরিষেবাগুলিতে কল করার জন্য অতিরিক্ত খরচ বহন করতে পারে।

নেটওয়ার্ক অনুমতি তালিকা

ডিফল্টরূপে, AI Studio-তে নিরাপত্তা নিশ্চিত করার জন্য আপনার এজেন্টের স্যান্ডবক্স পরিবেশের ভেতর থেকে করা সমস্ত বহির্গামী নেটওয়ার্ক অনুরোধ কঠোরভাবে নিয়ন্ত্রিত ও সীমাবদ্ধ থাকে। আপনার এজেন্টকে বাহ্যিক API, ওয়েব পরিষেবা, বা প্যাকেজ ম্যানেজারগুলিতে পৌঁছানোর ক্ষমতা দেওয়ার জন্য, আপনাকে অবশ্যই সেগুলিকে স্পষ্টভাবে ঘোষণা করতে হবে:

1. AI Studio-এর Environments প্যানেলে যান।
2. নেটওয়ার্কের পাশে থাকা রুলস বাটনটি সিলেক্ট করুন।
3. নেটওয়ার্ক কনফিগারেশন প্যানেলে, 'Add to allowlist'-এ ক্লিক করুন এবং প্রাসঙ্গিক বিবরণ পূরণ করুন:
   • ডোমেইন সীমাবদ্ধতা: এজেন্টের ভার্চুয়াল মেশিন শুধুমাত্র তালিকায় যুক্ত নির্দিষ্ট ডোমেইন বা ওয়াইল্ডকার্ড প্যাটার্নগুলোই অ্যাক্সেস করতে পারবে। উদাহরণস্বরূপ, আপনি api.github.com এর মতো সুনির্দিষ্ট ডোমেইন অথবা *.googleapis.com মতো সাধারণ প্যাটার্ন ইনপুট করতে পারেন।
   • HTTP হেডার এবং টোকেন ইনজেকশন যোগ করুন: একটি নির্দিষ্ট ডোমেনের জন্য প্রয়োজনীয় ক্রেডেনশিয়াল (যেমন একটি API টোকেন) নিরাপদে ইনজেক্ট করতে ‘Add HTTP header’ অপশনটি ব্যবহার করুন। এই ক্রেডেনশিয়ালগুলি একটি ইগ্রেস প্রক্সির মধ্য দিয়ে নিরাপদে যায় এবং এজেন্ট স্যান্ডবক্সের ভিতরে কখনই সরাসরি কাঁচা টেক্সট হিসাবে প্রকাশিত হয় না।

আপনার অনুমতি তালিকায় ডোমেইন যোগ করার সময় সর্বদা সতর্কতা অবলম্বন করুন। এজেন্টকে প্রমাণীকৃত পরিষেবাগুলিতে অ্যাক্সেস দেওয়ার অর্থ হলো এটি আপনার পক্ষ থেকে কাজ করতে পারবে, যা সতর্কভাবে পর্যবেক্ষণ না করা হলে অনাকাঙ্ক্ষিত ঘটনার জন্ম দিতে পারে।

শংসাপত্রের সর্বোত্তম অনুশীলন

যদি আপনার ওয়ার্কফ্লোতে এজেন্টের বাহ্যিক পরিষেবাগুলির সাথে প্রমাণীকরণের প্রয়োজন হয়, তবে সেই ক্রেডেনশিয়ালগুলির প্রোভিশনিং এবং স্কোপিংয়ের দায়িত্ব আপনার। ঝুঁকি কমাতে এই নির্দেশিকাগুলি অনুসরণ করুন:

• সর্বনিম্ন-সুবিধা সম্পন্ন ক্রেডেনশিয়াল ব্যবহার করুন: শুধুমাত্র আপনার এজেন্টের প্রয়োজনীয় অনুমতিগুলো দিয়েই সার্ভিস অ্যাকাউন্ট বা এপিআই কী তৈরি করুন। ব্যাপক বা প্রশাসনিক অ্যাক্সেসযুক্ত ক্রেডেনশিয়াল প্রদান করা থেকে বিরত থাকুন।
• স্বল্পস্থায়ী টোকেন ব্যবহার করুন: যেখানে সম্ভব, দীর্ঘস্থায়ী এপিআই কী-এর পরিবর্তে সময়-সীমিত ক্রেডেনশিয়াল বা মেয়াদোত্তীর্ণ টোকেন ব্যবহার করুন।
• পূর্ণ অ্যাক্সেস ধরে নিন: এজেন্ট আপনার দেওয়া কাজটি সম্পন্ন করার জন্য তার অ্যাক্সেস আছে এমন যেকোনো ক্রেডেনশিয়াল ব্যবহার করতে পারে। শুধুমাত্র সেইসব ক্রেডেনশিয়াল প্রদান করুন, যেগুলোর সম্পূর্ণ অ্যাক্সেস আপনি দিতে ইচ্ছুক।
• নিয়মিতভাবে ক্রেডেনশিয়াল পরিবর্তন করুন: এজেন্টের সাথে শেয়ার করা ক্রেডেনশিয়ালগুলোকে যেকোনো প্রোগ্রাম্যাটিক ক্রেডেনশিয়ালের মতোই বিবেচনা করুন; একটি নিয়মিত সময়সূচী অনুযায়ী সেগুলো পরিবর্তন করুন।

বাহ্যিক টুল এবং এপিআই সংযোগ করা

এজেন্টের কার্যক্ষমতা বাড়ানোর জন্য আপনি বাহ্যিক টুল এবং এপিআই (যেমন মডেল কনটেক্সট প্রোটোকল / এমসিপি সার্ভার) সংযোগ করতে পারেন। এমন করার সময়:

• শুধুমাত্র বিশ্বস্ত উৎস থেকে টুল সংযুক্ত করুন। একটি ক্ষতিকারক বা ত্রুটিপূর্ণ টুল ডেটা ফাঁস করতে পারে বা অনাকাঙ্ক্ষিত কাজ করতে পারে।
• আপনার ব্যবহারের জন্য প্রয়োজনীয় ন্যূনতম অনুমতি দিয়ে টুলগুলো কনফিগার করুন। যদি কোনো টুল রিড-অনলি মোড সমর্থন করে, তবে একান্ত প্রয়োজন না হলে সেটিই ব্যবহার করুন।
• কোনো টুলকে প্রোডাকশন ডেটা সোর্সের সাথে সংযুক্ত করার আগে, এজেন্টটি প্রত্যাশিতভাবে ডেটা ব্যবহার করছে কিনা তা যাচাই করার জন্য সেটিকে স্যাম্পল বা সিন্থেটিক ডেটার বিপরীতে পরীক্ষা করে দেখুন।

মানবিক তত্ত্বাবধান

এজেন্টরা উচ্চ মাত্রার স্বায়ত্তশাসনের সাথে যুক্তি দিয়ে কাজ করতে, পরিকল্পনা করতে এবং বহু-ধাপের কর্মপ্রবাহ সম্পাদন করতে পারে। যদিও এটি একটি শক্তিশালী দিক, এর অর্থ হলো আপনার যথাযথ তদারকি প্রয়োগ করা উচিত; বিশেষ করে সেইসব কাজের ক্ষেত্রে যেগুলো ডেটা পরিবর্তন করে বা বাহ্যিক সিস্টেমের সাথে যোগাযোগ করে।

জেনারেটেড কোড, ডেটা ট্রান্সফরমেশন বা কনফিগারেশন পরিবর্তনের মতো গুরুত্বপূর্ণ আউটপুটগুলো ডেপ্লয় করার আগে সর্বদা যাচাই করে নিন।