Konfigurowanie kanałów wersji Gemini Code Assist

Ten dokument opisuje, jak skonfigurować kanały wersji Gemini Code Assist w projekcie za pomocą konsoli Google Cloud lub interfejsu API.

Funkcje Gemini Code Assist udostępniamy na różnych kanałach wersji. Każdy projekt Google Cloud możesz ustawić na jeden kanał wersji w zależności od wybranej równowagi między dostępnością funkcji a stabilnością. Użytkownicy w organizacji, którzy korzystają z Gemini Code Assist w lokalnym środowisku IDE, mogą używać funkcji i modeli na podstawie kanału wersji skonfigurowanego dla projektu.

Dostępne są te kanały wersji:

  • Ogólnie dostępne. Domyślny kanał wersji. Umożliwia korzystanie z ogólnodostępnych modeli i funkcji. Pamiętaj, że do niektórych funkcji w wersji przedpremierowej można uzyskać dostęp bez rejestracji w kanale wersji przedpremierowej, korzystając z alternatywnych mechanizmów rejestracji. Te funkcje będą dostępne w kanale GA, ale nadal będą objęte Warunkami ofert przed GA.

  • Podgląd Umożliwia dostęp do niektórych funkcji w wersji testowej Gemini Code Assist oraz opcjonalne przesyłanie opinii i danych o korzystaniu, które pomogą Google ulepszać przyszłe wersje. Pamiętaj, że obecnie w kanale wersji testowej nie ma żadnych odrębnych funkcji.

    Włączając kanał wersji testowych w projekcie, potwierdzasz w imieniu klienta, że całkowite wykorzystanie Gemini Code Assist w tym projekcie podlega warunkom oferty przed GA ujętym w szczegółowych warunkach korzystania z usługi Google Cloud Platform. Nie używaj tego kanału w przypadku projektów i zasobów, które nie mogą korzystać z ofert przed GA.

W sekcjach poniżej znajdziesz instrukcje, jak ustawić lub zmienić kanał wersji Gemini Code Assist.

Zanim zaczniesz

Wymagane role

Aby utworzyć ustawienia i powiązania, które kontrolują kanał wersji, poproś administratora o przypisanie Ci w projekcie roli Administrator ustawień Gemini for Google Cloud (roles/cloudaicompanion.settingsAdmin).

Aby sprawdzić, jakie uprawnienia są wymagane, rozwiń sekcję Wymagane uprawnienia:

Wymagane uprawnienia

  • cloudaicompanion.releaseChannelSettings.create
  • cloudaicompanion.releaseChannelSettings.delete
  • cloudaicompanion.releaseChannelSettings.get
  • cloudaicompanion.releaseChannelSettings.list
  • cloudaicompanion.releaseChannelSettings.update
  • cloudaicompanion.dataSharingWithGoogleSettings.create
  • Konfigurowanie kanałów wersji za pomocą interfejsu API:
    • cloudaicompanion.settingBindings.releaseChannelSettingsCreate
    • cloudaicompanion.settingBindings.releaseChannelSettingsDelete
    • cloudaicompanion.settingBindings.releaseChannelSettingsGet
    • cloudaicompanion.settingBindings.releaseChannelSettingsList
    • cloudaicompanion.settingBindings.releaseChannelSettingsUpdate
    • cloudaicompanion.settingBindings.releaseChannelSettingsUse
  • Skonfiguruj udostępnianie promptów i odpowiedzi za pomocą interfejsu API:
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
  • Wyświetlanie ustawień administratora Gemini w Google Cloud:
    • cloudaicompanion.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings

Konfigurowanie kanałów wersji Gemini Code Assist

Wybierz jedną z tych opcji:

Konsola

  1. W konsoli Google Cloud otwórz stronę Administrator Gemini.

    Otwórz Gemini w Google Cloud

    Otworzy się strona Gemini w Google Cloud.

  2. Kliknij Ustawienia w menu nawigacyjnym.

    Wczytuje się strona Ustawienia.

  3. W sekcji Kanały wersji dla Gemini Code Assist w lokalnych środowiskach IDE wybierz kanał wersji, który najlepiej odpowiada Twoim potrzebom:

    Podgląd

    1. Wybierz Podgląd.
    2. Sprawdź szczegóły kanału wersji przedpremierowej i warunki programu zaufanych testerów, a potem kliknij Zapisz zmiany.

    Ogólnie dostępne

    1. Wybierz GA.
    2. Kliknij Zapisz zmiany.

