Bireysel kullanıcılar için Gemini Code Assist ile sohbet etme

Not: Bir işletmede çalışıyorsanız veya ekip düzeyinde daha fazla avantajdan yararlanmak istiyorsanız Gemini Code Assist Standard veya Enterprise'ı kullanabilirsiniz.

Bu dokümanda, IDE'nizdeki yapay zeka destekli bir iş ortağı olan Gemini Code Assist'i VS Code veya IntelliJ ile diğer desteklenen JetBrains IDE'lerinde aşağıdakileri yapmanıza yardımcı olmak için nasıl kullanabileceğiniz açıklanmaktadır:

• Kodunuzla ilgili sorunları çözmenize yardımcı olacak yol gösterici bilgiler alın.
• Projeniz için kod oluşturun.
• Dosya ve klasörler belirterek projenizin bağlamını yönetin.
• Özel komutlar ve kurallar oluşturma

Bu doküman, her beceri düzeyindeki geliştiriciler için hazırlanmıştır. Bu dokümanda, VS Code veya IntelliJ ve desteklenen diğer JetBrains IDE'leri hakkında bilgi sahibi olduğunuz varsayılır. Android Studio'da Gemini'yi de kullanabilirsiniz.

Not: Kod oluşturma, tamamlama ve dönüştürme davranışı, aynı kısayolları uygulayan ve/veya bu işlemleri işlemek için aynı platform API'sini kullanan diğer eklentilerle aynı anda kullanıldığında kesin değildir.

Başlamadan önce

VS Code

1. Henüz yapmadıysanız bireysel kullanıcılar için Gemini Code Assist, Gemini Code Assist Standard veya Gemini Code Assist Enterprise'ı ayarlayın.

2. Kod dosyanızda Gemini Code Assist özelliklerini test etmeden önce, dosyanızın kodlama dilinin desteklendiğinden emin olun. Desteklenen kodlama dilleri hakkında daha fazla bilgi için Desteklenen kodlama dilleri başlıklı makaleyi inceleyin.

3. IDE'nizi bir proxy arkasında kullanmayı tercih ediyorsanız Visual Studio Code'ta Ağ Bağlantıları başlıklı makaleyi inceleyin.

IntelliJ

1. Henüz yapmadıysanız bireysel kullanıcılar için Gemini Code Assist, Gemini Code Assist Standard veya Gemini Code Assist Enterprise'ı ayarlayın.

2. Kod dosyanızda Gemini Code Assist özelliklerini test etmeden önce, dosyanızın kodlama dilinin desteklendiğinden emin olun. Desteklenen kodlama dilleri hakkında daha fazla bilgi için Desteklenen kodlama dilleri başlıklı makaleyi inceleyin.

3. IDE'nizi bir proxy arkasında kullanmak istiyorsanız HTTP Proxy başlıklı makaleyi inceleyin.

Kodunuzu açıklamak için Gemini Code Assist sohbetinden yararlanma

Bu bölümde, Gemini Code Assist'ten mevcut kodunuzla ilgili bir açıklama sunmasını istersiniz.

VS Code

Kodunuzun açıklamasını almak için aşağıdaki adımları uygulayın:

1. Kod dosyanızı açın.

2. IDE'nizin etkinlik çubuğunda spark Gemini CodeAssist'i tıklayın.

3. Gemini Code Assist bölmesinde istemi Explain this code to me girin ve send Gönder'i tıklayın.

   Gemini Code Assist, isteminize referans olarak kod dosyanızdaki kodu kullanır ve kodunuzun açıklamasını içeren bir yanıt verir.

   Dosyadaki tüm kod yerine belirli bir kod bloğunu referans olarak kullanmak için kod dosyanızdaki bloğu seçip Gemini Code Assist'i isteyebilirsiniz.

IntelliJ

Kodunuzun açıklamasını almak için aşağıdaki adımları uygulayın:

1. IDE'nizde kod dosyanızı açın.

