Gemini Code Assist के रिलीज़ चैनल कॉन्फ़िगर करना

इस दस्तावेज़ में, Google API कंसोल या किसी एपीआई का इस्तेमाल करके, किसी प्रोजेक्ट के लिए Gemini Code Assist के रिलीज़ चैनल कॉन्फ़िगर करने का तरीका बताया गया है.

हम Gemini Code Assist की सुविधाओं को अलग-अलग रिलीज़ चैनल में रिलीज़ करते हैं. आपके पास हर Google Cloud प्रोजेक्ट को किसी एक रिलीज़ चैनल पर सेट करने का विकल्प होता है. हालांकि, यह इस बात पर निर्भर करता है कि आपको फ़ीचर की उपलब्धता और स्थिरता के बीच कौनसा विकल्प चुनना है. आपके संगठन के जो उपयोगकर्ता अपने लोकल आईडीई में Gemini Code Assist का इस्तेमाल करते हैं वे प्रोजेक्ट के लिए कॉन्फ़िगर किए गए रिलीज़ चैनल के आधार पर, सुविधाओं और मॉडल का इस्तेमाल कर सकते हैं.

ये रिलीज़ चैनल उपलब्ध हैं:

  • सामान्य रूप से उपलब्ध है. डिफ़ॉल्ट रिलीज़ चैनल. इससे आपको आम तौर पर उपलब्ध मॉडल और सुविधाओं का इस्तेमाल करने की अनुमति मिलती है. ध्यान दें कि Preview चैनल में ऑप्ट इन किए बिना भी, झलक में मिलने वाली कुछ सुविधाओं को ऐक्सेस किया जा सकता है. इसके लिए, Preview के लिए साइन-अप करने के अन्य तरीकों का इस्तेमाल करें. इन सुविधाओं को GA चैनल में ऐक्सेस किया जा सकेगा. हालांकि, इन पर अब भी Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं से जुड़ी शर्तें लागू होंगी.
  • झलक देखें. इस सेटिंग की मदद से, Gemini Code Assist की कुछ सुविधाओं को रिलीज़ होने से पहले ही ऐक्सेस किया जा सकता है. साथ ही, Google को सुझाव/राय दी जा सकती है या शिकायत की जा सकती है. इसके अलावा, इस्तेमाल का डेटा भी भेजा जा सकता है, ताकि Google आने वाले समय में इन सुविधाओं को बेहतर बना सके. ध्यान दें कि फ़िलहाल, Preview release channel में कोई खास सुविधा उपलब्ध नहीं है.

    किसी प्रोजेक्ट पर Preview रिलीज़ चैनल चालू करने का मतलब है कि ग्राहक की ओर से, आपने इस बात पर सहमति दी है कि उस प्रोजेक्ट में Gemini Code Assist के सभी इस्तेमाल पर, Pre-GA ऑफ़र की शर्तें लागू होंगी. ये शर्तें, Google Cloud Platform की सेवा की खास शर्तें में दी गई हैं. इस चैनल का इस्तेमाल उन प्रोजेक्ट और संसाधनों के लिए न करें जो Pre-GA ऑफ़र के साथ इस्तेमाल करने के लिए सही नहीं हैं.

यहां दिए गए सेक्शन में, Gemini Code Assist के रिलीज़ चैनल को सेट करने या बदलने का तरीका बताया गया है.

शुरू करने से पहले

ज़रूरी भूमिकाएं

सेटिंग और बाइंडिंग बनाने के लिए ज़रूरी अनुमतियां पाने के लिए, अपने एडमिन से कहें कि वह आपको प्रोजेक्ट पर Gemini for Google Cloud Settings Admin (roles/cloudaicompanion.settingsAdmin) की भूमिका दे. ये सेटिंग और बाइंडिंग, रिलीज़ चैनल को कंट्रोल करती हैं.

ज़रूरी अनुमतियों के बारे में जानने के लिए, ज़रूरी अनुमतियां सेक्शन को बड़ा करें:

ज़रूरी अनुमतियां

  • cloudaicompanion.releaseChannelSettings.create
  • cloudaicompanion.releaseChannelSettings.delete
  • cloudaicompanion.releaseChannelSettings.get
  • cloudaicompanion.releaseChannelSettings.list
  • cloudaicompanion.releaseChannelSettings.update
  • cloudaicompanion.dataSharingWithGoogleSettings.create
  • एपीआई का इस्तेमाल करके रिलीज़ चैनल कॉन्फ़िगर करना:
    • cloudaicompanion.settingBindings.releaseChannelSettingsCreate
    • cloudaicompanion.settingBindings.releaseChannelSettingsDelete
    • cloudaicompanion.settingBindings.releaseChannelSettingsGet
    • cloudaicompanion.settingBindings.releaseChannelSettingsList
    • cloudaicompanion.settingBindings.releaseChannelSettingsUpdate
    • cloudaicompanion.settingBindings.releaseChannelSettingsUse
  • एपीआई का इस्तेमाल करके, प्रॉम्प्ट और जवाब शेयर करने की सुविधा कॉन्फ़िगर करना:
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
  • Gemini for Google Cloud के एडमिन की सेटिंग देखने के लिए:
    • cloudaicompanion.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings

