Menggunakan chat berbasis agen sebagai programmer berpasangan

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.
  • Buat kode dari dokumen desain, masalah, dan komentar TODO.
  • Mengontrol perilaku agen dengan mengomentari, mengedit, dan menyetujui rencana dan penggunaan alat selama eksekusi.

Batasan

Beberapa fitur chat Gemini Code Assist standar mungkin tidak tersedia dalam mode agen atau mungkin berfungsi berbeda dengan chat standar.

Sebelum memulai

  1. Siapkan Gemini Code Assist.
  2. Setel saluran rilis Gemini Code Assist Anda ke build Insiders:
    1. Buka Command palette (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 untuk menyelesaikan tujuan tingkat tinggi dan tugas yang kompleks.

Untuk mengoptimalkan mode agen, ikuti praktik terbaik perintah dan berikan detail sebanyak mungkin.

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 ini ditandai saat dialihkan ke mode agen dan berwarna abu-abu saat berada dalam chat 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 luas layanan 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.

VS Code

  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.

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.
  • /mcp: Mencantumkan server Model Context Protocol (MCP) yang dikonfigurasi, status koneksinya, detail server, dan alat yang tersedia.

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.

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 ada ekstensi dengan nama yang sama di kedua lokasi, ekstensi di direktori ruang kerja akan 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?"
  • "Add a feature to this codebase - "[link-or-path-to-codebase]"." (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]."
  • "Optimize performance of this Go code so that it runs faster." (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