Mulai cepat: Gunakan mode agen GitHub Copilot

Mode agen memungkinkan GitHub Copilot mengatur alat yang dikontribusikan oleh ekstensi MSSQL untuk Visual Studio Code. Ketika ekstensi diinstal dan aktif, GitHub Copilot dapat mencantumkan koneksi Microsoft SQL Server, terhubung ke server dan database, mengambil metadata skema, menjalankan kueri, dan menyelidiki kinerja Query Store, semuanya dari prompt bahasa alami. Persyaratan persetujuan tergantung pada alatnya.

Semua tindakan menggunakan konteks koneksi dan kredensial yang sama dengan ekstensi MSSQL. Mode agen tidak memperkenalkan autentikasi atau perubahan izin lain.

Tip

Gunakan mode agen untuk alur kerja multi-langkah, eksplorasi dalam skala besar, dan perubahan yang didelegasikan. Gunakan mode pertanyaan saat Anda memerlukan satu jawaban atau kueri sekali jalan. Gunakan mode rencana saat Anda perlu mempertimbangkan desain sebelum menulis bahasa definisi data (DDL) Transact-SQL (T-SQL).

Kesimpulan utama

  • Mode agen mengambil alat ekstensi MSSQL secara otomatis. Tidak perlu @mssql menyebutkan.
  • Tinjau dan setujui panggilan alat saat diminta. Pembacaan diagnostik Query Store tidak meminta konfirmasi; memaksa atau melepas rencana memerlukan tinjauan dan konfirmasi.
  • Mode agen memahami skema melalui alat-alatnya: setiap pemanggilan alat mengembalikan data aktual dari basis data Anda yang terhubung.
  • Untuk konteks arsitektur di semua permukaan, lihat Cara GitHub Copilot bekerja dengan ekstensi MSSQL.

Kapan menggunakan mode agen

Mode agen adalah yang terbaik untuk:

  • Alur kerja multi-langkah. "Sambungkan ke LocalDev, beralihlah ke AdventureWorks, lalu tunjukkan kepada saya setiap tabel dengan kunci asing kepada Pelanggan."
  • Eksplorasi dalam skala besar. "Temukan prosedur tersimpan yang mereferensikan SalesOrderHeader dan ringkas apa yang dilakukan masing-masing."
  • Investigasi kinerja. "Gunakan Query Store untuk menemukan kueri CPU tertinggi dalam 24 jam terakhir, lalu analisis riwayat, tungguan, dan rencana kueri teratas."
  • Perubahan yang didelegasikan. "Tambahkan kolom audit ke setiap tabel dalam skema Penjualan dan regenerasi prosedur tersimpan terkait."

Gunakan mode tanya jika satu pertanyaan atau kueri sekali kirim sudah memenuhi kebutuhan Anda. Gunakan perintah garis miring saat Anda sudah mengetahui tindakan mana yang Anda inginkan. Gunakan mode rencana saat Anda menginginkan rencana tertulis sebelum melakukan perubahan apa pun.

Untuk detail tentang cara mode agen memilih dan menjalankan alat, lihat dokumentasi Visual Studio Code tentang mode agen.

Apa itu mode agen?

Mode agen memungkinkan GitHub Copilot melakukan aksi terkait SQL dengan menggunakan ekstensi MSSQL. Alat yang memerlukan konfirmasi akan menampilkan tindakan yang diminta untuk tinjauan Anda sebelum dieksekusi.

Anda dapat memanggil tindakan ini dengan menggunakan variabel obrolan seperti #mssql_connect, atau dengan mengeluarkan permintaan bahasa alami yang setara, misalnya:

Connect to my Library database using my LocalDev profile

Tangkapan layar antarmuka chat GitHub Copilot Agent Mode.

Referensi alat Mode Agen MSSQL

Bagian ini menyediakan referensi terperinci untuk alat khusus SQL yang tersedia dalam GitHub Copilot Agent Mode. Ekstensi MSSQL berkontribusi pada alat-alat ini, memungkinkan GitHub Copilot untuk menjalankan tindakan melalui variabel obrolan atau perintah bahasa alami. Alat diagnostik Query Store membaca data kinerja yang ditangkap tanpa meminta konfirmasi. Tinjau dan setujui tindakan lain saat diminta.

Tangkapan layar daftar alat khusus SQL yang disumbangkan oleh ekstensi MSSQL dalam Mode Copilot agent.

Tip

Anda juga dapat menggunakan variabel obrolan seperti #mssql_connect memanggil alat-alat ini secara langsung, atau menulis perintah dalam bahasa alami seperti:

Connect to my development database

GitHub Copilot menangani pemilihan alat secara otomatis.

Manajemen koneksi

Nama alat Description
connect Menyambungkan ke database dengan menggunakan profil koneksi tersimpan atau server dan database tertentu.
disconnect Mengakhiri sesi koneksi aktif saat ini.
change_database Mengubah database untuk sesi koneksi yang sudah ada.
get_connection_details Mendapatkan detail koneksi untuk koneksi MSSQL tertentu.
list_servers Mencantumkan semua profil koneksi SQL Server yang disimpan di lingkungan Anda.
list_databases Mencantumkan semua database yang tersedia untuk server MSSQL yang tersambung.

