कोड से जुड़ी सहायता देने वाली Gemini की सुविधा को सेट अप करना (स्टैंडर्ड और एंटरप्राइज़)

Gemini Code Assist का इस्तेमाल करने से पहले, आपकी टीम को सेटअप करने के लिए, इस दस्तावेज़ में बताए गए चरणों को पूरा करना होगा:

  1. Gemini Code Assist की सदस्यता खरीदें.

  2. अपने संगठन के अलग-अलग उपयोगकर्ताओं को लाइसेंस असाइन करें.

  3. Google Cloud प्रोजेक्ट में, Gemini for Google Cloud API को चालू करना.

  4. Google Cloud प्रोजेक्ट में Identity and Access Management की भूमिकाएं दें.

  5. आपके संगठन के उपयोगकर्ता, IDE में Gemini Code Assist का इस्तेमाल करने के लिए, Gemini Code Assist प्लग इन इंस्टॉल करते हैं.

Gemini Code Assist की सदस्यता खरीदना

हर वर्शन में उपलब्ध सुविधाओं की सूची देखने के लिए, काम करने वाली सुविधाएं देखें.

Gemini Code Assist के जिन नए ग्राहकों के बिलिंग खातों में पहले कभी Gemini Code Assist की सदस्यता नहीं थी उनके लिए, हम पहले महीने के लिए 50 मुफ़्त लाइसेंस के बराबर क्रेडिट अपने-आप लागू कर देते हैं. इस बात से कोई फ़र्क़ नहीं पड़ता कि Gemini Code Assist का कौनसा वर्शन इस्तेमाल किया जा रहा है. ध्यान दें कि बिना शुल्क के मिलने वाले शुरुआती लाइसेंस क्रेडिट के बंट जाने के बाद, बिना शुल्क के मिलने वाले क्रेडिट की संख्या नहीं बढ़ाई जा सकती. इसके अलावा, पहले महीने के अंदर Gemini Code Assist के वर्शन को नहीं बदला जा सकता.

Gemini Code Assist Enterprise, हर उपयोगकर्ता के लिए हर महीने 19 डॉलर की कीमत पर उपलब्ध है. यह प्लान, 31 मार्च, 2025 तक 12 महीने के लिए उपलब्ध है. प्रमोशनल ऑफ़र का फ़ायदा पाने के लिए, हमारी सेल्स टीम से संपर्क करें.

अगर आपके पास Google Cloud के साथ मौजूदा समझौते हैं, तो सदस्यता खरीदने से पहले हमारी सेल्स टीम से संपर्क करें.

  1. Google Cloud के लिए Gemini पेज पर जाएं.

    Gemini for Google Cloud पर जाना

    Google Cloud के लिए Gemini पेज खुलता है.

  2. Gemini Code Assist पाएं को चुनें. ध्यान दें कि अगर आपके बिलिंग खाते से Gemini Code Assist की सदस्यता नहीं खरीदी गई है, तो आपको एक मैसेज दिखेगा. इसमें लिखा होगा कि बिना किसी शुल्क के, 50 लाइसेंस के लिए 30 दिनों के ट्रायल की सुविधा उपलब्ध है. अगर आपके प्रोजेक्ट में पहले से ही Gemini Code Assist है, तो यह टेक्स्ट Gemini Code Assist मैनेज करें दिखाता है.

    Gemini Code Assist की सदस्यता लें पेज खुलेगा.

  3. Gemini Code Assist की सदस्यता का वर्शन चुनें में जाकर, Gemini Code Assist का कोई वर्शन चुनें. Gemini Code Assist के वर्शन की तुलना करें को चुनकर, हर वर्शन में उपलब्ध सुविधाओं की पूरी सूची देखें.

    इसके बाद, जारी रखें को चुनें.

  4. सदस्यता कॉन्फ़िगर करें में जाकर, सदस्यता को कॉन्फ़िगर करने के लिए फ़ील्ड भरें. इनमें ये भी शामिल हैं:

    • सदस्यता का नाम.
    • सदस्यता में लाइसेंस की संख्या. ध्यान दें कि अगर आपको एंटरप्राइज़ वर्शन खरीदना है, तो आपको कम से कम 10 लाइसेंस खरीदने होंगे.
    • सदस्यता की अवधि (महीने या साल). सालाना सदस्यता लेने पर, आपको छूट वाली कीमत पर सदस्यता मिलती है. इसकी सदस्यता शुल्क, एक बार में नहीं बल्कि हर महीने लिया जाता है.
    • सदस्यता की अवधि (हर महीने या साल भर) खत्म होने के बाद, आपकी सदस्यता अपने-आप रिन्यू हो जाएगी. अपने-आप रिन्यू होने की सुविधा से, आपकी सदस्यता और लाइसेंस चालू रहते हैं. अगर सदस्यता अपने-आप रिन्यू नहीं होती है, तो मौजूदा अवधि खत्म होने पर सदस्यता खत्म हो जाती है. इसके बाद, आपको फिर से खरीदारी की प्रोसेस पूरी करनी होगी और लाइसेंस फिर से असाइन करने होंगे.
  5. सदस्यता की पुष्टि करने के लिए, जारी रखें को चुनें.

  6. अगर आप इन शर्तों से सहमत हैं, तो मैं इस खरीदारी की शर्तों से सहमत हूं को चुनें. इसके बाद, सदस्यता की पुष्टि करें को चुनें.

  7. आगे बढ़ें: Gemini के लाइसेंस असाइनमेंट मैनेज करें को चुनें.

