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.
Ekstensi PostgreSQL berintegrasi dengan asisten AI melalui tiga antarmuka: partisipan obrolan @pgsql (khusus Visual Studio Code), alat mode agen, dan Penyedia Server MCP Alat PostgreSQL. Halaman ini membantu Anda memilih titik masuk yang tepat dan memahami konfigurasi bersama yang berlaku di ketiganya.
Ekstensi berjalan di Visual Studio Code (dengan GitHub Copilot) dan Kursor (dengan AI bawaannya). Sebagian besar fitur berfungsi dengan cara yang sama di kedua editor; segelintir perilaku yang khusus untuk editor tertentu dijelaskan di sepanjang artikel ini.
Prasyarat
Sebelum Anda menggunakan fitur yang dibantu AI, pastikan persyaratan berikut terpenuhi:
- Ekstensi PostgreSQL diinstal dan Anda memiliki setidaknya satu koneksi database yang dikonfigurasi.
- Asisten AI tersedia di editor Anda:
- Visual Studio Code: instal GitHub Copilot atau GitHub Copilot Chat dan masuk dengan langganan aktif.
- Kursor: tidak ada penginstalan tambahan; AI bawaan digunakan secara otomatis.
Note
Copilot fitur diaktifkan secara default (pgsql.copilot.enable adalah true). Saat Anda menyetel ini ke false, partisipan obrolan @pgsql (khusus Visual Studio Code), submenu editor Tindakan Kueri AI, alat Mode Agen, dan penyedia server MCP semuanya akan disembunyikan.
Tip
Bantuan AI berfungsi paling baik ketika Anda sudah memiliki koneksi database aktif. Jika Anda belum tersambung, mulailah dengan Koneksi dan identitas.
Pilih titik entri yang tepat
| Jika Anda ingin... | Mulai di sini | Availability | Pelajari lebih lanjut |
|---|---|---|---|
| Ajukan pertanyaan yang memahami skema tentang database Anda | @pgsql peserta chat | Visual Studio Code saja | peserta obrolan @pgsql |
| Mulai mode Agen dengan database tertentu yang sudah ada dalam cakupan | Menyambungkan AI dari simpul database di pohon Koneksi | Visual Studio Code dan Kursor | Mode Agen |
| Menjelaskan, menulis ulang, atau menganalisis SQL dari editor | Submenu Tindakan Kueri AI di menu konteks editor | Visual Studio Code dan Kursor | Tindakan editor |
| Mengotomatiskan tugas database multi-langkah | Menyambungkan AI pada simpul database untuk memulai mode Agen | Visual Studio Code dan Kursor | Mode Agen |
| Mengekspos alat PostgreSQL ke host yang kompatibel dengan MCP | Penyedia Server MCP untuk Alat PostgreSQL | Visual Studio Code dan Kursor | Server MCP |
Gunakan @pgsql untuk chat yang memahami skema
Note
Peserta obrolan @pgsql hanya terdaftar di Visual Studio Code, di mana ia terhubung ke GitHub Copilot Chat. Di Kursor, gunakan Sambungkan AI dari simpul database di pohon Koneksi untuk memulai mode Agen dengan konteks skema yang sama, atau mengandalkan server MCP di permukaan obrolan asli Kursor.
Ekstensi ini mendaftarkan peserta obrolan @pgsql (ID: vscode-postgresql.chat-agent) untuk percakapan sadar skema di GitHub Copilot Chat. Ketik @pgsql diikuti dengan pertanyaan Anda, dan peserta menjawab menggunakan konteks skema langsung dari database anda yang tersambung.
Untuk memulai alur kerja berbasis alat dengan database yang sudah berada dalam cakupan, klik kanan simpul database di pohon Koneksi dan pilih Sambungkan AI.
Untuk panduan pengguna akhir, contoh perintah, dan pemecahan masalah, lanjutkan ke @pgsql partisipan chat.
Gunakan tindakan editor untuk bantuan yang berfokus pada kueri
Saat Anda membuka SQL di editor kueri, klik kanan untuk menemukan submenu Tindakan Kueri AI . Ini berisi tindakan berikut:
| Tindakan | Deskripsi |
|---|---|
| Penjelasan Kueri | Mengembalikan penjelasan sederhana tentang fungsi kueri dengan bahasa yang mudah dipahami. |
| Tulis Ulang Kueri | Menyarankan versi alternatif kueri sambil mempertahankan hasil yang dimaksudkan. |
| Analisis Kinerja Kueri | Menjalankan EXPLAIN ANALYZE pada database yang terhubung, lalu mengirim rencana eksekusi ke AI untuk dianalisis. |
Anda juga dapat memilih Tanyakan AI tentang Kueri ini dari bilah alat editor untuk membuka percakapan chat yang didasarkan pada isi editor saat ini.
Untuk mengatur ulang pilihan penyertaan kueri yang diingat untuk analisis rencana, jalankan Hapus preferensi penyertaan kueri untuk analisis AI dari Palet Perintah.
Menggunakan mode Agen untuk alur kerja berbasis alat
Mode agen memberi asisten AI akses ke alat PostgreSQL sehingga dapat terhubung, memeriksa skema, menjalankan kueri, membuka skrip, dan bekerja melalui tugas multi-langkah dalam satu percakapan. Klik kanan simpul database di pohon Koneksi dan pilih Sambungkan AI untuk memulai sesi mode Agen.
Untuk keluarga alat, contoh alur kerja, dan pemecahan masalah, lanjutkan ke mode Agen.
Menggunakan server MCP di host yang didukung
Ekstensi ini mendaftarkan PostgreSQL Tools MCP Server Provider (ID: pgsql-tools-mcp-server-provider) yang menyediakan akses ke kumpulan alat PostgreSQL yang sama melalui Model Context Protocol. Host yang kompatibel dengan MCP dapat menemukan dan memanggil alat-alat ini tanpa menggunakan alur kerja obrolan bawaan.
Untuk host yang didukung, perilaku pendaftaran otomatis, dan kelompok alat yang tersedia melalui MCP, lanjut ke MCP server.
Konfigurasikan mode akses
Pengaturan pgsql.copilot.accessMode mengontrol seberapa besar akses database yang diterima asisten AI dalam mode Agen dan alat MCP. Defaultnya adalah Baca/Tulis (rw).
| Nilai Setelan | Label antarmuka pengguna | Apa yang dapat dilakukan asisten AI |
|---|---|---|
ro |
Hanya Baca | Operasi baca-saja: SELECT, SHOW, EXPLAIN, inspeksi skema |
rw |
Baca/Tulis | Operasi baca serta pernyataan modifikasi data dan DDL, dengan konfirmasi eksplisit |
Pengesampingan per koneksi
Anda juga dapat mengatur mode akses pada koneksi individual. Dalam dialog koneksi, perluas bagian Copilot (AI di Kursor) dan atur mode akses Copilot (mode akses AI di Kursor) ke salah satu dari:
| Option | Perilaku |
|---|---|
| Gunakan Pengaturan Global | Kembali ke nilai global pgsql.copilot.accessMode (default) |
| Hanya Baca | Memaksa akses baca-saja untuk koneksi ini terlepas dari pengaturan global |
| Baca/Tulis | Memaksa akses baca/tulis untuk koneksi ini terlepas dari pengaturan global |
Ekstensi menyelesaikan mode akses efektif menggunakan rantai fallback ini: nilai per koneksi → pengaturan global pgsql.copilot.accessMode → default (rw).
Caution
Gunakan Baca Saja untuk database produksi kecuali Anda sengaja menginginkan perubahan skema atau data yang tersedia melalui asisten AI.
Mengonfigurasi pengaturan tambahan
| Setting | Apa yang dikontrolnya | Default |
|---|---|---|
pgsql.copilot.enable |
Mengaktifkan atau menonaktifkan semua integrasi AI dalam ekstensi | true |
pgsql.copilot.accessMode |
Mode akses AI global (Baca Saja atau Baca/Tulis) | rw |
pgsql.copilot.autoAttachQuery |
Apakah teks kueri SQL disertakan saat menganalisis rencana dengan AI: Tanya Setiap Saat, Selalu Sertakan, atau Tidak Pernah Sertakan | ask |
pgsql.copilot.modelOptions |
Penyetelan model tingkat lanjut (token maks, suhu, top_p) untuk alur kerja AI ekstensi | - |
ID setelan tetap menggunakan awalan pgsql.copilot.* di kedua editor demi kompatibilitas ke belakang, meskipun label yang terlihat oleh pengguna menampilkan "AI".
Integrasi AI khusus fitur
Beberapa fitur termasuk titik integrasi AI khusus:
| Feature | Kemampuan AI |
|---|---|
| Visualisasi rencana kueri | Menganalisis data rencana eksekusi dengan Analisis dengan Copilot (atau Analisis dengan AI di Kursor) |
| Dashboard server | Buka sesi obrolan dari tombol Tanyakan ke Copilot (Ask AI di Cursor) pada panel Queries, Waits, Sessions, dan bagan metrik |
| Visualisasi skema | Memvisualisasikan hubungan skema dari alur kerja mode Agen |