2. Gemini Code Assist araç penceresinde istemi girinExplain this code to me ve Gönder'i tıklayın.

Gemini Code Assist, isteminize referans olarak kod dosyanızdaki kodu kullanır ve kodunuzun açıklamasını içeren bir yanıt verir.

Yalnızca kodunuzun belirli bir kısmının açıklamasını istiyorsanız ilgili kodu seçip Gemini Code Assist'i tekrar çağırabilirsiniz. Gemini Code Assist, seçilen kodu yalnızca oluşturulan yanıtı referans olarak kullanır.

Gemini Code Assist, yanıtında size kod sağladığında yanıtın sonunda listelenen aşağıdaki seçenekleri belirleyebilirsiniz:

• İmlecin olduğu yere ekle: Oluşturulan kodu, geçerli imleç konumunuzda mevcut dosyanıza ekler.

• Yeni Dosyaya Ekle: Yeni bir dosya açar ve oluşturulan kodu yeni dosyaya ekler.

  

Bu seçenekler, Gemini Code Assist kod bloğunuzda kullanılan dili tanımladığında ve bu dil mevcut IDE'nizde destekliyorsa kullanılabilir.

Sorgu geçmişini görüntüleme

Önceki istemlerinizi yeniden kullanmak istiyorsanız schedule Sorgu Geçmişini Göster'i tıklayarak Gemini Code Assist araç penceresindeki Sorgu Geçmişi'nde bulabilirsiniz.

Birden fazla sohbet oluşturma

Gemini Code Assist ile diğer sohbetlerden ayrı kendi bağlamlarını içeren birden fazla sohbet oluşturabilirsiniz. Sohbet geçmişinizde ilk sohbetiniz ve son güncelleme zaman damgası gösterilir. 20 sohbet sınırı vardır. Bu sınıra ulaştığınızda, yeni bir sohbet eklediğinizde en eski sohbet otomatik olarak silinir.

VS Code

1. Yeni bir sohbet eklemek için ekle Yeni Sohbet'i tıklayın ve isteminizi metin alanına girin. İstemi girdikten sonra Gemini Code Assist yeni sohbeti oluşturur.
2. Önceki sohbetinize erişmek için geçmiş Önceki Sohbeti Devam Et'i tıklayın. Sohbetlerinizin listesi görünür. Görüntülemek istediğiniz sohbeti seçin.
3. Bir sohbet ileti dizisini silmek için Önceki Sohbeti Devam Et'i, ardından silmek istediğiniz sohbetin yanındaki sil Sil'i tıklayın.

IntelliJ

Bu özellik şu anda IntelliJ için Gemini Code Assist ve desteklenen diğer JetBrains IDE'lerde desteklenmiyor.

Sohbet geçmişini sıfırlama

Gemini Code Assist, istemlerinize yanıt verirken ek bağlam bilgisi için sohbet geçmişini kullanır. Sohbet geçmişiniz artık ulaşmaya çalıştığınız hedefle alakalı değilse sohbet geçmişini sıfırlayabilirsiniz.

Gemini Code Assist'e sohbet üzerinden seçili kodu gösterme

Gemini Code Assist, seçtiğiniz koda göre görevleri gerçekleştirebilir veya sorularınızı yanıtlayabilir. Seçili kodu içeren bir istemi temel alan oluşturulmuş kodu almak için aşağıdaki adımları uygulayın:

VS Code

1. Etkinlik çubuğunda spark Gemini Code Assist'i tıklayarak Gemini Code Assist bölmesini açın.

2. Kod dosyanızda bir kod bloğu seçin.

3. Gemini Code Assist bölmesi metin alanına, seçili kod için bir istem girin.

   Örneğin, kodunuzda bir işlev seçin ve Write a unit test for this function istemini girin.

   Gemini, seçtiğiniz kodu referans olarak kullanır ve isteminize yanıt verir.

IntelliJ

1. Etkinlik çubuğunda çakmak simgesini tıklayarak Gemini Code Assist araç penceresini açın.