अब Gemini Code Assist के लिए सदस्यता खरीद ली गई है. अब आपको अपने संगठन में, Gemini के लाइसेंस असाइनमेंट मैनेज करने होंगे.

लाइसेंस असाइन करना

Gemini Code Assist का इस्तेमाल करने से पहले, आपके संगठन के हर उपयोगकर्ता के पास लाइसेंस होना चाहिए.

Gemini Code Assist के जिन नए ग्राहकों के बिलिंग खातों में पहले कभी Gemini Code Assist की सदस्यता नहीं थी उनके लिए, हम पहले महीने के लिए 50 मुफ़्त लाइसेंस के बराबर क्रेडिट अपने-आप लागू कर देते हैं. इस बात से कोई फ़र्क़ नहीं पड़ता कि Gemini Code Assist का कौनसा वर्शन इस्तेमाल किया जा रहा है. ध्यान दें कि बिना शुल्क के मिलने वाले शुरुआती लाइसेंस क्रेडिट के बंट जाने के बाद, बिना शुल्क के मिलने वाले क्रेडिट की संख्या नहीं बढ़ाई जा सकती. इसके अलावा, पहले महीने के अंदर Gemini Code Assist के वर्शन को नहीं बदला जा सकता.

कंसोल एपीआई

Google Cloud कंसोल में, अलग-अलग उपयोगकर्ताओं को Gemini के लाइसेंस असाइन करने के लिए, आपके पास ये अनुमतियां होनी चाहिए:

  • billing.accounts.get
  • consumerprocurement.orders.get
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.enumerateLicensedUsers
  • consumerprocurement.licensePools.assign
  1. Gemini के लिए एडमिन पेज पर जाएं.

    Gemini for Google Cloud पर जाना

  2. वह सदस्यता चुनें जिसमें आपको बदलाव करना है. इसके बाद, सदस्यता में बदलाव करें पर क्लिक करें.

  3. लाइसेंस असाइन करें पर क्लिक करें. उपयोगकर्ता को चुनने के लिए एक डायलॉग बॉक्स दिखेगा. किसी खास उपयोगकर्ता को खोजने के लिए, खोज बॉक्स में उसका नाम डालें.

  4. सूची से एक या उससे ज़्यादा उपयोगकर्ता चुनें. इसके बाद, आगे बढ़ें पर क्लिक करें.

  5. Gemini की वे सेवाएं चुनें जिनके लिए आपको लाइसेंस असाइन करने हैं.

  6. लाइसेंस असाइन करें पर क्लिक करें.

