Konfigurowanie Gemini Code Assist (wersja Standard i Enterprise)

Zanim zaczniesz korzystać z Gemini Code Assist, Twój zespół musi wykonać czynności konfiguracyjne opisane w tym dokumencie:

  1. Kup subskrypcję Gemini Code Assist.

  2. Przypisz licencje poszczególnym użytkownikom w organizacji.

  3. Włącz interfejs Gemini for Google Cloud API w projekcie Google Cloud.

  4. Przypisz role usługi Identity and Access Management w projekcie Google Cloud.

  5. Użytkownicy organizacji instalują wtyczkę Gemini Code Assist, aby korzystać z Gemini Code Assist w IDE.

Kup subskrypcję Gemini Code Assist

Listę funkcji dostępnych w poszczególnych wersjach znajdziesz w artykule Obsługiwane funkcje.

W przypadku nowych klientów Gemini Code Assist, którzy mają konta rozliczeniowe, na których nie było wcześniej subskrypcji Gemini Code Assist, automatycznie stosujemy środki równe maksymalnie 50 bezpłatnych licencji na pierwszy miesiąc, niezależnie od wersji Gemini Code Assist. Pamiętaj, że po przydzieleniu początkowych bezpłatnych środków na licencje nie możesz zwiększyć liczby bezpłatnych środków. W pierwszym miesiącu nie możesz też zmienić wersji Gemini Code Assist.

Gemini Code Assist Enterprise jest dostępna za 19 USD miesięcznie za użytkownika w ramach 12-miesięcznego zobowiązania do 31 marca 2025 roku. Skontaktuj się z zespołem sprzedaży, aby skorzystać z tej oferty promocyjnej.

Jeśli masz już umowy z Google Cloud, przed zakupem subskrypcji skontaktuj się z naszym zespołem sprzedaży.

  1. Otwórz stronę Gemini dla Google Cloud.

    Otwórz Gemini dla Google Cloud

    Otworzy się strona Gemini for Google Cloud.

  2. Wybierz Kup Gemini Code Assist. Jeśli na Twoim koncie rozliczeniowym nie kupiono subskrypcji Gemini Code Assist, wyświetli się wiadomość Uprawnienia do bezpłatnego 30-dniowego okresu próbnego dla maksymalnie 50 licencji. Jeśli w Twoim projekcie jest już włączona usługa Gemini Code Assist, wyświetli się tekst Zarządzaj Gemini Code Assist.

    Otworzy się strona Kup subskrypcję Gemini Code Assist.

  3. W sekcji Wybierz wersję subskrypcji Gemini Code Assist wybierz wersję Gemini Code Assist. Kliknij Porównaj wersje Gemini Code Assist, aby wyświetlić szczegółową listę funkcji dostępnych w każdej wersji.

    Następnie kliknij Dalej.

  4. W sekcji Skonfiguruj subskrypcję wypełnij pola, aby skonfigurować subskrypcję, w tym:

    • Nazwa subskrypcji.
    • Liczba licencji w ramach subskrypcji. Pamiętaj, że jeśli kupujesz wersję Enterprise, musisz kupić co najmniej 10 licencji.
    • Okres subskrypcji (miesięczny lub roczny). W przypadku abonamentu rocznego możesz korzystać z obniżonej ceny, która jest pobierana co miesiąc, a nie w formie jednorazowej płatności.
    • automatyczne odnawianie subskrypcji po zakończeniu okresu zobowiązania (miesięcznego lub rocznego); Automatyczne odnawianie sprawia, że subskrypcja i licencje pozostają aktywne. Jeśli subskrypcja nie zostanie automatycznie odnowiona, wygaśnie po zakończeniu bieżącego okresu. Należy wtedy ponownie przejść przez proces zakupu i ponownie przypisać licencje.

  5. Aby potwierdzić subskrypcję, kliknij Dalej.

  6. Jeśli zgadzasz się na warunki, wybierz Akceptuję warunki tego zakupu, a następnie Potwierdź subskrypcję.

  7. Kliknij Dalej: zarządzaj przypisaniami licencji na Gemini.

Subskrypcja Gemini Code Assist została kupiona. Musisz teraz zarządzać przypisaniami licencji na Gemini w organizacji.

Przypisywanie licencji

Aby móc korzystać z Gemini Code Assist, każda osoba w organizacji musi mieć licencję.

W przypadku nowych klientów Gemini Code Assist, którzy mają konta rozliczeniowe, na których nie było wcześniej subskrypcji Gemini Code Assist, automatycznie stosujemy środki równe maksymalnie 50 bezpłatnych licencji na pierwszy miesiąc, niezależnie od wersji Gemini Code Assist. Pamiętaj, że po przydzieleniu początkowych bezpłatnych środków na licencje nie możesz zwiększyć liczby bezpłatnych środków. W pierwszym miesiącu nie możesz też zmienić wersji Gemini Code Assist.

