Настройка 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. Выберите Get Gemini Code Assist .

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

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

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

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

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

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

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

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

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

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

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

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

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

По умолчанию для новых подписок требуется вручную назначать лицензии. После настройки вы сможете выбрать, как назначать лицензии: вручную или автоматически.

  {}

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

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

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

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

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

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

• oauth2.googleapis.com : используется для входа в Google Cloud.
• serviceusage.googleapis.com : используется для проверки правильности настройки проекта Gemini Code Assist пользователя.
• cloudaicompanion.googleapis.com : основная конечная точка API Gemini для Google Cloud.
• 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 для Google Cloud в API-консоли указанного проекта. Подробнее см. в обзоре Gemini для 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.

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

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

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

Расширенные соображения IAM

Вместо использования API Console или gcloud для предоставления предопределенных ролей IAM вы можете выполнить любое из следующих действий:

• Для назначения ролей используйте IAM REST API или клиентские библиотеки 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

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

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

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

Вы можете в любое время изменить канал выпуска Gemini Code Assist на канал Preview или обратно на канал Generally Available.

Что дальше?

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