Настройка Gemini Code Assist Standard и Enterprise

Прежде чем вы сможете использовать Gemini Code Assist Standard или Enterprise, вашей команде необходимо выполнить шаги по настройке, описанные в этом документе:

1. Приобретите подписку на Gemini Code Assist Standard или Enterprise .

2. Назначьте лицензии пользователям в вашей организации .

3. Включите API Gemini для Google Cloud в проекте Google Cloud .

4. Предоставление ролей в управлении идентификацией и доступом в проекте Google Cloud .

5. Пользователи вашей организации устанавливают плагин Gemini Code Assist , чтобы использовать Gemini Code Assist Standard или Enterprise в IDE. Этот шаг не требуется для пользователей Gemini CLI или Gemini в Android Studio .

Приобретите подписку Gemini Code Assist

Список функций, доступных в каждой редакции, см. в разделе «Поддерживаемые функции» .

Для новых клиентов Gemini Code Assist, чьи платежные аккаунты ранее не имели подписки на Gemini Code Assist, мы автоматически начисляем кредиты, эквивалентные до 50 бесплатным лицензиям, на первый месяц, независимо от версии Gemini Code Assist . Обратите внимание, что после начисления первоначального количества бесплатных лицензий увеличить количество кредитов нельзя. Кроме того, в течение первого месяца изменить версию Gemini Code Assist нельзя.

Если у вас уже есть договоры с Google Cloud, свяжитесь с нашим отделом продаж, прежде чем приобретать подписку.

1. Перейдите на страницу администратора Gemini .

   Перейдите в раздел "Администрирование" для Gemini.

   Открывается страница администрирования Gemini .

2. Выберите «Получить помощь с кодом Gemini» .

   Обратите внимание, что если у вас нет необходимых прав доступа consumerprocurement.orders.place , эта кнопка будет недоступна. Если для учетной записи, связанной с проектом, уже существует подписка на Gemini Code Assist, эта кнопка будет отображаться как «Управление Gemini Code Assist» и позволит вам редактировать вашу подписку .

   Открывается страница подписки Get Gemini Code Assist .

3. В разделе «Выберите версию подписки Gemini Code Assist» выберите версию Gemini Code Assist. Выберите «Сравнить версии Gemini Code Assist» , чтобы увидеть подробный список функций, доступных в каждой версии .

   Затем выберите «Продолжить» .

4. В разделе «Настройка подписки» заполните поля для настройки подписки, включая следующие:

   • Название подписки.
   • Количество лицензий в подписке. Обратите внимание, что при покупке корпоративной версии необходимо приобрести не менее 10 лицензий.
   • Период подписки (ежемесячная или годовая). При годовой подписке предоставляется скидка, оплата производится ежемесячно, а не единовременно.

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

   • Пользователь выбрал проект, связанный с платежным аккаунтом подписки.
   • У пользователя есть разрешение IAM cloudaicompanion.licences.selfAssign для выбранного проекта.

   После настройки Gemini Code Assist вы можете назначить лицензии вручную .

5. Для подтверждения подписки выберите «Продолжить» .

6. Если вы согласны с условиями, выберите «Я согласен с условиями этой покупки» , а затем выберите «Подтвердить подписку» .

7. Выберите Далее: Управление назначениями лицензий Gemini .

Теперь подписка приобретается для Gemini Code Assist Standard или Enterprise. Вам необходимо управлять назначением лицензий Gemini в вашей организации.

Назначить лицензии

Перед использованием лицензии Gemini Code Assist пользователи должны иметь роль пользователя Gemini for Google Cloud или аналогичные права доступа в проекте, где API уже включен.

Для новых клиентов Gemini Code Assist, чьи платежные аккаунты ранее не имели подписки на Gemini Code Assist, мы автоматически начисляем кредиты, эквивалентные до 50 бесплатным лицензиям, на первый месяц, независимо от версии Gemini Code Assist . Обратите внимание, что после начисления первоначального количества бесплатных лицензий увеличить количество кредитов нельзя. Кроме того, в течение первого месяца изменить версию Gemini Code Assist нельзя.

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

• Пользователь выбрал проект, связанный с платежным аккаунтом подписки.
• У пользователя есть разрешение IAM cloudaicompanion.licences.selfAssign для выбранного проекта.

Если лицензия неактивна в течение 30 дней, она будет автоматически назначена другому пользователю в вашей организации, отвечающему указанным выше условиям.

