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

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

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

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

   अहम जानकारी: अपने कोडबेस के अलग-अलग हिस्सों को ज़्यादा बारीकी से कंट्रोल करने के लिए, अलग-अलग डायरेक्ट्री में कई निर्देश फ़ाइलों का इस्तेमाल करें. उदाहरण के लिए, आपके पास प्रोजेक्ट रूट में एक ग्लोबल AGENT.md फ़ाइल और अलग-अलग मॉड्यूल के लिए सबडायरेक्ट्री में ज़्यादा खास AGENT.md फ़ाइलें हो सकती हैं.

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

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

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

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

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

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

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

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

अपनी AGENT.md फ़ाइलों को मॉड्यूल के हिसाब से व्यवस्थित करना

बड़ी AGENT.md फ़ाइलों को छोटी फ़ाइलों में बांटा जा सकता है. इन छोटी फ़ाइलों का इस्तेमाल अलग-अलग कॉन्टेक्स्ट में किया जा सकता है:

1. निर्देशों के सेट को अलग करें और उन्हें किसी दूसरी मार्कडाउन फ़ाइल में सेव करें. जैसे, style-guidance.md.

2. AGENT.md फ़ाइल में, छोटी मार्कडाउन फ़ाइलों का रेफ़रंस दें. इसके लिए, @ सिंबल का इस्तेमाल करें. इसके बाद, उस फ़ाइल का पाथ डालें जिसे इंपोर्ट करना है. पाथ के ये फ़ॉर्मैट इस्तेमाल किए जा सकते हैं:

   • रिलेटिव पाथ:
     • @./file.md - उसी डायरेक्ट्री से इंपोर्ट करें
     • @../file.md - पैरंट डायरेक्ट्री से इंपोर्ट करें
     • @./subdirectory/file.md - किसी सबडायरेक्ट्री से इंपोर्ट करना
   • ऐब्सलूट पाथ: @/absolute/path/to/file.md

उदाहरण के लिए, यहां दी गई AGENT.md फ़ाइल में, निर्देश देने वाली दो अन्य फ़ाइलों का रेफ़रंस दिया गया है:

# My AGENT.md

You are an experienced Android app developer.

@./get-started.md

## Coding style

@./shared/style-guidance.md

AGENT.md फ़ाइलें कैसे काम करती हैं

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

ध्यान दें: अगर आपके पास एक ही डायरेक्ट्री में GEMINI.md फ़ाइल और AGENT.md फ़ाइल है, तो GEMINI.md फ़ाइल को प्राथमिकता दी जाएगी.

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

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

ध्यान दें: आपकी क्वेरी को प्रोसेस करते समय, Gemini AGENT.md फ़ाइलों में मौजूद नियमों और निर्देशों को एक साथ इस्तेमाल करता है.