Aracılığıyla paylaş


Hızlı Başlangıç: GitHub Copilot Aracı Modunu Kullanma

GitHub Copilot Aracı Modu, Visual Studio Code için MSSQL uzantısına bağlamsal, eylem temelli bir sohbet deneyimi getirir. Aracı Modu ile GitHub Copilot kod önermenin ötesine geçebilir; doğal dil istemlerini veya yerleşik araçları kullanarak gerçek veritabanı görevlerini güvenli bir şekilde yürütebilir. Düzenleyicinizden çıkmadan tüm bağlantılarınızı listeleyebilir, belirli sunuculara/veritabanlarına bağlanabilir ve şemaları inceleyebilirsiniz.

Tip

Aracı Modunda SQL araçlarını kullanırken @mssql gibi bir katılımcıyı belirtmenize gerek yok. MSSQL uzantısı etkinleştirildikten sonra araçları Aracı Modu arabiriminde otomatik olarak kullanılabilir. Daha fazla bilgi için bkz. Aracı Modu Araçları.

Bu eylemler MSSQL uzantısının katkılarıyla sağlanan araçlarla desteklenir ve doğrudan GitHub Copilot'un Aracı Modu'nda ortaya çıkar. Aracı Modu'nun nasıl çalıştığı hakkında daha fazla bilgi için Aracı Modu ile ilgili Visual Studio Code belgelerine bakın.

Aracı Modu nedir?

Aracı Modu, GitHub Copilot'un kod önermenin ötesine geçmesini sağlar. Artık, gibi #mssql_connectsohbet değişkenlerini veya aşağıdaki gibi doğal ifadeleri kullanarak SQL geliştirme ortamınızda güvenli, onaylanmış eylemler gerçekleştirebilir:

Connect to my Library database using my LocalDev profile

GitHub Copilot Aracı Modu sohbet arabiriminin ekran görüntüsü.

MSSQL Agent Mode aracı referansı

Bu bölümde GitHub Copilot Aracı Modu'nda bulunan SQL'e özgü araçlar için ayrıntılı bir başvuru sağlanır. MSSQL uzantısı bu araçlara katkıda bulunarak GitHub Copilot'un sohbet değişkenleri veya doğal dil istemleri aracılığıyla eylemler yürütmesini sağlar. Tüm araçlar, yürütmeden önce kullanıcı onayı gerektirir.

Copilot Aracı Modu'nda MSSQL uzantısının katkıda bulunduğu SQL'e özgü araçların listesinin ekran görüntüsü.

Tip

Bu araçları doğrudan çağırmak veya aşağıdakiler gibi doğal dilde istemler yazmak için #mssql_connect sohbet değişkenlerini de kullanabilirsiniz:

Connect to my development database

GitHub Copilot, araç seçimini otomatik olarak işler.

Bağlantı yönetimi

Araç adı Description
connect Kaydedilmiş bir bağlantı profili veya belirtilen bir sunucu/veritabanı çifti kullanarak veritabanı bağlantısı kurar.
disconnect Geçerli etkin bağlantı oturumunu sonlandırır.
change_database Var olan bir bağlantı oturumu için veritabanını değiştirir.
get_connection_details Belirli bir MSSQL bağlantısı için bağlantı ayrıntılarını alır.
list_servers Ortamınızdaki tüm kaydedilmiş SQL Server bağlantı profillerini listeler.
list_databases Bağlı bir MSSQL sunucusu için tüm kullanılabilir veritabanlarını listeler.

Examples

Aşağıdaki tümcecikler GitHub Copilot ile etkileşime geçmek için kullanılabilir.

- Connect to my LocalDev environment
- Disconnect from my current database
- List my available connection profiles
- List all databases in the localhost server
- Set the active connection to localhost
- Set AdventureWorks as the active database
- Get the connection string for AdventureWorks on localhost

GitHub Copilot sohbetindeki bir veritabanına bağlanmak için aracı aracının kullanıldığı örneğin ekran görüntüsü.

Bağlantı mantığı nasıl çalışır?

GitHub Copilot Aracı Modu, kaydedilmiş profillere başvurarak veya doğrudan bir sunucu ve veritabanı belirterek SQL veritabanınıza bağlanmanın esnek yollarını destekler. Bağlantı mantığı şu şekilde çalışır:

Kayıtlı profil aracılığıyla bağlandığınızda:

  1. Kullanıcı, kaydedilmiş bir bağlantı profilinin adına başvurarak bağlanabilir.
  2. GitHub Copilot, profilin mssql_list_servers mevcut olduğunu doğrulamak için aracı kullanır.
  3. mssql_connect aracı, daha sonra kaydedilen profileId ve parametrelerini kullanarak bağlantıyı kurar.