Когда все доступные лицензии в подписке будут распределены, пользователи, пытающиеся получить доступ к Gemini Code Assist без лицензии, получат сообщение об ошибке, указывающее на необходимость её наличия.

После настройки Gemini Code Assist вы можете просмотреть назначенные лицензии, перейдя на страницу «Администрирование Gemini» , выбрав свой платежный аккаунт, нажав «Управление подпиской Gemini Code Assist» , а затем выбрав вкладку «Управление лицензиями» . Если вам требуется более точный контроль над назначением лицензий, вы также можете использовать эту вкладку для переключения с автоматического управления лицензиями на ручное управление лицензиями .

API Gemini для Google Cloud должен быть включен в одном или нескольких проектах, связанных с этим платежным аккаунтом. Пользователи не увидят функцию Gemini Code Assist, пока вы не активируете ее хотя бы в одном проекте.

Включите Gemini для Google Cloud API в облачном проекте.

В этом разделе описаны шаги, необходимые для включения API Gemini для Google Cloud в облачном проекте. Для работы Gemini Code Assist требуется облачный проект для управления доступом к API, квотами и выставлением счетов. Поэтому перед тем, как пользователи смогут получить доступ к Gemini Code Assist, необходимо включить API Gemini для Google Cloud в выбранном вами облачном проекте.

Теперь Gemini для Google Cloud доступен в указанном облачном проекте всем пользователям, имеющим необходимые роли IAM .

Настройте брандмауэр для API-трафика между вашей IDE и Google.

Помимо включения Gemini для Google Cloud, пользователям за брандмауэрами также необходимо разрешить прохождение трафика для следующих API:

• oauth2.googleapis.com : используется для входа в Google Cloud.
• serviceusage.googleapis.com : используется для проверки правильности настройки проекта Gemini Code Assist пользователя.
• cloudaicompanion.googleapis.com : основная конечная точка Gemini для Google Cloud API.
• cloudcode-pa.googleapis.com : внутренний API, предоставляющий функции, связанные с IDE.
• cloudresourcemanager.googleapis.com : используется в IDE для выбора проектов. API Resource Manager может не потребоваться, если проекты явно настроены в файле settings.json .
• people.googleapis.com : предоставляет доступ к информации о профилях и контактах.
• firebaselogging-pa.googleapis.com : внутренний API, используемый для отправки телеметрии продукта, включая события о том, были ли приняты предложения.
• feedback-pa.googleapis.com : внутренний API, используемый для отправки отзывов непосредственно в IDE.
• apihub.googleapis.com : используется функцией браузера Cloud Code API.
• lh3.googleusercontent.com и lh5.googleusercontent.com : используются для получения фотографий пользователей.

Определение IP-адресов для доменов по умолчанию Google Cloud

Для обеспечения возможности подключения вашей IDE к API Google Cloud ваш брандмауэр должен разрешать исходящий TCP-трафик к общедоступным диапазонам IP-адресов Google. Эти диапазоны динамически управляются Google.

Для ведения списка диапазонов IP-адресов для доступа к доменам Google Cloud у вас есть несколько вариантов:

• Используйте наши опубликованные списки или автоматизируйте скрипт для получения диапазонов IP-адресов Google .
• Используйте виртуальный IP-адрес private.googleapis.com .
• Используйте Private Service Connect .

Необязательно: Настройка элементов управления службами VPC.

Если ваша организация имеет периметр обслуживания, то вам необходимо добавить к нему следующие ресурсы:

• Gemini для Google Cloud API
• API Gemini Code Assist

Если вы используете Gemini Code Assist Standard или Enterprise за пределами вашей зоны действия сервиса, вам также необходимо изменить политику входящего трафика, чтобы разрешить доступ к этим сервисам.

Для получения дополнительной информации см. раздел «Настройка элементов управления службами VPC для Gemini» .

Предоставление ролей IAM в проекте Google Cloud

В этом разделе описаны шаги, необходимые для предоставления пользователям ролей IAM «Пользователь Gemini for Google Cloud» и «Потребитель использования сервисов».

Все пользователи, которым предоставлены эти роли, могут получить доступ к функциям Gemini for Google Cloud в консоли Google Cloud в рамках указанного проекта. Для получения дополнительной информации см. обзор Gemini for Google Cloud .

Установите плагин Gemini Code Assist.

