Konfigurowanie Gemini Code Assist Standard i Enterprise

Zanim Twój zespół będzie mógł korzystać z Gemini Code Assist w wersji Standard lub Enterprise, musi wykonać czynności 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 Gemini for Google Cloud API w projekcie Google Cloud.

  4. Przyznawanie ról Identity and Access Management w projekcie Google Cloud

  5. Użytkownicy w organizacji instalują wtyczkę Gemini Code Assist, aby korzystać z Gemini Code Assist Standard lub Enterprise w IDE. Ten krok nie jest wymagany w przypadku użytkowników interfejsu Gemini CLI.

Kup subskrypcję Gemini Code Assist

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

Nowym klientom Gemini Code Assist, którzy mają konta rozliczeniowe, na których nigdy nie było subskrypcji Gemini Code Assist, automatycznie przyznajemy środki w wysokości do 50 bezpłatnych licencji na pierwszy miesiąc, niezależnie od wersji Gemini Code Assist. Pamiętaj, że po przyznaniu początkowych bezpłatnych środków na licencję nie możesz zwiększyć liczby bezpłatnych środków. Nie możesz też zmienić wersji Gemini Code Assist w pierwszym miesiącu.

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

  1. Otwórz stronę Administracja Gemini.

    Otwórz stronę Administrowanie Gemini

    Otworzy się strona Administracja Gemini.

  2. Kliknij Kup Gemini Code Assist.

    Jeśli nie masz odpowiednich consumerprocurement.orders.placeuprawnień, ten przycisk jest wyłączony. Jeśli subskrypcja Gemini Code Assist jest już dostępna na koncie rozliczeniowym powiązanym z projektem, ten przycisk wyświetla się jako Zarządzaj Gemini Code Assist i umożliwia 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 poszczególnych wersjach.

    Następnie kliknij Dalej.

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

    • Nazwa subskrypcji.
    • Liczba licencji w 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 otrzymujesz zniżkę, a opłata jest naliczana co miesiąc, a nie jednorazowo.

  5. Aby potwierdzić subskrypcję, kliknij Dalej.

  6. Jeśli akceptujesz 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 na Gemini w swojej organizacji.

Przypisywanie licencji

Aby móc korzystać z Gemini Code Assist, każdemu użytkownikowi, który ma mieć dostęp do tej usługi w organizacji, należy przypisać licencję.

Nowym klientom Gemini Code Assist, którzy mają konta rozliczeniowe, na których nigdy nie było subskrypcji Gemini Code Assist, automatycznie przyznajemy środki w wysokości do 50 bezpłatnych licencji na pierwszy miesiąc, niezależnie od wersji Gemini Code Assist. Pamiętaj, że po przyznaniu początkowych bezpłatnych środków na licencję nie możesz zwiększyć liczby bezpłatnych środków. Nie możesz też zmienić wersji Gemini Code Assist w pierwszym miesiącu.

Konsola

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

  • 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 w Google Cloud

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

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

  4. Wybierz co najmniej jednego użytkownika z listy, 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 masz uprawnienie consumerprocurement.licensePools.assign Identity and Access Management na koncie rozliczeniowym, które zawiera pulę licencji, z której chcesz przypisać licencję.

  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 przypisywana jest licencja. Na przykład:"dana@example.com", "lee@example.com".

  3. Aby wywołać metodę, użyj 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. Wykorzystanie limitu i opłaty związane z żądaniem interfejsu API są naliczane 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 odzyskać, wyświetlając listę zamówień powiązanych z Twoim kontem rozliczeniowym.

Jeśli operacja się uda, odpowiedź będzie podobna do tej:

  {}

Teraz musisz włączyć interfejs Gemini w Google Cloud API w co najmniej jednym projekcie powiązanym z tym kontem rozliczeniowym. Użytkownicy nie będą widzieć Gemini Code Assist, dopóki nie aktywujesz go w co najmniej 1 projekcie.

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

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

Konsola

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

    Otwórz Gemini w Google Cloud

  2. W selektorze projektów wybierz projekt.

  3. Kliknij Włącz.

    Strona zostanie zaktualizowana i wyświetli stan Włączono. Usługa Gemini jest teraz dostępna w wybranym projekcie w Google Cloud dla wszystkich użytkowników, którzy mają wymagane role uprawnień.

gcloud

Aby używać lokalnego środowiska programistycznego, zainstaluj i zainicjuj 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 w Google Cloud jest teraz dostępny w określonym projekcie w chmurze dla wszystkich użytkowników, którzy mają wymagane role uprawnień.

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

Oprócz włączenia Gemini w Google Cloud użytkownicy korzystający z zapór sieciowych 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: główny 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ą wyraźnie 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 używany do wysyłania danych telemetrycznych produktów, w tym zdarzeń dotyczących tego, czy sugestie zostały zaakceptowane.
  • feedback-pa.googleapis.com: wewnętrzny interfejs API używany 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 domyślnych domen Google Cloud

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