Examples

Gunakan frasa berikut untuk berinteraksi dengan GitHub Copilot.

- 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

Tangkapan layar contoh menggunakan alat agen untuk terhubung ke database di chat GitHub Copilot.

Cara kerja logika koneksi

Mode Agen Copilot GitHub mendukung cara fleksibel untuk menyambungkan ke database SQL Anda, baik dengan mereferensikan profil yang disimpan atau dengan menentukan server dan database secara langsung. Berikut cara kerja logika koneksi.

Saat Anda tersambung dengan profil tersimpan:

  1. Anda tersambung dengan merujuk nama profil koneksi yang disimpan.
  2. GitHub Copilot menggunakan mssql_list_servers alat untuk memverifikasi bahwa profil ada.
  3. mssql_connect kemudian menggunakan profileId yang telah disimpan dan parameternya untuk membuat koneksi.

Saat Anda menyambungkan dengan menentukan server dan database:

  • Jika profil tersimpan cocok dengan server dan database yang ditentukan:

    1. GitHub Copilot menggunakan mssql_list_servers untuk menemukan kecocokan.
    2. Kemudian memanggil mssql_connect menggunakan profil lengkap.
  • Apabila profil yang tersimpan hanya cocok dengan server:

    1. GitHub Copilot menemukan profil server yang cocok.
    2. Ini mencoba menyambungkan dengan mengganti database yang diminta pengguna ke dalam profil tersebut.
    3. Jika koneksi gagal, kesalahan akan ditampilkan.
  • Jika tidak ada profil yang cocok dengan server yang ditentukan:

    • GitHub Copilot melaporkan kesalahan.

Sistem pencocokan fleksibel ini memungkinkan GitHub Copilot menangani berbagai skenario koneksi. Ini meminimalkan upaya pengguna sambil memastikan tindakan yang aman dan dapat dikonfirmasi.

Eksplorasi skema

Nama alat Description
show_schema Menampilkan diagram tingkat tinggi dari skema database tersambung Anda, termasuk tabel dan hubungan.
list_schemas Mencantumkan semua skema dalam database untuk server MSSQL yang tersambung.
list_tables Mencantumkan semua tabel dalam database untuk server MSSQL yang tersambung.
list_views Mencantumkan semua tampilan dalam database untuk server MSSQL yang tersambung.
list_functions Mencantumkan semua fungsi dalam database untuk server MSSQL yang tersambung.

Examples

Gunakan frasa berikut untuk berinteraksi dengan GitHub Copilot.

- 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?

Tangkapan layar animasi yang menunjukkan alat visualiser skema database dalam Copilot Agent Mode.

Eksekusi kueri

Nama alat Description
run_query Menjalankan kueri SQL terhadap database yang tersambung.

Examples

Gunakan frasa berikut untuk berinteraksi dengan GitHub Copilot.

- 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

Tangkapan layar contoh menggunakan alat agen untuk terhubung ke database dan mengambil data.

Tangkapan layar contoh lain yang menggunakan alat agen untuk terhubung ke database dan mengambil data.

Alat performa Query Store (pratinjau)

Gunakan alat-alat ini untuk menyelidiki kinerja query yang ditangkap daripada membangun SQL diagnostik secara manual. Mereka memerlukan database yang mendukung Query Store, data yang ditangkap untuk periode yang Anda minta, dan izin untuk membaca data tersebut. Anda dapat mengidentifikasi target melalui koneksi yang sudah ada atau profil koneksi yang disimpan dan nama database.

Nama alat Description
mssql_query_store_status Membaca status Query Store, alasan hanya-baca, dan riwayat yang tersedia.
mssql_query_store_top_queries Menemukan kueri yang diurutkan berdasarkan metrik sumber daya atau jumlah eksekusi dalam jendela waktu.
mssql_query_store_query_details Membaca teks satu kueri, statistik runtime, dan plan eksekusi beserta statistiknya.
mssql_query_store_query_history Membaca kinerja kueri dari waktu ke waktu, termasuk statistik untuk rencana yang berjalan di setiap interval.
mssql_query_store_wait_stats Membaca waktu tunggu berdasarkan kategori untuk database, query, atau rencana. Memerlukan dukungan dan perekaman statistik tunggu Query Store.
mssql_query_store_plan_summary Merangkum informasi pernyataan rencana tersimpan, peringatan, rekomendasi indeks hilang, dan operator yang mahal.
mssql_query_store_analyze_query Menggabungkan detail query, rencana, riwayat eksekusi, waktu tunggu, dan ringkasan rencana utama dalam satu panggilan diagnostik.
mssql_open_performance_dashboard Membuka Dasbor Kinerja Kueri untuk sebuah basis data, atau pada kueri dan tab tertentu yang spesifik.
mssql_query_store_plan_forcing Memaksa atau membatalkan paksa pada rencana kueri setelah Anda meninjau dan mengonfirmasi SQL yang dihasilkan.
mssql_query_store_verify_forced_plan Memeriksa apakah eksekusi setelah rencana dipaksakan menggunakan rencana tersebut.

