Gemini Code Assist sürüm kanallarını yapılandırma

Bu belgede, Google Cloud Console'u veya bir API'yi kullanarak bir proje için Gemini Code Assist yayın kanallarının nasıl yapılandırılacağı açıklanmaktadır.

Gemini Code Assist özelliklerini farklı yayın kanallarında yayınlarız. Özellik kullanılabilirliği ve kararlılık arasında seçtiğiniz dengeye bağlı olarak her Google Cloud projesini tek bir yayın kanalına ayarlayabilirsiniz. Kuruluşunuzda yerel IDE'lerinde Gemini Code Assist'i kullanan kullanıcılar, proje için yapılandırılan sürüm kanalına dayalı özellikleri ve modelleri kullanabilir.

Aşağıdaki sürüm kanalları kullanılabilir:

  • Genel kullanıma sunuldu. Varsayılan sürüm kanalı. Genel olarak kullanıma sunulan modelleri ve özellikleri kullanmanıza olanak tanır. Bazı önizleme özelliklerine, alternatif önizleme kaydı mekanizmalarını kullanarak Önizleme kanalına kaydolmadan erişilebileceğini unutmayın. Bu özelliklere GKST kanalından erişilebilir ancak GKST Öncesi Teklif Şartları kapsamında olmaya devam ederler.

  • Önizleme. Gemini Code Assist'in belirli önizleme özelliklerine erişmenize ve isteğe bağlı olarak Google'ın gelecekteki sürümleri iyileştirmesine yardımcı olmak için geri bildirim ve kullanım verileri sağlamanıza olanak tanır. Önizleme sürüm kanalında şu anda belirgin bir özellik olmadığını unutmayın.

    Bir projede önizleme sürümü kanalını etkinleştirdiğinizde, müşteri adına tüm Gemini Code Assist kullanımının Google Cloud Platform Hizmete Özel Şartları'nın GKST Öncesi Teklif Koşulları'na tabi olduğunu kabul edersiniz. Bu kanalı, GKST öncesi tekliflerle kullanıma uygun olmayan projeler ve kaynaklar için kullanmayın.

Aşağıdaki bölümlerde, Gemini Code Assist yayın kanalınızı ayarlamak veya değiştirmek için gereken adımlar açıklanmaktadır.

Başlamadan önce

Gerekli roller

Yayın kanalını kontrol eden ayarlar ve bağlamalar oluşturmak için gerekli izinler konusunda yöneticinizden projede Gemini for Google Cloud Settings Admin (roles/cloudaicompanion.settingsAdmin) rolünü vermesini isteyin.

Gerekli izinleri tam olarak görmek için Gerekli izinler bölümünü genişletin:

Gerekli izinler

  • cloudaicompanion.releaseChannelSettings.create
  • cloudaicompanion.releaseChannelSettings.delete
  • cloudaicompanion.releaseChannelSettings.get
  • cloudaicompanion.releaseChannelSettings.list
  • cloudaicompanion.releaseChannelSettings.update
  • cloudaicompanion.dataSharingWithGoogleSettings.create
  • API kullanarak yeni sürüm kanallarını yapılandırma:
    • cloudaicompanion.settingBindings.releaseChannelSettingsCreate
    • cloudaicompanion.settingBindings.releaseChannelSettingsDelete
    • cloudaicompanion.settingBindings.releaseChannelSettingsGet
    • cloudaicompanion.settingBindings.releaseChannelSettingsList
    • cloudaicompanion.settingBindings.releaseChannelSettingsUpdate
    • cloudaicompanion.settingBindings.releaseChannelSettingsUse
  • API kullanarak istem ve yanıt paylaşımını yapılandırma:
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
  • Google Cloud için Gemini yönetici ayarlarını görüntüleme:
    • cloudaicompanion.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings

Gemini Code Assist sürüm kanallarını yapılandırma

Aşağıdaki seçeneklerden birini belirtin:

Console

  1. Google Cloud Console'da Gemini için Yönetici sayfasına gidin.

    Google Cloud için Gemini'a gitme

    Google Cloud için Gemini sayfası yüklenir.

  2. Gezinme menüsünde Ayarlar'ı tıklayın.

    Ayarlar sayfası yüklenir.

  3. Yerel IDE'lerde Gemini Code Assist için yayın kanalları bölümünde, ihtiyaçlarınıza en uygun yayın kanalını seçin:

    Önizleme

    1. Önizle'yi seçin.
    2. Önizleme sürümü kanalının ayrıntılarını ve güvenilir test kullanıcıları programı şartlarını inceleyin, ardından Değişiklikleri kaydet'i tıklayın.

    Genel kullanıma sunuldu

    1. GA'yı seçin.
    2. Değişiklikleri kaydet'i tıklayın.