Gemini Code Assist के रिलीज़ चैनल कॉन्फ़िगर करना

निम्न विकल्पों में से कोई एक चुनें:

कंसोल

  1. API Console में, Admin for Gemini पेज पर जाएं.

    Gemini for Google Cloud पर जाएँ

    Gemini for Google Cloud पेज लोड होता है.

  2. नेविगेशन मेन्यू में, सेटिंग पर क्लिक करें.

    सेटिंग पेज लोड होता है.

  3. स्थानीय आईडीई में Gemini Code Assist के लिए रिलीज़ चैनल सेक्शन में जाकर, अपनी ज़रूरत के हिसाब से रिलीज़ चैनल चुनें:

    झलक देखें

    1. झलक देखें चुनें.
    2. प्रीव्यू रिलीज़ चैनल की जानकारी और भरोसेमंद टेस्टर प्रोग्राम की शर्तों की समीक्षा करें. इसके बाद, बदलाव सेव करें पर क्लिक करें.

    सामान्य तौर पर उपलब्ध

    1. GA को चुनें.
    2. बदलाव सेव करें पर क्लिक करें.

एपीआई

  1. रिलीज़ चैनल की सेटिंग और सेटिंग के हिसाब से वैल्यू बनाएं:

    1. पुष्टि करने वाला टोकन पाएं. इसे पाने के लिए, आपको gcloud की मदद से पुष्टि करनी होगी:

      TOKEN=$(gcloud auth print-access-token)
      
    2. सेटिंग बनाएं. इन निर्देशों में, एपीआई के तरीकों को कॉल करने के लिए cURL का इस्तेमाल किया गया है:

        curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
            "release_channel": "RELEASE_CHANNEL",
          } ' -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/releaseChannelSettings?release_channel_setting_id=RC_SETTING_ID"
      

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

      • RELEASE_CHANNEL: रिलीज़ चैनल, जो कि EXPERIMENTAL (झलक) या STABLE (आम तौर पर उपलब्ध) में से कोई एक होता है.
      • CONTAINER_PROJECT_NAME: यह उस प्रोजेक्ट का आईडी है जिसमें बाइंडिंग रिसॉर्स सेव किया गया है. यह बाइंडिंग का पैरंट प्रोजेक्ट है.
      • RC_SETTING_ID: सेटिंग का यूनीक नाम—उदाहरण के लिए, Release Channel के लिए rc1.

      आउटपुट में, releaseChannel को RELEASE_CHANNEL पर सेट किया गया है:

      {
        "name": "projects/CONTAINER_PROJECT_NAME
      /locations/global/releaseChannelSettings/RC_SETTING_ID",
        "createTime": "2025-01-23T15:22:49.717166932Z",
        "updateTime": "2025-01-23T15:22:49.717166932Z",
        "releaseChannel": RELEASE_CHANNEL
      }
      
    3. रिलीज़ चैनल की सेटिंग बाइंडिंग बनाएं:

        curl \
        -H "Authorization: Bearer $TOKEN" \
        -H 'Content-Type: application/json' \
        -d '{
            "target": "projects/TARGET_PROJECT_NAME",
            "product": "GEMINI_CODE_ASSIST"
          }' \
        -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/releaseChannelSettings/RC_SETTING_ID/settingBindings?setting_binding_id=RC_BINDING_ID"
      

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

      • TARGET_PROJECT_NAME: वह टारगेट प्रोजेक्ट जिससे बाइंडिंग को बाइंड किया जाना चाहिए. यह अक्सर कंटेनर प्रोजेक्ट के जैसा ही होता है. हालांकि, किसी सेटिंग को कई प्रोजेक्ट से बाइंड किया जा सकता है, ताकि सेटिंग रिसोर्स को डुप्लीकेट न करना पड़े.
      • CONTAINER_PROJECT_NAME: यह उस प्रोजेक्ट का आईडी है जिसमें बाइंडिंग रिसॉर्स सेव किया गया है. यह बाइंडिंग का पैरंट प्रोजेक्ट है.
      • RC_SETTING_ID: वही RC_SETTING_ID जिसका इस्तेमाल आपने सेटिंग बनाते समय किया था. हालांकि, इसमें b1 जोड़ा गया है. उदाहरण के लिए, Release Channel के लिए rc1b1 का इस्तेमाल करें.
      • RC_BINDING_ID: सेटिंग बाइंडिंग के लिए यूनीक नाम—उदाहरण के लिए, rc_binding.

      आउटपुट में, कार्रवाई का मेटाडेटा इस फ़ॉर्मैट में शामिल होता है:

      {
        "name": "projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-RC_BINDING_OPERATION_ID",
        "metadata": {
          "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
          "createTime": "2025-01-23T15:27:50.076075570Z",
          "target": "projects/TARGET_PROJECT_NAME/locations/global/releaseChannelSettings/RC_SETTING_ID/settingBindings/RC_BINDING_ID",
          "verb": "create",
          "requestedCancellation": false,
          "apiVersion": "v1"
        },
        "done": false
      }
      
    4. ज़रूरी नहीं: रिलीज़ चैनल की सेटिंग बाइंड करने की स्थिति देखें बनाना:

      curl -H "Authorization: Bearer $TOKEN" \
      https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-RC_BINDING_OPERATION_ID
      

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

      • CONTAINER_PROJECT_NAME: यह उस प्रोजेक्ट का आईडी है जिसमें बाइंडिंग रिसॉर्स सेव किया गया है. यह बाइंडिंग का पैरंट प्रोजेक्ट है.
      • RC_BINDING_OPERATION_ID: रिलीज़ चैनल की सेटिंग बाइंड करने के लिए, पिछले चरण में मिले जवाब में दिया गया आईडी.
  2. ज़रूरी नहीं: प्रॉम्प्ट और जवाब शेयर करने की सेटिंग और सेटिंग के हिसाब से वैल्यू बनाएं:

    1. टोकन पाएं:

      TOKEN=$(gcloud auth print-access-token)
      
    2. सेटिंग बनाएं:

      curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
          "enable_preview_data_sharing": true,
        } ' -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?data_sharing_with_google_setting_id=DSWG_SETTING_ID"
      

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

      • CONTAINER_PROJECT_NAME: पैरंट प्रोजेक्ट आईडी
      • DSWG_SETTING_ID: सेटिंग का यूनीक नाम—उदाहरण के लिए, Data Sharing with Google के लिए dswg1

      आउटपुट में, enablePreviewDataSharing को true पर सेट किया गया है:

      {
        "name": "projects/CONTAINER_PROJECT_NAME
      /locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID",
        "createTime": "2025-01-23T15:22:49.717166932Z",
        "updateTime": "2025-01-23T15:22:49.717166932Z",
        "enablePreviewDataSharing": true
      }
      
    3. प्रॉम्प्ट और जवाब की सेटिंग बाइंडिंग बनाएं:

        curl \
        -H "Authorization: Bearer $TOKEN" \
        -H 'Content-Type: application/json' \
        -d '{
            "target": "projects/TARGET_PROJECT_NAME",
            "product": "GEMINI_CODE_ASSIST"
          }' \
        -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID/settingBindings?setting_binding_id=DSWG_BINDING_ID"
      

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

      • TARGET_PROJECT_NAME: वह टारगेट प्रोजेक्ट जिस पर सेटिंग लागू की जानी चाहिए.
      • CONTAINER_PROJECT_NAME: पैरंट प्रोजेक्ट आईडी.
      • DSWG_SETTING_ID: वही DSWG_SETTING_ID जिसका इस्तेमाल आपने सेटिंग बनाते समय किया था. हालांकि, इसमें b1 जोड़ा गया है. उदाहरण के लिए, Data Sharing with Google के लिए dswg1b1 का इस्तेमाल करें.
      • DSWG_BINDING_ID: सेटिंग बाइंडिंग के लिए यूनीक नाम—उदाहरण के लिए, dswg_binding.

      आउटपुट में, कार्रवाई का मेटाडेटा इस फ़ॉर्मैट में शामिल होता है:

      {
      "name": "projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-DSWG_BINDING_OPERATION_ID",
      "metadata": {
        "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
        "createTime": "2025-01-23T15:27:50.076075570Z",
        "target": "projects/TARGET_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID/settingBindings/DSWG_BINDING_ID",
        "verb": "create",
        "requestedCancellation": false,
        "apiVersion": "v1"
      },
      "done": false
      }
      
    4. ज़रूरी नहीं: प्रॉम्प्ट और रिस्पॉन्स सेटिंग बाइंड करने की सुविधा चालू करने का स्टेटस देखें:

      curl -H "Authorization: Bearer $TOKEN" \
      https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-DSWG_BINDING_OPERATION_ID
      

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

      • CONTAINER_PROJECT_NAME: यह उस प्रोजेक्ट का आईडी है जिसमें बाइंडिंग रिसॉर्स सेव किया गया है. यह बाइंडिंग का पैरंट प्रोजेक्ट है.
      • DSWG_BINDING_OPERATION_ID: प्रॉम्प्ट और जवाब की सेटिंग बाइंड करने के लिए, क्रिएशन ऑपरेशन आईडी. यह आईडी, पिछले चरण में मिले जवाब में दिया गया था.