Workspaces में Firebase में Gemini को कॉन्फ़िगर करना

Firebase Studio, एआई की मदद से कोड लिखने की इन सुविधाओं के ज़रिए, डेवलपमेंट के आपके वर्कफ़्लो को आसान बनाता है:

  • टाइप करते समय, पूरे कोड के लिए सुझाव.

  • चैट या कमांड लाइन इंटरफ़ेस (सीएलआई) के ज़रिए एआई से मदद पाने की सुविधा. यह सुविधा, वर्कस्पेस के बारे में जानती है और आपके कोड के साथ पूरी तरह से इंटिग्रेट की गई है. यह कोड जनरेट कर सकता है, उसका अनुवाद कर सकता है, और उसके बारे में जानकारी दे सकता है. आपकी समीक्षा और मंज़ूरी के बाद, Firebase में मौजूद Gemini सीधे तौर पर आपके Workspace से इंटरैक्ट कर सकता है. इससे फ़ाइलों को अपडेट किया जा सकता है, टर्मिनल कमांड चलाई जा सकती हैं, कमांड के आउटपुट को समझा जा सकता है, और अगले चरणों का पता लगाया जा सकता है. ज़्यादा जानने के लिए, Firebase Studio में Gemini से चैट करने की सुविधा आज़माएं पर जाएं.

  • चुने गए कोड के हिस्सों पर की जा सकने वाली इनलाइन कार्रवाइयां. उदाहरण के लिए, चुने गए कोड को ज़्यादा आसानी से पढ़ने लायक बनाने के लिए, Gemini से कहा जा सकता है.

  • इनलाइन कोड से जुड़ी सहायता.

Gemini की सेटिंग में बदलाव करके और एआई के नियमों वाली फ़ाइलें जोड़कर, यह तय किया जा सकता है कि Firebase में Gemini आपकी मदद कैसे करे:

अपने Workspace में Firebase में Gemini का इस्तेमाल करना

Firebase में Gemini का इस्तेमाल करके, कोडिंग की प्रॉडक्टिविटी बढ़ाएँ. इसके लिए, चैट पैनल, टर्मिनल या इनलाइन कोड की मदद लें.

में किया जा रहा है, तो
  1. अपने वर्कस्पेस में चैट या इनलाइन कोड की मदद पाने की सुविधा का इस्तेमाल करें:

    • चैट का इस्तेमाल करने के लिए: खुले हुए वर्कस्पेस में, वर्कस्पेस में सबसे नीचे मौजूद spark Gemini पर क्लिक करें.

    • Gemini CLI का इस्तेमाल करने के लिए: टर्मिनल खोलें और Gemini CLI इंटरफ़ेस के लिए gemini डालें. इसके अलावा, नॉन-इंटरैक्टिव मोड में Gemini CLI का इस्तेमाल करने के लिए, gemini -p कमांड का इस्तेमाल करें.

    • इनलाइन कोड की मदद पाने के लिए: अपना कोड टाइप करना शुरू करें और सुझाव स्वीकार करने के लिए, Tab दबाएं.

  2. ध्यान दें कि ये दो विकल्प डिफ़ॉल्ट रूप से चालू होते हैं:

    • टाइप करते समय मिलने वाले सुझाव. इससे आपको इनलाइन कोड पूरा करने की सुविधा मिलती है.
    • कोडबेस इंडेक्सिंग, जो बेहतर तरीके से मनमुताबिक बनाने और ज़्यादा मददगार जवाब देने की सुविधा देती है.

    अपने Workspace की सेटिंग में जाकर, आने वाले समय में इन विकल्पों को बदलने के लिए:

    एआई इंडेक्सिंग से कुछ फ़ाइलों और डायरेक्ट्री को भी बाहर रखा जा सकता है. .aiexclude फ़ाइलों की मदद से, Gemini से फ़ाइलें हटाने का तरीका देखें.

Firebase के शॉर्टकट में Gemini

