Menggunakan chat berbasis agen sebagai programmer berpasangan

VS Code

Siapkan Gemini Code Assist.

IntelliJ

Siapkan Gemini Code Assist.

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 dialihkan ke mode agen dan berwarna abu-abu saat dalam percakapan biasa.
3. Di percakapan Gemini Code Assist, masukkan perintah Anda.

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

Untuk menghentikan agen, klik stopBerhenti.

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

Mode agen Gemini Code Assist didukung oleh Gemini CLI.

IntelliJ

1. Klik spark Gemini di kolom jendela alat. Login jika diminta untuk melakukannya.
2. Pilih tab Agen.
3. Jelaskan tugas yang ingin Anda lakukan oleh agen.

4. Saat agen melakukan langkah-langkah untuk menyelesaikan tugas, Anda akan memiliki opsi untuk meninjau dan menyetujui perubahan apa pun.

5. Opsional: Untuk menyetujui perubahan secara otomatis, pilih setelan Opsi agen, lalu klik kotak centang di samping Setujui perubahan secara otomatis.

VS Code

Anda dapat menggunakan setelan coreTools dan excludeTools untuk mengontrol alat mana yang dapat diakses Gemini dalam mode agen.

coreTools

Memungkinkan Anda menentukan daftar alat yang ingin Anda sediakan untuk model. Anda juga dapat menentukan batasan khusus perintah untuk alat yang mendukungnya. Misalnya—menambahkan kode berikut ke JSON setelan Gemini Anda hanya akan mengizinkan perintah shell ls -l dieksekusi:"coreTools": ["ShellTool(ls -l)"].

excludeTools

Memungkinkan Anda menentukan daftar alat yang tidak ingin Anda sediakan untuk model. Anda juga dapat menentukan batasan khusus perintah untuk alat yang mendukungnya. Misalnya—menambahkan kode berikut ke JSON setelan Gemini akan memblokir penggunaan perintah rm -rf: "excludeTools": ["ShellTool(rm -rf)"].

Alat yang tercantum di excludeTools dan coreTools akan dikecualikan.

Untuk mengonfigurasi alat bawaan yang tersedia dalam mode agen, lakukan hal berikut:

1. Buka JSON setelan Gemini Anda yang berada di ~/.gemini/settings.json dengan ~ adalah direktori beranda Anda.

2. Untuk membatasi penggunaan alat agen ke daftar alat yang disetujui, tambahkan baris berikut ke JSON setelan Gemini Anda:

   "coreTools": ["TOOL_NAME_1,TOOL_NAME_2"]
   

   Ganti TOOL_NAME_1 dan TOOL_NAME_2 dengan nama alat bawaan yang ingin Anda izinkan aksesnya oleh agen.

   Anda dapat mencantumkan alat bawaan sebanyak yang Anda inginkan. Secara default, semua alat bawaan tersedia untuk agen.

3. Untuk membatasi penggunaan alat agen pada perintah alat tertentu, tambahkan baris berikut ke JSON setelan Gemini Anda:

   "coreTools": ["TOOL_NAME(COMMAND)"]
   

   Ganti kode berikut:

   • TOOL_NAME: nama alat bawaan
   • COMMAND: nama perintah alat bawaan yang Anda inginkan agar agen dapat menggunakannya.

4. Untuk mengecualikan alat dari penggunaan agen, tambahkan baris berikut ke JSON setelan Gemini Anda:

   "excludeTools": ["TOOL_NAME_1,TOOL_NAME_2"]
   

   Ganti TOOL_NAME_1 dan TOOL_NAME_2 dengan nama alat bawaan yang ingin Anda kecualikan dari penggunaan agen.

5. Untuk mengecualikan perintah alat dari penggunaan agen, tambahkan baris berikut ke JSON setelan Gemini Anda:

   "excludeTools": ["TOOL_NAME(COMMAND)"]
   

   Ganti kode berikut:

   • TOOL_NAME: nama alat bawaan
   • COMMAND: nama perintah alat bawaan yang ingin Anda kecualikan dari penggunaan agen.

Untuk mengetahui informasi selengkapnya tentang setelan konfigurasi coreTools dan excludeTools, lihat dokumentasi konfigurasi Gemini CLI.

IntelliJ

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

VS Code