2. Kod dosyanızda bir kod bloğu seçin.

3. Gemini Code Assist araç penceresinin metin alanına, seçili kod için bir istem girin.

   Örneğin, kodunuzda bir işlev seçin ve Write a unit test for this function. istemini girin.

   Gemini Code Assist, seçtiğiniz kodu referans olarak kullanır ve isteminize yanıt verir.

Yerel kod tabanı farkındalığıyla çalışma alanınızdaki belirli dosya ve klasörler için istem gösterme

Önizleme

Gemini Code Assist ile bağlam olarak kullanılacak klasörleri belirtme özelliği, önizleme sürümündedir. Önizlemedeki ürünler ve özellikler "olduğu gibi" kullanılabilir.

Yerel kod tabanı farkındalığı, Gemini Code Assist'in bağlam olarak kullanacağı dosyaları veya klasörleri belirttiğinizde, kod tabanınızın daha geniş bağlamı içinde sentaks açısından doğru ve anlamsal olarak anlamlı olan yüksek kaliteli kod önerileri almanıza yardımcı olur.

Gemini Code Assist, bir klasör belirttiğinizde bağlam olarak hem klasördeki hem de alt klasörlerdeki dosyaları kullanır.

Not: Gemini Code Assist, bir klasör eklediğinizde klasör ve alt klasörlerinde bulduğu ilk 100 dosyayı seçer. Bu sınırın ötesinde kod tabanı farkındalığına ihtiyacınız varsa kod özelleştirme kullanmayı düşünebilirsiniz.

VS Code

Sohbet isteminizde dosya veya klasör belirtmek için @ yazıp belirtmek istediğiniz dosyayı veya klasörü seçin.

Kod tabanınızdaki iki dosya arasındaki farklar hakkında açıklama almak için aşağıdaki adımları uygulayın:

1. Etkinlik çubuğunda spark Gemini Code Assist'i tıklayın.

2. Gemini Code Assist bölmesine Explain the difference between @YOUR_FILE_NAME_1 and @YOUR_FILE_NAME_2 istemini girin ve Enter (Windows ve Linux için) veya Return (macOS için) ya da Tab tuşuna basın. Dosyayı seçmek için listedeki dosyanın adını da tıklayabilirsiniz. Dosya adını tıkladığınızda dosya, istem bağlamınıza eklenir ve IDE'nizde açılır.

Gemini Code Assist, bağlam için belirttiğiniz iki dosyayı kullanarak isteminize yanıt verir. Gemini Code Assist, bağlam kaynaklarında belirttiğiniz dosyaları da içerir.

Bu dosyaları belirttikten sonra, dosyaları tekrar belirtmek zorunda kalmadan aynı sohbet geçmişinde ek sorular veya istemler sormaya devam edebilirsiniz.

Örneğin: Gemini Code Assist bölmesine How can I improve YOUR_FILE_NAME_1? istemini (@ sembolü olmadan) girin ve Enter (Windows ve Linux için) veya Return (macOS için) tuşuna basın.

Gemini Code Assist, isteminizde belirttiğiniz dosyayla ilgili sorgunuzu yanıtlar.

Not: Sohbet geçmişinizi silerseniz Gemini Code Assist artık bağlam için dosyalarınızı kullanmaz. Dosyalar hakkında daha fazla bilgi edinmek isterseniz sohbet bölmesinde @ simgesini kullanarak dosyaları yeniden belirtmeniz gerekir.

IntelliJ

Sohbet isteminizde dosya veya klasör belirtmek için @ yazıp belirtmek istediğiniz dosyaları veya klasörleri seçin.

Kod tabanınızdaki iki dosya arasındaki farklar hakkında açıklama almak için aşağıdaki adımları uygulayın:

1. Etkinlik çubuğunda spark Gemini Code Assist'i tıklayın.

