Copilot entegrasyonu

PostgreSQL uzantısı üç yüzey aracılığıyla yapay zeka yardımcılarıyla tümleştirilir: @pgsql sohbet katılımcısı (yalnızca Visual Studio Code), Aracı modu araçları ve PostgreSQL Araçları MCP Sunucu Sağlayıcısı. Bu sayfa, doğru giriş noktasını seçmenize ve üçünü de geçerli olan paylaşılan yapılandırmayı anlamanıza yardımcı olur.

Uzantı hem Visual Studio Code'da (GitHub Copilot ile) hem de Cursor'da (yerleşik yapay zekâsıyla) çalışır. Özelliklerin çoğu her iki düzenleyicide de aynı şekilde çalışır; düzenleyiciye özgü az sayıda davranış bu makale boyunca vurgulanıyor.

Prerequisites

Yapay zeka destekli herhangi bir özelliği kullanmadan önce aşağıdaki gereksinimlerin karşılandığından emin olun:

  • PostgreSQL uzantısı yüklenir ve en az bir veritabanı bağlantınız yapılandırılmıştır.
  • Yapay zeka yardımcısı düzenleyicinizde kullanılabilir:
    • Visual Studio Code: GitHub Copilot veya GitHub Copilot Sohbet'i yükleyin ve etkin bir abonelikle oturum açın.
    • Cursor: ek kurulum gerekmez; yerleşik yapay zekâ otomatik olarak kullanılır.

Note

Copilot özellikleri varsayılan olarak etkindir (pgsql.copilot.enable ).true Bunu olarak falseayarladığınızda, @pgsql sohbet katılımcısı (yalnızca Visual Studio Code), AI Sorgu Eylemleri düzenleyicisi alt menüsü, Aracı modu araçları ve MCP sunucu sağlayıcısı gizlenir.

Tip

Etkin bir veritabanı bağlantınız varsa yapay zeka yardımı en iyi şekilde çalışır. Henüz bağlanmadıysanız Bağlantılar ve kimlik ile başlayın.

Doğru giriş noktasını seçin

Eğer istersen... Buradan başlayın Availability Learn more
Veritabanınız hakkında şema kullanan bir soru sorun @pgsql sohbet katılımcısı Yalnızca Visual Studio Code için @pgsql sohbet katılımcısı
Kapsam dahilinde zaten belirli bir veritabanı varken Agent modunu başlatın Bağlantılar ağacındaki bir veritabanı düğümünden yapay zekayı bağlama Visual Studio Code ve İmleç Aracı modu
Düzenleyiciden SQL'i açıklama, yeniden yazma veya analiz etme Düzenleyici bağlam menüsündeki AI Sorgu Eylemleri alt menüsü Visual Studio Code ve İmleç Düzenleyici eylemleri
Çok adımlı veritabanı görevini otomatikleştirme Aracı modunu başlatmak için veritabanı düğümünde yapay zekayı bağlama Visual Studio Code ve İmleç Aracı modu
PostgreSQL araçlarını MCP uyumlu konaklara sunma PostgreSQL Araçları MCP Sunucu Sağlayıcısı Visual Studio Code ve İmleç MCP sunucusu

Şema farkındalıklı sohbet için @pgsql kullanın

Note

@pgsql sohbet katılımcısı, yalnızca GitHub Copilot Chat'e entegre olduğu Visual Studio Code içinde kayıtlıdır. Cursor'da, aynı şema bağlamıyla Aracı modunu başlatmak için Connections ağacındaki bir veritabanı düğümünden Connect AI'yi kullanın veya Cursor'un yerleşik sohbet arayüzündeki MCP sunucusundan yararlanın.

Uzantı, GitHub Copilot Chat şema kullanan konuşmalar için bir @pgsql sohbet katılımcısı (Kimlik: vscode-postgresql.chat-agent) kaydeder. @pgsql yazıp ardından sorunuzu girin; katılımcı, bağlı veritabanınızdaki canlı şema bağlamını kullanarak yanıt verir.

Zaten kapsamda olan bir veritabanıyla araç odaklı bir iş akışı başlatmak için Bağlantılar ağacında bir veritabanı düğümüne sağ tıklayın ve Yapay zekaya bağlan'ı seçin.

Son kullanıcı yönergeleri, örnek istemler ve sorun giderme için @pgsql sohbet katılımcısına gidin.

Sorgu odaklı yardım için düzenleyici eylemlerini kullanma

Sorgu düzenleyicisinde SQL açık olduğunda, AI Sorgu Eylemleri alt menüsünü bulmak için sağ tıklayın. Aşağıdaki eylemleri içerir:

Eylem Description
Sorguyu Açıkla Sorgunun ne yaptığının düz dil açıklamasını döndürür.
Sorguyu Yeniden Yaz Hedeflenen sonucu korurken sorgunun alternatif bir sürümünü önerir.
Sorgu Performansını Analiz Etme Bağlı veritabanında çalışır EXPLAIN ANALYZE , ardından yürütme planını analiz için yapay zekaya gönderir.

