AGENTS.md फ़ाइलों का इस्तेमाल करके Gemini को अपनी पसंद के मुताबिक़ बनाना

Gemini in Android Studio को, एक या उससे ज़्यादा AGENTS.md फ़ाइलों का इस्तेमाल करके, अपनी पसंद के मुताबिक़ निर्देश दें. AGENTS.md फ़ाइलें, आपके कोडबेस में मौजूद अन्य फ़ाइलों के साथ रखी जाती हैं. इसलिए, इन्हें वर्शन कंट्रोल सिस्टम (वीसीएस) में आसानी से चेक किया जा सकता है. साथ ही, प्रोजेक्ट से जुड़े निर्देश, कोडिंग स्टाइल के नियम, और अन्य दिशा-निर्देश अपनी पूरी टीम के साथ शेयर किए जा सकते हैं.

शुरू करने के लिए यह तरीका अपनाएं:

1. अपने प्रोजेक्ट के फ़ाइल सिस्टम में कहीं भी AGENTS.md फ़ाइल बनाएं. क्वेरी सबमिट करने पर, Gemini AGENTS.md फ़ाइलों के लिए मौजूदा डायरेक्ट्री और सभी पैरंट डायरेक्ट्री को स्कैन करता है. ज़्यादा जानकारी के लिए, AGENTS.md फ़ाइलें कैसे काम करती हैं लेख पढ़ें.

2. अपने निर्देश जोड़ें. Markdown का इस्तेमाल करके निर्देश लिखें. पढ़ने में आसानी हो, इसके लिए अलग-अलग नियमों के लिए हेडिंग और बुलेट पॉइंट का इस्तेमाल करें. निर्देशों का उदाहरण देखें.

3. फ़ाइल को सेव करें और अपनी टीम के साथ शेयर करने के लिए, इसे वीसीएस में कमिट करें.

कॉन्टेक्स्ट के तौर पर AGENTS.md फ़ाइलों को मैनेज करना

चैट पैनल में मौजूद कॉन्टेक्स्ट ड्रॉअर का इस्तेमाल करके, किसी क्वेरी के लिए कॉन्टेक्स्ट के तौर पर AGENTS.md फ़ाइलें जोड़ी या हटाई जा सकती हैं. AGENTS.md फ़ाइलें विकल्प में, मौजूदा डायरेक्ट्री और उसकी पैरंट डायरेक्ट्री में मौजूद सभी AGENTS.md फ़ाइलें शामिल होती हैं.

निर्देशों का उदाहरण

एजेंट को निर्देश देने के लिए, AGENTS.md फ़ाइल का इस्तेमाल किया जा सकता है. यहां कुछ उदाहरण दिए गए हैं. हालांकि, आपको अपने प्रोजेक्ट के हिसाब से निर्देश देने चाहिए.

• "मुख्य गतिविधि /path/to/MainActivity.kt है."
• "स्क्रीन के बीच नेविगेट करने के लिए कोड path/to/navigation/UiNavigation.kt है"
• "एचटीटीपी अनुरोधों को हैंडल करने वाला कोड <path> पर है."
• प्रोजेक्ट का आर्किटेक्चर
  • "कारोबार से जुड़े सभी लॉजिक को ViewModels में रखें."
  • "आर्किटेक्चर से जुड़े आधिकारिक सुझावों का हमेशा पालन करें. इनमें लेयर्ड आर्किटेक्चर का इस्तेमाल करना भी शामिल है. एकतरफ़ा डेटा फ़्लो (यूडीएफ़), ViewModels, लाइफ़साइकल के बारे में जानने वाली यूज़र इंटरफ़ेस (यूआई) की स्थिति को इकट्ठा करने की सुविधा, और अन्य सुझावों का इस्तेमाल करें."
• पसंदीदा लाइब्रेरी: "नेविगेशन के लिए, <library name> लाइब्रेरी का इस्तेमाल करो."
• सामान्य एपीआई सेवाओं या अंदरूनी शब्दावली के लिए प्लेसहोल्डर के नाम तय करना: "प्राइमरी बैकएंड सेवा को 'PhotoSift-API' कहा जाता है."
• कंपनी की स्टाइल गाइड: "सभी नए यूज़र इंटरफ़ेस कॉम्पोनेंट, Jetpack Compose का इस्तेमाल करके बनाए जाने चाहिए. एक्सएमएल पर आधारित लेआउट का सुझाव न दो."

अपनी 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 फ़ाइलें कैसे काम करती हैं

Gemini, AGENTS.md फ़ाइलों के लिए मौजूदा डायरेक्ट्री और पैरंट डायरेक्ट्री को अपने-आप स्कैन करता है. साथ ही, उनके कॉन्टेंट को हर प्रॉम्प्ट की शुरुआत में, प्रस्तावना के तौर पर जोड़ता है. अगर क्वेरी सबमिट करते समय कोई फ़ाइल खुली नहीं है, तो प्रोजेक्ट रूट में मौजूद AGENTS.md फ़ाइल (अगर कोई है) डिफ़ॉल्ट रूप से शामिल हो जाती है.

AGENTS.md फ़ाइलों और नियमों में क्या अंतर है?

नियमों की मदद से, ऐसे निर्देश और प्राथमिकताएं भी तय की जा सकती हैं जो सभी प्रॉम्प्ट पर लागू होती हैं. हालांकि, नियम IntelliJ फ़ाइल /.idea/project.prompts.xml में तय किए जाते हैं. वहीं, AGENTS.md फ़ाइलें आपके सोर्स कोड के बगल में सेव की जाती हैं और ये आईडीई-न्यूट्रल होती हैं. अगर आपको अपनी टीम के साथ निर्देश शेयर करने हैं, तो हमारा सुझाव है कि आप AGENTS.md फ़ाइलों का इस्तेमाल करें.

AGENTS.md फ़ाइलों और स्किल के बीच क्या अंतर है?

स्किल, मांग के हिसाब से उपलब्ध कराई जाने वाली विशेषज्ञता होती है. इन्हें तब चालू किया जाता है, जब आपका अनुरोध किसी स्किल के ब्यौरे से मेल खाता हो. वहीं, AGENTS.md में मौजूद कॉन्टेंट को हर प्रॉम्प्ट की शुरुआत में जोड़ा जाता है. हमारा सुझाव है कि खास टास्क के लिए, स्किल का इस्तेमाल करें. साथ ही, एजेंट के सामान्य व्यवहार को बेहतर बनाने के लिए, AGENTS.md फ़ाइलों का इस्तेमाल करें. स्किल के बारे में ज़्यादा जानने के लिए, Android की स्किल के बारे में जानकारी लेख पढ़ें.