Menyesuaikan Gemini menggunakan file AGENT.md

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:

1. 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.

2. 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.

3. 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.

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:

1. Pisahkan serangkaian petunjuk dan simpan di file Markdown lain, seperti style-guidance.md.

2. 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.