AI এজেন্ট স্কিল কীভাবে ব্যবহার করবেন (Antigravity CLI এবং Agent Skills for Firebase-এর সাহায্যে)

১. ভূমিকা

এই ল্যাবে, আপনি শিখবেন কীভাবে এজেন্ট স্কিল তৈরি করে এআই এজেন্টদের নিজস্ব জ্ঞান এবং ওয়ার্কফ্লো ব্যবহারের সুযোগ দেওয়া যায়। আপনি এটিকে একটি লোকাল স্কিল হিসেবে তৈরি করবেন, যা অ্যান্টিগ্র্যাভিটি সিএলআই (Antigravity CLI) থেকে অ্যাক্সেস করা যাবে।

আপনি যা করবেন

• আপনার প্রিয় জিনিসগুলোর জন্য নিজস্ব এজেন্ট স্কিল তৈরি করুন।
• আপনার দক্ষতা সম্পর্কে জানতে Antigravity CLI ব্যবহার করুন।
• Firebase-এর জন্য অফিসিয়াল এজেন্ট স্কিলস ইনস্টল করুন এবং সেগুলো ব্যবহার করে একটি অ্যাপ তৈরি ও স্থাপন করুন।

আপনি যা শিখবেন

• কীভাবে একটি দক্ষতার কাঠামো তৈরি করা যায়।
• কীভাবে একটি SKILL.md ফাইল লিখতে হয়।
• Antigravity CLI-এর সাথে স্থানীয় দক্ষতা কীভাবে ব্যবহার করবেন

২. প্রকল্প স্থাপন

1. যদি আপনার আগে থেকে কোনো গুগল অ্যাকাউন্ট না থাকে, তাহলে আপনাকে অবশ্যই একটি গুগল অ্যাকাউন্ট তৈরি করতে হবে।
   • কর্মক্ষেত্র বা শিক্ষা প্রতিষ্ঠানের অ্যাকাউন্টের পরিবর্তে ব্যক্তিগত অ্যাকাউন্ট ব্যবহার করুন। কর্মক্ষেত্র এবং শিক্ষা প্রতিষ্ঠানে এমন কিছু সীমাবদ্ধতা থাকতে পারে, যার ফলে আপনি এই ল্যাবের জন্য প্রয়োজনীয় এপিআই (API) সক্রিয় করতে পারবেন না।
2. গুগল ক্লাউড কনসোলে সাইন-ইন করুন।
3. ক্লাউড কনসোলে বিলিং চালু করুন ।
   • এই ল্যাবটি সম্পন্ন করতে ক্লাউড রিসোর্সে ১ মার্কিন ডলারেরও কম খরচ হওয়া উচিত।
   • পরবর্তী চার্জ এড়াতে, এই ল্যাবের শেষে দেওয়া ধাপগুলো অনুসরণ করে আপনি রিসোর্সগুলো মুছে ফেলতে পারেন।
   • নতুন ব্যবহারকারীরা ৩০০ মার্কিন ডলারের ফ্রি ট্রায়ালের জন্য যোগ্য।
4. একটি নতুন প্রজেক্ট তৈরি করুন অথবা বিদ্যমান কোনো প্রজেক্ট পুনরায় ব্যবহার করুন।
   • প্রজেক্ট কোটা সংক্রান্ত কোনো ত্রুটি দেখলে, একটি নতুন প্রজেক্ট তৈরি করার জন্য বিদ্যমান কোনো প্রজেক্ট পুনরায় ব্যবহার করুন অথবা আগের প্রজেক্টটি মুছে ফেলুন।

৩. ক্লাউড শেল এডিটর খুলুন

1. সরাসরি ক্লাউড শেল এডিটর- এ যেতে এই লিঙ্কে ক্লিক করুন।
2. আজ যেকোনো সময়ে অনুমোদনের জন্য অনুরোধ করা হলে, চালিয়ে যাওয়ার জন্য 'অনুমোদন করুন' (Authorize) বোতামে ক্লিক করুন।
3. যদি স্ক্রিনের নিচে টার্মিনালটি দেখা না যায়, তাহলে এটি খুলুন:
   • ভিউ ক্লিক করুন
   • টার্মিনালে ক্লিক করুন
