Workspace'lerde Firebase'de Gemini'yi ayarlama

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.

• Workspace'e uyumlu ve kodunuzla tamamen entegre olan yapay zeka destekli sohbet. Kod oluşturabilir, kodları çevirebilir ve açıklayabilir. Ayrıca, incelemeniz ve onayınıza bağlı olarak Firebase'teki Gemini, dosyaları güncellemek, terminal komutlarını çalıştırmak, komut çıktısını yorumlamak ve sonraki adımları belirlemek için doğrudan çalışma alanınızla etkileşim kurabilir. Daha fazla bilgi için Gemini ile sohbet etmeyi deneyin başlıklı makaleyi inceleyin.

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

• Satır içi kod yardımıyla ilgili

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

• Kod tamamlama ayarlarını düzenleyin.
• Kod tabanı dizine ekleme ayarlarınızı yapın.
• Gemini ile ilgili talimatları bir yapay zeka kuralları dosyasıyla özelleştirin.
• .aiexclude dosyalarıyla Gemini'deki dosyaları hariç tut.
• Kendi anahtarınızı getirin: Sohbette diğer Gemini modellerini kullanın

Workspace'inizdeki Firebase'te Gemini'yi kullanma

Sohbet paneli veya satır içi kod yardımı ile kodlama üretkenliğinizi artırmak için Firebase'te Gemini'yi kullanın.

1. Workspace'inizde sohbet 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 simgesini 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 dizine ekleme işleminden de hariç tutabilirsiniz. .aiexclude dosyalarıyla Gemini dosyalarını hariç tutma başlıklı makaleyi inceleyin.

Firebase kısayollarında Gemini

Gemini ile olan 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 yazmaya başlar başlamaz açık dosyalardaki kodu tahmin edip otomatik olarak dolduran yapay zeka kod tamamlama özelliği sunar.

Kod tamamlamanın varsayılan olarak etkin olduğunu unutmayın.

Kod tamamlamayı 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.

     Prototyper view, click Switch to Code to open Code view.'te App Prototyping agent kullanıyorsanız

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

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

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

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

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

