AGENTS.md ফাইল ব্যবহার করে Gemini কাস্টমাইজ করুন

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

শুরু করার জন্য, এই ধাপগুলো অনুসরণ করুন:

1. আপনার প্রোজেক্টের ফাইল সিস্টেমের যেকোনো স্থানে একটি AGENTS.md ফাইল তৈরি করুন। আপনি যখন কোনো কোয়েরি জমা দেন, তখন Gemini বর্তমান ডিরেক্টরি এবং এর সমস্ত প্যারেন্ট ডিরেক্টরিতে AGENTS.md ফাইল খুঁজে বের করার জন্য স্ক্যান করে। আরও বিস্তারিত জানতে, AGENTS.md ফাইল কীভাবে কাজ করে’ দেখুন।

2. আপনার নির্দেশাবলী যোগ করুন। মার্কডাউন ব্যবহার করে আপনার নির্দেশাবলী লিখুন। পাঠযোগ্যতার জন্য, বিভিন্ন নিয়মের জন্য শিরোনাম এবং বুলেট পয়েন্ট ব্যবহার করার কথা বিবেচনা করুন। নির্দেশাবলীর নমুনা দেখুন ।

3. আপনার দলের সাথে শেয়ার করার জন্য ফাইলটি আপনার VCS-এ সেভ ও কমিট করুন।

প্রসঙ্গ হিসেবে AGENTS.md ফাইলগুলি পরিচালনা করুন

আপনি চ্যাট প্যানেলের কনটেক্সট ড্রয়ার ব্যবহার করে কোনো নির্দিষ্ট কোয়েরির জন্য কনটেক্সট হিসেবে AGENTS.md ফাইলগুলো প্রয়োগ বা অপসারণ করতে পারেন। AGENTS.md ফাইলস অপশনটিতে বর্তমান ডিরেক্টরি এবং এর প্যারেন্ট ডিরেক্টরিগুলোতে থাকা সমস্ত AGENTS.md ফাইল অন্তর্ভুক্ত থাকে।

উদাহরণ নির্দেশাবলী

আপনি এজেন্টকে নির্দেশনা দেওয়ার জন্য AGENTS.md ফাইলটি ব্যবহার করতে পারেন। নিচে কিছু উদাহরণ দেওয়া হলো, কিন্তু আপনার দেওয়া নির্দেশনাগুলো আপনার প্রোজেক্টের জন্য নির্দিষ্ট হওয়া উচিত।

• প্রধান অ্যাক্টিভিটিটি হলো /path/to/MainActivity.kt ।
• স্ক্রিনগুলির মধ্যে নেভিগেট করার জন্য প্রয়োজনীয় কোডটি হলো path/to/navigation/UiNavigation.kt
• HTTP অনুরোধগুলি পরিচালনা করার কোডটি <path> এ রয়েছে।
• প্রকল্প স্থাপত্য
  • সমস্ত ব্যবসায়িক যুক্তি ViewModel-এ রাখুন।
  • সর্বদা লেয়ার্ড আর্কিটেকচারের ব্যবহার সহ অফিসিয়াল আর্কিটেকচার সুপারিশগুলো অনুসরণ করুন। ইউনিডিরেকশনাল ডেটা ফ্লো (UDF), ভিউমডেল, লাইফসাইকেল-অ্যাওয়্যার UI স্টেট কালেকশন এবং অন্যান্য সুপারিশগুলো ব্যবহার করুন।
• পছন্দের লাইব্রেরি: "নেভিগেশনের জন্য <লাইব্রেরির নাম> লাইব্রেরিটি ব্যবহার করুন।"
• সাধারণ এপিআই পরিষেবা বা অভ্যন্তরীণ পরিভাষার জন্য প্লেসহোল্ডার নাম নির্ধারণ: "প্রাথমিক ব্যাকএন্ড পরিষেবাটিকে 'PhotoSift-API' হিসাবে উল্লেখ করা হয়।"
• কোম্পানির স্টাইল গাইডলাইন: "সমস্ত নতুন UI কম্পোনেন্ট অবশ্যই Jetpack Compose দিয়ে তৈরি করতে হবে। XML-ভিত্তিক লেআউটের পরামর্শ দেবেন না।"

আপনার AGENTS.md ফাইলগুলোকে মডিউলারাইজ করুন

আপনি বড় AGENTS.md ফাইলগুলোকে ছোট ছোট ফাইলে বিভক্ত করতে পারেন যা বিভিন্ন প্রেক্ষাপটে পুনরায় ব্যবহার করা যাবে:

1. নির্দেশাবলীর একটি সেট আলাদা করে style-guidance.md এর মতো অন্য একটি মার্কডাউন ফাইলে সংরক্ষণ করুন।

2. একটি AGENTS.md ফাইলে ছোট মার্কডাউন ফাইলগুলোকে রেফারেন্স করতে, @ চিহ্নের পরে আপনি যে ফাইলটি ইম্পোর্ট করতে চান তার পাথটি ব্যবহার করুন। নিম্নলিখিত পাথ ফরম্যাটগুলো সমর্থিত:

   • আপেক্ষিক পথ:
     • @./file.md - একই ডিরেক্টরি থেকে ইম্পোর্ট করুন
     • @../file.md - মূল ডিরেক্টরি থেকে ইম্পোর্ট করুন
     • @./subdirectory/file.md - একটি সাবডিরেক্টরি থেকে ইম্পোর্ট করুন
   • পরম পথ: @/absolute/path/to/file.md

উদাহরণস্বরূপ, নিম্নলিখিত AGENTS.md ফাইলটি অন্য দুটি নির্দেশনা ফাইলকে নির্দেশ করে:

# My AGENTS.md

You are an experienced Android app developer.

@./get-started.md

## Coding style

@./shared/style-guidance.md

AGENTS.md ফাইলগুলো কীভাবে কাজ করে

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

AGENTS.md ফাইল এবং Rules-এর মধ্যে পার্থক্য কী?

রুলস আপনাকে এমন নির্দেশাবলী এবং পছন্দ নির্ধারণ করার সুযোগ দেয় যা সমস্ত প্রম্পটের ক্ষেত্রে প্রযোজ্য। তবে, রুলস IntelliJ-এর /.idea/project.prompts.xml ফাইলে সংজ্ঞায়িত করা হয়, যেখানে AGENTS.md ফাইলগুলি আপনার সোর্স কোডের পাশে সেভ করা থাকে এবং এগুলি IDE-নিরপেক্ষ। যদি আপনার দলের সাথে নির্দেশাবলী শেয়ার করা অন্যতম প্রধান উদ্দেশ্য হয়, তবে আমরা AGENTS.md ফাইল ব্যবহার করার পরামর্শ দিই।

AGENTS.md ফাইল এবং দক্ষতার মধ্যে পার্থক্য কী?

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