Mode agen

Dokumen ini menjelaskan mode agen di Gemini Code Assist.

Mode agen tersedia di lingkungan pengembangan terintegrasi (IDE) VS Code. Untuk mulai menggunakan mode agen, lihat Menggunakan chat berbasis agen sebagai programmer berpasangan.

Mode agen di VS Code didukung oleh 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 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 untuk menyelesaikan tindakan yang diperlukan, dan hasil tindakan tersebut 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 kepada Anda 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.

Ekstensi Gemini CLI

Anda dapat menggunakan ekstensi Gemini CLI untuk mengonfigurasi dan memperluas fungsi mode agen Gemini Code Assist.

Agen mencari ekstensi di dua lokasi:

  • WORKSPACE/.gemini/extensions dengan WORKSPACE adalah ruang kerja Anda saat ini.
  • ~/.gemini/extensions dengan ~ adalah direktori home Anda.

Agen memuat semua ekstensi dari kedua lokasi, tetapi jika ekstensi dengan nama yang sama ada di keduanya, ekstensi di direktori ruang kerja akan lebih diutamakan. Setiap ekstensi adalah direktori yang berisi file gemini-extension.json. File ini berisi konfigurasi untuk ekstensi.

Untuk mengetahui informasi selengkapnya, lihat Ekstensi Gemini CLI.

IntelliJ

Fitur ini tidak didukung di Gemini Code Assist untuk IntelliJ atau IDE JetBrains lainnya.

Alat

Alat adalah kategori layanan luas yang dapat digunakan agen untuk konteks dan tindakan dalam responsnya terhadap perintah Anda. 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 penerapan layanan khusus.

Langkah berikutnya