4. টার্মিনালে এই কমান্ডটি দিয়ে আপনার প্রজেক্ট সেট করুন:
   • বিন্যাস:

     gcloud config set project [PROJECT_ID]
     

   • উদাহরণ:

     gcloud config set project lab-project-id-example
     

   • যদি আপনি আপনার প্রজেক্ট আইডি মনে করতে না পারেন:
     • আপনি আপনার সমস্ত প্রজেক্ট আইডি তালিকাভুক্ত করতে পারেন:

       gcloud projects list | awk '/PROJECT_ID/{print $2}'
       

     
5. আপনি এই বার্তাটি দেখতে পাবেন:

   Updated property [core/project].
   

   যদি আপনি একটি WARNING দেখতে পান এবং আপনাকে Do you want to continue (Y/n)? জিজ্ঞাসা করা হয়, তাহলে সম্ভবত আপনি প্রজেক্ট আইডি ভুলভাবে প্রবেশ করিয়েছেন। n চাপুন, Enter চাপুন এবং gcloud config set project কমান্ডটি আবার চালানোর চেষ্টা করুন।

৪. আপনার নিজস্ব দক্ষতা তৈরি করুন

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

1. এই ল্যাবের জন্য একটি ডিরেক্টরি তৈরি করুন এবং সেটিতে প্রবেশ করুন:

   mkdir ~/agent-skills-lab && cd ~/agent-skills-lab
   

2. আপনার প্রকল্পের দক্ষতার জন্য একটি ডিরেক্টরি তৈরি করুন:

   mkdir -p ~/agent-skills-lab/.agents/skills/my-favorite-things
   

3. আপনার স্কিলের জন্য একটি নতুন SKILL.md ফাইল তৈরি করে খুলুন:

   cloudshell edit ~/agent-skills-lab/.agents/skills/my-favorite-things/SKILL.md
   

   cloudshell edit কমান্ডটি টার্মিনালের উপরের এডিটরে SKILL.md ফাইলটি খুলবে।
4. SKILL.md ফাইলে নিম্নলিখিত বিষয়বস্তু যোগ করুন:

   ---
   name: my-favorite-things
   description: Provides personal information about my favorite color, food, and programming language. Use this skill when the user asks questions about my personal preferences or favorite things.
   ---
   
   # Knowledge
   
   - **Favorite Color:** Blue
   - **Favorite Food:** Pizza
   - **Favorite Programming Language:** Python
   
   If asked about one of my favorite things, please respond with the information provided above.
   

শুধুমাত্র একটি SKILL.md ফাইল দিয়েই আপনি আপনার প্রথম স্কিলটি তৈরি করে ফেলেছেন! এখন Antigravity CLI-তে এই স্কিলটি ব্যবহার করার সময় হয়েছে।

৫. অ্যান্টিগ্র্যাভিটি সিএলআই থেকে আপনার দক্ষতা ব্যবহার করুন।

এখন যেহেতু আপনি সফলভাবে একটি স্কিল তৈরি করেছেন, এটি .agents/skills ডিরেক্টরিতে অবস্থিত হওয়ায় Antigravity CLI দ্বারা ইতিমধ্যেই খুঁজে পাওয়া যাবে।

1. অ্যান্টিগ্র্যাভিটি সিএলআই শুরু করুন:

   agy
   

দ্রষ্টব্য: ক্লাউড শেলে অ্যান্টিগ্র্যাভিটি সিএলআই আগে থেকেই ইনস্টল করা থাকে।

1. Antigravity CLI দিয়ে প্রমাণীকরণ করুন: প্রথমবার চালু করার সময় প্রমাণীকরণ প্রয়োজন। OAuth নির্বাচন করুন ( Enter চেপে)।
2. লিঙ্কটিতে ক্লিক করুন (যদি ক্লিকযোগ্য না হয়, তাহলে ক্লাউড শেলে URL-টি হাইলাইট করে কপি করুন, তারপর আপনার ব্রাউজারে পেস্ট করুন)।
3. আপনার গুগল অ্যাকাউন্টে সাইন ইন করুন
4. কোডটি কপি করুন
5. কোডটি ক্লাউড শেল এডিটর টার্মিনালে পেস্ট করুন।
6. Enter চাপুন।
7. কিছু ডিফল্ট সেটিংস গ্রহণ করতে Enter চাপুন।
8. অ্যান্টিগ্র্যাভিটি সিএলআই-কে তার প্রেক্ষাপটের মধ্যে উপলব্ধ দক্ষতাগুলির তালিকা দেখাতে বলুন।

   /skills
   

   উপলব্ধ দক্ষতার তালিকায় আপনি my-favorite-things দেখতে পাবেন।
