Aracı modu

Aracı modu, düzenleyicinizdeki yapay zeka yardımcısının tek bir çok adımlı konuşmanın parçası olarak uzantıdan PostgreSQL araçlarını kullanmasına olanak tanır. Yardımcı yalnızca bir soruyu yanıtlamak yerine veritabanına bağlanabilir, şemayı inceleyebilir, sorgu çalıştırabilir, betikleri açabilir ve iş akışında uçtan uca ilerlemenize yardımcı olabilir.

Ajan modu, hem Visual Studio Code'da (GitHub Copilot ile) hem de Cursor'da (yerleşik yapay zekâsıyla) çalışır. Uzantı, her iki düzenleyicide de aynı PostgreSQL aracının yüzeyini kullanıma sunar; yalnızca açılan sohbet paneli farklılık gösterir.

Yapay zekanın yalnızca SQL'i açıklamak veya taslak yapmak yerine yapılandırılmış eylemler gerçekleştirmesini istediğinizde Aracı modunu kullanın.

Prerequisites

Başlamadan önce şunları yaptığınızdan emin olun:

  • PostgreSQL uzantısı yüklü.
  • Uzantıda etkin olan Copilot/AI özellikleri (pgsql.copilot.enabletrue).
  • Uzantıda yapılandırılan en az bir veritabanı bağlantısı.
  • Düzenleyicinizde kullanılabilen bir yapay zeka yardımcısı:
    • Visual Studio Code: GitHub Copilot veya GitHub Copilot Sohbet yüklü ve etkin.
    • Cursor: ek kurulum gerekmez; yerleşik yapay zekâ otomatik olarak kullanılır.

Temsilci modunu başlat

  1. PostgreSQL uzantısında hedef sunucuya veya veritabanına bağlanın.
  2. Bağlantılar ağacında, kullanmak istediğiniz veritabanına sağ tıklayın.
  3. Yapay zekayı bağla'yı seçin.
  4. Tamamlamak istediğiniz iş akışıyla açılan sohbet panelinde konuşmaya devam edin.
    • Visual Studio Code'de bu, Aracı modundaki GitHub Copilot Chat panelidir.
    • İmleç'te bu, İmleç'in yerel yapay zeka panelidir; uzantı, yardımcının kullanılabilir PostgreSQL araçları hakkında bilgi edinmesi için kısa bir MCP odaklı ön derleme sağlar.

Oturum başladıktan sonra yapay zeka, isteğiniz doğrultusunda çalışan PostgreSQL araçlarını arka planda birleştirebilir.

Doğru erişim modunu seçin

Bu ayar, pgsql.copilot.accessMode Aracı modunun ne kadar veritabanı erişimi alacağını denetler. Ayar kimliği, uyumluluk için pgsql.copilot.* ön ekini korur; kullanıcıya görünen etiket, Visual Studio Code’da Copilot erişim modu ve Cursor’da Yapay zeka erişim modu şeklindedir.

Mode Yapay zekanın yapabilecekleri Önerilen kullanım
ro SELECT, SHOW, EXPLAIN, şema incelemesi ve analiz gibi salt okunur işlemler Değişiklik yapmadan araştırma yapmak istediğiniz üretim sistemleri veya paylaşılan ortamlar
rw Yürütmeden önce açık onay ile okuma işlemlerinin yanı sıra veri değiştirme deyimleri ve DDL Yerel geliştirme, geçici yalıtılmış ortamlar ve kontrollü test ortamları

Caution

Şema veya veri değişikliklerinin Aracı modu aracılığıyla kullanılabilir olmasını istemediğiniz sürece üretim veritabanları için modu kullanın ro .

Araç ailelerini anlama

Aracı modu, iş akışına bağlı olarak birden çok araç ailesi kullanabilir.

Araç ailesi Ne yapar? Kullandığınızda
Bağlantı araçları Profilleri listeleme, bağlanma, bağlantıyı kesme, veritabanlarını listeleme Bağlamı başlatın veya değiştirin
Şema bağlam araçları Nesne tanımlarını getirme veya şemayı görselleştirme Tabloları, görünümleri, işlevleri, dizinleri ve ilişkileri anlama
Sorgu araçları Okuma sorguları çalıştırma, sorgu planlarını inceleme, betikleri açma Verileri araştırma, fikirleri doğrulama veya oluşturulan SQL'i gözden geçirme
Değişiklik araçları DDL veya DML'i onay ile çalıştırma rw modunda denetimli şema veya veri değişikliklerini uygulayın
Veri içeri aktarma araçları CSV dosyalarını açıklama ve toplu yükleme CSV içeri aktarma iş akışlarını planlama ve yürütme