एपीआई की मदद से Gemini के लाइसेंस असाइन करने के लिए, आपके पास consumerprocurement.licensePools.assign अनुमति होनी चाहिए.

एचटीटीपी का तरीका: POST

URL: https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

इनकी जगह ये डालें:

  • BILLING_ACCOUNT_ID: बिलिंग खाता आईडी
  • ORDER_ID: आईएएम नीति

अनुरोध का मुख्य हिस्सा:

    {
        "usernames": [
                  "dana@example.com",
                  "lee@example.com"
        ]
    }

आउटपुट इस तरह का दिखता है:

{}

लाइसेंस असाइन होने पर, रिस्पॉन्स खाली होता है.

अब आपको इस बिलिंग खाते से जुड़े एक या एक से ज़्यादा प्रोजेक्ट में, Gemini for Google Cloud API को चालू करना होगा. जब तक इसे कम से कम एक प्रोजेक्ट में चालू नहीं किया जाता, तब तक उपयोगकर्ताओं को Gemini Code Assist नहीं दिखेगा.

किसी Cloud प्रोजेक्ट में, Gemini for Google Cloud API को चालू करना

इस सेक्शन में, किसी Cloud प्रोजेक्ट में Gemini for Google Cloud API को चालू करने के लिए ज़रूरी चरणों के बारे में बताया गया है.

कंसोल gcloud
  1. Gemini for Google Cloud API को चालू करने के लिए, Gemini for Google Cloud पेज पर जाएं.

    Gemini for Google Cloud पर जाना

  2. प्रोजेक्ट चुनने वाले टूल में, कोई प्रोजेक्ट चुनें.

  3. चालू करें पर क्लिक करें.

    पेज अपडेट हो जाता है और चालू है स्टेटस दिखाता है. Gemini अब चुने गए Cloud प्रोजेक्ट में उन सभी उपयोगकर्ताओं के लिए उपलब्ध है जिनके पास ज़रूरी IAM भूमिकाएं हैं.

लोकल डेवलपमेंट एनवायरमेंट का इस्तेमाल करने के लिए, gcloud सीएलआई को इंस्टॉल और इस्तेमाल शुरू करें.

  1. प्रोजेक्ट चुनने वाले मेन्यू में, कोई प्रोजेक्ट चुनें.

  2. gcloud services enable कमांड का इस्तेमाल करके, Gemini for Google Cloud API को चालू करें:

    gcloud services enable cloudaicompanion.googleapis.com
    

    अगर आपको किसी दूसरे Google Cloud प्रोजेक्ट में, Gemini for Google Cloud API को चालू करना है, तो --project पैरामीटर जोड़ें:

    gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID
    

    PROJECT_ID की जगह अपने Cloud प्रोजेक्ट का आईडी डालें.

    आउटपुट इस तरह का दिखता है:

    Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
    Operation finished successfully.
    

Gemini for Google Cloud, अब चुने गए Google Cloud प्रोजेक्ट में उन सभी उपयोगकर्ताओं के लिए उपलब्ध है जिनके पास ज़रूरी IAM भूमिकाएं हैं.

फ़ायरवॉल के पीछे मौजूद उपयोगकर्ताओं के लिए ज़रूरी एपीआई

