AGENT.md dosyalarını kullanarak Gemini'ı özelleştirme

Android Studio'daki Gemini'a, bir veya daha fazla AGENT.md dosya kullanarak izlemesi için özelleştirilmiş talimatlar verin. AGENT.md dosyaları, kod tabanınızdaki diğer dosyaların yanına yerleştirilir. Bu nedenle, bu dosyaları sürüm kontrol sisteminize (VCS) kolayca ekleyebilir ve projeye özel talimatları, kodlama stili kurallarını ve diğer yönergeleri ekibinizin tamamıyla paylaşabilirsiniz.

Başlamak için şu adımları uygulayın:

1. Projenizin dosya sisteminde herhangi bir yerde AGENT.md dosyası oluşturun. Gemini, sorgu gönderdiğinizde geçerli dizini ve tüm üst dizinleri AGENT.md dosyaları için tarar. Daha fazla bilgi için AGENT.md dosyalarının işleyiş şekli başlıklı makaleyi inceleyin.

2. Talimatlarınızı ekleyin. Talimatlarınızı Markdown kullanarak yazın. Daha anlaşılır olması için farklı kurallar için başlıklar ve madde işaretleri kullanabilirsiniz. Örnek talimatları inceleyin.

3. Dosyayı kaydedip ekibinizle paylaşmak için VCS'nize gönderin.

AGENT.md dosyalarını bağlam olarak yönetme

Sohbet panelindeki Bağlam çekmecesini kullanarak belirli bir sorgu için AGENT.md dosyalarını bağlam olarak uygulayabilir veya kaldırabilirsiniz. AGENT.md Dosyalar seçenekleri, geçerli dizindeki ve üst dizinlerindeki tüm AGENT.md dosyalarını içerir.

Örnek talimatlar

Aracıya talimat vermek için AGENT.md dosyasını kullanabilirsiniz. Aşağıda bazı örnekler verilmiştir ancak sağladığınız talimatlar projenize özel olmalıdır.

• "Ana etkinlik /path/to/MainActivity.kt."
• "Ekranlar arasında gezinmeyi destekleyen kod: path/to/navigation/UiNavigation.kt"
• "HTTP isteklerini işleyen kod <path> konumunda."
• Proje mimarisi
  • "Tüm iş mantığını ViewModel'lere yerleştirin."
  • "Katmanlı mimari kullanımı da dahil olmak üzere resmi mimari önerilerine her zaman uyun. Tek yönlü veri akışı (UDF), ViewModel'ler, yaşam döngüsüne duyarlı kullanıcı arayüzü durumu toplama ve diğer önerileri kullanın."
• Tercih edilen kitaplıklar: "Gezinme için <kitaplık adı> kitaplığını kullan."
• Yaygın API hizmetleri veya şirket içi terminoloji için yer tutucu adlar tanımlama: "Birincil arka uç hizmeti "PhotoSift-API" olarak adlandırılır."
• Şirket stil kılavuzları: "Tüm yeni kullanıcı arayüzü bileşenleri Jetpack Compose ile oluşturulmalıdır. XML tabanlı düzenler önermeyin."

AGENT.md dosyalarınızı modüler hale getirme

Büyük AGENT.md dosyalarını, farklı bağlamlarda yeniden kullanılabilen daha küçük dosyalara ayırabilirsiniz:

1. Bir dizi talimatı ayırıp başka bir Markdown dosyasına kaydedin (ör. style-guidance.md).

2. İçe aktarmak istediğiniz dosyanın yolunu belirterek AGENT.md dosyasındaki daha küçük Markdown dosyalarına @ sembolüyle referans verin. Aşağıdaki yol biçimleri desteklenir:

   • Göreceli yollar:
     • @./file.md - Aynı dizinden içe aktarma
     • @../file.md: Üst dizinden içe aktarma
     • @./subdirectory/file.md - Alt dizinden içe aktarma
   • Mutlak yollar: @/absolute/path/to/file.md

Örneğin, aşağıdaki AGENT.md dosyası iki talimat dosyasına daha referans veriyor:

# My AGENT.md

You are an experienced Android app developer.

@./get-started.md

## Coding style

@./shared/style-guidance.md

AGENT.md dosyaları nasıl çalışır?

Gemini, geçerli dizini ve üst dizinleri AGENT.md dosyaları için otomatik olarak tarar ve bu dosyaların içeriğini her istemin başına önsöz olarak ekler. Sorgu gönderdiğinizde açık bir dosyanız yoksa proje kökündeki AGENT.md dosyası (varsa) varsayılan olarak eklenir.

AGENT.md dosyaları ile kurallar arasındaki fark nedir?

Kurallar, tüm istemler için geçerli olan talimatları ve tercihleri tanımlamanıza da olanak tanır. Ancak kurallar IntelliJ dosyasında /.idea/project.prompts.xml tanımlanırken AGENT.md dosyaları kaynak kodunuzun yanına kaydedilir ve IDE'den bağımsızdır. Temel amaçlardan biri talimatları ekibinizle paylaşmaksa AGENT.md dosyalarını kullanmanızı öneririz.