Menggunakan chat berbasis agen sebagai programmer berpasangan

Pratinjau

Produk atau fitur ini dalam pratinjau dan tersedia di Gemini Code Assist insiders channel. Produk dan fitur yang dalam pratinjau tersedia "sebagaimana adanya".

Dokumen ini menjelaskan cara mengonfigurasi dan menggunakan mode agen Gemini Code Assist sebagai programmer berpasangan di lingkungan pengembangan terintegrasi (IDE) Anda.

Mode agen tersedia di IDE VS Code.

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.

Batasan

Batasan berikut berlaku saat menggunakan mode agen:

• Agen tidak dapat memanggil alat Gemini Code Assist. Anda harus keluar dari mode agen untuk menggunakan alat ini.
• Agen tidak dapat menggunakan penyesuaian kode. Anda harus keluar dari mode agen untuk menggunakan penyesuaian kode.
• Project dengan beberapa root tidak didukung dalam mode agen. Jika Anda menggunakan mode agen dalam project dengan beberapa direktori root, agen hanya memiliki akses ke direktori root pertama yang ditemuinya.
• Log Gemini untuk Google Cloud tidak didukung dalam mode agen.

Sebelum memulai

1. Siapkan edisi Gemini Code Assist yang ingin Anda gunakan di IDE Anda:
   • Gemini Code Assist untuk perorangan
   • Gemini Code Assist Standard atau Enterprise
2. Setel saluran rilis Gemini Code Assist Anda ke build Insiders:
   1. Buka Palet perintah (Cmd + Shift + P), lalu pilih Open User Settings JSON.
   2. Tambahkan baris berikut ke JSON setelan pengguna Anda:

      "geminicodeassist.updateChannel": "Insiders",

Menggunakan mode agen

Dalam mode agen, Anda dapat meminta Gemini menyelesaikan tujuan tingkat tinggi dan tugas yang kompleks.

Untuk mendapatkan hasil maksimal dari mode agen, ikuti praktik terbaik perintah dan berikan detail sebanyak mungkin.

Perhatian: Tidak ada opsi untuk mengurungkan perubahan yang dilakukan pada resource di luar IDE Anda dalam mode agen, jadi berhati-hatilah saat menggunakannya.

Untuk beralih ke mode agen:

VS Code

1. Untuk membuka percakapan Gemini Code Assist, di panel aktivitas IDE, klik spark Gemini Code Assist.
2. Klik tombol Agen untuk masuk ke mode agen. Tombol akan ditandai saat beralih ke mode agen dan berwarna abu-abu saat dalam percakapan biasa.
3. Di chat Gemini Code Assist, masukkan perintah Anda.

Gemini akan memberikan respons terhadap perintah Anda, atau meminta izin untuk menggunakan alat.

Untuk menghentikan agen, klik Berhenti.

Untuk menggunakan chat Gemini Code Assist standar, klik Chat baru untuk membuat chat baru.

Mode agen Gemini Code Assist didukung oleh Gemini CLI.

IntelliJ

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

Mengonfigurasi alat untuk mode agen

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, atau penerapan layanan khusus.

Mengonfigurasi server MCP

Untuk mengontrol server mana yang tersedia dalam mode agen, tambahkan server tersebut ke JSON setelan Gemini Anda sesuai dengan dokumentasi server.

Perhatian: Server MCP dapat menjalankan kode arbitrer dengan izin yang tersedia untuk akun pengguna Anda. Pastikan Anda memercayai sumber server MCP yang Anda gunakan.

VS Code

Catatan: Anda tidak dapat menggunakan palet perintah untuk menginstal server MCP untuk mode agen. Anda harus menambahkan server MCP ke JSON setelan Gemini Anda.

1. Instal dependensi apa pun yang diperlukan oleh server MCP Anda.
2. Buka JSON setelan Gemini Anda yang berada di ~/.gemini/settings.json dengan ~ adalah direktori beranda Anda.

3. Tambahkan server MCP lokal atau jarak jauh ke JSON setelan Gemini Anda sesuai dengan petunjuk server.

   Contoh berikut menambahkan server MCP Cloudflare jarak jauh, dan menginstal server GitHub dan GitLab di komputer lokal.

   {
       "mcpServers": {
       "github": {
         "command": "npx",
         "args": [
           "-y",
           "@modelcontextprotocol/server-github"
         ],
         "env": {
           "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
         }
       },
       "gitlab": {
         "command": "npx",
         "args": [
             "-y",
             "@modelcontextprotocol/server-gitlab"
         ]
       },
           "cloudflare-observability": {
               "command": "npx",
               "args": ["mcp-remote", "https://observability.mcp.cloudflare.com/sse"]
           },
           "cloudflare-bindings": {
               "command": "npx",
               "args": ["mcp-remote", "https://bindings.mcp.cloudflare.com/sse"]
           }
       }
   }
   

4. Buka palet perintah dan pilih Developer: Reload Window.

Server MCP yang dikonfigurasi tersedia untuk digunakan agen dalam mode agen.

IntelliJ

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

Autentikasi server MCP

Untuk server MCP yang memerlukan autentikasi, Anda dapat menambahkannya ke JSON setelan Gemini Anda.

Contoh berikut menambahkan token akses pribadi untuk GitHub:

{
//other settings...

"github": {
  "command": "/Users/username/code/github-mcp-server/cmd/github-mcp-server/github-mcp-server",
  "args": ["stdio"],
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": "ACCESS_TOKEN"
  }
},