Interfejs API

  1. Utwórz ustawienie kanału wersji i wartość specyficzną dla tego ustawienia:

    1. Uzyskaj token uwierzytelniania. Aby go uzyskać, musisz się uwierzytelnić za pomocą uwierzytelniania gcloud:

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

    2. Utwórz ustawienie. W tych instrukcjach do wywoływania metod interfejsu API używamy znaku 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"

      Zastąp następujące elementy:

      • RELEASE_CHANNEL: kanał wersji, czyli EXPERIMENTAL w przypadku wersji podglądowej lub STABLE w przypadku wersji ogólnodostępnej.
      • CONTAINER_PROJECT_NAME: identyfikator projektu, w którym jest przechowywany zasób powiązania. Jest to projekt nadrzędny powiązania.
      • RC_SETTING_ID: unikalna nazwa ustawienia, np. rc1 w przypadku Release Channel.

      Dane wyjściowe pokazują, że releaseChannel jest ustawione na 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. Utwórz powiązanie ustawienia kanału wersji:

        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"

      Zastąp następujące elementy:

      • TARGET_PROJECT_NAME: projekt docelowy, z którym ma być powiązane powiązanie. Często jest to ten sam projekt co projekt kontenera. Możesz jednak powiązać ustawienie z wieloma projektami, aby nie trzeba było duplikować zasobu ustawienia.
      • CONTAINER_PROJECT_NAME: identyfikator projektu, w którym jest przechowywany zasób powiązania. Jest to projekt nadrzędny powiązania.
      • RC_SETTING_ID: ten sam adres RC_SETTING_ID, którego użyto podczas tworzenia ustawienia, ale z dodanym na końcu ciągiem b1. Na przykład użyj elementu rc1b1 dla elementu Release Channel.
      • RC_BINDING_ID: unikalną nazwę powiązania ustawień, np. rc_binding.

      Dane wyjściowe zawierają metadane operacji w tym formacie:

      {
  "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. Opcjonalnie: sprawdź stan tworzenia powiązania ustawienia kanału wersji:

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

      Zastąp następujące elementy:

      • CONTAINER_PROJECT_NAME: identyfikator projektu, w którym jest przechowywany zasób powiązania. Jest to projekt nadrzędny powiązania.
      • RC_BINDING_OPERATION_ID: identyfikator operacji tworzenia powiązania ustawienia kanału wersji podany w odpowiedzi w poprzednim kroku.

  2. Opcjonalnie: utwórz ustawienie udostępniania promptów i odpowiedzi oraz wartość specyficzną dla ustawienia:

    1. Uzyskaj token:

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

    2. Utwórz ustawienie:

      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"

      Zastąp następujące elementy:

      • CONTAINER_PROJECT_NAME: identyfikator projektu nadrzędnego
      • DSWG_SETTING_ID: unikalna nazwa ustawienia, np. dswg1 w przypadku Data Sharing with Google.

      Dane wyjściowe pokazują, że enablePreviewDataSharing jest ustawione na 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. Utwórz powiązanie ustawień prompta i odpowiedzi:

        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"

      Zastąp następujące elementy:

      • TARGET_PROJECT_NAME: projekt docelowy, do którego ma zostać zastosowane ustawienie.
      • CONTAINER_PROJECT_NAME: identyfikator projektu nadrzędnego.
      • DSWG_SETTING_ID: ten sam adres DSWG_SETTING_ID, którego użyto podczas tworzenia ustawienia, ale z dodanym na końcu ciągiem b1. Na przykład użyj elementu dswg1b1 dla elementu Data Sharing with Google.
      • DSWG_BINDING_ID: unikalną nazwę powiązania ustawień, np. dswg_binding.

      Dane wyjściowe zawierają metadane operacji w tym formacie:

      {
"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. Opcjonalnie: sprawdź stan tworzenia powiązania ustawień promptu i odpowiedzi:

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

      Zastąp następujące elementy:

      • CONTAINER_PROJECT_NAME: identyfikator projektu, w którym jest przechowywany zasób powiązania. Jest to projekt nadrzędny powiązania.
      • DSWG_BINDING_OPERATION_ID: identyfikator operacji tworzenia powiązania ustawień prompta i odpowiedzi podany w odpowiedzi w poprzednim kroku.