Gemini Code Assist'i (Standart ve Enterprise) ayarlama

Not: Daha önce hiç Gemini Code Assist aboneliği olmayan faturalandırma hesaplarına sahip yeni Gemini Code Assist müşterilerine, Gemini Code Assist sürümünden bağımsız olarak ilk ay için 50'ye varan ücretsiz lisansa eşdeğer kredi otomatik olarak uygulanır. Ayrıca, Gemini Code Assist Enterprise, 31 Mart 2025'e kadar 12 aylık taahhütle kullanıcı başına aylık 19 ABD doları karşılığında kullanılabilir. Bu promosyon fırsatından yararlanmak için satış ekibimizle iletişime geçin.

Gemini Code Assist'i kullanabilmeniz için ekibinizin bu dokümanda açıklanan kurulum adımlarını uygulaması gerekir:

Not: 1-4 arasındaki adımları genellikle bir yönetici gerçekleştirir.

1. Gemini Code Assist aboneliği satın alın.

2. Kuruluşunuzdaki kullanıcılara tek tek lisans atama

3. Google Cloud projesinde Google Cloud için Gemini API'yi etkinleştirin.

4. Google Cloud projesinde Identity and Access Management rolleri verme.

5. Kuruluşunuzun kullanıcıları, Gemini Code Assist'i bir IDE'de kullanmak için Gemini Code Assist eklentisini yükler.

Gemini Code Assist aboneliği satın alma

Her sürümde sunulan özelliklerin listesi için Desteklenen özellikler başlıklı makaleyi inceleyin.

Daha önce hiç Gemini Code Assist aboneliği olmayan faturalandırma hesaplarına sahip yeni Gemini Code Assist müşterilerine, Gemini Code Assist sürümünden bağımsız olarak ilk ay için 50'ye varan ücretsiz lisansa eşdeğer kredi otomatik olarak uygulanır. İlk ücretsiz lisans kredileri ayrıldıktan sonra ücretsiz kredi sayısını artıramayacağınızı unutmayın. Ayrıca, ilk ay içinde Gemini Code Assist sürümünü değiştiremezsiniz.

Gemini Code Assist Enterprise, 31 Mart 2025'e kadar 12 aylık taahhüt kapsamında kullanıcı başına ayda 19 ABD doları karşılığında kullanılabilir. Bu promosyon fırsatından yararlanmak için satış ekibimizle iletişime geçin.

Google Cloud ile mevcut sözleşmeleriniz varsa abonelik satın almadan önce satış ekibimizle iletişime geçin.

1. Google Cloud için Gemini sayfasına gidin.

   Google Cloud için Gemini'ye gitme

   Google Cloud için Gemini sayfası açılır.

2. Gemini Code Assist'i al'ı seçin. Faturalandırma hesabınızda Gemini Code Assist aboneliği satın alınmadıysa 50 lisansa kadar 30 günlük ücretsiz deneme için uygun mesajının gösterildiğini unutmayın. Projenizde zaten Gemini Code Assist varsa bu metinde Gemini Code Assist'i yönet ifadesi gösterilir.

   Gemini Code Assist aboneliği alma sayfası açılır.

3. Gemini Code Assist abonelik sürümünü seçin bölümünde bir Gemini Code Assist sürümü seçin. Her sürümde kullanılabilen özelliklerin ayrıntılı listesini görmek için Gemini Code Assist Sürümlerini Karşılaştırma'yı seçin.

   Ardından Devam'ı seçin.

4. Aboneliği yapılandır bölümünde, aşağıdakiler de dahil olmak üzere aboneliği yapılandırmak için alanları doldurun:

   • Abonelik adı.
   • Abonelikteki lisans sayısı. Enterprise sürümünü satın alıyorsanız en az 10 lisans satın almanız gerektiğini unutmayın.
   • Abonelik dönemi (aylık veya yıllık). Yıllık abonelikte, tek seferlik ödeme yerine aylık olarak tahsil edilen indirimli bir fiyattan yararlanırsınız.
   • Taahhüt dönemi (aylık veya yıllık) sona erdikten sonra aboneliğinizin otomatik olarak yenilenmesi. Otomatik kayıt uzatma, aboneliğinizin ve lisanslarınızın etkin kalmasını sağlar. Abonelik otomatik olarak yenilenmezse geçerli dönem sona erdiğinde abonelik de sona erer. Bu durumda satın alma sürecini tekrar tamamlamanız ve lisansları yeniden atamanız gerekir.

5. Aboneliği onaylamak için Devam'ı seçin.

6. Şartları kabul ediyorsanız Bu satın alma işleminin şartlarını kabul ediyorum'u, ardından Aboneliği onayla'yı seçin.

7. Sonraki: Gemini Lisans Atamalarını Yönet'i seçin.

Abonelik artık Gemini Code Assist için satın alınmıştır. Artık kuruluşunuzda Gemini lisans atamalarını yönetmeniz gerekir.

Lisans atama

Gemini Code Assist'i kullanmadan önce kuruluşunuzdaki her kullanıcının lisansı olmalıdır.

