Workspace'teki Firebase'de Gemini'yi 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.

  • Workspace'e duyarlı ve kodunuzla tamamen entegre olan sohbet özelliğiyle yapay zeka yardımı Kod oluşturabilir, çevirebilir ve açıklayabilir. Ayrıca, incelemeniz ve onayınızla birlikte Firebase'daki 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şimde bulunabilir. Daha fazla bilgiyi Try chat with Gemini adresinde bulabilirsiniz.

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

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

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

Workspace'inizde Firebase'da Gemini'ı kullanma

Firebase'da Gemini'ı kullanarak sohbet paneli veya satır içi kod yardımıyla kodlama üretkenliğinizi artırı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 parıltı 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:

    Belirli dosyaları ve dizinleri de yapay zeka dizine ekleme işleminden hariç tutabilirsiniz. .aiexclude dosyalarıyla Gemini içindeki dosyaları hariç tutma başlıklı makaleyi inceleyin.

Firebase kısayollarında Gemini

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 destekli 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. Dişli simgesi 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 kullanıyorsanız Prototyper view, click Code switch icon Switch to Code to open Code view.

    2. Workspace sekmesini seçin, ardından Firebase Studio > AI > 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.

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 ekleme özelliğinin varsayılan olarak etkin olduğunu unutmayın.

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. Dişli simgesi 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 kullanıyorsanız Prototyper view, click Code switch icon Switch to Code to open Code view.

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

    3. Firebase Studio > AI: Enable Codebase Indexing'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.

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

Yapay zeka kuralları dosyası (.idx/airules.md) oluşturarak bağlam ve sistem istemi bilgileri ekleyebilirsiniz. Firebase içindeki Gemini, kurallarınızı sistem talimatları ve bağlam olarak kullanarak yanıtlarının kullanım alanınıza göre özelleştirilmesini sağlar.

Aşağıdaki gibi hedeflere ulaşmak için yapay zeka kuralları dosyasını kullanarak özel istemleri, en iyi uygulamaları ve hatta projenizle ilgili önemli bağlamı Gemini ile paylaşı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.

Yapılandırdığınız kurallar, Gemini tarafından sohbette kullanılır.

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

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

  1. .idx/airules.md konumunda, Firebase Studio çalışma alanınızda (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. Dosyaya airules.md adını verin ve Enter tuşuna basın.
    • Terminalden, tercih ettiğiniz metin düzenleyiciyi kullanarak .idx/airules.md dosyasını açın.

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

  3. Dosyayı kaydedin ve Gemini'ı Firebase'da 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 içindeki Gemini, sohbet içindeki kurallar dosyasını kullanır. Yapay zeka kuralları dosyasında yapılan değişiklikler sohbete hemen yansıtılmalıdır.
    • Çalışma alanınızı yeniden oluşturmak istemiyorsanız Gemini kullanarak load airules.md isteğinde bulunabilirsiniz. Mevcut oturum sırasında dosyada değişiklik yaparsanız kurallar dosyasını tekrar yüklemek için Gemini istemini yeniden girmeniz gerekebilir.

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

Ö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.

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

Gemini dosyalarını projenize ekleyerek kod tabanınızdaki hangi dosyaların .aiexclude'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ı da 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 dizindeki veya bu dizinin altındaki dosyalar üzerinde çalışır.

.aiexclude kapsamındaki dosyalar, Codebase Indexing etkinleştirildiğinde Gemini tarafından dizine eklenmez. Ayrıca, .aiexclude, kapsam dahilindeki 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 tamamlama özelliği kullanılamaz.
  • Satır içi yardım: Yeni kod oluşturabilirsiniz ancak kapsanan 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 dosyaları engeller. Bu, **/* içeren bir dosyayla aynıdır.
  • .aiexclude dosyaları olumsuzlamayı (kalıplara ! önekini ekleme) desteklemez.

Örnekler

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

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

    apikeys.txt

  • .aiexclude dosyasını içeren dizinde veya bu dizinin altında .key dosya uzantılı tüm dosyaları engelleme:

    *.key

  • Yalnızca apikeys.txt dosyasını .aiexclude ile aynı dizinde 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

Firebase sohbetinde Gemini'ın kullandığı Gemini modelini yapılandırabilirsiniz. Yerleşik model, sohbet penceresinde yapılandırılan modeller (Gemini 2.5 modeller dahil) veya erişiminiz olan herhangi bir Gemini modeli arasından seçim yapabilirsiniz.

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

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 spark Gemini simgesini (veya Gemini sekmesini) tıklayın.

  2. Gemini'daki Firebase sohbet penceresinde model adı açılır listesini, ardından Gemini API anahtarı bağlantısı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.

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. Sohbette kullanmak istediğiniz Gemini modelini Gemini modelleri listesinden bulun. Örneğin, en yeni kararlı Gemini 2.0 Flash‑Lite modelini kullanmak için gemini-2.0-flash-lite değerini girersiniz.

  2. Firebase sohbet penceresinde Gemini'dan 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