Tip

Cursor'da, aynı araçlar MCP sunucusu kaydı aracılığıyla da sunulur. Cursor’ın yerel sohbeti, Connect AI giriş noktası üzerinden geçmeden onları doğrudan çağırabilir. Ayrıntılar için bkz. MCP sunucusu .

Yaygın iş akışları için Aracı modunu kullanma

Aşağıdaki örneklerde, yeni bir veritabanını keşfetmeden sorguları iyileştirmeye kadar değişen görevler için Aracı modunun nasıl kullanılacağı gösterilmektedir.

Tanıdık olmayan bir veritabanını keşfetme

Yapay zekadan veritabanına bağlanmasını, anahtar nesnelerini listelemesini ve göreviniz için önemli olan şema alanlarını özetlediğini isteyin.

Örnek:

Geliştirme veritabanıma bağlanın, genel şemadaki tabloları listeleyin ve hangilerinin müşteriler ve siparişlerle ilgili olduğunu söyleyin.

Sorgu performansını araştırma

Yapay zekadan şema bağlamını sorgu yürütme veya plan incelemesiyle birleştirmesini isteyin.

Örnek:

Hazırlama veritabanına bağlanın, bu sorguyu salt okunur modda çalıştırın ve yürütme planının hangi bölümünün maliyeti yönlendirdiği açıklayın.

Verileri yükleme veya yeniden şekillendirme

İş akışı betikler veya CSV tabanlı işlemler içerdiğinde Aracı modunu kullanın.

Örnek:

Bu CSV dosyasını gözden geçirin, hangi şemayı ima ettiği açıklayın ve tablo için sales.records güvenli bir içeri aktarma planı hazırlayın.

Taslaktan el ile gözden geçirmeye geçme

Yürütmeden önce bir insan inceleme denetim noktası istediğinizde, yapay zekadan oluşturulan SQL'i hemen çalıştırmak yerine sorgu düzenleyicisinde açmasını isteyin.

Bunun yerine Aracı modunun ne zaman kullanılacağını öğrenme @pgsql

Şemaya duyarlı bir yanıt veya bir sorgu taslağı istediğinizde @pgsql sohbet katılımcısını kullanın. @pgsql katılımcısı yalnızca Visual Studio Code içinde mevcuttur.

Yapay zekanın aşağıdakileri kullanmasını istediğinizde Aracı modunu (hem Visual Studio Code hem de İmleç'te kullanılabilir) kullanın:

  • sizin için doğru veritabanına bağlanın,
  • tek bir konuşmada birden çok aracı ardışık olarak kullanın,
  • sonraki adımdan önce sonuçları inceleyin veya
  • bir betik veya denetimli değişiklik iş akışı hazırlayın.

Note

Cursor'da, @pgsql sohbet katılımcısı burada kullanılamadığından birincil yol Agent modudur. Aynı araç arayüzüne Cursor’un yerel sohbeti üzerinden, MCP sunucusu aracılığıyla da erişilebilir.

Aracı Modu'nda Sorun Giderme

Aracı modu beklendiği gibi davranmıyorsa, önce erişim modunu ve araç kullanılabilirliğini denetleyin.

Yapay zeka veritabanını değiştiremiyor

pgsql.copilot.accessMode öğesini kontrol edin ve etkin bağlantının ro olarak çözümlenmediğini doğrulayın.

Beklediğiniz araç kullanılamıyor

Copilot tümleştirmenin etkinleştirildiğinden ve geçerli bir PostgreSQL bağlantı bağlamı olan bir veritabanından başladığınızdan emin olun.

Bağlantı isteği başarısız oluyor

Bağlantı profilinin hala mevcut olduğunu, kimlik bilgilerinin kullanılabilir olduğunu ve uzantının Aracı modu dışında aynı veritabanına bağlanabildiğini onaylayın.

Sohbet öncelikli daha basit bir iş akışı istiyorum

Visual Studio Code'da, araç temelli otomasyon olmadan açıklama, sorgu taslak oluşturma veya şema soruları istediğinizde sohbet katılımcısını @pgsql kullanın. Cursor'da, yerel sohbette sorduğunuzla aynı tür soruları sorun. Uzantının MCP araçları hâlâ keşfedilebilir, ancak açık bir Aracı modu seçeneği olmadan sohbet daha konuşma odaklı ilerler.

İlgili içerik

  • Last updated on