Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Mode agen memungkinkan asisten AI di editor Anda menggunakan alat PostgreSQL dari ekstensi sebagai bagian dari percakapan multi-langkah tunggal. Alih-alih hanya menjawab pertanyaan, asisten dapat tersambung ke database, memeriksa skema, menjalankan kueri, membuka skrip, dan membantu Anda menelusuri alur kerja secara menyeluruh.
Mode agen berjalan di Visual Studio Code (dengan GitHub Copilot) dan Kursor (dengan AI bawaannya). Ekstensi ini mengekspos permukaan alat PostgreSQL yang sama di kedua editor; hanya panel obrolan yang terbuka yang berbeda.
Gunakan mode Agen saat Anda ingin AI mengambil tindakan terstruktur, bukan hanya menjelaskan atau menyusun SQL.
Prerequisites
Sebelum memulai, pastikan Anda memiliki:
- Ekstensi PostgreSQL terinstal.
- Fitur Copilot/AI yang diaktifkan di ekstensi (
pgsql.copilot.enableadalahtrue). - Setidaknya satu koneksi database dikonfigurasi dalam ekstensi.
- Asisten AI tersedia di editor Anda:
- Visual Studio Code: GitHub Copilot atau GitHub Copilot Chat harus terinstal dan aktif.
- Kursor: tidak ada penginstalan tambahan; AI bawaan digunakan secara otomatis.
Mulai mode Agen
- Sambungkan ke server target atau database di ekstensi PostgreSQL.
- Di pohon Koneksi , klik kanan database yang ingin Anda gunakan.
- Pilih Sambungkan AI.
- Lanjutkan percakapan di panel obrolan yang terbuka dengan alur kerja yang ingin Anda selesaikan.
- Dalam Visual Studio Code, ini adalah panel GitHub Copilot Chat dalam mode agen.
- Di Kursor, ini adalah panel AI asli Kursor; ekstensi ini menyediakan awalan berorientasi MCP singkat sehingga asisten tahu tentang alat PostgreSQL yang tersedia.
Setelah sesi dimulai, AI dapat menggunakan beberapa alat PostgreSQL secara terpadu di belakang layar saat memproses permintaan Anda.
Pilih mode akses yang tepat
Pengaturan pgsql.copilot.accessMode mengontrol berapa banyak akses database yang diterima mode Agen. ID pengaturan tetap mempertahankan prefiks pgsql.copilot.* demi kompatibilitas; label yang ditampilkan kepada pengguna adalah mode akses Copilot di Visual Studio Code dan mode akses AI di Cursor.
| Modus | Apa yang dapat dilakukan AI | Penggunaan yang disarankan |
|---|---|---|
ro |
Operasi baca-saja seperti SELECT, , SHOWEXPLAIN, inspeksi skema, dan analisis |
Sistem produksi atau lingkungan bersama tempat Anda ingin penyelidikan tanpa perubahan |
rw |
Membaca operasi ditambah pernyataan pengubahan data dan DDL, dengan konfirmasi eksplisit sebelum eksekusi | Pengembangan lokal, kotak pasir sekali pakai, dan lingkungan pengujian terkontrol |
Caution
Gunakan ro mode untuk database produksi kecuali Anda sengaja menginginkan perubahan skema atau data yang tersedia melalui mode Agen.
Pahami kelompok alat
Mode agen dapat menggunakan beberapa keluarga alat tergantung pada alur kerja.
| Kelompok alat | Apa fungsinya | Saat Anda menggunakannya |
|---|---|---|
| Alat koneksi | Menampilkan profil, menghubungkan, memutuskan sambungan, menampilkan basis data | Memulai atau mengalihkan konteks |
| Alat konteks skema | Mengambil definisi objek atau memvisualisasikan skema | Memahami tabel, tampilan, fungsi, indeks, dan hubungan |
| Alat kueri | Menjalankan kueri baca, memeriksa rencana kueri, membuka skrip | Menyelidiki data, memvalidasi ide, atau meninjau SQL yang dihasilkan |
| Alat modifikasi | Jalankan DDL atau DML dengan konfirmasi | Menerapkan skema terkontrol atau perubahan data dalam rw mode |
| Alat impor data | Menjelaskan file CSV dan memuatnya secara massal | Merencanakan dan menjalankan alur kerja impor CSV |
Tip
Di Kursor, alat yang sama juga muncul melalui pendaftaran server MCP. Chat bawaan Cursor dapat mengaksesnya secara langsung tanpa menggunakan jalur masuk Connect AI. Lihat Server MCP untuk detailnya.
Menggunakan mode Agen untuk alur kerja umum
Contoh berikut menunjukkan cara menggunakan mode Agen untuk tugas yang berkisar dari menjelajahi database baru hingga menyempurnakan kueri.
Menjelajahi database yang tidak dikenal
Minta AI untuk menyambungkan ke database, mencantumkan objek kunci, dan meringkas area skema yang penting bagi tugas Anda.
Contoh:
Sambungkan ke database pengembangan saya, cantumkan tabel dalam skema publik, dan beri tahu saya mana yang terkait dengan pelanggan dan pesanan.
Selidiki kinerja kueri
Minta AI untuk menggabungkan konteks skema dengan eksekusi kueri atau inspeksi rencana.
Contoh:
Hubungkan ke database staging, jalankan kueri ini dalam mode hanya-baca, dan jelaskan bagian mana dari rencana eksekusi yang menjadi penyebab utama biaya.
Memuat atau membentuk ulang data
Gunakan mode Agen saat alur kerja menyertakan skrip atau operasi berbasis CSV.
Contoh:
Tinjau file CSV ini, beri tahu saya skema apa yang tersirat, dan siapkan rencana impor yang aman untuk
sales.recordstabel.
Pindah dari draf ke tinjauan manual
Saat Anda menginginkan titik pemeriksaan tinjauan manusia sebelum eksekusi, minta AI untuk membuka SQL yang dihasilkan di editor kueri alih-alih menjalankannya segera.
Ketahui kapan harus menggunakan mode Agen alih-alih @pgsql
Gunakan peserta obrolan @pgsql saat Anda menginginkan jawaban sadar skema atau draf kueri. Peserta @pgsql hanya tersedia di Visual Studio Code.
Gunakan mode Agen (tersedia baik di Visual Studio Code maupun di Cursor) saat Anda ingin AI:
- hubungkan ke basis data yang sesuai untuk Anda,
- rantai beberapa alat dalam satu percakapan,
- memeriksa hasil sebelum langkah berikutnya, atau
- siapkan skrip atau alur kerja modifikasi terkontrol.
Note
Di Cursor, mode Agen adalah jalur utama karena partisipan chat @pgsql tidak tersedia di sana. Antarmuka alat yang sama juga dapat diakses dari chat bawaan Cursor melalui server MCP.
Pemecahan masalah mode Agen
Jika mode Agen tidak berperilaku seperti yang diharapkan, periksa mode akses dan ketersediaan alat terlebih dahulu.
AI tidak dapat mengubah database
Periksa pgsql.copilot.accessMode dan konfirmasikan bahwa koneksi aktif tidak diselesaikan ke ro.
Alat yang Anda harapkan tidak tersedia
Pastikan integrasi Copilot diaktifkan dan Anda memulai dari database dengan konteks koneksi PostgreSQL yang valid.
Permintaan koneksi gagal
Konfirmasikan profil koneksi masih ada, kredensial tersedia, dan ekstensi dapat tersambung ke database yang sama di luar mode Agen.
Saya ingin alur kerja chat-first yang lebih sederhana
Di Visual Studio Code, gunakan peserta obrolan @pgsql saat Anda menginginkan penjelasan, penyusuran kueri, atau pertanyaan skema tanpa otomatisasi berbasis alat. Di Kursor, ajukan pertanyaan yang sama dari obrolan asli. Alat MCP milik ekstensi masih bisa ditemukan, tetapi chat terasa lebih natural seperti percakapan tanpa entri Mode Agen yang eksplisit.