Gemini के साथ चैट को तुरंत खोलने के लिए: Ctrl+Shift+Space (या MacOS पर Cmd+Shift+Space) दबाएं.

कमांड पैलेट से Gemini कमांड देखने के लिए:

  1. कमांड पैलेट खोलने के लिए, Ctrl+Shift+P (या macOS पर Cmd+Shift+P) दबाएं.

  2. Gemini खोजें.

    आपको Gemini कमांड की सूची दिखेगी.

कोड पूरा करने की सुविधा से जुड़ी सेटिंग में बदलाव करना

कोड लिखने में आपकी मदद करने के लिए, Firebase Studio में एआई की मदद से कोड पूरा करने की सुविधा मिलती है. यह सुविधा, किसी भी खुली हुई फ़ाइल में कोड का अनुमान लगाती है और उसे अपने-आप भर देती है. ऐसा तब होता है, जब आप टाइप करना शुरू करते हैं.

ध्यान दें कि कोड पूरा करने की सुविधा डिफ़ॉल्ट रूप से चालू होती है.

कोड पूरा करने की सुविधा को चालू या बंद करने के लिए, इनमें से किसी एक तरीके का इस्तेमाल करके, कोड पूरा करने की सेटिंग बदलें:

  • अगर settings.json फ़ाइल का इस्तेमाल किया जाता है, तो "IDX.aI.enableInlineCompletion" को true या false पर सेट करें.

  • Firebase Studio वर्कस्पेस में सेटिंग अपडेट करने के लिए:

    1. गियर आइकॉन मैनेज करें (वर्कस्पेस में सबसे नीचे बाईं ओर मौजूद) पर क्लिक करें. इसके बाद, सेटिंग चुनें या Ctrl+, (Mac पर Cmd+,) दबाएं.

      अगर Prototyper view, click Code switch icon Switch to Code to open Code view. में App Prototyping agent का इस्तेमाल किया जा रहा है

    2. Workspace टैब चुनें. इसके बाद, Firebase Studio > एआई > इनलाइन सुझाव देने की सुविधा चालू करें सेटिंग खोजें.

    3. कोड अपने-आप पूरा होने की सुविधा बंद करने के लिए, टाइप करते समय, इनलाइन कोड अपने-आप पूरा होने की सुविधा चालू करें विकल्प से सही का निशान हटाएं.

कोडबेस इंडेक्सिंग की सेटिंग में बदलाव करना

आपके पास यह कंट्रोल करने का विकल्प होता है कि Gemini आपके कोड को इंडेक्स करे या नहीं. अपने कोड को इंडेक्स करने से, चैट या इनलाइन एआई की मदद का इस्तेमाल करते समय ज़्यादा काम के नतीजे मिलते हैं.

ध्यान दें कि कोडबेस इंडेक्सिंग की सुविधा डिफ़ॉल्ट रूप से चालू होती है.

कोड इंडेक्सिंग की सुविधा चालू या बंद करने के लिए, कोडबेस इंडेक्सिंग की सेटिंग में बदलाव करें. इसके लिए, इनमें से कोई एक तरीका इस्तेमाल करें:

  • अगर settings.json फ़ाइल का इस्तेमाल किया जाता है, तो "IDX.aI.enableCodebaseIndexing" को true या false पर सेट करें.

  • Firebase Studio वर्कस्पेस में सेटिंग अपडेट करने के लिए:

    1. गियर आइकॉन मैनेज करें (वर्कस्पेस में सबसे नीचे बाईं ओर मौजूद) पर क्लिक करें. इसके बाद, सेटिंग चुनें या Ctrl+, (Mac पर Cmd+,) दबाएं.

      अगर Prototyper view, click Code switch icon Switch to Code to open Code view. में App Prototyping agent का इस्तेमाल किया जा रहा है

    2. Workspace टैब चुनें. इसके बाद, Firebase Studio > एआई > इनलाइन पूरा होने की सुविधा चालू करें सेटिंग खोजें.

    3. Firebase Studio > एआई: कोडबेस इंडेक्सिंग चालू करें को चुनें.

    4. कोड इंडेक्सिंग की सुविधा बंद करने के लिए, एआई: कोडबेस इंडेक्सिंग चालू करें से चुने हुए का निशान हटाएं. आपको अपने हर वर्कस्पेस के लिए, कोड इंडेक्स करने की सेटिंग अपडेट करनी होंगी.

