Ç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 desteği. Kod oluşturabilir, çevirebilir ve açıklayabilir. Ayrıca incelemeniz ve onayınızla Gemini, dosyaları güncellemek, terminal komutlarını çalıştırmak, komut çıkışını yorumlamak ve sonraki adımları belirlemek için çalışma alanınızla doğrudan etkileşim kurabilir. Daha fazla bilgi için Firebase Studio içinde Gemini ile sohbet etmeyi deneyin.

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

• Satır içi kod yazma desteği

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

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

• Kod tamamlama ayarlarını düzenleyin.
• Kod tabanı dizine ekleme ayarlarınızı düzenleyin.
• Yapay zeka kuralları dosyasıyla Gemini için talimatları özelleştirme
• .aiexclude dosyalarıyla Gemini dosyalarını hariç tutun.
• Kendi anahtarınızı getirin: Sohbetlerde diğer Gemini modellerini kullanın
• Gemini'ın kod değişikliklerini önerme veya uygulama şeklini ayarlayın.

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

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

Sohbet paneli, terminal veya satır içi kod yardımıyla kodlama üretkenliğinizi artırmak için Gemini kullanın.

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

1. Çalışma alanınızda sohbet veya satır içi kod yazma desteğini kullanın:

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

   • Satır içi kod yazma desteğini 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 etkinleştirildiğini unutmayın:

   • Satır içi kod tamamlama özelliği sunan yazarken öneri gösterme
   • Daha iyi özelleştirme ve daha faydalı yanıtlar sunan kod tabanı dizine ekleme.

   Çalışma alanı ayarlarınızla ilgili bu seçimleri daha sonra değiştirmek için:

   • 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 dosya ve dizinleri yapay zeka dizine ekleme işleminden de hariç tutabilirsiniz. .aiexclude dosyalarıyla Gemini konumundaki dosyaları hariç tutma başlıklı makaleyi inceleyin.

Gemini kısayol

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

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