9. স্কিলস ভিউ থেকে বের হতে ESC চাপুন।
10. আপনার প্রিয় রঙ সম্পর্কে অ্যান্টিগ্র্যাভিটি সিএলআই-কে জিজ্ঞাসা করুন:

    What is my favorite color?
    

    আপনার প্রশ্নের উত্তর দেওয়ার জন্য Antigravity CLI-এর my-favorite-things স্কিলটি ব্যবহার করা উচিত। অনুরোধ করা হলে, Antigravity CLI-কে স্কিলটি ব্যবহার করার অনুমতি দিন।

আউটপুটে দেখানো উচিত যে অ্যান্টিগ্র্যাভিটি সিএলআই আপনার দক্ষতা ব্যবহার করেছে এবং "নীল" বা "আমার প্রিয় রঙ নীল"-এর মতো কিছু একটা উত্তর দিয়েছে।

আপনি পেরেছেন! আপনি সফলভাবে একটি স্কিল তৈরি করেছেন এবং Antigravity CLI ব্যবহার করে সেটি পরীক্ষা করেছেন।

আপনার সেশন শেষ করার জন্য প্রস্তুত হলে, /exit টাইপ করুন এবং তারপরে Antigravity CLI থেকে বের হতে Enter চাপুন।

৬. (ঐচ্ছিক) ফায়ারবেস হোস্টিং-এ একটি অ্যাপ্লিকেশন তৈরি ও স্থাপন করুন।

নিজের দক্ষতা তৈরি করার পাশাপাশি, আপনি অন্যদের তৈরি করা দক্ষতাও ইনস্টল করতে পারেন। এটি বহনযোগ্য দক্ষতার ব্যবহার প্রদর্শন করে — যা হলো জ্ঞান, নির্দেশাবলী এবং কর্মপ্রবাহের স্বয়ংসম্পূর্ণ মডিউল, যা সহজেই ভাগ করে নেওয়া এবং পুনরায় ব্যবহার করা যায়।

Agent Skills for Firebase হলো এই ধরনের বহনযোগ্য মডিউলগুলোর একটি চমৎকার উদাহরণ। এগুলো এআই অ্যাসিস্ট্যান্টদেরকে Firebase-এর সেরা অনুশীলনগুলো বুঝতে এবং আরও বেশি নির্ভুলতা ও কম টোকেন খরচে জটিল কাজ সম্পাদন করতে সাহায্য করার জন্য ডিজাইন করা হয়েছে।

এখন Agent Skills for Firebase ব্যবহার করে ব্যবহারকারী প্রমাণীকরণ ও ডেটাবেস সহ একটি "To Do" ওয়েব অ্যাপ্লিকেশন তৈরি করুন এবং এটিকে Firebase হোস্টিং-এ ডেপ্লয় করুন।

আপনার প্রজেক্ট সেট আপ করুন

1. আপনি যদি এখনও Antigravity CLI-তে থাকেন, তাহলে বের হওয়ার জন্য /exit টাইপ করুন।
2. আপনার প্রোজেক্টের জন্য একটি নতুন ডিরেক্টরি তৈরি করুন এবং সেটির ভেতরে যান:

   mkdir ~/todo-app && cd ~/todo-app
   