Kod dizine eklemeyi 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+, (Mac'te Cmd+,) tuşuna basın.

     Prototyper view, click Switch to Code to open Code view.'te App Prototyping agent kullanıyorsanız

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

  3. Firebase Studio > Yapay zeka: Kod tabanı dizine eklemeyi etkinleştir'i seçin.

  4. Kod dizine eklemeyi devre dışı bırakmak için Yapay zeka: Kod tabanı dizine eklemeyi etkinleştir seçeneğinin işaretini kaldırın. Her çalışma alanınızın kod dizine ekleme ayarlarını güncellemeniz gerekir.

Firebase'te Gemini talimatlarını yapay zeka kuralları dosyasıyla özelleştirme

Bir yapay zeka kuralları dosyası (.idx/airules.md) oluşturarak bağlam ve sistem istemi bilgileri ekleyebilirsiniz. Firebase'teki Gemini, yanıtlarının kullanım alanınıza göre özelleştirilmesini sağlamak için kurallarınızı sistem talimatları ve bağlam olarak kullanır.

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

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

Yapılandırdığınız kurallar, sohbet bölümünde Gemini tarafından kullanılır.

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

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

1. Firebase Studio çalışma alanınızdaki .idx/airules.md konumunda (dev.nix dosyanızla aynı dizinde) yeni bir dosya oluşturun. Aşağıdaki seçeneklerden birini kullanabilirsiniz:

   • Gezgin'de (Ctrl+Shift+E) .idx dosyasını sağ tıklayın ve Yeni dosya'yı seçin. Dosyayı airules.md olarak adlandırıp Enter tuşuna basın.
   • Terminalde, tercih ettiğiniz metin düzenleyiciyi kullanarak .idx/airules.md dosyasını açın.

2. Dosyaya içerik ekleyin. Gemini karakterinin kullanması gereken bilgiler (ör. "Next.js hakkında her şeyi bilen uzman bir geliştirici ve yardımcı asistansınız"), kodlama ve sohbet standartları ve projeyle ilgili bağlam hakkında bilgi ekleyebilirsiniz. Örnek bir yapay zeka kuralları dosyası için aşağıdaki örneğe bakın.

3. Dosyayı kaydedin ve Gemini'yi Firebase'de 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 Firebase'teki Gemini, Chat'teki kurallar dosyasını kullanır. Yapay zeka kuralları dosyasında yapılan değişiklikler sohbete hemen yansıtılır.
   • Workspace'inizi yeniden oluşturmak istemiyorsanız sohbet üzerinden Geminiload airules.md'den yardım isteyebilirsiniz. Mevcut oturum sırasında dosyada değişiklik yaparsanız Gemini'den kuralları tekrar yüklemesini istemeniz gerekebilir.

5. Kodunuzla ilgili soru sorabilirsiniz. Gemini, kurallar dosyasına dahil ettiğiniz bilgileri bağlam olarak kullanarak yanıt verir.

Örnek

Aşağıda, Next.js ile geliştirilmiş bir gündelik oyun için kullanabileceğiniz temel bir kurallar dosyası örneği 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.

.aiexclude dosyaları ile Gemini'teki dosyaları hariç tutma

Projenize .aiexclude dosyaları ekleyerek kod tabanınızdaki hangi dosyaların Gemini'ten gizli tutulacağını kontrol edebilirsiniz. Bu sayede, Gemini ile paylaştığınız proje bağlamını ayrıntılı olarak kontrol edebilirsiniz.

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

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

• Sohbet yardımı: Gemini, .aiexclude kapsamındaki dosyalar hakkında soruları yanıtlayamaz veya öneride bulunamaz.
• Kod tamamlama: Kapsanan dosyalar düzenlenirken önerilen kod tamamlama seçenekleri kullanılamaz.
• Satır içi yardım: Kapsanan dosyaları düzenlerken yeni kod oluşturabilirsiniz ancak mevcut kodu değiştiremezsiniz.

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

.aiexclude dosyaları yazma

.aiexclude dosyaları, .gitignore dosyalarıyla aynı söz dizimini kullanır. Bununla birlikte, aşağıdaki 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ı olumsuzlama işlemini (! ile kalıpların başına ! eklenmesi) desteklemez.

Örnekler

Aşağıda bazı örnek .aiexclude dosyası yapılandırmaları verilmiştir:

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

  apikeys.txt
  

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

  *.key
  

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

  /apikeys.txt
  

• my/sensitive/dir dizinindeki ve tüm alt dizinlerdeki tüm dosyaları engelleyin. Yol, .aiexclude dosyasını içeren dizinle ilişkili olmalıdır:

  my/sensitive/dir/
  

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

Chat'teki FirebaseGemini'nin kullandığı Gemini modelini yapılandırabilirsiniz. Yerleşik modeli, sohbet penceresinde yapılandırılan modelleri (Gemini 2.5 modelleri dahil) veya erişiminiz olan herhangi bir Gemini modelini seçebilirsiniz.

Mevcut tüm modellerin listesi için Gemini models bölümüne bakın.

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 alt kısmındaki çakmak simgesini Gemini (veya Gemini sekmesini) tıklayın.

2. Firebase'te Gemini sohbet penceresinde model adı açılır menüsünü ve ardından Gemini API anahtarı bağlantısını tıklayın. Kullanıcı Ayarları görünür.

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

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, en son kararlı Gemini 2.0 Flash‑Lite modelini kullanmak için gemini-2.0-flash-lite değerini girersiniz.

2. Firebase sohbet penceresindeki Gemini'de 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. Sohbet penceresini kapatın, ardından model listesini yenilemek için çalışma alanının alt kısmındaki çakmak simgesini Gemini tıklayarak yeniden açın.

Sonraki adımlar

• Firebase'te Gemini'yi deneyin.