Agar server MCP tersedia untuk digunakan dalam mode agen, tambahkan konfigurasi untuk setiap server di file JSON setelan Gemini Anda, sesuai dengan dokumentasi setiap server.

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

3. Konfigurasi setiap server MCP lokal atau jarak jauh di file JSON setelan Gemini, sesuai dengan petunjuk setiap server.

   File JSON setelan Gemini contoh berikut mengonfigurasi dua server MCP Cloudflare jarak jauh, server MCP GitLab jarak jauh, dan server MCP GitHub lokal untuk digunakan dengan Gemini Code Assist di VS Code.

   {
     "mcpServers": {
       "github": {
         "command": "npx",
         "args": ["-y", "@modelcontextprotocol/server-github"],
         "env": {
           "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
         }
       },
       "gitlab": {
         "command": "npx",
         "args": ["mcp-remote", "https://your-gitlab-instance.com/api/v4/mcp"]
       },
       "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

Untuk menyediakan server MCP agar dapat digunakan dalam mode agen, tambahkan konfigurasi untuk setiap server dalam file mcp.json dan tempatkan file mcp.json di direktori konfigurasi untuk IDE Anda.

1. Instal dependensi apa pun yang diperlukan oleh server MCP yang Anda tambahkan.
2. Buat file bernama mcp.json di direktori konfigurasi IDE Anda.

3. Konfigurasi setiap server MCP lokal atau jarak jauh dalam file mcp.json, sesuai dengan petunjuk setiap server.

   Contoh file mcp.json berikut mengonfigurasi dua server MCP Cloudflare jarak jauh, satu server MCP GitLab jarak jauh, dan satu server MCP GitHub lokal untuk digunakan dengan Gemini Code Assist di IntelliJ.

   {
     "mcpServers": {
       "github": {
         "command": "npx",
         "args": ["-y", "@modelcontextprotocol/server-github"],
         "env": {
           "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
         }
       },
       "gitlab": {
         "command": "npx",
         "args": ["mcp-remote", "https://your-gitlab-instance.com/api/v4/mcp"]
       },
       "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"]
       }
     }
   }
   

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

VS Code

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

Contoh berikut menunjukkan cara menentukan token akses pribadi untuk server MCP lokal dan jarak jauh GitHub:

{
  "mcpServers": {
    "github-remote": {
      "httpUrl": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ACCESS_TOKEN"
      }
    },
    "github-local": {
      "command": "/Users/username/code/github-mcp-server/cmd/github-mcp-server/github-mcp-server",
      "args": ["stdio"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ACCESS_TOKEN"
      }
    }
  }
}

Dengan ACCESS_TOKEN adalah token akses pengguna.

IntelliJ

Untuk server MCP yang memerlukan autentikasi, Anda dapat menambahkannya ke file mcp.json.

Contoh berikut menambahkan token akses pribadi untuk server lokal GitHub:

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

Dengan ACCESS_TOKEN adalah token akses pengguna.

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.

Agen menyertakan informasi dalam file konteks Anda bersama dengan perintah apa pun yang Anda kirimkan kepadanya.

IntelliJ

1. Buat file bernama GEMINI.md atau AGENT.md di root project Anda.

2. Tulis aturan, informasi panduan gaya, atau konteks yang ingin Anda gunakan oleh agen dalam Markdown, lalu simpan file.

Agen menyertakan informasi dalam file konteks Anda bersama dengan perintah apa pun yang Anda kirimkan kepadanya. Anda juga dapat menambahkan konteks dengan menyertakan file secara manual menggunakan sintaksis @FILENAME, dengan FILENAME adalah nama file dengan informasi kontekstual yang ingin Anda sertakan.

VS Code

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.

IntelliJ

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

VS Code

Gunakan mode yolo untuk mengizinkan semua tindakan agen secara otomatis. Mode Yolo hanya dapat digunakan di ruang kerja tepercaya.

Untuk mengonfigurasi mode yolo:

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. Saat menggunakan ruang kerja terbatas, agen akan meminta konfirmasi sebelum melakukan tindakan, terlepas dari setelan ini.

IntelliJ

Untuk menyetujui perubahan secara otomatis, di tab agen Gemini Chat, pilih setelan Opsi agen, lalu klik kotak centang di samping Setujui perubahan secara otomatis.

Mode agen otomatis menyetujui semua permintaan, dan tidak akan meminta izin sebelum melakukan tindakan saat Anda mengirimkan perintah.