3. আপনার Google অ্যাকাউন্ট ব্যবহার করে Firebase-এ লগ ইন করুন। যেহেতু আপনি Cloud Shell-এ আছেন, তাই --no-localhost ফ্ল্যাগটি ব্যবহার করুন:

   firebase login --no-localhost
   

   1. CLI প্রম্পটগুলির সাথে ইন্টারঅ্যাক্ট করুন :
      • যখন জিজ্ঞাসা করা হবে Enable Gemini in Firebase features? , তখন Y (হ্যাঁ-এর জন্য) টাইপ করুন এবং Enter চাপুন।
      • যখন জিজ্ঞাসা করা হবে Allow Firebase to collect CLI and Emulator Suite usage and error reporting information? , তখন Y (হ্যাঁ-এর জন্য) টাইপ করুন এবং Enter চাপুন।
   2. ব্রাউজারে অনুমোদন করুন :
      • আপনি টার্মিনালে একটি ইউআরএল দেখতে পাবেন। লগইন পেজটি একটি নতুন ব্রাউজার ট্যাবে খোলার জন্য লিঙ্কটিতে ক্লিক করুন (যদি ক্লিকযোগ্য না হয়, তবে ক্লাউড শেলে ইউআরএলটি হাইলাইট করে কপি করুন, তারপর আপনার ব্রাউজারে পেস্ট করুন)।
      • ধাপ ১ (কমান্ড নিশ্চিত করুন) : 'হ্যাঁ, আমি এইমাত্র এই কমান্ডটি চালিয়েছি ' ক্লিক করুন।
      • ধাপ ২/৩ (সেশন আইডি নিশ্চিত করুন) : নিশ্চিত করুন যে সেশন আইডিটি আপনার টার্মিনালে প্রদর্শিত আইডির সাথে মিলছে, তারপর ‘হ্যাঁ, এটিই আমার সেশন আইডি’-তে ক্লিক করুন।
      • ধাপ ৩ (কোড কপি করুন) : অনুমোদন কোডটি আপনার ক্লিপবোর্ডে কপি করতে কপি-তে ক্লিক করুন।
   3. লগইন সম্পূর্ণ করুন :
      • ক্লাউড শেল টার্মিনালে ফিরে যান এবং ? Enter authorization code: প্রম্পটে অনুমোদন কোডটি পেস্ট করুন ।
      • Enter চাপুন।
   আপনি একটি সফলতার বার্তা দেখতে পাবেন: ✔ Success! Logged in as .

পরামর্শ: ক্লাউড শেলে অথরাইজেশন কোড পেস্ট করার সময়, ক্লিপবোর্ড পারমিশন চাওয়ার জন্য আসা ক্রোম ডায়ালগটির দিকে খেয়াল রাখুন এবং নিশ্চিত করুন যে সেটি চালু আছে। টার্মিনালে কোডটি পেস্ট করার জন্য আপনি Ctrl+Shift+V (উইন্ডোজ) বা CMD+Shift+V (ম্যাক) ব্যবহার করতে পারেন।

ফায়ারবেসের জন্য এজেন্ট স্কিলস ইনস্টল করুন

এখন যেহেতু আপনি আপনার প্রজেক্ট ডিরেক্টরি তৈরি করে ফেলেছেন, এর ভেতরে Agent Skills for Firebase ইনস্টল করুন।

আপনি আপনার টার্মিনালে skills CLI ব্যবহার করে Agent Skills for Firebase ইনস্টল করতে পারেন:

npx skills add firebase/agent-skills

ইনস্টলেশনের সময়, আপনাকে কোন স্কিলগুলো ইনস্টল করবেন তা বেছে নিতে বলা হবে। তালিকাটি নেভিগেট করতে আপনার অ্যারো কী এবং স্কিলগুলো নির্বাচন করতে স্পেসবার ব্যবহার করুন।

• firebase-auth-basics
• firebase-basics
• firebase-firestore
• firebase-hosting-basics
• firebase-security-rules-auditor

পরবর্তী প্রম্পটগুলোর জন্য, আপনি Enter চেপে নিরাপদে ডিফল্টগুলো গ্রহণ করতে পারেন।

এই কমান্ডটি firebase-basics এবং firebase-hosting-basics সহ বিভিন্ন স্কিল ডাউনলোড ও ইনস্টল করবে, যার ফলে এগুলো আপনার my-favorite-things স্কিলের পাশাপাশি Antigravity CLI-তে ব্যবহারের জন্য উপলব্ধ হবে।

Firebase-এর জন্য এজেন্ট স্কিল সম্পর্কে আরও জানতে, উপলব্ধ স্কিলগুলো দেখুন।

