Çalışma alanlarında Gemini'ı yapılandırma

Firebase Studio, aşağıdaki yapay zeka destekli kod özellikleriyle geliştirme iş akışlarınızı kolaylaştırır:

• Yazarken önerilen kod tamamlama.

• Çalışma alanına duyarlı ve kodunuzla tamamen entegre olan sohbetle yapay zeka yardımı. Kod oluşturabilir, çevirebilir ve açıklayabilir. İncelemeniz ve onayınızla birlikte Gemini, dosyaları güncellemek, terminal komutlarını çalıştırmak, komut çıkışını yorumlamak ve sonraki adımları belirlemek için doğrudan çalışma alanınızla etkileşime geçebilir. Try chat with Gemini within Firebase Studio adresinden daha fazla bilgi edinin.

• Seçili kod parçaları üzerinde yapabileceğiniz satır içi işlemler. Örneğin, Gemini'dan seçilen kodu daha okunabilir hale getirmesini isteyebilirsiniz.

• Satır içi kodlama yardımı.

Önemli: Bu kılavuzda varsayılan Gemini etkileşimli sohbet açıklanmaktadır. App Prototyping agent ile oluşturulan uygulamalar, Code görünümünde varsayılan olarak Prototyper sohbetini kullanır. Bunun yerine Gemini etkileşimli sohbeti kullanmak için Gemini bölümünde + işaretini tıklayın ve Yeni Sohbet'i seçin. Prototyper sohbetine dönmek için Son sohbetler'i tıklayın ve Prototyper sohbeti'ni seçin. Prototyper sohbeti hakkında bilgi edinmek için App Prototyping agent'ı kullanmaya başlama başlıklı makaleyi inceleyin.

Gemini'nın size nasıl yardımcı olacağını, ayarlarını düzenleyerek ve yapay zeka kuralları dosyaları ekleyerek özelleştirebilirsiniz:

• Kod tamamlama ayarlarını düzenleme.
• Kod tabanı dizine ekleme ayarlarınızı düzenleyin.
• Gemini için talimatları yapay zeka kuralları dosyasıyla özelleştirme.
• .aiexclude dosyalarıyla Gemini dosyalarını hariç tutun.
• Kendi anahtarınızı getirin: Sohbetlerde diğer Gemini modellerini kullanma
• Gemini'nin kod değişikliklerini nasıl önerdiğini veya uyguladığını ayarlayın.

Önemli: Gemini, olası görünen ancak gerçekte yanlış olan çıktılar üretebilir. Google'ın görüşlerini yansıtmayan yanlış bilgilerle yanıt verebilir. Gemini'dan gelen tüm çıktıları kullanmadan önce doğrulayın ve test edilmemiş kodları üretimde kullanmayın. Sohbet penceresine kimliği tanımlayabilecek bilgiler (PII) veya kullanıcı verileri girmeyin.

Çalışma alanınızda Gemini kullanma

Gemini ile sohbet paneli, terminal veya satır içi kod yardımı aracılığıyla kodlama üretkenliğinizi artırın.

Not: App Prototyping agent görünümünde Prototyper kullanıyorsanız Koda Geç'i tıklayarak Code görünümünü açın.

1. Çalışma alanınızda sohbeti veya satır içi kod yardımını kullanın:

   • Sohbeti kullanmak için: Açık çalışma alanınızda, çalışma alanının alt kısmındaki spark'ı Gemini tıklayın.

   • Satır içi kod yardımını kullanmak için: Kodunuzu yazmaya başlayın ve önerileri kabul etmek için Tab tuşuna basın.