API

  1. Sürüm kanalı ayarını ve ayara özel bir değeri oluşturun:

    1. Kimlik doğrulama jetonu alın. Bu kimliği almak için gcloud kimlik doğrulamasını kullanarak kimliğinizi doğrulamanız gerekir:

      TOKEN=$(gcloud auth print-access-token)

    2. Ayarı oluşturun. Bu talimatlarda API yöntemlerini çağırmak için cURL kullanılır:

        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"

      Aşağıdakini değiştirin:

      • RELEASE_CHANNEL: Yayın kanalı. Önizleme için EXPERIMENTAL, genel kullanıma sunulan sürüm için STABLE.
      • CONTAINER_PROJECT_NAME: Bağlama kaynağının depolandığı projenin proje kimliği. Bu, bağlamanın üst projesidir.
      • RC_SETTING_ID: Benzersiz bir ayar adı (ör. Release Channel için rc1).

      Çıkışta, releaseChannel değerinin RELEASE_CHANNEL olarak ayarlandığı gösterilir:

      {
  "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. Sürüm kanalı ayarı bağlamasını oluşturun:

        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"

      Aşağıdakini değiştirin:

      • TARGET_PROJECT_NAME: Bağlamanın bağlanacağı hedef proje. Bu genellikle kapsayıcı projesiyle aynıdır. Ancak, ayar kaynağının kopyalanmaması için bir ayarı birden fazla projeye bağlayabilirsiniz.
      • CONTAINER_PROJECT_NAME: Bağlama kaynağının depolandığı projenin proje kimliği. Bu, bağlamanın üst projesidir.
      • RC_SETTING_ID: Ayarı oluştururken kullandığınız RC_SETTING_ID ile aynıdır ancak b1 eklenmiştir. Örneğin, Release Channel için rc1b1 kullanın.
      • RC_BINDING_ID: Ayarlar bağlama için benzersiz bir ad (ör. rc_binding).

      Çıkış, işlem meta verilerini aşağıdaki biçimde içerir:

      {
  "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. İsteğe bağlı: Sürüm kanalı ayarı bağlama/oluşturma işleminin durumunu kontrol edin:

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

      Aşağıdakini değiştirin:

      • CONTAINER_PROJECT_NAME: Bağlama kaynağının depolandığı projenin proje kimliği. Bu, bağlamanın üst projesidir.
      • RC_BINDING_OPERATION_ID: Önceki adımda yanıtta sağlanan yayın kanalı ayarı bağlama oluşturma işlemi kimliği.

  2. İsteğe bağlı: İstem ve yanıt paylaşımı ayarı ile ayara özel bir değer oluşturun:

    1. Jetonu alın:

      TOKEN=$(gcloud auth print-access-token)

    2. Ayarı oluşturun:

      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"

      Aşağıdakini değiştirin:

      • CONTAINER_PROJECT_NAME: üst proje kimliği
      • DSWG_SETTING_ID: Benzersiz bir ayar adı (ör. Data Sharing with Google için dswg1)

      Çıkışta, enablePreviewDataSharing değerinin true olarak ayarlandığı gösterilir:

      {
  "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. İstem ve yanıt ayarı bağlamasını oluşturun:

        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"

      Aşağıdakini değiştirin:

      • TARGET_PROJECT_NAME: Ayarın uygulanacağı hedef proje.
      • CONTAINER_PROJECT_NAME: üst proje kimliği.
      • DSWG_SETTING_ID: Ayarı oluştururken kullandığınız DSWG_SETTING_ID ile aynıdır ancak b1 eklenmiştir. Örneğin, Data Sharing with Google için dswg1b1 kullanın.
      • DSWG_BINDING_ID: Ayarlar bağlama için benzersiz bir ad (ör. dswg_binding).

      Çıkış, işlem meta verilerini aşağıdaki biçimde içerir:

      {
"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. İsteğe bağlı: İstem ve yanıt ayarı bağlama oluşturma işleminin durumunu kontrol edin:

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

      Aşağıdakini değiştirin:

      • CONTAINER_PROJECT_NAME: Bağlama kaynağının depolandığı projenin proje kimliği. Bu, bağlamanın üst projesidir.
      • DSWG_BINDING_OPERATION_ID: Önceki adımda yanıtta sağlanan istem ve yanıt ayarı bağlama oluşturma işlemi kimliği.