ضبط قنوات إصدار Gemini Code Assist

يوضّح هذا المستند كيفية ضبط قنوات الإصدار في Gemini Code Assist لمشروع باستخدام Google API Console أو واجهة برمجة تطبيقات.

نطرح ميزات Gemini Code Assist في قنوات إصدار مختلفة. يمكنك ضبط كل مشروع على Google Cloud على قناة إصدار واحدة استنادًا إلى التوازن الذي تختاره بين توفّر الميزات والاستقرار. يمكن للمستخدمين في مؤسستك الذين يستعينون بـ "مساعد Gemini للرموز البرمجية" في بيئة التطوير المتكاملة (IDE) المحلية استخدام الميزات والنماذج استنادًا إلى قناة الإصدار التي تم ضبطها للمشروع.

تتوفّر قنوات الإصدار التالية:

  • متوفّر للجمهور العام: قناة الإصدار التلقائية يتيح لك استخدام النماذج والميزات المتاحة بشكل عام. يُرجى العِلم أنّه يمكن الوصول إلى بعض الميزات التجريبية بدون الاشتراك في "قناة الإصدار التجريبي"، وذلك باستخدام آليات بديلة للاشتراك في الإصدار التجريبي. يمكن الوصول إلى هذه الميزات من خلال قناة الإصدار العام، ولكنها تظل خاضعة لأحكام "عروض مرحلة ما قبل التوفّر للجمهور العام".
  • المعاينة: تتيح لك هذه الميزة الوصول إلى بعض ميزات المعاينة في Gemini Code Assist، ويمكنك أيضًا تقديم ملاحظات وبيانات الاستخدام لمساعدة Google في تحسين الإصدارات المستقبلية. يُرجى العِلم أنّه لا تتوفّر حاليًا أي ميزات مميّزة في قناة الإصدار التجريبي.

    عند تفعيل قناة الإصدار التجريبي في أحد المشاريع، يعني ذلك موافقتك نيابةً عن العميل على أنّ جميع استخدامات Gemini Code Assist في هذا المشروع تخضع لأحكام العرض لمرحلة ما قبل التوفّر للجمهور العام الواردة في الأحكام الخاصة بخدمة Google Cloud Platform. لا تستخدِم هذه القناة للمشاريع والموارد غير المناسبة للاستخدام مع عروض مرحلة ما قبل التوفّر للجمهور العام.

توضّح الأقسام التالية الخطوات المطلوبة لضبط قناة الإصدار الخاصة بـ "مساعد Gemini في كتابة الرموز" أو تغييرها.

قبل البدء

الأدوار المطلوبة

للحصول على الأذونات المطلوبة لإنشاء الإعدادات وعمليات الربط التي تتحكّم في قناة الإصدار، اطلب من المشرف منحك دور "مشرف إعدادات Gemini في Google Cloud" (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 في Google Cloud":
    • cloudaicompanion.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings

ضبط قنوات إصدار Gemini Code Assist

اختر أحد الخيارات التالية:

وحدة التحكّم

  1. في API Console، انتقِل إلى صفحة المشرف على Gemini.

    الانتقال إلى "Gemini في Google Cloud"

    يتم تحميل صفحة Gemini في 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: اسم إعداد فريد، مثل rc1 لـ Release Channel

      تعرض النتيجة قيمة 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. على سبيل المثال، استخدِم rc1b1 لـ Release Channel.
      • 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: اسم إعداد فريد، مثل dswg1 لـ Data Sharing with Google

      تعرض النتيجة قيمة 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. على سبيل المثال، استخدِم dswg1b1 لـ Data Sharing with Google.
      • 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: رقم تعريف عملية إنشاء ربط الإعدادات الخاصة بالطلب والاستجابة المقدَّم في الاستجابة في الخطوة السابقة.