2. Aşağıdaki iki seçeneğin varsayılan olarak etkin olduğunu unutmayın:

   • Satır içi kod tamamlama sağlayan yazarken öneriler.
   • Daha iyi özelleştirme ve daha faydalı yanıtlar sağlayan kod tabanı dizine ekleme.

   Gelecekte çalışma alanı ayarlarınız için bu seçimleri değiştirmek isterseniz:

   • Kod tamamlama ayarlarını güncellemek için Kod tamamlama ayarlarınızı düzenleme başlıklı makaleyi inceleyin.
   • Kod dizine ekleme ayarlarını güncellemek için Kod dizine ekleme ayarlarınızı düzenleme başlıklı makaleyi inceleyin.

   Belirli dosyaları ve dizinleri yapay zeka indekslemesinden de hariç tutabilirsiniz. .aiexclude dosyalarıyla Gemini dosyalarını hariç tutma başlıklı makaleyi inceleyin.

Gemini kısayollar

Gemini ile sohbeti hızlıca açmak için Ctrl+Shift+Space (veya MacOS'te Cmd+Shift+Space) tuşuna basın.

Komut paletinden Gemini komutlarını görüntülemek için:

1. Ctrl+Shift+P (veya MacOS'te Cmd+Shift+P) tuşuna basarak komut paletini açın.

2. Gemini için arama yapın.

   Gemini komutlarının listesi gösterilir.

Kod tamamlama ayarlarınızı düzenleme

Firebase Studio, kod yazmanıza yardımcı olmak için yapay zeka kod tamamlama özelliği sunar. Bu özellik, yazmaya başladığınız anda açık olan tüm dosyalardaki kodu tahmin edip otomatik olarak doldurur.

Kod tamamlama özelliğinin varsayılan olarak etkin olduğunu unutmayın.

Kod tamamlama özelliğini etkinleştirmek veya devre dışı bırakmak için aşağıdaki yöntemlerden birini kullanarak kod tamamlama ayarlarınızı düzenleyin:

• settings.json dosyası kullanıyorsanız "IDX.aI.enableInlineCompletion" değerini true veya false olarak ayarlayın.

• Firebase Studio çalışma alanındaki ayarları güncellemek için:

  1. Yönet'i (çalışma alanının sol alt kısmında bulunur) tıklayın, ardından Ayarlar'ı seçin veya Ctrl+, (Mac'te Cmd+,) tuşuna basın.

     App Prototyping agent görünümünde Prototyper kullanıyorsanız Koda Geç'i tıklayarak Code görünümünü açın.

  2. Workspace sekmesini seçin, ardından Firebase Studio > Yapay Zeka > Satır İçi Tamamlama'yı Etkinleştir ayarını arayın.

  3. Kod tamamlama özelliğini devre dışı bırakmak için Yazarken satır içi kod tamamlama özelliğini etkinleştir seçeneğinin işaretini kaldırın.

İpucu: Bu ayarı tüm çalışma alanlarınızda korumak için ayarı Kullanıcı sekmesinde yapılandırın. Bu sayede, kullanıcı hesabınızla eriştiğiniz her çalışma alanında ayarlarınızın uygulanması sağlanır. Çalışma alanınızı paylaşıyorsanız Workspace ayarını yapılandırmanız gerekir.

Kod tabanı dizine ekleme ayarlarınızı düzenleme

Gemini'nın kodunuzu dizine ekleyip eklemeyeceğini kontrol edebilirsiniz. Kodunuzu dizine eklemek, sohbet veya satır içi yapay zeka yardımını kullanırken daha faydalı sonuçlar sağlar.

Kod tabanı dizine eklemenin varsayılan olarak etkin olduğunu unutmayın.

İpucu: Gemini'ın hangi dosyaları dizine ekleyeceğini kontrol edebilirsiniz. .aiexclude dosyalarıyla Gemini'dan dosya hariç tutma hakkında daha fazla bilgi edinin.

Kod dizine ekleme özelliğini etkinleştirmek veya devre dışı bırakmak için aşağıdaki yöntemlerden birini kullanarak kod tabanı dizine ekleme ayarlarınızı düzenleyin:

• settings.json dosyası kullanıyorsanız "IDX.aI.enableCodebaseIndexing" değerini true veya false olarak ayarlayın.

• Firebase Studio çalışma alanındaki ayarları güncellemek için:

  1. Yönet'i (çalışma alanının sol alt kısmında bulunur) tıklayın, ardından Ayarlar'ı seçin veya Ctrl+, tuşuna (Mac'te Cmd+,) basın.

     App Prototyping agent görünümünde Prototyper kullanıyorsanız Koda Geç'i tıklayarak Code görünümünü açın.

  2. Workspace sekmesini seçin, ardından Firebase Studio > AI > Satır İçi Tamamlama'yı Etkinleştir ayarını bulun.

  3. Firebase Studio > Yapay Zeka: Kod Tabanı Dizine Eklemeyi Etkinleştir'i seçin.

  4. Kod dizine eklemeyi devre dışı bırakmak için AI: Enable Codebase Indexing (Yapay Zeka: Kod Tabanı Dizine Eklemeyi Etkinleştir) seçeneğinin işaretini kaldırın. Çalışma alanlarınızın her biri için kod dizine ekleme ayarlarını güncellemeniz gerekir.

İpucu: Bu ayarı tüm çalışma alanlarınızda korumak için ayarı Kullanıcı sekmesinde yapılandırın. Bu sayede, kullanıcı hesabınızla eriştiğiniz her çalışma alanında ayarlarınızın uygulanması sağlanır. Çalışma alanınızı paylaşıyorsanız Workspace ayarını yapılandırmanız gerekir.

Gemini için talimatları yapay zeka kuralları dosyasıyla özelleştirme

Yapay zeka kuralları dosyası oluşturarak bağlam ve sistem istemi bilgileri ekleyebilirsiniz:

Gemini sohbet önceliklidir .idx/airules.md ancak .idx/airules.md yoksa GEMINI.md kullanılır.

Gemini, kurallarınızı sistem talimatları ve bağlam olarak kullanır ve yanıtlarını kullanım alanınıza göre özelleştirir.

Aşağıdaki gibi hedeflere ulaşmak için özel istemleri, en iyi uygulamaları ve hatta projenizle ilgili önemli bağlamı Gemini ile paylaşmak üzere yapay zeka kuralları dosyasını kullanın:

• Gemini'ın karakterini etkileme ve uzmanlığını geliştirme
• Kodlama stili, kurallar ve teknoloji tercihleri gibi proje genelinde standartlar uygulama.
• Projenizle ilgili temel bağlamı sağlayarak kodda veya sohbette açıkça paylaşmanız gereken bilgi miktarını azaltır.

Yapay zeka kuralları dosyanızı oluşturma ve test etme

Yapay zeka kuralları dosyanızı oluşturmak ve test etmek için:

1. Firebase Studio çalışma alanınızda .idx/airules.md (veya GEMINI.md) konumunda yeni bir dosya oluşturun. Aşağıdaki seçeneklerden birini kullanabilirsiniz:

   • Gezgin'de (Ctrl+Shift+E) üst dizini sağ tıklayın ve Yeni dosya'yı seçin. Dosyaya ad verin ve Enter tuşuna basın.
   • Terminalden, GEMINI.md veya .idx/airules.md dosyalarını açmak için tercih ettiğiniz metin düzenleyiciyi kullanın.

2. Dosyaya içerik ekleyin. Karakterin kullanması gereken bilgiler (ör. "Next.js hakkında her şeyi bilen uzman bir geliştirici ve faydalı bir asistansın"), kodlama ve sohbet standartları ile proje hakkında bağlam bilgileri eklemek isteyebilirsiniz.Gemini Örnek bir yapay zeka kuralları dosyası için aşağıdaki Örnek bölümüne bakın.

3. Dosyayı kaydedin ve Gemini'ı açın.

4. Yapay zeka kurallarınızı kullanmaya başlamak için aşağıdakilerden birini yapabilirsiniz:

   • Sayfayı yenileyerek çalışma alanını yeniden oluşturun. Yeniden oluşturduktan sonra, Gemini sohbet içinde kurallar dosyasını kullanır. Yapay zeka kuralları dosyasında yapılan değişiklikler hemen yansıtılmalıdır.
   • Çalışma alanınızı yeniden oluşturmak istemiyorsanız Gemini'dan load GEMINI.md veya load airules.md yapmasını isteyebilirsiniz. Geçerli oturum sırasında dosyada değişiklik yaparsanız Gemini'ı kurallar dosyasını tekrar yüklemeye yönlendirmeniz gerekebilir.

5. Kodunuzla ilgili sorular sorun. Gemini, kurallar dosyasına bağlam olarak eklediğiniz bilgileri kullanarak yanıt verir.

   Gemini, öncelik sırasına göre .idx/airules.md, GEMINI.md, .gemini/styleguide.md, AGENTS.md veya cursorrules değerini kullanır.

Örnek

Aşağıda, Next.js ile geliştirilen sıradan bir oyun için kullanabileceğiniz kurallar dosyasına ilişkin temel bir örnek verilmiştir:

# Persona

You are an expert developer proficient in both front- and back-end development
with a deep understanding of Node.js, Next.js, React, and Tailwind CSS. You
create clear, concise, documented, and readable TypeScript code.

You are very experienced with Google Cloud and Firebase services and how
you might integrate them effectively.

# Coding-specific guidelines

- Prefer TypeScript and its conventions.
- Ensure code is accessible (for example, alt tags in HTML).
- You are an excellent troubleshooter. When analyzing errors, consider them
  thoroughly and in context of the code they affect.
- Do not add boilerplate or placeholder code. If valid code requires more
  information from the user, ask for it before proceeding.
- After adding dependencies, run `npm i` to install them.
- Enforce browser compatibility. Do not use frameworks/code that are not
  supported by the following browsers: Chrome, Safari, Firefox.
- When creating user documentation (README files, user guides), adhere to the
  Google developer documentation style guide
  (https://developers.google.com/style).

# Overall guidelines

- Assume that the user is a junior developer.
- Always think through problems step-by-step.

# Project context

- This product is a web-based strategy game with a marine life theme.
- Intended audience: casual game players between the ages of 17 and 100.

İpucu: Yapay zeka kuralları, genel bağlam boyutuna katkıda bulunur. Bu nedenle, en iyi model performansını sağlamak için yapay zeka kuralları dosyanızı makul bir sınırda tutmanızı öneririz.

Gemini klasöründeki .aiexclude dosyaları hariç tut

Projenize .aiexclude dosyalarını ekleyerek kod tabanınızdaki hangi dosyaların Gemini'dan gizli tutulması gerektiğini kontrol edebilirsiniz. Bu sayede, Gemini ile paylaştığınız proje bağlamını ayrıntılı bir şekilde kontrol edebilirsiniz.

.gitignore dosyasına benzer şekilde, .aiexclude dosyası, sohbet deneyimi ve düzenleyicide çalışan yapay zeka özellikleri de dahil olmak üzere Gemini ile paylaşılmaması gereken dosyaları izler. Bir .aiexclude dosyası, kendisini içeren dizinde veya bu dizinin altındaki dosyalarda çalışır.

Not: Deponuzdaki .gitignore dosyaları tarafından yoksayılan dosyalar, .aiexclude dosyasında listelenmemiş olsalar bile otomatik olarak hariç tutulur.

.aiexclude kapsamındaki dosyalar, Codebase Indexing etkinleştirildiğinde Gemini tarafından dizine eklenmez. Ayrıca, .aiexclude, kapsamdaki dosyalar için satır içi yardımı aşağıdaki şekillerde etkileyecektir:

• Sohbet yardımı: Gemini, .aiexclude kapsamındaki dosyalarla ilgili soruları yanıtlayamaz veya önerilerde bulunamaz.
• Kod tamamlama: Kapsam dahilindeki dosyalar düzenlenirken önerilen kod tamamlamaları kullanılamaz.
• Satır içi yardım: Yeni kod oluşturabilirsiniz ancak kapsam dahilindeki dosyaları düzenlerken mevcut kodu değiştiremezsiniz.

Android Studio gibi diğer geliştirme ortamları da .aiexclude dosyalarını destekleyebilir.

.aiexclude dosyaları yazma

.aiexclude dosyası, .gitignore dosyasıyla aynı söz dizimini kullanır. Ancak şu farklılıklar vardır:

• Boş bir .aiexclude dosyası, bulunduğu dizindeki ve tüm alt dizinlerdeki tüm dosyaları engeller. Bu, **/* içeren bir dosyayla aynıdır.
• .aiexclude dosyaları olumsuzlamayı (kalıplara ! öneki ekleme) desteklemez.

Örnekler

Bazı örnek .aiexclude dosya yapılandırmaları:

• apikeys.txt dosyasını içeren dizinde veya bu dizinin altında .aiexclude adlı tüm dosyaları engelleyin:

  apikeys.txt
  

• .key dosya uzantısına sahip tüm dosyaları, .aiexclude dosyasını içeren dizinde veya bu dizinin altında engelleyin:

  *.key
  

• Yalnızca apikeys.txt ile aynı dizindeki .aiexclude dosyasını engelleyin, alt dizinleri engellemeyin:

  /apikeys.txt
  

• my/sensitive/dir dizinindeki ve tüm alt dizinlerdeki tüm dosyaları engeller. Yol, .aiexclude dosyasını içeren dizine göre olmalıdır:

  my/sensitive/dir/
  

Kendi anahtarınızı getirin: Chat'te diğer Gemini modellerini kullanma

Deneysel: Bu özellik deneyseldir.

Gemini Sohbet'in kullandığı Gemini modelini yapılandırabilirsiniz. Yerleşik modeli, sohbet penceresinde yapılandırılan modelleri veya erişiminizin olduğu herhangi bir Gemini modelini seçebilirsiniz.

Kullanılabilir tüm modellerin listesi için Gemini modeller başlıklı makaleyi inceleyin.

Önemli: Firebase Studio yapay zeka ayarları kullanıcı ayarlarıdır. Bu, ayarların birden fazla iş istasyonunda sizin için yapılandırılmış olarak kalacağı anlamına gelir.

Anahtarınızı yapılandırmak ve farklı bir Gemini modeli seçmek için:

1. Açık çalışma alanınızda, çalışma alanının en altındaki (veya Gemini sekmesi) spark'ı Gemini tıklayın.

2. Gemini sohbet penceresinde Yapay Zeka Ayarları'nı tıklayın. Kullanıcı Ayarları gösterilir.

3. IDX > AI: Gemini Api Key (IDX > AI: Gemini API Anahtarı) alanına Gemini API anahtarınızı girin.

   Not: App Prototyping agent simgesini kullandıysanız ve bu simge sizin için bir Firebase projesi ve Gemini API anahtarı oluşturduysa bu alan zaten doldurulmuş olabilir.

4. IDX > AI: Model Provider (IDX > Yapay Zeka: Model Sağlayıcı) açılır listesinden Gemini API seçeneğini belirleyin.

Artık sohbette önceden yapılandırılmış Gemini modellerinden herhangi birini seçebilirsiniz.

Açılır listede bulunmayan bir Gemini modelini yapılandırmak için:

1. Gemini modelleri listesinden sohbette kullanmak istediğiniz Gemini modelini belirleyin. Örneğin, Gemini 3 Pro Preview önizleme modelini kullanmak için gemini-3-pro-preview yazın.

2. Gemini sohbet penceresinde model seçiciyi tıklayın, ardından Özel model kimliği'ni seçin. Kullanıcı Ayarları açılır.

3. Seçtiğiniz model adını IDX > AI: Gemini Model alanına kopyalayın.

4. Model listesini yenilemek için sohbet penceresini kapatın, ardından çalışma alanının alt kısmındaki spark Gemini simgesini tıklayarak yeniden açın.

Sonraki adımlar

• Gemini'i deneyin.