একটি বেসিক ওয়েব অ্যাপ তৈরি এবং স্থাপন করুন

1. আপনার প্রোজেক্টের জন্য প্রয়োজনীয় API-গুলো সক্রিয় করুন:

   gcloud services enable \
     cloudresourcemanager.googleapis.com \
     firebase.googleapis.com
   

2. আপনার বর্তমান গুগল ক্লাউড প্রকল্পে ফায়ারবেস সক্রিয় করুন:

   firebase projects:addfirebase ${GOOGLE_CLOUD_PROJECT}
   

3. অ্যান্টিগ্র্যাভিটি সিএলআই শুরু করুন:

   agy
   

4. একটি সাধারণ index.html তৈরি করতে Antigravity CLI-কে বলুন:

   Generate an index.html file with the content "Hello Firebase Hosting" and
   deploy the application to Firebase Hosting using the current Google Cloud
   Project.
   

   Antigravity CLI অ্যাপ্লিকেশনটি তৈরি এবং স্থাপন করার সময় অনুমতি চাইবে। অনুমতি দেওয়ার জন্য Enter চাপুন। আপনার 'approve' টাইপ করে Enter চাপার প্রয়োজন হতে পারে। আপনার ওয়েবসাইট তৈরি এবং স্থাপন করার জন্য Antigravity CLI-এর Firebase-এর জন্য Agent Skills ব্যবহার করা উচিত। প্রয়োজন অনুযায়ী অনুমোদনের মাধ্যমে এজেন্টকে নির্দেশনা দিন।

ডেপ্লয়মেন্ট সম্পন্ন হলে, এটি আপনার ওয়েব অ্যাপের জন্য একটি URL প্রদান করবে। ক্লাউড শেল এডিটর টার্মিনালে লিঙ্কগুলো খোলার জন্য ctrl+click (Windows/Linux) বা cmd+click (Mac) ব্যবহার করুন। আপনার ডেপ্লয় করা অ্যাপের URL-টি ভিজিট করুন!

ফায়ারবেস অথেন্টিকেশন যোগ করুন

1. যদি আগে থেকে চালু না থাকে তবে Antigravity CLI চালু করুন:

   agy
   

   Antigravity CLI "আপনি কি এই ফোল্ডারটিকে বিশ্বাস করেন?"-এর মতো প্রশ্ন জিজ্ঞাসা করতে পারে। ডিফল্টগুলো গ্রহণ করতে Enter চাপুন।
2. এখন, Antigravity CLI-কে গুগল সাইন-ইন যোগ করতে বলুন:

   Generate HTML, CSS, and Javascript for a single page application.
   It should use Google Sign-in with Firebase Authentication.
   A user should be able to sign in with their Google Account.
   Deploy when you are done and give the URL to me.
   

   Antigravity CLI index.html , style.css , এবং script.js মতো ফাইল তৈরি বা আপডেট করার জন্য অনুরোধ করতে পারে। এটিকে তা করার অনুমতি দিন। Antigravity CLI আপনাকে Firebase কনসোলে কিছু কাজ করার জন্য অনুরোধ করতে পারে। আপনি চেষ্টা করতে বললে CLI এগুলোর বেশিরভাগই করতে সক্ষম, কিন্তু আপনার Cloud Shell ইনস্ট্যান্সে যদি Firebase CLI-এর পুরোনো সংস্করণ ইনস্টল করা থাকে, তবে ধাপগুলো ম্যানুয়ালি সম্পন্ন করার (যেমন Google OAuth সক্রিয় করা) প্রয়োজন হতে পারে।

ডেপ্লয়মেন্ট সম্পন্ন হলে, এটি আপনার ওয়েব অ্যাপের জন্য একটি URL প্রদান করবে। ক্লাউড শেল এডিটর টার্মিনালে লিঙ্কগুলো খোলার জন্য ctrl+click (Windows/Linux) বা cmd+click (Mac) ব্যবহার করুন। আপনার ডেপ্লয় করা অ্যাপের URL-টি ভিজিট করুন!