Daha önce hiç Gemini Code Assist aboneliği olmayan faturalandırma hesaplarına sahip yeni Gemini Code Assist müşterilerine, Gemini Code Assist sürümünden bağımsız olarak ilk ay için 50'ye varan ücretsiz lisansa eşdeğer kredi otomatik olarak uygulanır. İlk ücretsiz lisans kredileri ayrıldıktan sonra ücretsiz kredi sayısını artıramayacağınızı unutmayın. Ayrıca, ilk ay içinde Gemini Code Assist sürümünü değiştiremezsiniz.

Console API

Google Cloud Console'da tek tek kullanıcılara Gemini lisansı atamak için aşağıdaki izinlere sahip olmanız gerekir:

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

1. Gemini için yönetici sayfasına gidin.

   Google Cloud için Gemini'ye gitme

2. Değiştirmek istediğiniz aboneliği seçip Aboneliği Değiştir'i tıklayın.

3. Lisans ata'yı tıklayın. Kullanıcı seçme iletişim kutusu görünür. Belirli kullanıcıları aramak için arama kutusuna kullanıcının adını girin.

4. Listeden bir veya daha fazla kullanıcı seçip Sonraki'yi tıklayın.

5. Lisans atamak istediğiniz Gemini hizmetlerini seçin.

6. Lisans ata'yı tıklayın.

Gemini lisanslarını API ile atamak için consumerprocurement.licensePools.assign iznine sahip olmanız gerekir.

HTTP Yöntemi: POST

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

Aşağıdakini değiştirin:

• BILLING_ACCOUNT_ID: faturalandırma hesabı kimliği
• ORDER_ID: IAM politikası

İstek içeriği:

    {
        "usernames": [
                  "[e-mail]",
                  "[e-mail]"
        ]
    }

Çıkış şuna benzer:

{}

Lisans başarıyla atandıysa yanıt boş olur.

Artık bu faturalandırma hesabıyla ilişkili bir veya daha fazla projede Google Cloud için Gemini API'yi etkinleştirmeniz gerekir. Gemini Code Assist'i en az bir projede etkinleştirmediğiniz sürece kullanıcılar bu özelliği görmez.

Cloud projesinde Google Cloud için Gemini API'yi etkinleştirme

Bu bölümde, Google Cloud API için Gemini'yi bir Cloud projesinde etkinleştirmek için gereken adımlar açıklanmaktadır.

Console gcloud

1. Google Cloud için Gemini API'yi etkinleştirmek üzere Google Cloud için Gemini sayfasına gidin.

   Google Cloud için Gemini'ye gitme

2. Proje seçicide bir proje seçin.

3. Etkinleştir'i tıklayın.

   Sayfa güncellenir ve Etkin durumunu gösterir. Gemini artık seçili Cloud projesinde, gerekli IAM rollerine sahip tüm kullanıcılar tarafından kullanılabilir.

Yerel bir geliştirme ortamı kullanmak için gcloud CLI'yi yükleyin ve başlatın.

1. Proje seçici menüsünde bir proje seçin.

2. gcloud services enable komutunu kullanarak Gemini için Google Cloud API'yi etkinleştirin:

   gcloud services enable cloudaicompanion.googleapis.com
   

   Google Cloud için Gemini API'yi farklı bir Cloud projesinde etkinleştirmek istiyorsanız --project parametresini ekleyin:

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

   PROJECT_ID yerine Cloud proje kimliğinizi yazın.

   Çıkış şuna benzer:

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

Google Cloud için Gemini, belirtilen Cloud projesinde gerekli IAM rollerine sahip tüm kullanıcılar tarafından kullanılabilir.

Güvenlik duvarı arkasındaki kullanıcılar için gerekli API'ler

Google Cloud için Gemini'yi etkinleştirmenin yanı sıra, güvenlik duvarı arkasındaki kullanıcıların aşağıdaki API'leri de etkinleştirmesi gerekebilir:

• oauth2.googleapis.com: Google Cloud'da oturum açmak için kullanılır.
• serviceusage.googleapis.com: Kullanıcı Gemini Code Assist projesinin doğru yapılandırıldığını kontrol etmek için kullanılır.
• cloudaicompanion.googleapis.com: Google Cloud API için birincil Gemini uç noktası.
• cloudcode-pa.googleapis.com: IDE ile ilgili özellikler sunan dahili bir API.
• cloudresourcemanager.googleapis.com: IDE'lerde proje seçicileri için kullanılır. Projeler settings.json dosyanızda açıkça yapılandırılmışsa Resource Manager API gerekmeyebilir.
• people.googleapis.com: profiller ve kişiler hakkındaki bilgilere erişim sağlar.
• firebaselogging-pa.googleapis.com: Önerimlerin kabul edilip edilmediğine dair etkinlikler de dahil olmak üzere ürün telemetrisini göndermek için kullanılan dahili bir API.
• feedback-pa.googleapis.com: IDE içi geri bildirim göndermek için kullanılan dahili bir API.
• apihub.googleapis.com: Cloud Code API Tarayıcı özelliği tarafından kullanılır.

İsteğe bağlı: VPC Hizmet Kontrolleri'ni yapılandırma