2. Gemini Code Assist bölmesine Explain the difference between @YOUR_FILE_NAME_1 and @YOUR_FILE_NAME_2 istemini girin ve Enter (Windows ve Linux için) veya Return (macOS için) ya da Tab tuşuna basın. Dosyayı seçmek için listedeki dosyanın adını da tıklayabilirsiniz. Dosya adını tıkladığınızda dosya, istem bağlamınıza eklenir ve IDE'nizde açılır.

Gemini Code Assist, bağlam için belirttiğiniz iki dosyayı kullanarak isteminize yanıt verir. Gemini Code Assist, bağlam kaynaklarında belirttiğiniz dosyaları da içerir.

Bu dosyaları belirttiğiniz için, aynı sohbet geçmişinde tekrar belirtmenize gerek kalmadan ek sorular veya istemler sormaya devam edebilirsiniz.

Örneğin: Gemini Code Assist bölmesine How can I improve YOUR_FILE_NAME_1? istemini (@ sembolü olmadan) girin ve Enter (Windows ve Linux için) veya Return (macOS için) tuşuna basın.

Gemini Code Assist, isteminizde belirttiğiniz dosyayla ilgili sorgunuzu yanıtlar.

Not: Sohbet geçmişinizi silerseniz Gemini Code Assist artık bağlam için dosyalarınızı kullanmaz. Dosyalar hakkında daha fazla bilgi edinmek istiyorsanız sohbet bölmesinde @ simgesini kullanarak dosyaları veya klasörleri yeniden belirtmeniz gerekir.

Bağlam çekmecesinde dosya ve klasörleri yönetme

Gemini Code Assist istemleriniz için bağlam olarak kullanılacak bir dosya veya klasör belirttikten sonra bu dosya ve klasörler, görüntüleyip istem bağlamından kaldırabileceğiniz bağlam çekmecesine yerleştirilir.

Bağlam Çekme Menünüzdeki dosyaları ve klasörleri yönetmek için aşağıdaki görevleri gerçekleştirin:

VS Code

Not: 2.34.0 sürümünden önce VS Code için Gemini Code Assist ile oluşturulan sohbetler, kaydedilen bağlamı saklamaz ve Bağlam Çekmecesi'nde göstermez. Bu durum, sohbetin doğru bağlamı göstermemesine yol açabilir. Sohbetler arasında bağlam oluşturmak ve bağlamı korumak için bu sürümden önceki sohbetleri temizlemenizi öneririz.

1. IDE'nizin etkinlik çubuğunda spark Gemini CodeAssist'i tıklayın.

2. Bağlam Çekme Menünüzdeki dosyaları ve klasörleri görüntülemek için Bağlam öğeleri'ni tıklayın.

   

3. Bağlam çekmecesinden öğeleri kaldırmak için close Kaldır'ı tıklayın.

IntelliJ

1. Etkinlik çubuğunda spark Gemini Code Assist'i tıklayın.

2. Bağlam çekmecinizdeki dosyaları ve klasörleri görüntülemek için Bağlam'ı tıklayın.

   

3. Dosyaları ve klasörleri Bağlam Çekmecesi'nden kaldırmak için close Kaldır'ı tıklayın.

Özel komutlar oluşturma

Gemini Code Assist varsayılan olarak VS Code için /generate ve IntelliJ ile desteklenen diğer JetBrains IDE'ler için Kod Oluştur gibi komutlar sağlar. Ayrıca, IDE'nizde tekrarlanan görevleri daha hızlı tamamlamanıza yardımcı olacak kendi özel komutlarınızı da oluşturabilirsiniz.

Bu bölümde, kod dosyanızdaki koda yorum ekleyen add-comments adlı özel bir komut oluşturursunuz. IntelliJ ve desteklenen diğer JetBrains IDE'lerde özel komutu istem kitaplığından ve düzenleyici içi istemden oluşturur, kaydeder ve çalıştırırsınız.

VS Code

1. Kod dosyanızda Gemini Code Assist Hızlı Seçim menüsünü açmak için Control+I (Windows ve Linux için) veya Command+I (macOS için) tuşlarına basın.