Aby prowadzić listę zakresów adresów IP, które mają dostęp do domen Google Cloud, masz kilka opcji:

Opcjonalnie: skonfiguruj ustawienia usługi VPC

Jeśli Twoja organizacja ma granicę usług, musisz dodać do niej te zasoby:

  • Gemini for Google Cloud API
  • Gemini Code Assist API

Jeśli korzystasz z Gemini Code Assist w wersji Standard lub Enterprise spoza granic usługi, musisz też zmodyfikować 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 opisujemy czynności, które należy wykonać, aby przypisać użytkownikom role uprawnień użytkownika Gemini for Google Cloud i konsumenta wykorzystania usług.

Konsola

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

    Otwórz stronę Administracja

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

  3. W panelu Edytowanie dostępu kliknij  Dodaj kolejną rolę.

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

  5. Kliknij Dodaj kolejną rolę i wybierz Użytkownik usług.

  6. Kliknij Zapisz.

gcloud

Aby używać lokalnego środowiska programistycznego, zainstaluj i zainicjuj 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 Twojego projektu Cloud,np.1234567890.
    • PRINCIPAL: identyfikator podmiotu, np. user:cloudysanfrancisco@gmail.com.

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

    - 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 pojedynczej 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 interfejsów API w określonym projekcie. Więcej informacji znajdziesz w omówieniu Gemini w Google Cloud.

Instalowanie wtyczki Gemini Code Assist

Użytkownicy w Twojej organizacji instalują wtyczkę Gemini Code Assist w wybranym przez siebie 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. W razie potrzeby uruchom ponownie VS Code.

    Po zainstalowaniu rozszerzenia Gemini Code Assist pojawi się na pasku aktywności i będzie gotowy do użycia. Możesz dodatkowo skonfigurować instalację Gemini Code Assist, określając preferencje na pasku zadań aplikacji najwyższego poziomu: kliknij Code > Settings > Settings > Extensions i wyszukaj Gemini Code Assist.

IntelliJ

  1. Kliknij settings Ustawienia IDE i 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 środowiska 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 IDE. Więcej informacji o obsługiwanych funkcjach:

Na początek zapoznaj się z tymi przewodnikami:

Lista katalogów, w których Gemini Code Assist buforuje informacje

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

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 środowiskach IDE użytkownicy muszą zalogować się na swoje konta Google. Jeśli korzystają z Gemini Code Assist w wersji Standard lub Enterprise w środowisku IDE po raz pierwszy, 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 przejść przez przewodnik po kodowaniu z Gemini Code Assist bezpośrednio w IDE, kliknij Uruchom VS Code i wykonaj czynności opisane w przewodniku, 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 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 Gemini Code Assist na otwarcie zewnętrznej witryny, kliknij Otwórz.

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

  6. Gdy pojawi się pytanie, czy Gemini Code Assist został pobrany z Google, kliknij Zaloguj się.

    Masz teraz połączenie z Google Cloud.

    Następnie, aby wybrać projekt Google Cloud z włączonym interfejsem Gemini w 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 jest włączony interfejs Gemini for Google Cloud API.

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

    Ikona Gemini na pasku stanu jest ustawiona na normalną.

IntelliJ

Aby zalogować się na konto Google, wykonaj te czynności:

  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 ta aplikacja została pobrana z Google, kliknij Zaloguj się.

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

    Jeśli korzystasz z Gemini Code Assist w wersji Standard lub Enterprise w IDE po raz pierwszy, musisz wybrać projekt Google Cloud, wykonując te czynności:

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

  6. W oknie Wybierz projekt Google Cloud wyszukaj i wybierz projekt Google Cloud, a następnie kliknij OK.

  7. Kliknij ZAKOŃCZ.

Wybrany projekt Google Cloud ma włączony interfejs Gemini Code Assist API. Możesz już korzystać z Gemini Code Assist Standard lub Enterprise w swoim środowisku IDE.

Zaawansowane zadania konfiguracyjne

Zamiast używać konsoli API lub narzędzia gcloud do przyznawania predefiniowanych ról IAM, możesz wykonać jedną z tych czynności:

  • Do przypisywania ról używaj interfejsów API REST IAM lub bibliotek klienta IAM.

    Jeśli korzystasz z tych interfejsów, używaj pełnych i jednoznacznych 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.

  • tworzenie i przyznawanie ról niestandardowych;

    Wszystkie utworzone przez Ciebie role niestandardowe muszą mieć te uprawnienia, aby umożliwić Ci dostęp do Gemini Code Assist w wersji Standard i 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

  • przypisywać licencje i zarządzać nimi,

    Wszystkie utworzone przez Ciebie role niestandardowe muszą mieć te uprawnienia, aby można było przypisywać licencje Gemini Code Assist i nimi zarządzać:

    • 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 tych uprawnień działało, interfejs Gemini w Google Cloud API musi być włączony w tym samym projekcie Google Cloud, w którym przypisano poszczególne uprawnienia.

Co dalej?