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

Not: AGENTS.md başlıklı aracı dosyaları, Android Studio Narwhal 4 Yeni Özellikler Güncellemesi Canary 4 ve sonraki sürümlerle uyumludur. Android Studio Narwhal 3 Yeni Özellikler Güncellemesi ile aracı dosyalarını kullanmak için AGENTS.md yerine AGENT.md adını kullanın.

Android Studio'da Gemini'a, bir veya daha fazla AGENTS.md dosya kullanarak izlemesi için özelleştirilmiş talimatlar verin. AGENTS.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 AGENTS.md dosyası oluşturun. Gemini, bir sorgu gönderdiğinizde geçerli dizini ve tüm üst dizinleri AGENTS.md dosyaları için tarar. Daha fazla bilgi için AGENTS.md dosyalarının işleyiş şekli başlıklı makaleye göz atın.

   İpucu: Kod tabanınızın farklı bölümleri üzerinde daha ayrıntılı kontrol sağlamak için farklı dizinlerde birden fazla talimat dosyası kullanın. Örneğin, proje kökünde genel bir AGENTS.md dosyanız ve farklı modüller için alt dizinlerde daha spesifik AGENTS.md dosyalarınız olabilir.

2. Talimatlarınızı ekleyin. Talimatlarınızı Markdown kullanarak yazın. Okunabilirliği artırmak için farklı kurallar için başlıklar ve madde işaretleri kullanabilirsiniz. Örnek talimatları inceleyin.

3. Dosyayı ekibinizle paylaşmak için VCS'nize kaydedip işleyin.

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

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

Şekil 1. AGENTS.md dosyalarını bağlam olarak yönetme

Örnek talimatlar

Temsilciye talimat vermek için AGENTS.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."

AGENTS.md dosyalarınızı modüler hale getirin

Büyük AGENTS.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 @ sembolünü kullanarak daha küçük Markdown dosyalarına AGENTS.md dosyasında 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 AGENTS.md dosyası iki talimat dosyasına daha referans veriyor:

# My AGENTS.md

You are an experienced Android app developer.

@./get-started.md

## Coding style

@./shared/style-guidance.md

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

Gemini, geçerli dizini ve üst dizinleri AGENTS.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 AGENTS.md dosyası (varsa) varsayılan olarak eklenir.

Not: Aynı dizinde GEMINI.md ve AGENTS.md dosyalarınız varsa GEMINI.md dosyası öncelikli olur.

AGENTS.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 AGENTS.md dosyaları kaynak kodunuzun yanına kaydedilir ve IDE'den bağımsızdır. Temel amaçlardan biri talimatları ekibinizle paylaşmaksa AGENTS.md dosyalarını kullanmanızı öneririz.

Not: Gemini, sorgunuzu işlerken AGENTS.md dosyalarındaki kuralları ve talimatları birleştirir.

AGENTS.md dosyaları ile beceriler arasındaki fark nedir?

Beceriler, isteğiniz bir beceri açıklamasıyla eşleştiğinde çağrılan isteğe bağlı uzmanlığı temsil ederken AGENTS.md içindeki içerik her istemin başına eklenir. Aracının genel davranışını etkilemek için belirli görevlerde becerileri, AGENTS.md dosyalarında ise bilgileri kullanmanızı öneririz. Beceriler hakkında daha fazla bilgi edinmek için Android becerilerine giriş başlıklı makaleyi inceleyin.