2. Menüde Tercihler: Ayarları Aç (Kullanıcı Arayüzü)'ı arayıp seçin.

3. Arama ayarları alanına Geminicodeassist: Custom Commands yazın.

4. Özel Komutlar kutusunda Öğe Ekle'yi seçin.

5. Öğe alanına komutun adı olarak add-comments yazın.

6. Değer alanına istem olarak add comments to all functions without comments in my code yazın.

7. Tamam'ı tıklayın.

Artık IDE'nizde add-comments özel komutunu kullanabilirsiniz. Komut, Gemini Code Assist Hızlı Seçim menüsündeki komut listesinde (Control+I (Windows ve Linux için) veya Command+I (macOS için)) görünür.

IntelliJ

1. IDE'nizde Ayarlar > Araçlar > Gemini > İstem Kitaplığı'na gidin.

   

2. İstem Kitaplığı penceresinde add Ekle'yi tıklayın.

3. Özel komutunuzu add-comments olarak adlandırın.

4. İstem kitaplığının metin kutusuna şu istemi girin: Add comments to all functions without comments in this code.

5. Henüz seçili değilse Düzenleyici İçerisinde İstemde Göster onay kutusunu işaretleyin.

6. Özel komutu istem kitaplığına kaydetmek için Tamam'ı tıklayın.

7. Kod dosyanızda, değiştirmek istediğiniz kodu vurgulayın.

8. Vurgulanan kodu sağ tıklayın ve Gemini > İstem Kitaplığı'na gidin, ardından özel komut add-comments'yi seçin.

   Gemini Code Assist, add-comments komutunu yürütür ve vurguladığınız koda yorum ekler.

Özel komutu, aşağıdaki görevleri gerçekleştirerek düzenleyici istemiyle de çağırabilirsiniz:

1. Kod dosyanızda, değiştirmek istediğiniz kodu vurgulayın ve Gemini Code Assist Hızlı Seçim menüsünü açmak için Alt+\ (Windows ve Linux için) veya Cmd+\ (macOS için) tuşlarına basın.

2. Menüden özel komutunuzu add-comments seçin.

   Gemini Code Assist, add-comments komutunu yürütür ve vurguladığınız koda yorum ekler.

Kural oluşturma

Gemini Code Assist'in uyması için kurallar oluşturabilirsiniz. Bu kurallar, girdiğiniz her sohbet isteminde yer alır.

VS Code

1. Kod dosyanızda Gemini Code Assist Hızlı Seçim menüsünü açmak için Control+I (Windows ve Linux için) veya Command+I (macOS için) tuşlarına basın.

2. Menüde Tercihler: Ayarları Aç (Kullanıcı Arayüzü)'ı arayıp seçin.

3. Arama ayarları alanına Geminicodeassist: Rules yazın.

4. Metin alanına Always generate unit tests when creating a new function gibi bir kural girin. Metin alanına birden fazla satırlık bir veya daha fazla kural da ekleyebilirsiniz.

   Kurallar ayarlarına kural ekledikten sonra Gemini Code Assist, yaptığınız her istem veya istek için kuralı dikkate alır.

   Kuralı kaldırmak için Kurallar metin alanındaki içeriği silin.

IntelliJ

Bu özellik şu anda IntelliJ için Gemini Code Assist ve desteklenen diğer JetBrains IDE'lerde desteklenmemektedir.

Bilinen sorunlar

Bu bölümde, Gemini Code Assist ile ilgili bilinen sorunlar özetlenmiştir:

VS Code

• Büyük bir açık dosyanın güncellenmiş sürümünü içeren sohbet yanıtları kısaltılabilir

  Bu sorunu gidermek için daha küçük bir kod bölümü seçin ve sohbet isteminde only output the selected code. gibi ek bir yönerge ekleyin.