1. Ctrl+Shift+P (veya macOS'te Cmd+Shift+P) tuşlarına 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, siz yazmaya başlar başlamaz açık olan tüm dosyalardaki kodları tahmin eder ve otomatik olarak doldurur.

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

Kod tamamlamayı açmak veya kapatmak 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 görünümünde App Prototyping agent kullanıyorsanız Code görünümünü açmak için Koda geç'i tıklayın.

  2. Workspace (Çalışma Alanı) sekmesini seçin, ardından Firebase Studio > AI > Enable Inline Completion (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.

İpucu: Bu ayarı tüm çalışma alanlarınızda korumak için Kullanıcı sekmesinde yapılandırın. Bu sayede ayarlarınız, kullanıcı hesabınızla eriştiğiniz her çalışma alanına uygulanı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 hizmetinin kodunuzu dizine ekleyip eklemeyeceğini kontrol edebilirsiniz. Kodunuzu dizine eklemek, sohbet veya satır içi yapay zeka desteğini kullanırken daha faydalı sonuçlar sağlar.

Kod tabanı dizine ekleme özelliğinin varsayılan olarak etkin olduğunu unutmayın.

İpucu: Gemini tarafından hangi dosyaların dizine ekleneceğini kontrol edebilirsiniz. .aiexclude dosyalarıyla Gemini uygulamasından dosya hariç tutma başlıklı makaleden daha fazla bilgi edinebilirsiniz.

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 görünümünde App Prototyping agent kullanıyorsanız Code görünümünü açmak için Koda geç'i tıklayın.

  2. Workspace (Çalışma Alanı) sekmesini seçin, ardından Firebase Studio > AI > Enable Inline Completion ( > Yapay Zeka > Satır İçi Tamamlamayı Etkinleştir) ayarını arayın.

  3. Firebase Studio > AI: Enable Codebase Indexing'i (Yapay Zeka: Kod Tabanı Dizine Eklemeyi Etkinleştir) 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 Kullanıcı sekmesinde yapılandırın. Bu sayede ayarlarınız, kullanıcı hesabınızla eriştiğiniz her çalışma alanına uygulanır. Çalışma alanınızı paylaşıyorsanız Workspace ayarını yapılandırmanız gerekir.

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

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

Gemini sohbeti .idx/airules.md öncelikli olarak kullanır ancak .idx/airules.md yoksa GEMINI.md kullanılır.

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

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

• Gemini adlı karakterin kişiliğini etkileme ve uzmanlık alanını belirleme
• 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ı azaltma

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:

   • Explorer'da (Ctrl+Shift+E) ana dizini sağ tıklayın ve New file'ı (Yeni dosya) seçin. Dosyaya bir ad verip Enter tuşuna basın.
   • Terminalden, tercih ettiğiniz metin düzenleyiciyi kullanarak GEMINI.md veya .idx/airules.md dosyasını açın.

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

3. Dosyayı kaydedin ve Gemini sayfasını 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 derleme işleminden sonra Gemini, sohbetteki kurallar dosyasını kullanır. Yapay zeka kuralları dosyasında yapılan değişiklikler hemen yansıtılır.
   • Çalışma alanınızı yeniden oluşturmak istemiyorsanız Gemini adlı kullanıcıdan load GEMINI.md veya load airules.md yapmasını isteyebilirsiniz. Geçerli oturum sırasında dosyada değişiklik yaparsanız kural dosyasını tekrar yüklemek için Gemini'ı yeniden istemeniz gerekebilir.

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

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

Örnek

Aşağıda, Next.js ile geliştirilen basit bir oyun için kullanabileceğiniz kurallar dosyasına dair basit 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ı elde etmek için yapay zeka kuralları dosyanızı makul bir sınırda tutmanızı öneririz.

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

Projenize .aiexclude dosyaları ekleyerek kod tabanınızdaki hangi dosyaların Gemini tarafından gizli tutulması gerektiğini 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 Gemini ile paylaşılmaması gereken dosyaları takip eder. Buna sohbet deneyimi ve düzenleyicide çalışan yapay zeka özellikleri de dahildir. .aiexclude dosyası, bulunduğu dizindeki veya altındaki dosyalar üzerinde çalışır.

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

Kod Tabanı Dizine Ekleme etkinleştirildiğinde .aiexclude kapsamındaki dosyalar Gemini tarafından dizine eklenmez. Ayrıca .aiexclude, kapsanan dosyalarda satır içi yardımı aşağıdaki şekillerde etkiler:

• 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 özellikleri kullanılamaz.
• Satır içi yardım: Kapsam dahilindeki 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ı nasıl yazılır?

.aiexclude dosyası, .gitignore dosyasıyla aynı söz dizimini kullanır ancak aşağıdaki farklılıklar vardır:

• Boş bir .aiexclude dosyası, dizinindeki ve tüm alt dizinlerindeki tüm dosyaları engeller. Bu, **/* içeren bir dosyayla aynıdır.
• .aiexclude dosyaları, olumsuzlamayı (kalıpların önüne ! ekleme) desteklemez.

Örnekler

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

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

  apikeys.txt
  

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

  *.key
  

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

  /apikeys.txt
  

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

  my/sensitive/dir/
  

Kendi anahtarınızı kullanma: Sohbette diğer Gemini modellerini kullanma

Deneysel: Bu özellik deneyseldir.

Gemini sohbetinin kullandığı Gemini modelini yapılandırabilirsiniz. Yerleşik modeli, sohbet penceresinde yapılandırılan modelleri veya erişiminiz olan herhangi bir Gemini modelini seçebilirsiniz.

Kullanılabilir tüm modellerin listesi için Gemini modelleri sayfasına bakın.

Önemli: Firebase Studio yapay zeka ayarları, Kullanıcı ayarlarıdır. Bu sayede, birden fazla iş istasyonunda sizin için yapılandırılmış olarak kalırlar.

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

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

3. IDX > yapay zeka: Gemini API anahtarı alanına Gemini API anahtarınızı girin.

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

4. IDX > AI: Model Provider açılır menüsünden Gemini API seçeneğini belirleyin.

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

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

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

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ı kopyalayıp IDX > AI: Gemini Model alanına yapıştırı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 pencereyi yeniden açın.

Sonraki adımlar

• Gemini ürününü deneyin.