Google Cloud के लिए Gemini को चालू करने के अलावा, फ़ायरवॉल के पीछे मौजूद उपयोगकर्ताओं को इन एपीआई को भी चालू करना पड़ सकता है:

  • oauth2.googleapis.com: इसका इस्तेमाल, Google Cloud में साइन इन करने के लिए किया जाता है.
  • serviceusage.googleapis.com: इसका इस्तेमाल, यह जांचने के लिए किया जाता है कि उपयोगकर्ता का Gemini Code Assist प्रोजेक्ट सही तरीके से कॉन्फ़िगर किया गया है या नहीं.
  • cloudaicompanion.googleapis.com: Google Cloud API के लिए Gemini का मुख्य एंडपॉइंट.
  • cloudcode-pa.googleapis.com: एक इंटरनल एपीआई, जो IDE से जुड़ी सुविधाएं देता है.
  • cloudresourcemanager.googleapis.com: प्रोजेक्ट पिकर के लिए, IDE में इस्तेमाल किया जाता है. अगर प्रोजेक्ट आपकी settings.json फ़ाइल में साफ़ तौर पर कॉन्फ़िगर किए गए हैं, तो हो सकता है कि Resource Manager API की ज़रूरत न पड़े.
  • people.googleapis.com: इससे प्रोफ़ाइलों और संपर्कों की जानकारी का ऐक्सेस मिलता है.
  • firebaselogging-pa.googleapis.com: यह एक इंटरनल एपीआई है. इसका इस्तेमाल, प्रॉडक्ट के बारे में टेलीमेट्री भेजने के लिए किया जाता है. इसमें, सुझावों को स्वीकार किए जाने के बारे में इवेंट भी शामिल होते हैं.
  • feedback-pa.googleapis.com: यह एक इंटरनल एपीआई है, जिसका इस्तेमाल IDE में सुझाव/राय/शिकायत सबमिट करने के लिए किया जाता है.
  • apihub.googleapis.com: Cloud Code API ब्राउज़र की सुविधा का इस्तेमाल किया जाता है.

ज़रूरी नहीं: VPC सर्विस कंट्रोल कॉन्फ़िगर करना

अगर आपके संगठन के पास सेवा का परिधि क्षेत्र है, तो आपको अपने परिधि क्षेत्र में ये संसाधन जोड़ने होंगे:

  • Google Cloud API के लिए Gemini
  • Gemini Code Assist API

अगर सेवा के परिधि से बाहर से Gemini Code Assist का इस्तेमाल किया जा रहा है, तो आपको उन सेवाओं को ऐक्सेस करने की अनुमति देने के लिए, इनग्रेस नीति में भी बदलाव करना होगा.

ज़्यादा जानकारी के लिए, Gemini के लिए VPC सर्विस कंट्रोल कॉन्फ़िगर करना लेख पढ़ें.

Google Cloud प्रोजेक्ट में IAM भूमिकाएं देना

इस सेक्शन में, उपयोगकर्ताओं को Gemini for Google Cloud उपयोगकर्ता और सेवा के इस्तेमाल से जुड़ी उपभोक्ता IAM भूमिकाएं देने का तरीका बताया गया है.

कंसोल gcloud
  1. Gemini का इस्तेमाल करने के लिए ज़रूरी आईएएम भूमिकाएं देने के लिए, आईएएम और एडमिन पेज पर जाएं.

    IAM और एडमिन पेज पर जाना

  2. प्रिंसिपल कॉलम में, वह प्रिंसिपल ढूंढें जिसके लिए आपको Gemini का ऐक्सेस देना है. इसके बाद, उस पंक्ति में प्रिंसिपल में बदलाव करें पर क्लिक करें.

  3. ऐक्सेस में बदलाव करें पैनल में, कोई और भूमिका जोड़ें पर क्लिक करें.

  4. कोई भूमिका चुनें में जाकर, Google Cloud उपयोगकर्ता के लिए Gemini चुनें.

  5. अन्य भूमिका जोड़ें पर क्लिक करें और सेवा के इस्तेमाल का उपभोक्ता चुनें.

  6. सेव करें पर क्लिक करें.

लोकल डेवलपमेंट एनवायरमेंट का इस्तेमाल करने के लिए, gcloud सीएलआई को इंस्टॉल और इस्तेमाल शुरू करें.

  1. प्रोजेक्ट चुनने वाले मेन्यू में, कोई प्रोजेक्ट चुनें.

  2. Gemini for Google Cloud उपयोगकर्ता की भूमिका असाइन करें:

    gcloud projects add-iam-policy-binding  PROJECT_ID \
        --member=PRINCIPAL --role=roles/cloudaicompanion.user
    

    PRINCIPAL को प्रिंसिपल के आइडेंटिफ़ायर से बदलें. आइडेंटिफ़ायर का फ़ॉर्मैट user|group|serviceAccount:email या domain:domain होता है. उदाहरण के लिए, user:cloudysanfrancisco@gmail.com, group:admins@example.com, serviceAccount:test123@example.domain.com या domain:example.domain.com.

    आउटपुट, नीति बाइंडिंग की सूची होती है. इसमें ये चीज़ें शामिल होती हैं:

    - members:
      - user:PRINCIPAL
      role: roles/cloudaicompanion.user
    
  3. सेवा के इस्तेमाल से जुड़े उपभोक्ता को भूमिका दें:

    gcloud projects add-iam-policy-binding  PROJECT_ID \
        --member=PRINCIPAL --role=roles/serviceusage.serviceUsageConsumer
    

    आउटपुट, नीति बाइंडिंग की सूची होती है. इसमें ये चीज़ें शामिल होती हैं:

    - members:
      - user:PRINCIPAL
      role: roles/serviceusage.serviceUsageConsumer
    

