AGENT.md dosyalarını kullanarak Gemini'ı özelleştirme
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
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:
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.
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.
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.
1. şekil.AGENT.md dosyalarını bağlam olarak yönetme
Ö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:
Bir dizi talimatı ayırıp başka bir Markdown dosyasına kaydedin (ör. style-guidance.md).
İç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.
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-22 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-08-22 UTC."],[],[],null,["# Customize Gemini using AGENT.md files\n\nGive Gemini in Android Studio customized instructions to follow using one or\nmore `AGENT.md` files. `AGENT.md` files are placed alongside the other files in\nyour codebase, so it's straightforward to check them in to your version control\nsystem (VCS) and share project-specific instructions, coding style rules, and\nother guidance with your entire team.\n\nTo get started, follow these steps:\n\n1. Create an `AGENT.md` file anywhere in your project's file system. Gemini\n scans the current directory and all parent directories for `AGENT.md` files when\n you submit a query. For more details, see [How `AGENT.md` files work](#how-agent-files-work).\n\n | **Tip:** Use multiple instruction files across different directories for more granular control over different parts of your codebase. For example, you can have a global `AGENT.md` file at the project root and more specific `AGENT.md` files in subdirectories for different modules.\n2. Add your instructions. Write your instructions using Markdown. For\n readability, consider using headings and bullet points for different rules.\n [See example instructions](#example-instructions).\n\n3. Save and commit the file to your VCS to share it with your team.\n\nManage `AGENT.md` files as context\n----------------------------------\n\nYou can apply or remove `AGENT.md` files as context for a particular query\nusing the **Context** drawer in the chat panel. The **`AGENT.md` Files** options\nincludes all `AGENT.md` files in the current directory and its parent\ndirectories.\n**Figure 1.** Manage `AGENT.md` files as context.\n\nExample instructions\n--------------------\n\nYou can use the `AGENT.md` file to give instructions to the agent. The following\nare some examples, but the instructions that you provide should be specific to\nyour project.\n\n- \"The main activity is `/path/to/MainActivity.kt`.\"\n- \"The code to support navigating between screens is `path/to/navigation/UiNavigation.kt`\"\n- \"The code handling HTTP requests is at `\u003cpath\u003e`.\"\n- Project architecture\n - \"Place all business logic in ViewModels.\"\n - \"Always follow official architecture recommendations, including use of a layered architecture. Use a unidirectional data flow (UDF), ViewModels, lifecycle-aware UI state collection, and other recommendations.\"\n- Preferred libraries: \"Use the \\\u003clibrary name\\\u003e library for navigation.\"\n- Defining placeholder names for common API services or internal terminology: \"The primary backend service is referred to as 'PhotoSift-API'.\"\n- Company style guides: \"All new UI components must be built with Jetpack Compose. Don't suggest XML-based layouts.\"\n\nModularize your `AGENT.md` files\n--------------------------------\n\nYou can break down large `AGENT.md` files into smaller files that can be reused\nin different contexts:\n\n1. Separate out a set of instructions and save them in another Markdown file,\n such as `style-guidance.md`.\n\n2. Reference the smaller Markdown files in an `AGENT.md` file by using the `@`\n symbol followed by the path to the file you want to import. The following path\n formats are supported:\n\n - Relative paths:\n - `@./file.md` - Import from the same directory\n - `@../file.md` - Import from the parent directory\n - `@./subdirectory/file.md` - Import from a subdirectory\n - Absolute paths: `@/absolute/path/to/file.md`\n\nFor example, the following `AGENT.md` file references two other instruction\nfiles: \n\n # My AGENT.md\n\n You are an experienced Android app developer.\n\n @./get-started.md\n\n ## Coding style\n\n @./shared/style-guidance.md\n\nHow `AGENT.md` files work\n-------------------------\n\nGemini automatically scans the current directory and parent directories for\n`AGENT.md` files and adds their content to the beginning of every prompt as a\npreamble. If you don't have a file open when you submit a query, then the\n`AGENT.md` file at the project root (if there is one) is included by default.\n| **Note:** If you have a `GEMINI.md` file and `AGENT.md` file in the same directory, the `GEMINI.md` file takes precedence.\n\nWhat's the difference between `AGENT.md` files and Rules?\n---------------------------------------------------------\n\n[Rules](/studio/gemini/rules) also let you define instructions and preferences\nthat apply to all prompts. However, rules are defined in the IntelliJ file\n`/.idea/project.prompts.xml`, whereas `AGENT.md` files are saved next to your\nsource code and are IDE-neutral. We recommend using `AGENT.md` files if one of\nthe primary purposes is to share the instructions with your team.\n| **Note:** Gemini combines rules and instructions in `AGENT.md` files when processing your query."]]