// other settings...
}

Dengan ACCESS_TOKEN adalah token akses pengguna.

Membuat file konteks

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. Untuk mengetahui informasi selengkapnya, lihat Konteks mode agen.

VS Code

1. Buat file bernama GEMINI.md di lokasi yang cocok dengan cakupan yang Anda inginkan untuk penerapan konteks. Tabel berikut menjelaskan lokasi file konteks untuk cakupan yang berbeda:

   Cakupan	Lokasi
   Semua project Anda	~/.gemini/GEMINI.md
   Project tertentu	Direktori kerja Anda atau direktori induk hingga root project Anda (diidentifikasi oleh folder .git) atau direktori beranda Anda.
   Komponen, modul, atau subbagian tertentu dari project	Subdirektori direktori kerja Anda.

   Sistem memori agen dibuat dengan memuat file konteks dari beberapa lokasi. Konteks dari file yang lebih spesifik, seperti file untuk komponen atau modul tertentu, menggantikan atau melengkapi konten dari file konteks yang lebih umum seperti file konteks global di ~/.gemini/GEMINI.md.

2. Tulis aturan, informasi panduan gaya, atau konteks yang ingin Anda gunakan oleh agen dalam Markdown, lalu simpan file. Untuk mengetahui informasi selengkapnya, lihat file konteks contoh di GitHub.

IntelliJ

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

Menggunakan perintah

Perintah garis miring / memungkinkan Anda menjalankan perintah dengan cepat yang mirip dengan perintah di jendela terminal.

Anda dapat menggunakan perintah Gemini CLI berikut dalam mode agen:

• /tools: Menampilkan daftar alat yang tersedia di sesi mode agen Anda. Subperintah mencakup hal berikut:
  • desc atau descriptions: Menampilkan deskripsi mendetail setiap alat.
  • nodesc atau nodescriptions: Menyembunyikan deskripsi alat dan hanya menampilkan nama alat.
• /memory: Mengelola konteks instruksional agen yang dimuat dari file GEMINI.md. Subperintah mencakup hal berikut:
  • show: Menampilkan konten lengkap yang digabungkan dari memori saat ini yang dimuat dari semua file GEMINI.md yang tersedia.
  • refresh: Memuat ulang memori dari semua file GEMINI.md di lokasi yang tersedia. Untuk mengetahui informasi tentang bagaimana file GEMINI.md berkontribusi pada memori hierarkis agen, lihat dokumentasi Konfigurasi Gemini CLI.
• /mcp: Mencantumkan server Model Context Protocol (MCP) yang dikonfigurasi, status koneksinya, detail server, dan alat yang tersedia. Subperintah mencakup hal berikut:
  • desc atau descriptions: Menampilkan deskripsi mendetail tentang server dan alat MCP.
  • nodesc atau nodescriptions: Menyembunyikan deskripsi server MCP dan hanya menampilkan nama server MCP.
  • schema: Menampilkan skema JSON lengkap untuk parameter yang dikonfigurasi server MCP.
• /stats: Menampilkan statistik dan durasi sesi mode agen yang mendetail.

Untuk mengetahui informasi selengkapnya tentang perintah Gemini CLI, lihat Perintah Gemini CLI. Perhatikan bahwa tidak semua perintah Gemini CLI tersedia dalam mode agen.

Selalu izinkan tindakan agen

Anda dapat mengizinkan semua tindakan agen secara otomatis.

Peringatan: Agen memiliki akses ke sistem file dan tindakan terminal mesin Anda serta alat apa pun yang telah Anda konfigurasi untuk digunakan. Berhati-hatilah saat Anda mengizinkan tindakan agen secara otomatis.

Untuk mengizinkan semua tindakan agen secara otomatis:

1. Buka file JSON setelan pengguna VS Code Anda:

   1. Buka Palet perintah (ctrl/command + Shift + P).
   2. Pilih Preferences: Open User Settings (JSON).

2. Tambahkan kode berikut ke file JSON setelan pengguna VS Code Anda:

   //other settings...
   
   "geminicodeassist.agentYoloMode": "true",
   //other settings...
   

3. Buka palet perintah dan pilih Developer: Reload Window.

Mode agen menggunakan mode yolo, dan tidak akan meminta izin sebelum mengambil tindakan saat Anda mengirimkan perintah.

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

Perintah tambahan

Cobalah perintah berikut dengan informasi Anda sendiri:

• "Apa fungsi repositori ini? Bantu saya memahami arsitekturnya."
• "Apa fungsi [class/function] ini?"
• "Tambahkan fitur ke codebase ini - "[link-or-path-to-codebase]"."
• "Faktorkan ulang fungsi [A] dan [B] untuk menggunakan metode umum [C]."
• "Perbaiki masalah GitHub [link-to-github-issue]."
• "Buat aplikasi untuk melakukan [tujuan] dengan UI yang memungkinkan pengguna melakukan [tugas] di [lingkungan]."
• "Migrasikan versi library di repositori ini dari [X] ke [Y]."
• "Optimalkan performa kode Go ini agar berjalan lebih cepat."
• "Gunakan [nama-API] untuk membuat fitur ini."
• "Terapkan algoritma untuk melakukan [x], [Y], dan [Z]."

Langkah berikutnya

• Baca ringkasan Gemini Code Assist.
• Pelajari beberapa contoh server MCP.
• Temukan server MCP lainnya di GitHub.
• Kirim masukan dari IDE Anda.