ज़्यादा जानकारी के लिए, सिर्फ़ एक भूमिका असाइन करना और gcloud projects add-iam-policy-binding लेख पढ़ें.

जिन उपयोगकर्ताओं को ये भूमिकाएं दी गई हैं वे तय किए गए प्रोजेक्ट में, Google Cloud Console में Gemini for Google Cloud की सुविधाओं को ऐक्सेस कर सकते हैं. ज़्यादा जानकारी के लिए, Gemini for Google Cloud की खास जानकारी लेख पढ़ें.

किसी आईडीई में Gemini Code Assist प्लग इन इंस्टॉल करना

आपके संगठन के उपयोगकर्ता, अपने पसंदीदा आईडीई में Gemini Code Assist इंस्टॉल करते हैं. ज़्यादा जानकारी के लिए, ये देखें:

डिफ़ॉल्ट रूप से, Gemini Code Assist इन आईडीई में शामिल होता है:

सेटअप से जुड़े बेहतर टास्क

पहले से तय की गई आईएएम भूमिकाएं देने के लिए, Google Cloud Console या gcloud का इस्तेमाल करने के बजाय, इनमें से कोई एक तरीका अपनाया जा सकता है:

  • भूमिकाएं देने के लिए, IAM REST API या IAM क्लाइंट लाइब्रेरी का इस्तेमाल करें.

    इन इंटरफ़ेस का इस्तेमाल करने पर, भूमिका के लिए पूरी तरह से सही नाम इस्तेमाल करें:

    • roles/cloudaicompanion.user
    • roles/serviceusage.serviceUsageConsumer

    भूमिकाएं देने के बारे में ज़्यादा जानने के लिए, प्रोजेक्ट, फ़ोल्डर, और संगठनों का ऐक्सेस मैनेज करना लेख पढ़ें.

  • कस्टम भूमिकाएं बनाना और उन्हें असाइन करना.

    Gemini Code Assist को ऐक्सेस करने के लिए, आपके बनाई गई कस्टम भूमिकाओं के पास ये अनुमतियां होनी चाहिए:

    • cloudaicompanion.companions.generateChat
    • cloudaicompanion.companions.generateCode
    • cloudaicompanion.instances.completeCode
    • cloudaicompanion.instances.completeTask
    • cloudaicompanion.instances.generateCode
    • cloudaicompanion.instances.generateText
    • serviceusage.services.enable
  • लाइसेंस असाइन और मैनेज करना.

    Gemini Code Assist को ऐक्सेस करने के लिए, आपके बनाई गई कस्टम भूमिकाओं के पास ये अनुमतियां होनी चाहिए:

    • consumerprocurement.orders.get
    • consumerprocurement.orders.licensePools..*
    • consumerprocurement.orders.licensePools.update
    • consumerprocurement.orders.licensePools.get
    • consumerprocurement.orders.licensePools.assign
    • consumerprocurement.orders.licensePools.unassign
    • consumerprocurement.orders.licensePools.enumerateLicensedUsers

यह भी ध्यान रखें कि ऊपर दी गई किसी भी अनुमति के काम करने के लिए, Gemini for Google Cloud API को उसी Google Cloud प्रोजेक्ट में चालू करना ज़रूरी है जहां आपने हर अनुमति असाइन की है.

आगे क्या करना है