Настройка 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 лицензий.
    • Период подписки (ежемесячная или годовая). При годовой подписке вам предоставляется скидка, которая взимается ежемесячно, а не единовременно.

    По умолчанию для новых подписок настраивается автоматическое назначение лицензий. Пользователю в вашей организации автоматически назначается лицензия при использовании 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 для 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, пока вы не активируете ее хотя бы в одном проекте.

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

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

Консоль

  1. Чтобы включить API Gemini для Google Cloud, перейдите на страницу Gemini для Google Cloud .

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

  2. В селекторе проектов выберите проект.

  3. Нажмите «Включить» .

    Страница обновится и отобразит статус «Включено» . Теперь Gemini доступен в выбранном облачном проекте всем пользователям с необходимыми ролями IAM.

gcloud

Чтобы использовать локальную среду разработки, установите и инициализируйте gcloud CLI.

  1. В меню выбора проектов выберите проект.

  2. Включите API Gemini для Google Cloud для Gemini с помощью команды gcloud services enable :

    gcloud services enable cloudaicompanion.googleapis.com

    Если вы хотите включить API Gemini для Google Cloud в другом проекте Cloud, добавьте параметр --project :

    gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID

    Замените PROJECT_ID на идентификатор вашего облачного проекта.

    Вывод будет аналогичен следующему:

    Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.

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, у вас есть несколько вариантов:

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

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

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

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

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

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

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

Консоль

  1. Чтобы предоставить роли IAM, необходимые для использования Gemini, перейдите на страницу IAM и администрирование .

    Перейти к IAM и администрированию

  2. Нажмите Предоставить доступ , а затем введите имя участника , которому вы хотите предоставить доступ к Gemini.

  3. На панели «Предоставить доступ» нажмите кнопку Добавить еще одну роль» .

  4. В разделе Назначить роли выберите Gemini для пользователя Google Cloud .

  5. Нажмите Добавить роли и выберите Потребитель использования услуг .

  6. Нажмите « Сохранить ».

gcloud

Чтобы использовать локальную среду разработки, установите и инициализируйте gcloud CLI.

  1. В меню выбора проектов выберите проект.

  2. Предоставьте роль пользователя Gemini для Google Cloud:

    gcloud projects add-iam-policy-binding PROJECT_ID \
  --member=PRINCIPAL --role=roles/cloudaicompanion.user

    Заменить следующее:

    • PROJECT_ID : идентификатор вашего облачного проекта, например, 1234567890 .
    • PRINCIPAL : идентификатор принципала, например, user:cloudysanfrancisco@gmail.com .

    Результатом является список привязок политик, включающий следующее:

    - members:
  - user:PRINCIPAL
  role: roles/cloudaicompanion.user

  3. Повторите предыдущий шаг для роли roles/serviceusage.serviceUsageConsumer .

Дополнительные сведения см. в разделах Предоставление одной роли и gcloud projects add-iam-policy-binding .

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

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

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

VS Код

  1. Чтобы открыть представление «Расширения» в VS Code, щелкните Значок расширения Расширения или нажмите Ctrl / Cmd + Shift + X

  2. Найдите Gemini Code Assist .

  3. Нажмите «Установить» .

  4. При появлении соответствующего запроса перезапустите VS Code.

    После успешной установки расширения Gemini Code Assist появится на панели действий и будет готов к использованию. Вы можете дополнительно настроить установку Gemini Code Assist, указав свои предпочтения на панели задач приложения: перейдите в Code > Settings > Settings > Extensions и найдите Gemini Code Assist .

IntelliJ

  1. Нажмите settings IDE и Настройки проекта > Плагины .
  2. На вкладке «Маркетплейс» найдите Gemini Code Assist .
  3. Нажмите «Установить» , чтобы установить плагин.
  4. После завершения установки нажмите кнопку «Перезапустить IDE» .

  5. После перезапуска IDE на панели действий появится Gemini Code Assist.

    На панели действий появится значок Gemini Code Assist.

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

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

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

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

Окна

  • %LOCALAPPDATA%/cloud-code
  • %LOCALAPPDATA%/google-vscode-extension

macOS

  • ~/Library/Application Support/cloud-code
  • ~/Library/Application Support/google-vscode-extension

Линукс

  • ~/.cache/cloud-code
  • ~/.cache/google-vscode-extension

Войдите в Google и выберите проект Google Cloud.

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

VS Код

Если вы выберете проект Google Cloud, в котором не включен API Gemini для Google Cloud, вы получите уведомление с возможностью включения API из IDE. Выберите «Включить API» в окне уведомления, чтобы включить API для вашего проекта.

Если вы предпочитаете следовать пошаговому руководству по использованию Gemini Code Assist непосредственно в вашей IDE, нажмите «Запустить VS Code» и выполните действия, описанные в руководстве, чтобы подключиться к Google Cloud и активировать Gemini Code Assist Standard или Enterprise.

Запуск VS Code

В противном случае выполните следующие действия:

  1. Запустите IDE.

  2. На панели действий нажмите Gemini Code Assist .

  3. На панели чата Gemini Code Assist нажмите Войти в Google Cloud .

  4. При появлении запроса на разрешение Gemini Code Assist открыть внешний веб-сайт нажмите «Открыть» .

  5. Следуйте инструкциям, чтобы войти в свою учетную запись Google.

  6. На вопрос, загрузили ли вы Gemini Code Assist с сайта Google, нажмите «Войти» .

    Теперь вы подключены к Google Cloud.

    Затем, чтобы выбрать проект Google Cloud, в котором включен API Gemini для Google Cloud, выполните следующие действия:

  7. В строке состояния Gemini Code Assist нажмите Gemini Code Assist .

    Доступна строка состояния Gemini.

  8. В меню Gemini Code Assist выберите Выбрать проект Gemini Code .

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

    Gemini Code Assist Standard или Enterprise готов к использованию.

    Значок Gemini в строке состояния установлен в обычное состояние.

IntelliJ

Чтобы войти в свою учетную запись Google, выполните следующие действия:

  1. На панели действий нажмите spark Gemini Code Assist .

  2. Нажмите «Войти в Google» . Вы также можете нажать «Копировать ссылку» и вставить URL-адрес в адресную строку браузера.

  3. На открывшейся странице веб-браузера выберите свою учетную запись Google.

  4. На экране, на котором вам будет предложено убедиться, что вы загрузили это приложение из Google, нажмите кнопку Войти .

    Теперь Gemini Code Assist имеет право доступа к вашей учетной записи.

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

  5. Вернитесь в свою IDE. В окне инструментов Gemini Code Assist, если вы согласны разрешить Google включить API, необходимые для использования Gemini Code Assist от вашего имени для выбранного вами проекта, нажмите «Выбрать проект GCP» , чтобы продолжить.

  6. В диалоговом окне «Выбор проекта Google Cloud» найдите и выберите свой проект Google Cloud, а затем нажмите кнопку «ОК» .

  7. Нажмите кнопку ГОТОВО .

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

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

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

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

Вместо использования консоли Google Cloud или 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 в разных каналах релизов: Generally Available (общедоступный) и Preview (предварительное тестирование). При настройке Gemini Code Assist ваш проект автоматически переводится в канал Generally Available.

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

Что дальше?