Konfigurowanie Gemini Code Assist Standard i Enterprise

Zanim będziesz mógł korzystać z Gemini Code Assist w wersji standardowej lub Enterprise, Twój zespół musi wykonać czynności konfiguracyjne opisane w tym dokumencie:

  1. Kup subskrypcję Gemini Code Assist Standard lub Enterprise.

  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 Identity and Access Management w projekcie Google Cloud.

  5. Użytkownicy Twojej organizacji zainstalują wtyczkę Gemini Code Assist, aby korzystać z Gemini Code Assist Standard lub Enterprise 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 odpowiadające 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.

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

  1. Otwórz stronę Administracja Gemini.

    Otwórz stronę Administracja Gemini

    Otworzy się strona Administracja Gemini.

  2. Wybierz Kup Gemini Code Assist.

    Jeśli nie masz wymaganych uprawnień consumerprocurement.orders.place, ten przycisk jest wyłączony. Jeśli subskrypcja Gemini Code Assist jest już dostępna na koncie rozliczeniowym powiązanym z projektem, ten przycisk będzie wyświetlany jako Zarządzaj Gemini Code Assist i umożliwi edytowanie subskrypcji.

    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 subskrypcji rocznej możesz korzystać z obniżonej ceny, która jest pobierana co miesiąc, a nie w formie jednorazowej płatności.

  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 Standard lub Enterprise została kupiona. Teraz musisz zarządzać przypisaniami licencji Gemini w swojej organizacji.

Przypisywanie licencji

Aby móc korzystać z Gemini Code Assist, musisz przypisać licencję każdemu użytkownikowi, któremu chcesz przyznać dostęp w organizacji.

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 odpowiadające 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

Aby przypisać licencje Gemini poszczególnym użytkownikom w Konsoli API, musisz mieć te uprawnienia na koncie rozliczeniowym:

  • 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. 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.

Interfejs API

Aby przypisać licencje Gemini za pomocą interfejsu API, użyj metody billingAccounts.orders.licensePool.assign.

  1. Sprawdź, czy na koncie rozliczeniowym zawierającym pulę licencji, której licencję chcesz przypisać, masz uprawnienie consumerprocurement.licensePools.assign do usługi Identity and Access Management.

  2. Utwórz plik JSON zawierający te informacje:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    Gdzie USER_EMAILS to rozdzielona przecinkami lista kont użytkowników, którym przypisana jest licencja. Na przykład: "dana@example.com", "lee@example.com".

  3. Użyj metody 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/"

    Zastąp następujące elementy:

    • JSON_FILE_NAME: ścieżka do pliku JSON utworzonego w kroku 2.
    • PROJECT_ID: identyfikator projektu. Limity i opłaty związane z żądaniem interfejsu API są stosowane w tym projekcie.
    • BILLING_ACCOUNT_ID: identyfikator konta rozliczeniowego powiązanego z pulą licencji.
    • ORDER_ID: identyfikator zamówienia. Jeśli nie znasz identyfikatora zamówienia, możesz go pobrać, wyświetlając zamówienia powiązane z Twoim kontem rozliczeniowym.

W przypadku powodzenia odpowiedź będzie wyglądać tak:

  {}

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 wymagane do włączenia interfejsu Gemini for Google Cloud API w projekcie Cloud.

Konsola

  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ępna w wybranym projekcie Cloud dla wszystkich użytkowników, którzy mają wymagane role uprawnień.

gcloud

Aby korzystać z 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ępny w określonym projekcie Cloud dla wszystkich użytkowników, którzy mają wymagane role uprawnień IAM.

Konfigurowanie zapory sieciowej pod kątem ruchu API między IDE a Google

Oprócz włączenia Gemini for Google Cloud użytkownicy za zaporami sieciowymi muszą też zezwolić na przepływ ruchu w przypadku 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 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.
  • lh3.googleusercontent.com i lh5.googleusercontent.com: służą do uzyskiwania zdjęć użytkowników.

Określanie adresów IP domen domyślnych Google Cloud

Aby umożliwić połączenie z IDE z interfejsami API Google Cloud, zapora sieciowa musi zezwalać na ruch TCP wychodzący do publicznie udokumentowanych zakresów adresów IP Google. Google zarządza tymi zakresami dynamicznie.

Aby utrzymać listę zakresów adresów IP umożliwiających dostęp do domen Google Cloud, masz do wyboru kilka opcji:

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 używasz Gemini Code Assist Standard lub Enterprise poza obrębem usługi, musisz też zmodyfikować zasady ingress, aby zezwolić na 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

  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.

gcloud

Aby korzystać z 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 następujące elementy:

    • PROJECT_ID: identyfikator projektu Cloud,np. 1234567890.
    • PRINCIPAL: identyfikator głównego odbiorcy, np. user:cloudysanfrancisco@gmail.com.

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

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

  3. Powtórz poprzedni krok w przypadku roli 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 interfejsu API w wybranym projekcie. Więcej informacji znajdziesz w artykule Gemini dla Google Cloud – omówienie.

Instalowanie wtyczki Gemini Code Assist

Użytkownicy organizacji instalują wtyczkę Gemini Code Assist w preferowanym obsługiwanym IDE.

VS Code

  1. Aby otworzyć widok Rozszerzenia w VS Code, kliknij Ikona rozszerzenia Rozszerzenia lub naciśnij Ctrl/Cmd + Shift + X.

  2. Wyszukaj: Gemini Code Assist

  3. Kliknij Zainstaluj.

  4. Jeśli pojawi się taka prośba, uruchom ponownie VS Code.

    Po zainstalowaniu rozszerzenia Gemini Code Assist pojawi się na pasku aktywności i będzie gotowe do użycia. Możesz dostosować instalację Gemini Code Assist, określając preferencje za pomocą paska aplikacji na najwyższym poziomie: otwórz Code > Ustawienia > Ustawienia > Rozszerzenia i wyszukaj Gemini Code Assist.

