Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Berikan petunjuk khusus kepada Gemini di Android Studio untuk diikuti menggunakan satu atau
beberapa file AGENT.md. File AGENT.md ditempatkan bersama file lain dalam
basis kode Anda, sehingga mudah untuk memeriksanya ke sistem kontrol versi (VCS) dan membagikan petunjuk khusus project, aturan gaya coding, dan
panduan lainnya kepada seluruh tim Anda.
Untuk memulai, ikuti langkah-langkah ini:
Buat file AGENT.md di mana saja dalam sistem file project Anda. Gemini
memindai direktori saat ini dan semua direktori induk untuk menemukan file AGENT.md saat
Anda mengirimkan kueri. Untuk mengetahui detail selengkapnya, lihat Cara kerja file AGENT.md.
Tambahkan petunjuk Anda. Tulis petunjuk Anda menggunakan Markdown. Agar
lebih mudah dibaca, pertimbangkan untuk menggunakan judul dan poin-poin untuk aturan yang berbeda.
Lihat contoh petunjuk.
Simpan dan lakukan commit file ke VCS Anda untuk membagikannya kepada tim Anda.
Mengelola file AGENT.md sebagai konteks
Anda dapat menerapkan atau menghapus file AGENT.md sebagai konteks untuk kueri tertentu
menggunakan panel Konteks di panel chat. Opsi AGENT.md File
mencakup semua file AGENT.md di direktori saat ini dan direktori induknya.
Gambar 1. Mengelola file AGENT.md sebagai konteks.
Contoh petunjuk
Anda dapat menggunakan file AGENT.md untuk memberikan petunjuk kepada agen. Berikut adalah beberapa contoh, tetapi petunjuk yang Anda berikan harus spesifik untuk project Anda.
"Aktivitas utamanya adalah /path/to/MainActivity.kt."
"Kode untuk mendukung navigasi antar-layar adalah
path/to/navigation/UiNavigation.kt"
"Kode yang menangani permintaan HTTP ada di <path>."
Arsitektur project
"Tempatkan semua logika bisnis di ViewModel."
"Selalu ikuti rekomendasi arsitektur resmi, termasuk penggunaan arsitektur berlayer. Gunakan aliran data searah (UDF), ViewModel, pengumpulan status UI yang mendukung siklus proses, dan rekomendasi lainnya."
Library pilihan: "Gunakan library <nama library> untuk navigasi."
Menentukan nama placeholder untuk layanan API umum atau terminologi internal:
"Layanan backend utama disebut sebagai 'PhotoSift-API'."
Panduan gaya perusahaan: "Semua komponen UI baru harus dibangun dengan Jetpack Compose. Jangan menyarankan tata letak berbasis XML."
Membuat modularisasi file AGENT.md
Anda dapat memecah file AGENT.md besar menjadi file yang lebih kecil yang dapat digunakan kembali dalam konteks yang berbeda:
Pisahkan serangkaian petunjuk dan simpan di file Markdown lain, seperti style-guidance.md.
Referensi file Markdown yang lebih kecil dalam file AGENT.md menggunakan simbol @
yang diikuti dengan jalur ke file yang ingin Anda impor. Format jalur berikut didukung:
Jalur relatif:
@./file.md - Mengimpor dari direktori yang sama
@../file.md - Impor dari direktori induk
@./subdirectory/file.md - Mengimpor dari subdirektori
Jalur absolut: @/absolute/path/to/file.md
Misalnya, file AGENT.md berikut mereferensikan dua file
instruksi lainnya:
# My AGENT.md
You are an experienced Android app developer.
@./get-started.md
## Coding style
@./shared/style-guidance.md
Cara kerja file AGENT.md
Gemini akan otomatis memindai direktori saat ini dan direktori induk untuk menemukan file AGENT.md dan menambahkan kontennya ke awal setiap perintah sebagai pengantar. Jika Anda tidak membuka file saat mengirimkan kueri, file AGENT.md di root project (jika ada) akan disertakan secara default.
Apa perbedaan antara file AGENT.md dan Aturan?
Aturan juga memungkinkan Anda menentukan petunjuk dan preferensi yang berlaku untuk semua perintah. Namun, aturan ditentukan dalam file IntelliJ
/.idea/project.prompts.xml, sedangkan file AGENT.md disimpan di samping
kode sumber Anda dan netral terhadap IDE. Sebaiknya gunakan file AGENT.md jika salah satu tujuan utamanya adalah membagikan petunjuk kepada tim Anda.
Konten dan contoh kode di halaman ini tunduk kepada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-22 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 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."]]