Konsola Interfejs API

Aby przypisać licencje Gemini poszczególnym użytkownikom w konsoli Google Cloud, musisz mieć te uprawnienia:

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

  1. Otwórz stronę Administracja Gemini.

    Otwórz Gemini dla Google Cloud

  2. Wybierz subskrypcję, którą chcesz zmienić, a następnie kliknij Modyfikuj subskrypcję.

  3. Kliknij Przypisz licencje. Pojawi się okno wyboru użytkownika. Aby wyszukać konkretnych użytkowników, wpisz ich nazwy w polu wyszukiwania.

  4. Wybierz z listy co najmniej 1 użytkownika, a następnie kliknij Dalej.

  5. Wybierz usługi Gemini, do których chcesz przypisać licencje.

  6. Kliknij Przypisz licencje.

Aby przypisać licencje Gemini za pomocą interfejsu API, musisz mieć uprawnienie consumerprocurement.licensePools.assign.

Metoda HTTP: POST

Adres URL: https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

Zastąp następujące elementy:

  • BILLING_ACCOUNT_ID: identyfikator konta rozliczeniowego
  • ORDER_ID: zasady uprawnień

Treść żądania:

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

Dane wyjściowe są podobne do tych:

{}

Jeśli licencja została przypisana, odpowiedź jest pusta.

Teraz musisz włączyć interfejs Gemini for Google Cloud API w co najmniej jednym projekcie powiązanym z tym kontem rozliczeniowym. Użytkownicy nie zobaczą Gemini Code Assist, dopóki nie aktywujesz tej funkcji w co najmniej 1 projekcie.

Włączanie interfejsu Gemini for Google Cloud API w projekcie Cloud

W tej sekcji opisano czynności, które należy wykonać, aby włączyć interfejs Gemini for Google Cloud API w projekcie Cloud.

Konsola gcloud

  1. Aby włączyć interfejs Gemini for Google Cloud API, otwórz stronę Gemini for Google Cloud.

    Otwórz Gemini dla Google Cloud

  2. W selektorze projektów wybierz projekt.

  3. Kliknij Włącz.

    Strona się aktualizuje i wyświetla stan Włączony. Gemini jest teraz dostępny w wybranym projekcie Cloud dla wszystkich użytkowników, którzy mają wymagane role IAM.

Aby używać lokalnego środowiska programistycznego, zainstaluj i inicjuj interfejs wiersza poleceń gcloud.

  1. W menu selektora projektów wybierz projekt.

  2. Włącz interfejs Gemini for Google Cloud API dla Gemini za pomocą polecenia gcloud services enable: 

    gcloud services enable cloudaicompanion.googleapis.com

    Jeśli chcesz włączyć interfejs Gemini for Google Cloud API w innym projekcie Cloud, dodaj parametr --project:

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

    Zastąp PROJECT_ID identyfikatorem projektu Cloud.

    Dane wyjściowe są podobne do tych:

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

Gemini for Google Cloud jest teraz dostępna w określonym projekcie Cloud dla wszystkich użytkowników, którzy mają wymagane role uprawnień IAM.

Wymagane interfejsy API dla użytkowników za zaporą sieciową

Oprócz włączenia interfejsu Gemini for Google Cloud użytkownicy za zaporami sieciowymi mogą też potrzebować włączenia tych interfejsów API:

  • oauth2.googleapis.com: służy do logowania się w Google Cloud.
  • serviceusage.googleapis.com: używany do sprawdzania, czy projekt Gemini Code Assist użytkownika jest prawidłowo skonfigurowany.
  • cloudaicompanion.googleapis.com: podstawowy punkt końcowy interfejsu Gemini for Google Cloud API.
  • cloudcode-pa.googleapis.com: wewnętrzny interfejs API, który udostępnia funkcje związane z IDE.
  • cloudresourcemanager.googleapis.com: używany w IDE do selektorów projektów. Interfejs Resource Manager API może nie być potrzebny, jeśli projekty są jawnie skonfigurowane w pliku settings.json.
  • people.googleapis.com: zapewnia dostęp do informacji o profilach i kontaktach.
  • firebaselogging-pa.googleapis.com: wewnętrzny interfejs API służący do wysyłania telemetrii dotyczącej produktów, w tym zdarzeń dotyczących tego, czy sugestie zostały zaakceptowane.
  • feedback-pa.googleapis.com: wewnętrzny interfejs API służący do przesyłania opinii w IDE.
  • apihub.googleapis.com: używany przez funkcję przeglądarki interfejsu Cloud Code API.