Ayrıca, mevcut düzenleyici içeriğine dayanan bir sohbet açmak için düzenleyici araç çubuğundan Yapay zekâya bu sorguyu sor seçeneğini belirleyebilirsiniz.

Plan analizi için hatırlanan sorgu ekleme seçeneklerini sıfırlamak için Komut Paleti'nden Yapay zeka analizi için sorgu ekleme tercihlerini temizle'yi çalıştırın.

Araç temelli iş akışları için Aracı modunu kullanma

Aracı modu, yapay zeka yardımcısının PostgreSQL araçlarına erişmesini sağlar; böylece tek bir konuşmada bağlantı kurabilir, şemayı inceleyebilir, sorgu çalıştırabilir, betikleri açabilir ve çok adımlı görevlerle çalışabilir. Bağlantılar ağacında bir veritabanı düğümüne sağ tıklayın ve Aracı modu oturumu başlatmak için Yapay zekayı bağla'yı seçin.

Araç aileleri, örnek iş akışları ve sorun giderme için Aracı moduna geçin.

Desteklenen konaklarda MCP sunucusunu kullanma

Uzantı, Model Bağlam Protokolü aracılığıyla aynı PostgreSQL araç yüzeyini kullanıma sunan bir PostgreSQL Araçları MCP Sunucu Sağlayıcısı (ID: pgsql-tools-mcp-server-provider) kaydeder. MCP uyumlu konaklar, yerleşik sohbet iş akışlarını kullanmadan bu araçları bulabilir ve çağırabilir.

Desteklenen konaklar, otomatik kayıt davranışı ve MCP aracılığıyla kullanıma sunulan araç aileleri için MCP sunucusuna geçin.

Erişim modunu yapılandırma

Bu ayar, pgsql.copilot.accessMode AI yardımcısının Aracı modu ve MCP araçları arasında ne kadar veritabanı erişimi alacağını denetler. Varsayılan değer Okuma/Yazma (rw).

Ayar değeri UI etiketi Yapay zeka yardımcısının yapabilecekleri
ro Sadece Okunabilir Salt okunur işlemler: SELECT, SHOW, EXPLAIN, şema denetimi
rw Okuma/Yazma Açık onay gerektiren okuma işlemleri, veri değiştirme deyimleri ve DDL

Bağlantı bazında geçersiz kılma

Erişim modunu tek tek bağlantılarda da ayarlayabilirsiniz. Bağlantı iletişim kutusunda Copilot bölümünü genişletin (İmleç'te yapay zeka) ve Copilot erişim modunu (İmleç'te AI erişim modu) aşağıdakilerden birine ayarlayın:

Seçenek Davranış
Genel Ayarı Kullan Genel pgsql.copilot.accessMode değere geri döner (varsayılan)
Sadece Okunabilir Genel ayardan bağımsız olarak bu bağlantı için salt okunur erişim uygular
Okuma/Yazma Genel ayardan bağımsız olarak bu bağlantı için okuma/yazma erişimini zorlar

Uzantı, şu geri dönüş zincirini kullanarak etkin erişim modunu çözümler: bağlantı başına değer → genel pgsql.copilot.accessMode ayar → varsayılan (rw ).

Caution

Şema veya veri değişikliklerinin yapay zeka asistanı üzerinden kullanılabilir olmasını özellikle istemiyorsanız, üretim veritabanları için Read Only kullanın.

Ek ayarları yapılandırma

Ayar Neleri denetler? Varsayılan
pgsql.copilot.enable Uzantıdaki tüm yapay zeka tümleştirmesini etkinleştirir veya devre dışı bırakır true
pgsql.copilot.accessMode Global yapay zeka erişim modu (Yalnızca Okuma veya Okuma/Yazma) rw
pgsql.copilot.autoAttachQuery Yapay zeka ile planları analiz ederken SQL sorgu metninin eklenip eklenmediği: Her Zaman Sor, Her Zaman Dahil Et veya Hiçbir Zaman Dahil Etme ask
pgsql.copilot.modelOptions Uzantının yapay zeka iş akışları için gelişmiş model ayarlama (maksimum belirteçler, sıcaklık, top_p) -

Ayar kimlikleri, kullanıcının gördüğü etiketlerde "AI" yazsa bile, geriye dönük uyumluluk için her iki düzenleyicide de pgsql.copilot.* önekini korur.

Özelliğe özgü yapay zeka tümleştirmeleri

Bazı özellikler, özel yapay zeka entegrasyon noktaları içerir:

Özellik Yapay zeka özelliği
Sorgu planı görselleştiricisi Yürütme planı verilerini Copilot ile Analiz Et (veya Cursor’da Yapay Zeka ile Analiz Et) seçeneğiyle analiz edin
Sunucu panosu Sorgular, Beklemeler, Oturumlar ve ölçüm grafiği panellerindeki Copilot'a Sor düğmelerinden (İmleçte Yapay Zekaya Sorun) sohbet oturumlarını açma
Şema görselleştiricisi Aracı modu iş akışından şema ilişkilerini görselleştirme

İlgili içerik

  • Last updated on