Настройка Gemini Code Assist (стандартный и Enterprise)

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

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

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

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

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

  5. Пользователи вашей организации устанавливают плагин Gemini Code Assist , чтобы использовать Gemini Code Assist в IDE.

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

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

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

Gemini Code Assist Enterprise доступен по цене 19 долларов США в месяц за пользователя при 12-месячном контракте до 31 марта 2025 г. Свяжитесь с нашим отделом продаж, чтобы воспользоваться этим рекламным предложением.

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

  1. Перейдите на страницу Gemini для Google Cloud .

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

    Откроется страница Gemini для Google Cloud .

  2. Выберите «Получить помощь по коду Gemini» . Обратите внимание: если в вашей учетной записи для выставления счетов не была приобретена подписка Gemini Code Assist, появится сообщение о том, что имеется право на 30-дневную пробную версию для 50 лицензий бесплатно . Если в вашем проекте уже есть Gemini Code Assist, этот текст будет отображать «Управление Gemini Code Assist» .

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

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

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

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

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

  5. Чтобы подтвердить подписку, выберите Продолжить .

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

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

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

Назначение лицензий

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

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

Консоль API

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

  • billing.accounts.get
  • consumerprocurement.orders.get
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.enumerateLicensedUsers
  • consumerprocurement.licensePools.assign

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

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

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

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

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

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

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

Чтобы назначить лицензии Gemini с помощью API, у вас должно быть разрешение consumerprocurement.licensePools.assign .

HTTP-метод: POST

URL-адрес: https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/ BILLING_ACCOUNT_ID /orders/ ORDER_ID /licensePool:assign/

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

  • BILLING_ACCOUNT_ID : идентификатор платежного аккаунта.
  • ORDER_ID : политика IAM.

Тело запроса:

    {
        "usernames": [
                  "dana@example.com",
                  "lee@example.com"
        ]
    }

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

{}

Ответ пуст, если лицензия успешно назначена.

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

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

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

Консоль gcloud

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

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

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

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

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

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

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

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

    gcloud services enable cloudaicompanion.googleapis.com

    Если вы хотите включить Gemini для Google Cloud API в другом облачном проекте, добавьте параметр --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 для пользователей за брандмауэрами

Помимо включения 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.

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

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

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

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

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

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

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

Консоль gcloud

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

    Зайдите в IAM и администратор.

  2. В столбце «Основной» найдите принципала , которому вы хотите предоставить доступ к Gemini, а затем нажмите принципала» в этой строке.

  3. На панели «Изменить доступ » нажмите другую роль» .

  4. В разделе «Выбор роли » выберите «Близнецы» для пользователя Google Cloud .

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

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

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

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

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

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

    Замените PRINCIPAL идентификатором принципала. Идентификатор принимает форму user|group|serviceAccount:email или domain:domain — например, user:cloudysanfrancisco@gmail.com , group:admins@example.com , serviceAccount:test123@example.domain.com или domain:example.domain.com .

    Выходные данные представляют собой список привязок политик, который включает в себя следующее:

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

  3. Предоставьте роль потребителя использования службы:

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

    Выходные данные представляют собой список привязок политик, который включает в себя следующее:

    - members:
  - user:PRINCIPAL
  role: roles/serviceusage.serviceUsageConsumer

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

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

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

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

По умолчанию Gemini Code Assist включен в следующие IDE:

Задачи расширенной настройки

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

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

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

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

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

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

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

    • cloudaicompanion.companions.generateChat
    • cloudaicompanion.companions.generateCode
    • cloudaicompanion.instances.completeCode
    • cloudaicompanion.instances.completeTask
    • cloudaicompanion.instances.generateCode
    • cloudaicompanion.instances.generateText
    • 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, которому вы назначили каждое разрешение.

Что дальше