IntelliJ

  1. Kliknij settings IDE i ustawienia projektu > Wtyczki.
  2. Na karcie Marketplace wyszukaj Gemini Code Assist.
  3. Aby zainstalować wtyczkę, kliknij Zainstaluj.
  4. Po zakończeniu instalacji kliknij Restart IDE (Uruchom ponownie IDE).

  5. Po ponownym uruchomieniu IDE Gemini Code Assist pojawi się na pasku aktywności.

    Na pasku działań pojawi się ikona Gemini Code Assist.

Użytkownicy mogą teraz korzystać z Gemini Code Assist Standard lub Enterprise w swoim IDE. Dowiedz się więcej o obsługiwanych funkcjach:

Zapoznaj się z tymi przewodnikami:

Lista katalogów, w których Gemini Code Assist przechowuje informacje w pamięci podręcznej

W tabeli poniżej znajdziesz listę katalogów, w których Gemini Code Assist przechowuje informacje o rozszerzeniu, takie jak tokeny uwierzytelniające:

Windows

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

macOS

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

Linux

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

Zaloguj się w Google i wybierz projekt Google Cloud

Po zainstalowaniu Gemini Code Assist w swoim IDE użytkownicy muszą zalogować się na swoje konta Google. Jeśli po raz pierwszy korzystają z Gemini Code Assist Standard lub Enterprise w swoim IDE, muszą wybrać projekt Google Cloud.

VS Code

Jeśli wybierzesz projekt Google Cloud bez włączonego interfejsu Gemini for Google Cloud API, otrzymasz powiadomienie z opcją włączenia interfejsu API w IDE. W oknie powiadomienia kliknij Włącz interfejs API, aby włączyć interfejs API w projekcie. Więcej informacji znajdziesz w artykule Konfigurowanie Gemini Code Assist Standard i Enterprise w projekcie.

Jeśli wolisz korzystać z instrukcji kodowania z Gemini Code Assist bezpośrednio w IDE, kliknij Uruchom VS Code i wykonaj czynności opisane w instrukcji, aby połączyć się z Google Cloud i aktywować Gemini Code Assist Standard lub Enterprise.

Uruchom VS Code

W przeciwnym razie wykonaj te czynności:

  1. Uruchom środowisko IDE.

  2. Na pasku działań kliknij Gemini Code Assist.

  3. W panelu czatu Gemini Code Assist kliknij Zaloguj się w Google Cloud.

  4. Gdy pojawi się prośba o zezwolenie na otwarcie przez Gemini Code Assist strony zewnętrznej, kliknij Otwórz.

  5. Postępuj zgodnie z instrukcjami, aby zalogować się na konto Google.

  6. Gdy pojawi się pytanie, czy pobrałeś/pobraliście Gemini Code Assist z Google, kliknij Zaloguj się.

    Połączenie z Google Cloud zostało nawiązane.

    Aby wybrać projekt Google Cloud z włączonym interfejsem Gemini for Google Cloud API, wykonaj te czynności:

  7. Na pasku stanu Gemini Code Assist kliknij Gemini Code Assist.

    Pasek stanu Gemini jest dostępny.

  8. W menu Gemini Code Assist kliknij Wybierz projekt Gemini Code.

  9. Wybierz projekt Google Cloud, w którym włączono interfejs Gemini for Google Cloud API.

    Gemini Code Assist Standard lub Enterprise jest gotowe do użycia.

    Ikona Gemini na pasku stanu jest ustawiona normalnie.

IntelliJ

Aby zalogować się na konto Google:

  1. Na pasku działań kliknij spark Gemini Code Assist.

  2. Kliknij Zaloguj się w Google.

  3. Na stronie, która otworzy się w przeglądarce, wybierz swoje konto Google.

  4. Na ekranie z prośbą o sprawdzenie, czy aplikacja została pobrana z Google, kliknij Zaloguj się.

    Gemini Code Assist ma teraz uprawnienia do dostępu do Twojego konta.

    Jeśli korzystasz z Gemini Code Assist w standardowej lub rozszerzonej wersji w swoim środowisku IDE po raz pierwszy, musisz wybrać projekt Google Cloud. Aby to zrobić:

  5. Wróć do IDE. Jeśli w oknie narzędzia Gemini Code Assist zgadzasz się na włączenie przez Google interfejsów API wymaganych do używania Gemini Code Assist w Twoim imieniu w wybranym projekcie, kliknij Select a GCP Project (Wybierz projekt GCP), aby kontynuować.

  6. W oknie Select Google Cloud Project (Wybierz projekt Google Cloud) odszukaj i wybierz swój projekt Google Cloud, a następnie kliknij OK (OK).

  7. Kliknij ZAKOŃCZ.

Twój projekt Google Cloud jest wybrany i włączony jest interfejs Gemini Code Assist API. Możesz już używać Gemini Code Assist Standard lub Enterprise w swoim IDE.

Zadania konfiguracji zaawansowanej

Zamiast korzystania z konsoli API lub gcloud do przyznawania wstępnie zdefiniowanych ról IAM możesz wykonać jedną z tych czynności:

  • Aby przypisać role, użyj interfejsów REST uprawnień IAM lub bibliotek klienta uprawnień 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 Standard i Enterprise, musisz mieć te uprawnienia w przypadku każdej utworzonej przez siebie niestandardowej roli:

    • 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

  • Przypisywanie licencji i zarządzanie nimi.

    Aby móc przypisywać licencje Gemini Code Assist i nimi zarządzać, musisz mieć te uprawnienia dla utworzonych przez siebie ról niestandardowych:

    • 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 którekolwiek 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?