एआई के नियमों वाली फ़ाइल की मदद से, Gemini के लिए निर्देशों को पसंद के मुताबिक बनाना

एआई के नियमों वाली फ़ाइल बनाकर, कॉन्टेक्स्ट और सिस्टम प्रॉम्प्ट की जानकारी जोड़ी जा सकती है:

  • Gemini CLI सिर्फ़ GEMINI.md का इस्तेमाल करता है.
  • Gemini, Firebase चैट में .idx/airules.md को प्राथमिकता देता है. हालांकि, अगर .idx/airules.md मौजूद नहीं है, तो वह GEMINI.md का इस्तेमाल करेगा.

Gemini Firebase में, आपके नियमों का इस्तेमाल सिस्टम के निर्देशों और कॉन्टेक्स्ट के तौर पर किया जाता है. इससे, यह आपके इस्तेमाल के उदाहरण के हिसाब से जवाबों को पसंद के मुताबिक़ बना पाता है.

एआई के नियमों वाली फ़ाइल का इस्तेमाल करके, Gemini के साथ कस्टम प्रॉम्प्ट, सबसे सही तरीके, और अपने प्रोजेक्ट के बारे में अहम जानकारी शेयर करें. इससे आपको ये लक्ष्य हासिल करने में मदद मिलेगी:

  • Gemini के पर्सोना को बेहतर बनाना और उसकी विशेषज्ञता को बढ़ाना.
  • पूरे प्रोजेक्ट पर लागू होने वाले स्टैंडर्ड, जैसे कि कोडिंग स्टाइल, कन्वेंशनल, और टेक्नोलॉजी की प्राथमिकताएं लागू करना.
  • अपने प्रोजेक्ट के बारे में ज़रूरी कॉन्टेक्स्ट देकर, कोड या चैट में साफ़ तौर पर शेयर की जाने वाली जानकारी की मात्रा को कम करना.

एआई के नियमों वाली फ़ाइल बनाना और उसकी जांच करना

एआई के नियमों वाली फ़ाइल बनाने और उसकी जांच करने के लिए:

  1. अपने Firebase Studio Workspace में, ~/GEMINI.md (Gemini CLI के लिए) या .idx/airules.md (Firebase चैट में Gemini के लिए) पर जाकर नई फ़ाइल बनाएं. इनमें से किसी एक विकल्प का इस्तेमाल किया जा सकता है:

    • एक्सप्लोरर (Ctrl+Shift+E) में जाकर, पैरंट डायरेक्ट्री पर राइट क्लिक करें. इसके बाद, नई फ़ाइल चुनें. फ़ाइल को कोई नाम दें और Enter दबाएं.
    • टर्मिनल में, अपने पसंदीदा टेक्स्ट एडिटर का इस्तेमाल करके GEMINI.md या .idx/airules.md खोलें.
  2. फ़ाइल में कॉन्टेंट जोड़ें. आपको पर्सोना के बारे में जानकारी जोड़नी चाहिए. जैसे, Gemini को किस तरह की भूमिका निभानी चाहिए ("तुम एक विशेषज्ञ डेवलपर और मददगार असिस्टेंट हो, जिसे Next.js के बारे में सब कुछ पता है"), कोडिंग और बातचीत के स्टैंडर्ड, और प्रोजेक्ट के बारे में कॉन्टेक्स्ट. एआई के नियमों वाली फ़ाइल का उदाहरण देखने के लिए, यहां दिया गया उदाहरण देखें.

  3. फ़ाइल सेव करें और Gemini CLI या Gemini Firebase खोलें.

  4. एआई के नियमों का इस्तेमाल शुरू करने के लिए, इनमें से कोई एक काम करें:

    • पेज को रीफ़्रेश करके, वर्कस्पेस को फिर से बनाएं. फिर से बनाने के बाद, Gemini चैट में मौजूद नियमों की फ़ाइल का इस्तेमाल करेगा. एआई के नियमों वाली फ़ाइल में किए गए बदलाव तुरंत दिखने चाहिए.
    • अगर आपको अपना वर्कस्पेस फिर से नहीं बनाना है, तो Gemini से load GEMINI.md या load airules.md करने के लिए कहें. अगर मौजूदा सेशन के दौरान फ़ाइल में बदलाव किए जाते हैं, तो आपको नियमों वाली फ़ाइल को फिर से लोड करने के लिए, Gemini को फिर से प्रॉम्प्ट करना पड़ सकता है.
  5. अपने कोड के बारे में सवाल पूछें. Gemini, नियमों वाली फ़ाइल में शामिल की गई जानकारी का इस्तेमाल करके जवाब देता है.