Sunucu/veritabanı belirtimi aracılığıyla bağlandığınızda:

  • Kaydedilen profil hem belirtilen sunucu hem de veritabanıyla eşleşiyorsa:

    1. GitHub Copilot, eşleşmeyi bulmak için kullanır mssql_list_servers .
    2. Sonra mssql_connect'yi tam profili kullanarak çağırır.
  • Kaydedilen profil yalnızca sunucuyla eşleşiyorsa:

    1. GitHub Copilot eşleşen sunucu profilini bulur.
    2. Kullanıcı tarafından istenen veritabanını o profile yerleştirerek bağlanmaya çalışır.
    3. Bağlantı başarısız olursa bir hata gösterilir.
  • Belirtilen sunucuyla eşleşen profil yoksa:

    • GitHub Copilot bir hata bildirir.

Bu esnek eşleştirme sistemi, GitHub Copilot'un çeşitli bağlantı senaryolarını işlemesine olanak tanır ve kullanıcı çabasını en aza indirirken güvenli, doğrulanabilir eylemler sağlar.

Veri Yapısı Keşfi

Araç adı Description
show_schema Tablolar ve ilişkiler de dahil olmak üzere bağlı veritabanı şemanızın üst düzey bir diyagramını görüntüler.
list_schemas Bağlı bir MSSQL sunucusu için veritabanındaki tüm şemaları listeler.
list_tables Bağlı bir MSSQL sunucusu için veritabanındaki tüm tabloları listeler.
list_views Bağlı bir MSSQL sunucusu için veritabanındaki tüm görünümleri listeler.
list_functions Bağlı bir MSSQL sunucusu için veritabanındaki tüm işlevleri listeler.

Examples

Aşağıdaki tümcecikler GitHub Copilot ile etkileşime geçmek için kullanılabilir.

- Show me the schema for this database
- Show me all tables in the current database
- List all views from this MSSQL database
- Give me a list of all the functions available in this schema
- What schemas are available in this database?

Copilot Aracı Modu'nda veritabanı şeması görselleştirici aracını gösteren animasyonun ekran görüntüsü.

Sorgu yürütme

Araç adı Description
run_query Bağlı veritabanına karşı bir SQL sorgusu yürütür.

Examples

Aşağıdaki tümcecikler GitHub Copilot ile etkileşime geçmek için kullanılabilir.

- Give me the top five posts published this week
- Execute the current file to find how many comments each post has
- Get all categories along with the number of posts in each

Veritabanına bağlanmak ve verileri almak için aracı aracının kullanıldığı örneğin ekran görüntüsü.

Veritabanına bağlanmak ve veri almak için aracı aracını kullanan başka bir örneğin ekran görüntüsü.

Araçlar Aracı Modunda nasıl yönetilir?

GitHub Copilot, isteğinizi işlerken MSSQL'e özgü araçları ve uzantıyla katkıda bulunan diğer araçları çağırabilir. Bu araçlar Araçlar menüsünün altındaki Aracı Modu arabiriminde görünür ve burada belirli araçları etkinleştirebilir veya devre dışı bırakabilirsiniz.

Bir araç çağrıldığında (özellikle makinenizle veya veritabanınızla etkileşime geçtiğinde), GitHub Copilot güvenli yürütmeyi sağlamak için onay ister. Yalnızca geçerli oturum, çalışma alanı için ya da kalıcı olarak araca izin verebilirsiniz.

Araç görünürlüğü ve onayları hakkında daha fazla bilgi için Bkz. Araç onaylarını yönetme.

Aracı Modu onay iş akışı

GitHub Copilot bir araç seçtiğinde, istenen eylemle ilgili ayrıntıları gösteren bir onay iletişim kutusuyla sizi uyarır. Makinenizle veya veritabanınızla etkileşim kuran komutları yürütebilmesi için önce isteği açıkça onaylamanız gerekir:

  • Bu oturumda izin ver
  • Bu çalışma alanına izin ver
  • Her zaman izin ver

Bu onay adımı, geliştirme ortamınızla güvenli ve kasıtlı etkileşimler sağlamaya yardımcı olur.

Note

Aracı Modu'ndaki tüm araçlarda onayın nasıl çalıştığı hakkında daha fazla bilgi için , araç onaylarıyla ilgili Visual Studio Code belgelerine bakın.