• Vim: Ekle modunda değilseniz kod oluşturma önerilerini kabul edemez veya reddedemezsiniz

  Vim eklentisini normal modda kullanırken kod önerilerini kabul edemez veya reddedemezsiniz.

  Bu sorunu gidermek için ekleme moduna girmek üzere i tuşuna, ardından öneriyi kabul etmek için Sekme tuşuna basın.

• Vim: Önerileri reddetmek için Esc tuşuna basıldığında tutarsız davranış

  Esc tuşuna bastığınızda hem IDE hem de Gemini Code Assist önerileri kapatılır. Bu davranış, Esc tuşuna basıldığında Gemini Code Assist'in yeniden tetiklendiği Vim dışı davranıştan farklıdır.

• Oturum açma girişimleri zaman aşımına uğruyor

  Oturum açma denemeleriniz zaman aşımına uğramaya devam ediyorsa cloudcode.beta.forceOobLogin ayarını settings.json dosyanıza eklemeyi deneyin:

   "cloudcode.beta.forceOobLogin": true
  

• Lisans okuma uyarıları oturumlar arasında devam etmez

  Lisans okuma uyarıları oturumlar arasında devam etmiyorsa kalıcı günlüklere bakın:

  1. Görünüm > Çıkış'ı tıklayın.

  2. Gemini Code Assist - Citations (Gemini Code Assist - Alıntılar) seçeneğini belirleyin.

• Gemini Code Assist çıkış penceresindeki bağlantı sorunları

  Gemini Code Assist çıkış penceresinde bağlantı hatası veya başka bağlantı sorunları görürseniz aşağıdakileri deneyin:

  • Güvenlik duvarınızı oauth2.googleapis.com ve cloudaicompanion.googleapis.com'a erişime izin verecek şekilde yapılandırın.

  • Güvenlik duvarınızı, gRPC'nin kullandığı HTTP/2 üzerinden iletişime izin verecek şekilde yapılandırın.

  Bağlantıyı test etmek için grpc-health-probe aracını kullanabilirsiniz. Başarılı bir kontrol aşağıdaki çıkışı sağlar:

  $ grpc-health-probe -addr cloudaicompanion.googleapis.com:443 -tls error: this server does not implement the grpc health protocol (grpc.health.v1.Health): GRPC target method can't be resolved

  Başarısız bir kontrol aşağıdaki çıkışla sonuçlanır:

  timeout: failed to connect service "cloudaicompanion.googleapis.com:443" within 1s

  Daha fazla bilgi edinmek için grpc-health-probe'den önce aşağıdakileri çalıştırın:

  export GRPC_GO_LOG_SEVERITY_LEVEL=info
  

IntelliJ

IntelliJ ve diğer desteklenen JetBrains IDE'ler için Gemini Code Assist ile ilgili bilinen bir sorun yoktur.

Geri bildirim gönder

Deneyiminizle ilgili geri bildirim bırakmak için aşağıdaki adımları uygulayın:

VS Code

1. Durum çubuğunda spark Gemini Code Assist'i tıklayın ve ardından Hızlı Seç menüsünde Geri bildirim gönder'i seçin.

2. Formdaki Başlık ve Yorumlar alanlarını doldurun.

3. Skaffold veya AI Companion günlüklerinizi paylaşmak istiyorsanız Skaffold günlüklerini gönder veya AI Companion günlüklerini gönder seçeneğini belirlediğinizden emin olun.

4. Geri Bildirim Gönder'i tıklayın.

IntelliJ

1. Durum çubuğunda spark Gemini CodeAssist'i tıklayın ve menüden Geri bildirim gönder'i seçin.

2. Formun üst kısmındaki metin alanına geri bildiriminizi girin.

3. Gemini Code Assist günlüklerinizi paylaşmak istiyorsanız günlük dosyalarını seçtiğinizden emin olun.

4. Geri Bildirim Gönder'i tıklayın.

Sırada ne var?

• Google Cloud için Gemini'nin verilerinizi nasıl kullandığını öğrenin.
• Gemini Code Assist Standard ve Enterprise fiyatlandırması hakkında bilgi edinin.