আপনার সর্বশেষ পরিবর্তনগুলো দেখতে, আপনাকে ctrl+shift+R (Windows/Linux) অথবা cmd+shift+R (Mac) চেপে একটি "হার্ড রিফ্রেশ" করতে হতে পারে।

ক্লাউড ফায়ারস্টোর যোগ করুন

1. যদি আগে থেকে চালু না থাকে তবে Antigravity CLI চালু করুন:

   agy
   

   Antigravity CLI "আপনি কি এই ফোল্ডারটিকে বিশ্বাস করেন?"-এর মতো প্রশ্ন জিজ্ঞাসা করতে পারে। ডিফল্টগুলো গ্রহণ করতে Enter চাপুন।
2. টাস্কগুলি সংরক্ষণ করতে ফায়ারস্টোর যোগ করার জন্য অ্যান্টিগ্র্যাভিটি সিএলআই-কে বলুন:

   Update the application to save tasks in Cloud Firestore for the signed-in user.
   A user should be able to add new tasks and see a list of their tasks.
   Deploy when you are done and give the URL to to me.
   

   Antigravity CLI ফাইলগুলো আপডেট করবে। এটিকে তা করার অনুমতি দিন।

ডেপ্লয়মেন্ট সম্পন্ন হলে, এটি আপনার ওয়েব অ্যাপের জন্য একটি URL প্রদান করবে। ক্লাউড শেল এডিটর টার্মিনালে লিঙ্কগুলো খোলার জন্য ctrl+click (Windows/Linux) বা cmd+click (Mac) ব্যবহার করুন। আপনার ডেপ্লয় করা অ্যাপের URL-টি ভিজিট করুন!

আপনার সর্বশেষ পরিবর্তনগুলো দেখতে, আপনাকে ctrl+shift+R (Windows/Linux) অথবা cmd+shift+R (Mac) চেপে একটি "হার্ড রিফ্রেশ" করতে হতে পারে।

যদি আপনার অ্যাপ্লিকেশনটি প্রত্যাশিতভাবে কাজ না করে, তবে আপনার কাঙ্ক্ষিত কার্যকারিতা পেতে Antigravity CLI ব্যবহার করে কাজ চালিয়ে যান। উদাহরণ: shell Hide the task form when the user is logged out. Update the security rules so the user can see their TODOs.

আপনার নতুন ফায়ারবেস অ্যাপ্লিকেশনে আপনি যে বৈশিষ্ট্যগুলি দেখতে চান তা যোগ করতে ল্যাবে পরীক্ষা-নিরীক্ষা চালিয়ে যান।

৭. উপসংহার

অভিনন্দন! আপনি সফলভাবে একটি স্কিল তৈরি করেছেন এবং Antigravity CLI-এর জন্য অতিরিক্ত স্কিল ইনস্টল করার পদ্ধতি শিখেছেন।

(ঐচ্ছিক) পরিষ্কার করা

আপনি যদি সবকিছু পরিষ্কার করতে চান, তাহলে অতিরিক্ত চার্জ এড়ানোর জন্য আপনার ক্লাউড প্রজেক্টটি ডিলিট করে দিতে পারেন।

আপনি চাইলে প্রজেক্টটি মুছে ফেলতে পারেন:

gcloud projects delete $GOOGLE_CLOUD_PROJECT

জায়গা খালি করার জন্য আপনি আপনার ক্লাউড শেল ডিস্ক থেকে অপ্রয়োজনীয় রিসোর্সগুলোও মুছে ফেলতে পারেন।

1. ল্যাব ডিরেক্টরিটি মুছে ফেলুন (এতে স্কিল এবং অ্যাপ উভয়ই মুছে যাবে):

   rm -rf ~/agent-skills-lab
   

2. 'To Do' অ্যাপ্লিকেশন ডিরেক্টরিটি মুছে ফেলুন (যদি আপনি এটি বাইরে তৈরি করে থাকেন):

   rm -rf ~/todo-app
   

যদি কখনো আপনার ক্লাউড শেলকে তার ডিফল্ট অবস্থায় রিসেট করার প্রয়োজন হয়, তবে নিরাপদে তা করার নির্দেশাবলীর জন্য আপনি অফিসিয়াল ডকুমেন্টেশন অনুসরণ করতে পারেন।