Untuk memulai investigasi, identifikasi database dan periode dalam prompt Anda:

Use Query Store to find the queries with the highest total CPU time in AdventureWorksLT in the past 24 hours. Analyze the top query, explain its execution history and waits, and open it in the performance dashboard. Don't make changes.

Ganti contoh nama database dengan database Anda. Anda juga dapat merujuk alat secara eksplisit, seperti #mssql_query_store_analyze_query, ketika Anda sudah mengetahui ID kueri dan basis data target.

Aksi Chat di dashboard membuka mode agen dan mengirimkan prompt yang secara eksplisit mereferensikan #mssql_query_store_analyze_query dan menyediakan server, database, ID profil yang tersimpan, ID kueri, dan rentang waktu dari query yang dipilih. Untuk panduan dan petunjuk tindak lanjut, lihat Investigate Query Store performance.

Important

Pembacaan diagnostik tidak memodifikasi database atau memerlukan konfirmasi. Memaksa atau melepas rencana adalah perubahan terpisah: alat ini menampilkan SQL yang tepat dan peringatan untuk ditinjau dan dikonfirmasi. Memverifikasi rencana yang dipaksakan bersifat hanya-baca. Diagnosa masalahnya dan tinjau bukti sebelum meminta perubahan rencana.

Pengaturan retensi dan penangkapan Query Store menentukan data yang tersedia. Jika Query Store dimatikan atau periode yang diminta tidak memiliki data yang tertangkap, alat tidak dapat memberikan diagnosis kinerja untuk periode tersebut. Untuk detail pengaturan, lihat prasyarat Dasbor Kinerja Query.

Cara alat dikelola dalam Mode Agen

GitHub Copilot dapat menggunakan alat khusus MSSQL dan alat berkontribusi ekstensi lainnya saat memproses permintaan Anda. Anda dapat melihat alat-alat ini di antarmuka Mode Agen di bawah menu Alat , di mana Anda juga dapat mengaktifkan atau menonaktifkan alat tertentu.

Ketika sebuah alat memerlukan konfirmasi, GitHub Copilot meminta Anda untuk meninjau tindakan yang diminta sebelum dijalankan. Anda dapat mengizinkan alat hanya untuk sesi saat ini, ruang kerja, atau secara permanen. Pembacaan diagnostik Query Store tidak meminta konfirmasi; pemaksaan dan pembatalan pemaksaan rencana memintanya.

Untuk informasi selengkapnya tentang visibilitas dan persetujuan alat, lihat Mengelola persetujuan alat.

Alur kerja konfirmasi Mode Agen

Untuk alat yang memerlukan konfirmasi, GitHub Copilot menampilkan detail tentang tindakan yang diminta. Tinjau permintaan sebelum memilih opsi persetujuan:

  • Izinkan dalam sesi ini
  • Izinkan di ruang kerja ini
  • Selalu izinkan

Langkah konfirmasi ini membantu memastikan interaksi yang aman dan disengaja dengan lingkungan pengembangan Anda.

Note

Untuk informasi selengkapnya tentang cara kerja konfirmasi di semua alat dalam Mode Agen, lihat dokumentasi Visual Studio Code tentang persetujuan alat.

Katalog prompt mode agen

Gunakan perintah bahasa alami ini untuk memanggil alat ekstensi MSSQL melalui mode agen. Untuk setiap kategori, perintah garis miring yang setara atau permintaan mode tanya dirujuk silang.

Manajemen koneksi

Connect to my LocalDev profile and set AdventureWorks as the active database.
List all my saved connection profiles and tell me which one I'm currently connected to.
Disconnect from my current database.

Perintah garis miring yang setara: /connect, /listServers, /changeDatabase, /disconnect.

Eksplorasi skema

Show me every table in the SalesLT schema, grouped by whether they're
referenced by a foreign key from another table.
Find all stored procedures that reference SalesLT.SalesOrderHeader and
summarize what each one does in one sentence.
Which tables in the current database have no primary key?

Permintaan yang setara: lihat Mengobrol dengan @mssql peserta.

Eksekusi kueri

Run a query to count the number of active customers in SalesLT.Customer,
then show me the top 10 by order total.
Show me the execution plan for this query: SELECT ... FROM ...
Execute the last query I ran against my Dev database instead.

Alur kerja multi-langkah

Connect to LocalDev, switch to AdventureWorks, list all tables with a
foreign key to SalesLT.Customer, and save the list to a file called
customer-dependents.md.
Find every stored procedure that uses dynamic SQL and open each one
in a new editor tab so I can review them.

Perubahan skema yang didelegasikan

Note

Perubahan skema cocok untuk dijalankan dalam mode perencanaan terlebih dahulu. Rencanakan perubahan, tinjau perubahan tersebut, lalu serahkan rencana itu ke mode agen untuk dieksekusi.

Add createdAt and updatedAt audit columns to every table in the Sales
schema that doesn't already have them. Use DATETIME2(7) with a default
of GETUTCDATE().
Regenerate every stored procedure that inserts into SalesLT.Customer
to include the new email column.