Настройка каналов выпуска Gemini Code Assist

В этом документе описывается, как настроить каналы выпуска Gemini Code Assist для проекта с помощью Google API Console или API.

Мы выпускаем функции Gemini Code Assist через разные каналы выпуска. Вы можете выбрать для каждого проекта Google Cloud один канал выпуска в зависимости от выбранного баланса между доступностью функций и стабильностью. Пользователи вашей организации, использующие Gemini Code Assist в своей локальной IDE, могут использовать функции и модели в зависимости от канала выпуска, настроенного для проекта.

Доступны следующие каналы релиза:

  • Доступно всем. Канал выпуска по умолчанию. Позволяет использовать общедоступные модели и функции. Обратите внимание, что доступ к некоторым функциям предварительной версии возможен без регистрации в канале предварительной версии, используя альтернативные механизмы регистрации. Эти функции будут доступны в канале общей версии, но по-прежнему подпадают под действие условий предложения предварительной версии.

  • Предварительная версия. Позволяет получить доступ к некоторым функциям предварительной версии Gemini Code Assist и, при необходимости, отправлять отзывы и данные об использовании , чтобы помочь Google улучшить будущие версии. Обратите внимание, что в настоящее время в предварительной версии нет отдельных функций.

    При включении канала предварительной версии для проекта вы от имени клиента соглашаетесь с тем, что любое использование Gemini Code Assist в этом проекте регулируется Условиями предоставления услуг Pre-GA , изложенными в Условиях предоставления услуг Google Cloud Platform . Не используйте этот канал для проектов и ресурсов, которые не подходят для использования с предложениями Pre-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 перейдите на страницу «Администрирование Gemini» .

    Перейти на Gemini для Google Cloud

    Загрузится страница Gemini для Google Cloud .

  2. Нажмите «Настройки» в меню навигации.

    Загрузится страница настроек .

  3. В разделе «Каналы выпуска Gemini Code Assist в локальных IDE» выберите канал выпуска, который лучше всего соответствует вашим потребностям:

    Предварительный просмотр

    1. Выберите Предварительный просмотр .
    2. Ознакомьтесь со сведениями о канале выпуска предварительной версии и условиями программы Trusted Tester, а затем нажмите кнопку Сохранить изменения .

    Доступно всем

    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 для общедоступной версии.
      • 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 : идентификатор операции создания привязки параметров подсказки и ответа, предоставленный в ответе на предыдущем шаге.