Настройка 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 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 уже существует для учетной записи выставления счетов, связанной с проектом, эта кнопка отображается как Manage Gemini Code Assist и позволяет вам редактировать вашу подписку .

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

  3. В Select Gemini Code Assist subscription Edition выберите издание Gemini Code Assist. Выберите Compare Gemini Code Assist Editions, чтобы увидеть подробный список функций, доступных для каждого издания .

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

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

    • Название подписки.
    • Количество лицензий в подписке. Обратите внимание, что если вы покупаете Enterprise edition, то вам необходимо приобрести не менее 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 Console, у вас должны быть следующие разрешения для учетной записи выставления счетов:

  • 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 — это список учетных записей пользователей, разделенных запятыми, которым назначается лицензия. Например, "dana@example.com", "lee@example.com" .

  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 доступен в выбранном проекте Cloud всем пользователям, имеющим требуемые роли 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 в API Console в указанном проекте. Для получения дополнительной информации см. Обзор Gemini for 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, указав свои предпочтения с помощью панели задач приложения верхнего уровня: перейдите в 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.

Код 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. В окне инструмента 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!

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

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

Что дальше?