Opcjonalnie: skonfiguruj ustawienia usługi VPC

Jeśli Twoja organizacja ma peryferium usługi, musisz dodać do niego te zasoby:

  • Gemini for Google Cloud API
  • Gemini Code Assist API

Jeśli korzystasz z Gemini Code Assist spoza perymetru usługi, musisz też zmienić zasady dostępu, aby umożliwić dostęp do tych usług.

Więcej informacji znajdziesz w artykule Konfigurowanie ustawień usługi VPC dla Gemini.

Przyznawanie ról uprawnień w projekcie Google Cloud

W tej sekcji opisano czynności wymagane do przypisania użytkownikom ról uprawnień użytkownika Gemini for Google Cloud oraz konsumenta wykorzystania usługi.

Konsola gcloud

  1. Aby przyznać role uprawnień wymagane do korzystania z Gemini, otwórz stronę Administracja.

    Otwórz stronę Administracja

  2. W kolumnie Podmiot zabezpieczeń odszukaj podmiot zabezpieczeń, któremu chcesz przyznać dostęp do Gemini, a następnie w tym samym wierszu kliknij Edytuj podmiot zabezpieczeń.

  3. W panelu Edytuj dostęp kliknij Dodaj kolejną rolę.

  4. W sekcji Wybierz rolę wybierz Użytkownik Gemini for Google Cloud.

  5. Kliknij Dodaj kolejną rolę i wybierz Konsument użycia usługi.

  6. Kliknij Zapisz.

Aby używać lokalnego środowiska programistycznego, zainstaluj i inicjuj interfejs wiersza poleceń gcloud.

  1. W menu selektora projektów wybierz projekt.

  2. Przypisz rolę użytkownika Gemini for Google Cloud:

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

    Zastąp PRINCIPAL identyfikatorem podmiotu zabezpieczeń. Identyfikator ma postać user|group|serviceAccount:email lub domain:domain, np. user:cloudysanfrancisco@gmail.com, group:admins@example.com, serviceAccount:test123@example.domain.com lub domain:example.domain.com.

    Dane wyjściowe to lista powiązań zasad, która zawiera:

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

  3. Przypisz rolę konsumenta usługi:

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

    Dane wyjściowe to lista powiązań zasad, która zawiera:

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

Więcej informacji znajdziesz w artykule Przyznawanie jednej roli i gcloud projects add-iam-policy-binding.

Wszyscy użytkownicy, którym przypisano te role, mogą korzystać z funkcji Gemini for Google Cloud w konsoli Google Cloud w określonym projekcie. Więcej informacji znajdziesz w artykule Gemini dla Google Cloud – omówienie.

Instalowanie wtyczki Gemini Code Assist w IDE

Użytkownicy organizacji instalują Gemini Code Assist w preferowanym środowisku IDE. Więcej informacji znajdziesz w tych dokumentach:

Domyślnie Gemini Code Assist jest uwzględniony w tych środowiskach IDE:

Zadania konfiguracji zaawansowanej

Zamiast korzystania z konsoli Google Cloud lub gcloud do przypisywania wstępnie zdefiniowanych ról uprawnień możesz wykonać jedną z tych czynności:

  • Aby przypisać role, użyj interfejsów REST usługi IAM lub bibliotek klienta usługi IAM.

    Jeśli używasz tych interfejsów, użyj pełnych nazw ról:

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

    Więcej informacji o przyznawaniu ról znajdziesz w artykule Zarządzanie dostępem do projektów, folderów i organizacji.

  • tworzyć role niestandardowe i przyznawać do nich uprawnienia.

    Aby uzyskać dostęp do Gemini Code Assist, musisz mieć te niestandardowe role:

    • cloudaicompanion.companions.generateChat
    • cloudaicompanion.companions.generateCode
    • cloudaicompanion.instances.completeCode
    • cloudaicompanion.instances.completeTask
    • cloudaicompanion.instances.generateCode
    • cloudaicompanion.instances.generateText
    • serviceusage.services.enable

  • Przypisywanie licencji i zarządzanie nimi.

    Aby uzyskać dostęp do Gemini Code Assist, musisz mieć te niestandardowe uprawnienia:

    • 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

Pamiętaj też, że aby dowolne z wymienionych wyżej uprawnień mogło działać, musisz włączyć interfejs Gemini for Google Cloud API w tym samym projekcie Google Cloud, w którym przypisałeś/przypisałaś uprawnienia.

Co dalej?