उदाहरण

यहां नियमों वाली फ़ाइल का एक बुनियादी उदाहरण दिया गया है. इसका इस्तेमाल Next.js से बनाए गए किसी कैज़ुअल गेम के लिए किया जा सकता है:

# Persona

You are an expert developer proficient in both front- and back-end development
with a deep understanding of Node.js, Next.js, React, and Tailwind CSS. You
create clear, concise, documented, and readable TypeScript code.

You are very experienced with Google Cloud and Firebase services and how
you might integrate them effectively.

# Coding-specific guidelines

- Prefer TypeScript and its conventions.
- Ensure code is accessible (for example, alt tags in HTML).
- You are an excellent troubleshooter. When analyzing errors, consider them
  thoroughly and in context of the code they affect.
- Do not add boilerplate or placeholder code. If valid code requires more
  information from the user, ask for it before proceeding.
- After adding dependencies, run `npm i` to install them.
- Enforce browser compatibility. Do not use frameworks/code that are not
  supported by the following browsers: Chrome, Safari, Firefox.
- When creating user documentation (README files, user guides), adhere to the
  Google developer documentation style guide
  (https://developers.google.com/style).

# Overall guidelines

- Assume that the user is a junior developer.
- Always think through problems step-by-step.

# Project context

- This product is a web-based strategy game with a marine life theme.
- Intended audience: casual game players between the ages of 17 and 100.

.aiexclude फ़ाइलों वाले Gemini से फ़ाइलों को बाहर रखें

आपके पास यह कंट्रोल करने का विकल्प होता है कि आपके कोडबेस में मौजूद कौनसी फ़ाइलें Gemini से छिपी रहें. इसके लिए, अपने प्रोजेक्ट में .aiexclude फ़ाइलें शामिल करें. इससे, Gemini के साथ शेयर किए जाने वाले प्रोजेक्ट के कॉन्टेक्स्ट को ज़्यादा बारीकी से कंट्रोल किया जा सकता है.

.gitignore फ़ाइल की तरह ही, .aiexclude फ़ाइल उन फ़ाइलों को ट्रैक करती है जिन्हें Gemini के साथ शेयर नहीं किया जाना चाहिए. इनमें चैट करने की सुविधा के साथ-साथ, एडिटर में काम करने वाली एआई की सुविधाएं भी शामिल हैं. .aiexclude फ़ाइल, उस डायरेक्ट्री में मौजूद फ़ाइलों पर काम करती है जिसमें वह मौजूद है.

कोडबेस इंडेक्सिंग चालू होने पर, .aiexclude में शामिल फ़ाइलों को Gemini इंडेक्स नहीं करेगा. इसके अलावा, .aiexclude से इनलाइन सहायता की सुविधा पर इन तरीकों से असर पड़ेगा:

  • चैट में मदद पाने की सुविधा: Gemini, .aiexclude में शामिल फ़ाइलों के बारे में सवालों के जवाब नहीं दे पाएगा. साथ ही, उनसे जुड़े सुझाव भी नहीं दे पाएगा.
  • कोड पूरा करने की सुविधा: कवर की गई फ़ाइलों में बदलाव करते समय, कोड पूरा करने के सुझाव उपलब्ध नहीं होंगे.
  • इनलाइन सहायता: आपको नया कोड जनरेट करने की सुविधा मिलेगी. हालांकि, कवर की गई फ़ाइलों में बदलाव करते समय, मौजूदा कोड में बदलाव नहीं किया जा सकेगा.

Android Studio जैसे अन्य डेवलपमेंट एनवायरमेंट भी .aiexclude फ़ाइलों का इस्तेमाल कर सकते हैं.

.aiexclude फ़ाइलें लिखने का तरीका

.aiexclude फ़ाइल का सिंटैक्स, .gitignore फ़ाइल के सिंटैक्स जैसा ही होता है. हालांकि, इनमें ये अंतर होते हैं:

  • खाली .aiexclude फ़ाइल, अपनी डायरेक्ट्री और सभी सब-डायरेक्ट्री में मौजूद सभी फ़ाइलों को ब्लॉक करती है. यह उस फ़ाइल की तरह ही है जिसमें **/* शामिल है.
  • .aiexclude फ़ाइलों में, नेगेशन (पैटर्न के पहले ! लगाना) की सुविधा काम नहीं करती.

उदाहरण

यहां .aiexclude फ़ाइल कॉन्फ़िगरेशन के कुछ उदाहरण दिए गए हैं:

  • apikeys.txt फ़ाइल वाली डायरेक्ट्री में मौजूद या उससे नीचे की सभी फ़ाइलों को ब्लॉक करें:.aiexclude

    apikeys.txt
    
  • .key फ़ाइल एक्सटेंशन वाली सभी फ़ाइलों को उस डायरेक्ट्री में या उसके नीचे ब्लॉक करें जिसमें .aiexclude फ़ाइल मौजूद है:

    *.key
    
  • सिर्फ़ apikeys.txt फ़ाइल को ब्लॉक करें. यह फ़ाइल, .aiexclude फ़ाइल वाली डायरेक्ट्री में मौजूद होनी चाहिए. हालांकि, किसी भी सबडायरेक्ट्री को ब्लॉक न करें:

    /apikeys.txt
    
  • डायरेक्ट्री my/sensitive/dir और सभी सबडायरेक्ट्री में मौजूद सभी फ़ाइलों को ब्लॉक करें. पाथ, उस डायरेक्ट्री के हिसाब से होना चाहिए जिसमें .aiexclude फ़ाइल मौजूद है:

    my/sensitive/dir/
    

अपनी कुंजी का इस्तेमाल करना: चैट में अन्य Gemini मॉडल इस्तेमाल करना

Firebase में Gemini की चैट के लिए, Gemini मॉडल को कॉन्फ़िगर किया जा सकता है. आपके पास, डिवाइस में पहले से मौजूद मॉडल, चैट विंडो में कॉन्फ़िगर किए गए मॉडल (इनमें Gemini 2.5 मॉडल भी शामिल हैं) या कोई ऐसा Gemini मॉडल चुनने का विकल्प होता है जिसे ऐक्सेस करने की अनुमति आपके पास है.

सभी उपलब्ध मॉडल की सूची देखने के लिए, Gemini models पर जाएं.

अपनी कुंजी को कॉन्फ़िगर करने और कोई दूसरा Gemini मॉडल चुनने के लिए:

  1. खुले हुए फ़ाइल फ़ोल्डर में, फ़ाइल फ़ोल्डर के सबसे नीचे (या Gemini टैब में) मौजूद स्पार्क Gemini पर क्लिक करें.

  2. Gemini in Firebase चैट विंडो में, मॉडल के नाम वाले ड्रॉप-डाउन पर क्लिक करें. इसके बाद, Gemini API कुंजी लिंक पर क्लिक करें. उपयोगकर्ता सेटिंग दिखती हैं.

  3. IDX > AI: Gemini Api Key फ़ील्ड में, अपना Gemini API पासकोड डालें.

अब चैट में, पहले से कॉन्फ़िगर किए गए किसी भी Gemini मॉडल को चुना जा सकता है.

ड्रॉप-डाउन में मौजूद नहीं है, तो Gemini मॉडल को कॉन्फ़िगर करने के लिए:

  1. Gemini मॉडल में जाकर, सूची में से वह Gemini मॉडल ढूंढें जिसका इस्तेमाल आपको चैट में करना है. उदाहरण के लिए, gemini-2.0-flash-lite डालकर, Gemini 2.0 Flash‑Lite मॉडल के सबसे नए स्टेबल वर्शन का इस्तेमाल किया जा सकता है.

  2. Gemini की Firebase चैट विंडो में जाकर, मॉडल पिकर पर क्लिक करें. इसके बाद, कस्टम मॉडल आईडी चुनें. उपयोगकर्ता सेटिंग खुलती हैं.

  3. चुने गए मॉडल के नाम को IDX > AI: Gemini Model फ़ील्ड में कॉपी करें.

  4. चैट विंडो बंद करें. इसके बाद, मॉडल की सूची को रीफ़्रेश करने के लिए, वर्कस्पेस में सबसे नीचे मौजूद स्पार्क Gemini पर क्लिक करके, इसे फिर से खोलें.

Gemini CLI को पसंद के मुताबिक बनाएं

  • सेटिंग: थीम बदलने के लिए .gemini/settings.json फ़ाइल बनाएं. इसके अलावा, इस्तेमाल के आंकड़े इकट्ठा करने की सुविधा चालू या बंद करें. साथ ही, यह तय करें कि Gemini CLI के पास किन टूल का ऐक्सेस होगा. इसके अलावा, चेकपॉइंट की सुविधा कॉन्फ़िगर करें और भी बहुत कुछ करें.
  • सेटिंग: सेटिंग को अडजस्ट करने के तरीके के बारे में ज़्यादा जानने के लिए, Gemini CLI दस्तावेज़ देखें.
  • एनवायरमेंट वैरिएबल: Gemini CLI, .env फ़ाइल से एनवायरमेंट वैरिएबल अपने-आप लोड करता है. आपको यहां अपना GEMINI_API_KEY (ज़रूरी है) सेव करना चाहिए. इसके अलावा, आपके पास यह विकल्प भी होता है कि आपको कौनसा Gemini मॉडल इस्तेमाल करना है, अपना Google Cloud प्रोजेक्ट आईडी, और अन्य जानकारी शामिल करनी है.
  • निर्देश: निर्देशों का पालन करते समय, Gemini CLI जिस कॉन्टेक्स्ट का इस्तेमाल करता है उसे अडजस्ट करने के लिए, GEMINI.md फ़ाइल बनाएं. इसकी मदद से, Gemini को प्रोजेक्ट के हिसाब से निर्देश, कोडिंग स्टाइल गाइड या काम की बैकग्राउंड जानकारी दी जा सकती है. इससे, Gemini आपकी ज़रूरतों के हिसाब से ज़्यादा सटीक और बेहतर जवाब दे पाता है. ध्यान दें कि इस फ़ाइल को बनाने से, Firebase में Gemini को वही निर्देश मिलेंगे जो Gemini CLI में मिलते हैं. ऐसा तब तक होगा, जब तक कि .idx/airules.md फ़ाइल नहीं बनाई जाती. .idx/airules.md फ़ाइल बनाने पर, Gemini CLI में GEMINI.md का इस्तेमाल होगा और Firebase में Gemini, airules.md का इस्तेमाल करेगा.

सेटिंग, एनवायरमेंट वैरिएबल, और निर्देशों में बदलाव करने के तरीके के बारे में ज़्यादा जानने के लिए, Gemini CLI दस्तावेज़ पढ़ें.

अगले चरण