Kuruluşunuzun hizmet çevresi varsa çevrenize aşağıdaki kaynakları eklemeniz gerekir:

• Google Cloud API için Gemini
• Gemini Code Assist API

Gemini Code Assist'i hizmet çevrenizin dışından kullanıyorsanız giriş politikasını bu hizmetlere erişim izni verecek şekilde de değiştirmeniz gerekir.

Daha fazla bilgi için Gemini için VPC Hizmet Kontrolleri'ni yapılandırma başlıklı makaleyi inceleyin.

Google Cloud projesinde IAM rolleri atama

Bu bölümde, kullanıcılara Google Cloud için Gemini Kullanıcı ve Hizmet Kullanımı Tüketici IAM rollerini vermek için gereken adımlar açıklanmaktadır.

Console gcloud

1. Gemini'yi kullanmak için gereken IAM rollerini vermek üzere IAM ve Yönetici sayfasına gidin.

   IAM ve Yönetici'ye gidin

2. Müdür sütununda, Gemini'ye erişim vermek istediğiniz bir müdür bulun ve ardından ilgili satırda Müdürü düzenle'yi tıklayın.

3. Erişimi düzenle bölmesinde Başka rol ekle'yi tıklayın.

4. Rol seç bölümünde Google Cloud Kullanıcısı için Gemini'yi seçin.

5. Başka bir rol ekle'yi tıklayın ve Hizmet Kullanımı Kullanıcısı'nı seçin.

6. Kaydet'i tıklayın.

Yerel bir geliştirme ortamı kullanmak için gcloud CLI'yi yükleyin ve başlatın.

1. Proje seçici menüsünde bir proje seçin.

2. Google Cloud için Gemini kullanıcı rolünü verin:

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

   PRINCIPAL öğesini, asıl kullanıcının tanımlayıcısıyla değiştirin. Tanımlayıcı, user|group|serviceAccount:email veya domain:domain biçimindedir (ör. user:[e-mail], group:[e-mail], serviceAccount:[e-mail] veya domain:example.domain.com).

   Çıkış, aşağıdakileri içeren politika bağlamalarının bir listesidir:

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

3. Hizmet Kullanımı Tüketicisi rolünü verin:

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

   Çıkış, aşağıdakileri içeren politika bağlamalarının bir listesidir:

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

Daha fazla bilgi için Tek bir rol verme ve gcloud projects add-iam-policy-binding başlıklı makaleleri inceleyin.

Bu rollere sahip olan tüm kullanıcılar, belirtilen projedeki Google Cloud Console'da Google Cloud için Gemini özelliklerine erişebilir. Daha fazla bilgi için Google Cloud için Gemini'ye genel bakış başlıklı makaleyi inceleyin.

Gemini Code Assist eklentisini bir IDE'ye yükleme

Kuruluşunuzun kullanıcıları, tercih ettikleri IDE'ye Gemini Code Assist'i yükler. Daha fazla bilgi için aşağıdakilere bakın:

• VS Code: Gemini Code Assist ile kodlama
• IntelliJ ve diğer JetBrains IDE'ler: Gemini Code Assist ile kodlama

Gemini Code Assist varsayılan olarak aşağıdaki IDE'lere dahildir:

• Cloud Workstations: Gemini Code Assist ile kodlama
• Cloud Shell Düzenleyici: Gemini Code Assist ile kodlama

Gelişmiş kurulum görevleri

Önceden tanımlanmış IAM rolleri vermek için Google Cloud Console'u veya gcloud'u kullanmak yerine aşağıdakilerden herhangi birini yapabilirsiniz:

• Rol vermek için IAM REST API'lerini veya IAM istemci kitaplıklarını kullanın.

  Bu arayüzleri kullanıyorsanız tam nitelikli rol adlarını kullanın:

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

  Rol verme hakkında daha fazla bilgi için Projelere, klasörlere ve kuruluşlara erişimi yönetme başlıklı makaleyi inceleyin.

• Özel roller oluşturabilir ve verebilirsiniz.

  Oluşturduğunuz özel rollerin, Gemini Code Assist'e erişebilmeniz için aşağıdaki izinlere sahip olması gerekir:

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

• Lisans atama ve yönetme.

  Oluşturduğunuz özel rollerin, Gemini Code Assist'e erişebilmeniz için aşağıdaki izinlere sahip olması gerekir:

  • 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

Ayrıca, yukarıdaki izinlerden herhangi birinin çalışması için Google Cloud API için Gemini'nin, her izni atadığınız Google Cloud projesinde etkinleştirilmesi gerektiğini unutmayın.

Sırada ne var?

• Google Cloud için Gemini'de sunulan üretken yapay zeka yardım türleri hakkında daha fazla bilgi edinin.
• Google Cloud için Gemini'nin verilerinizi nasıl kullandığını öğrenin.
• Gemini Code Assist yönetici denetimlerine nasıl erişeceğinizi ve bunları nasıl yöneteceğinizi öğrenin.
• Gemini Code Assist Enterprise için kod özelleştirmeyi nasıl yapılandıracağınızı öğrenin.
• Gemini için VPC Hizmet Kontrolleri'ni yapılandırın.