Пользователи вашей организации устанавливают плагин Gemini Code Assist в предпочитаемую ими поддерживаемую IDE . Пользователям поддерживаемых IDE JetBrains следует следовать инструкциям для IntelliJ.

Теперь пользователи готовы использовать Gemini Code Assist Standard или Enterprise в своей IDE. Узнайте больше о поддерживаемых функциях:

• Обзор возможностей кода
• Обзор функций чата

Начните с ознакомления со следующими руководствами:

• Программируйте с помощью Gemini Code Assist
• Пообщайтесь с Gemini Code Assist

Список каталогов, в которых Gemini Code Assist кэширует информацию.

В таблице ниже приведен список каталогов, в которых Gemini Code Assist хранит информацию о расширениях, такую ​​как токены аутентификации:

Войдите в свою учетную запись Google и выберите проект Google Cloud.

После установки Gemini Code Assist в свои IDE пользователям необходимо войти в свои учетные записи Google, и если они впервые используют Gemini Code Assist Standard или Enterprise в своей IDE, им нужно выбрать проект Google Cloud. Это тот же проект, который использовался для настройки Gemini Code Assist, и он используется для управления доступом к API, квотами и выставлением счетов.

Ваш проект Google Cloud выбран, и API Gemini Code Assist включен. Вы готовы использовать Gemini Code Assist Standard или Enterprise в своей IDE!

Расширенные задачи настройки

В следующих разделах описаны расширенные задачи настройки, которые вы можете выполнить для персонализации Gemini Code Assist.

Расширенные аспекты управления идентификацией и доступом (IAM)

Вместо использования консоли Google Cloud или gcloud для предоставления предопределенных ролей IAM, вы можете сделать следующее:

• Для предоставления ролей используйте REST API IAM или клиентские библиотеки IAM .

  При использовании этих интерфейсов используйте полные имена ролей:

  • roles/cloudaicompanion.user
  • roles/serviceusage.serviceUsageConsumer

  Для получения дополнительной информации о предоставлении ролей см. раздел «Управление доступом к проектам, папкам и организациям» .

• Создавайте и предоставляйте пользовательские роли.

  Для доступа к Gemini Code Assist Standard и Enterprise любым созданным вами пользовательским ролям необходимы следующие разрешения:

  • cloudaicompanion.companions.generateChat
  • cloudaicompanion.companions.generateCode
  • cloudaicompanion.instances.completeCode
  • cloudaicompanion.instances.completeTask
  • cloudaicompanion.instances.generateCode
  • cloudaicompanion.instances.generateText
  • cloudaicompanion.instances.exportMetrics
  • cloudaicompanion.instances.queryEffectiveSetting
  • cloudaicompanion.instances.queryEffectiveSettingBindings
  • serviceusage.services.enable

• Назначение и управление лицензиями.

  Для назначения и управления лицензиями Gemini Code Assist любым создаваемым вами пользовательским ролям необходимы следующие разрешения:

  • consumerprocurement.orders.get
  • consumerprocurement.orders.licensePools.*
  • consumerprocurement.orders.licensePools.update
  • consumerprocurement.orders.licensePools.get
  • consumerprocurement.orders.licensePools.assign
  • consumerprocurement.orders.licensePools.unassign
  • consumerprocurement.orders.licensePools.enumerateLicensedUsers

Также обратите внимание, что для корректной работы любого из вышеперечисленных разрешений необходимо включить Gemini for Google Cloud API в том же проекте Google Cloud, где вы назначили каждое из этих разрешений.

Изменить канал выпуска проекта Google Cloud

Мы выпускаем функции Gemini Code Assist в разных каналах релизов: Generally Available (общедоступный) и Preview (предварительное тестирование). При настройке Gemini Code Assist ваш проект автоматически переводится в канал Generally Available.

Вы можете в любой момент изменить канал выпуска Gemini Code Assist с канала предварительного просмотра на канал предварительного просмотра или обратно на канал общедоступной версии.

Что дальше?

• Узнайте больше о типах генеративной помощи на основе ИИ, доступных в Gemini для Google Cloud .
• Узнайте, как Gemini для Google Cloud использует ваши данные .
• Узнайте , как получить доступ к элементам управления администратора Gemini Code Assist Standard и Enterprise и управлять ими .
• Узнайте , как настроить персонализацию кода для Gemini Code Assist Enterprise.
• Настройка элементов управления службами VPC для Gemini Code Assist Standard и Enterprise .