Dokumen ini menjelaskan mode agen di Gemini Code Assist.
Mode agen tersedia di lingkungan pengembangan (IDE) terintegrasi VS Code dan IntelliJ. Untuk mulai menggunakan mode agen, lihat Menggunakan chat berbasis agen sebagai programmer berpasangan.
Mode agen di VS Code didukung oleh Gemini CLI.
Mode agen di IntelliJ tidak menggunakan Gemini CLI.
Dengan mode agen, Anda dapat melakukan hal berikut dan lainnya:
- Mengajukan pertanyaan tentang kode Anda.
- Gunakan konteks dan alat bawaan untuk meningkatkan kualitas konten yang dihasilkan.
- Konfigurasi server MCP untuk memperluas kemampuan agen.
- Dapatkan solusi untuk tugas kompleks dengan beberapa langkah.
- Membuat kode dari dokumen desain, masalah, dan komentar
TODO. - Mengontrol perilaku agen dengan mengomentari, mengedit, dan menyetujui rencana dan penggunaan alat selama eksekusi.
Cara kerja mode agen
Dalam mode agen, perintah Anda dikirim ke Gemini API dengan daftar alat yang tersedia. Gemini API memproses perintah dan menampilkan respons. Respons dapat berupa jawaban langsung atau permintaan untuk menggunakan alat yang tersedia.
Saat alat diminta, agen bersiap menggunakan alat dan memeriksa apakah alat tersebut diizinkan untuk digunakan dengan atau tanpa izin eksplisit:
- Untuk permintaan alat yang mengubah sistem file, atau melakukan operasi mutasi pada resource apa pun, Gemini akan meminta Anda untuk mengizinkan operasi tersebut, kecuali jika Anda telah mengonfigurasi Gemini untuk selalu mengizinkan alat tersebut.
- Permintaan alat yang bersifat hanya baca mungkin tidak meminta izin sebelum menyelesaikan tugas.
Saat diminta untuk mengizinkan penggunaan alat, Anda dapat memilih untuk mengizinkan atau menolak operasi. Agen juga dapat memberi Anda opsi untuk selalu mengizinkan alat atau server atau mengizinkan operasi serupa. Untuk mengetahui informasi selengkapnya, lihat Selalu izinkan tindakan agen.
Setelah izin untuk menggunakan alat diberikan atau diberikan sendiri, agen akan menggunakan alat tersebut untuk menyelesaikan tindakan yang diperlukan, dan hasil tindakan tersebut akan dikirim kembali ke Gemini API. Gemini memproses hasil tindakan alat dan membuat respons lain. Siklus tindakan dan evaluasi ini berlanjut hingga tugas selesai.
Untuk tugas yang kompleks, Gemini mungkin menampilkan rencana tingkat tinggi untuk mendapatkan persetujuan Anda. Anda dapat menyesuaikan rencana dan mengajukan pertanyaan di chat sebelum memulai prosesnya. Setelah puas dengan rencana tersebut, Anda dapat menyetujuinya. Setelah Anda menyetujui rencana, agen akan mulai mengerjakan tugas pertama, dan akan meminta klarifikasi atau izin sesuai kebutuhan saat menjalankan rencana.
Konteks mode agen
Konteks memungkinkan agen menghasilkan respons yang lebih baik untuk perintah tertentu. Konteks dapat diambil dari file di IDE Anda, file di folder sistem lokal Anda, respons alat, dan detail perintah Anda.
Bergantung pada IDE dan setelan Anda, konteks yang berbeda mungkin tersedia untuk agen.
Tab berikut menjelaskan cara mengumpulkan konteks untuk berbagai IDE.
VS Code
Metode berikut untuk mendapatkan konteks biasanya tersedia untuk Gemini Code Assist dalam mode agen:
- Informasi di ruang kerja IDE Anda.
- Respons alat dari alat bawaan seperti grep, terminal, pembacaan file, atau penulisan file.
- Respons Google Penelusuran.
- Konten dari URL tertentu yang diberikan dalam perintah atau oleh alat.
- File konteks yang Anda buat di Markdown.
Memori agen
Mode agen Gemini Code Assist di VS Code memanfaatkan layanan penemuan memori Gemini CLI untuk menemukan dan memuat file GEMINI.md yang memberikan konteks untuk agen. Layanan penemuan memori
menelusuri file ini secara hierarkis, dimulai dari direktori kerja saat ini
dan bergerak ke root project dan direktori beranda Anda. Fitur ini juga
menelusuri subdirektori.
Anda dapat membuat file konteks yang bersifat global, tingkat project, dan tingkat komponen, yang semuanya digabungkan untuk memberikan informasi yang paling relevan kepada model.
Anda dapat menggunakan perintah /memory show untuk melihat gabungan konten semua file GEMINI.md yang dimuat, dan perintah /memory refresh untuk memuat ulang file tersebut.
IntelliJ
Metode berikut untuk mendapatkan konteks biasanya tersedia untuk Gemini Code Assist dalam mode agen:
- Informasi dalam project IDE Anda, termasuk file, simbol yang diindeks, dan penggunaan simbol dalam project Anda.
- Respons alat dari alat bawaan seperti grep, pembacaan file, atau penulisan file.
- Kontrol versi IntelliJ.
- Server dan alat MCP yang dikonfigurasi
- File konteks yang Anda buat di Markdown.
Anda dapat melihat konteks yang tersedia untuk agen di panel konteks di area perintah chat mode agen.
Alat
Alat adalah kategori luas layanan yang dapat digunakan agen untuk konteks dan tindakan dalam responsnya terhadap perintah Anda. Alat memungkinkan agen mengakses informasi terbaru melalui panggilan fungsi ke endpoint API atau ke agen lain. Alat hanya dapat menawarkan satu fungsi, atau dapat menawarkan beberapa fungsi terkait.
Beberapa contoh alat adalah alat bawaan seperti grep dan baca atau tulis file, server Model Context Protocol (MCP) lokal atau jarak jauh dan fungsi yang dapat dieksekusinya, serta panggilan RESTful API.
Alat bawaan
Dalam mode agen, Gemini memiliki akses ke alat sistem bawaan Anda. Pilih IDE Anda untuk melihat daftar alat bawaan yang tersedia untuk Gemini dalam mode agen.
VS Code
Semua alat bawaan Gemini CLI tersedia untuk mode agen di Gemini Code Assist.
IntelliJ
read_file- Mengambil konten teks file menggunakan jalur absolutnya.
write_file- Menulis teks yang diberikan ke file tertentu, membuat file jika tidak ada.
analyze_current_file- Menganalisis file yang terbuka di editor untuk menemukan error dan peringatan.
find_files- Menemukan jalur absolut ke file berdasarkan nama file atau bagian jalur
grep- Menemukan semua file di dalam project yang berisi pola teks atau ekspresi reguler tertentu.
list_files- Mencantumkan semua file dan direktori dalam jalur absolut tertentu.
resolve_symbol- Menyelesaikan referensi simbol tertentu ke deklarasi aslinya.
find_usages- Menelusuri project untuk semua referensi ke deklarasi simbol tertentu.
git- Menjalankan perintah antarmuka command line (CLI) Git dan menampilkan hasilnya.
list_vcs_roots- Menampilkan semua root Sistem Kontrol Versi (VCS), seperti repositori Git, dalam project saat ini.
Batasan
Beberapa fitur chat Gemini Code Assist standar mungkin tidak tersedia dalam mode agen atau mungkin berfungsi berbeda dengan chat standar.
Pembacaan tidak tersedia dalam mode agen. Saat dalam mode agen, Gemini tidak mengutip sumber dan Anda tidak dapat menonaktifkan saran kode yang cocok dengan sumber yang dikutip.