Настройка 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 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 в течение первого месяца.

Консоль

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

  • billing.accounts.get
  • billing.accounts.list
  • consumerprocurement.orders.get
  • consumerprocurement.orders.list
  • consumerprocurement.orders.modify
  • consumerprocurement.orders.place
  • consumerprocurement.licensePools.enumerateLicensedUsers
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.update
  • consumerprocurement.licensePools.assign
  • consumerprocurement.licensePools.unassign

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

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

  2. Выберите подписку, которую вы хотите изменить, а затем нажмите Изменить подписку .

  3. Нажмите «Назначить лицензии» . Откроется диалоговое окно выбора пользователя. Чтобы найти нужного пользователя, введите его имя в поле поиска.

  4. Выберите одного или нескольких пользователей из списка, а затем нажмите кнопку Далее .

  5. Выберите сервисы Gemini, на которые вы хотите назначить лицензии.

  6. Нажмите Назначить лицензии .

API

Для назначения лицензий Gemini с помощью API используйте метод billingAccounts.orders.licensePool.assign .

  1. Убедитесь, что у вас есть разрешение consumerprocurement.licensePools.assign на управление идентификацией и доступом в учетной записи выставления счетов, содержащей пул лицензий, лицензию которого вы собираетесь назначить.

  2. Создайте JSON-файл, содержащий следующую информацию:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    Где USER_EMAILS — это список учётных записей пользователей, которым назначена лицензия, разделённый запятыми. Например, "[email protected]", "[email protected]" .

  3. Используйте cURL для вызова метода:

    curl -X POST --data-binary @JSON_FILE_NAME \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json" \
  "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/"

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

    • JSON_FILE_NAME : путь к JSON-файлу, созданному на шаге 2.
    • PROJECT_ID : идентификатор проекта. К этому проекту применяются квота и плата, связанная с запросом API.
    • BILLING_ACCOUNT_ID : идентификатор учетной записи для выставления счетов, связанной с пулом лицензий.
    • ORDER_ID : идентификатор заказа. Если вы не знаете идентификатор заказа, вы можете узнать его, перечислив заказы, связанные с вашим платежным аккаунтом .

В случае успеха ответ будет примерно следующим:

  {}

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

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

В этом разделе описываются шаги, необходимые для включения 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:[email protected] .

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

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

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

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

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

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

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

VS Код

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

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

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

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

    После успешной установки расширения Gemini Code Assist появится на панели задач и будет готов к использованию. Вы можете настроить установку Gemini Code Assist, указав свои параметры на панели задач верхнего уровня: перейдите в раздел «Код» > «Настройки» > «Настройки» > «Расширения» и найдите 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.

VS Код

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

Если вы предпочитаете следовать пошаговому руководству по написанию кода с помощью 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 .

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

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

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

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

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

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

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

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

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

Вместо использования 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, в котором вы назначили каждое разрешение.

Что дальше?