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

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

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

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

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

    وقتی کانال انتشار پیش‌نمایش را در یک پروژه فعال می‌کنید، از طرف مشتری موافقت می‌کنید که تمام استفاده از Gemini Code Assist در آن پروژه تابع شرایط ارائه Pre-GA از شرایط خدمات خاص پلتفرم Google Cloud باشد. از این کانال برای پروژه‌ها و منابعی که برای استفاده با پیشنهادات 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
  • کانال‌های انتشار را با استفاده از 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 را مشاهده کنید:
    • cloudaicompanion.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings

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

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

کنسول

  1. در کنسول گوگل کلود، به صفحه ادمین برای جمینی بروید.

    برای دسترسی به فضای ابری گوگل به Gemini بروید

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

  2. در منوی ناوبری، روی تنظیمات کلیک کنید.

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

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

    پیش‌نمایش

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

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

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

رابط برنامه‌نویسی کاربردی

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