کانال های انتشار Gemini Code Assist را پیکربندی کنید

این سند نحوه پیکربندی کانال‌های انتشار Gemini Code Assist را برای یک پروژه با استفاده از Google API Console یا یک API توضیح می‌دهد.

ما ویژگی‌های Gemini Code Assist را در کانال‌های انتشار مختلف منتشر می‌کنیم. بسته به تعادل انتخابی خود بین در دسترس بودن ویژگی و پایداری، می‌توانید هر پروژه Google Cloud را روی یک کانال انتشار تنظیم کنید. کاربران سازمان شما که از Gemini Code Assist در IDE محلی خود استفاده می‌کنند، می‌توانند از ویژگی‌ها و مدل‌های مبتنی بر کانال انتشار پیکربندی‌شده برای پروژه استفاده کنند.

کانال های انتشار زیر در دسترس هستند:

  • به طور کلی در دسترس است. کانال انتشار پیش فرض به شما امکان می دهد از مدل ها و ویژگی های عمومی موجود استفاده کنید. توجه داشته باشید که دسترسی به برخی ویژگی‌های پیش‌نمایش بدون شرکت در کانال پیش‌نمایش، با استفاده از مکانیسم‌های جایگزین ثبت‌نام پیش‌نمایش امکان‌پذیر است. این ویژگی‌ها در کانال GA قابل دسترسی خواهند بود، اما همچنان تحت شرایط ارائه قبل از GA هستند.
  • پیش نمایش. به شما امکان می‌دهد به ویژگی‌های پیش‌نمایش خاصی برای Gemini Code Assist دسترسی داشته باشید و به صورت اختیاری، بازخورد و داده‌های استفاده را برای کمک به Google در بهبود نسخه‌های بعدی ارائه دهید. توجه داشته باشید که در حال حاضر هیچ ویژگی متمایزی در کانال انتشار پیش نمایش وجود ندارد.

    وقتی کانال انتشار پیش‌نمایش را در پروژه‌ای فعال می‌کنید، از طرف مشتری موافقت می‌کنید که تمام استفاده از Gemini Code Assist در آن پروژه مشمول شرایط ارائه Pre-GA در شرایط خدمات خاص Google Cloud Platform باشد. از این کانال برای پروژه ها و منابعی که برای استفاده با پیشنهادات قبل از GA مناسب نیستند استفاده نکنید.

بخش‌های زیر مراحل لازم برای تنظیم یا تغییر کانال انتشار Gemini Code Assist را ارائه می‌کنند.

قبل از شروع

نقش های مورد نیاز

برای مجوزهای لازم برای ایجاد تنظیمات و اتصال‌هایی که کانال انتشار را کنترل می‌کنند، از سرپرست خود بخواهید که نقش Gemini برای مدیر تنظیمات Google Cloud ( roles/cloudaicompanion.settingsAdmin ) را در پروژه به شما اعطا کند.

برای مشاهده مجوزهای دقیق مورد نیاز، بخش مجوزهای مورد نیاز را گسترش دهید:

مجوزهای مورد نیاز

  • cloudaicompanion.releaseChannelSettings.create
  • cloudaicompanion.releaseChannelSettings.delete
  • cloudaicompanion.releaseChannelSettings.get
  • cloudaicompanion.releaseChannelSettings.list
  • cloudaicompanion.releaseChannelSettings.update
  • cloudaicompanion.dataSharingWithGoogleSettings.create
  • کانال های انتشار را با استفاده از یک API پیکربندی کنید:
    • cloudaicompanion.settingBindings.releaseChannelSettingsCreate
    • cloudaicompanion.settingBindings.releaseChannelSettingsDelete
    • cloudaicompanion.settingBindings.releaseChannelSettingsGet
    • cloudaicompanion.settingBindings.releaseChannelSettingsList
    • cloudaicompanion.settingBindings.releaseChannelSettingsUpdate
    • cloudaicompanion.settingBindings.releaseChannelSettingsUse
  • پیکربندی اشتراک‌گذاری سریع و پاسخ با استفاده از یک API:
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
  • تنظیمات مدیر Gemini برای Google Cloud را مشاهده کنید:
    • cloudaicompanion.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings

کانال های انتشار Gemini Code Assist را پیکربندی کنید

یکی از گزینه های زیر را انتخاب کنید:

کنسول

  1. در کنسول API، به صفحه Admin for Gemini بروید.

    برای Google Cloud به Gemini بروید

    صفحه Gemini for Google Cloud بارگیری می شود.

  2. در منوی پیمایش روی تنظیمات کلیک کنید.

    صفحه تنظیمات بارگیری می شود.

  3. در بخش Release channels for Gemini Code Assist در IDEs محلی ، کانال انتشار را انتخاب کنید که به بهترین وجه با نیازهای شما مطابقت دارد:

    پیش نمایش

    1. پیش نمایش را انتخاب کنید.
    2. جزئیات کانال انتشار پیش‌نمایش و شرایط برنامه آزمایش‌کننده معتمد را مرور کنید و سپس روی ذخیره تغییرات کلیک کنید.

    به طور کلی در دسترس است

    1. GA را انتخاب کنید.
    2. روی ذخیره تغییرات کلیک کنید.

API

  1. تنظیم کانال انتشار و یک مقدار خاص تنظیم را ایجاد کنید:

    1. یک نشانه احراز هویت دریافت کنید. برای به دست آوردن آن باید با استفاده از احراز هویت gcloud احراز هویت شوید:

      TOKEN=$(gcloud auth print-access-token)
      
    2. تنظیم را ایجاد کنید. این دستورالعمل ها از cURL برای فراخوانی متدهای API استفاده می کنند:

        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 برای Generally Available.
      • 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 : شناسه عملیات ایجاد صحافی تنظیم اعلان و پاسخ ارائه شده در پاسخ در مرحله قبل.