Bagikan melalui


Panduan Cepat: Menggunakan Mode Agen GitHub Copilot

Mode Agen Copilot GitHub menghadirkan pengalaman obrolan kontekstual berbasis tindakan ke ekstensi MSSQL untuk Visual Studio Code. Dengan Mode Agen, GitHub Copilot dapat melampaui kode yang disarankan—dapat menjalankan tugas database nyata dengan aman menggunakan perintah bahasa alami atau alat bawaan. Anda dapat mencantumkan semua koneksi Anda, menyambungkan ke server/database tertentu, dan menjelajahi skema tanpa meninggalkan editor Anda.

Tip

Anda tidak perlu menyebutkan peserta seperti @mssql untuk menggunakan alat SQL dalam Mode Agen. Setelah ekstensi MSSQL aktif, alatnya secara otomatis tersedia di antarmuka Mode Agen. Untuk informasi selengkapnya, lihat Alat Mode Agen.

Tindakan ini didukung oleh alat yang dikontribusikan oleh ekstensi MSSQL dan muncul langsung dalam Mode Agen GitHub Copilot. Untuk informasi selengkapnya tentang cara kerja Mode Agen, lihat dokumentasi Visual Studio Code tentang Mode Agen.

Apa itu Mode Agen?

Mode Agen memungkinkan GitHub Copilot melampaui kode yang disarankan. Sekarang dapat melakukan tindakan yang aman dan terkonfirmasi di dalam lingkungan pengembangan SQL Anda, menggunakan variabel obrolan seperti #mssql_connect, atau frasa alami seperti:

Connect to my Library database using my LocalDev profile

Cuplikan layar antarmuka obrolan 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. Semua alat memerlukan konfirmasi pengguna sebelum eksekusi.

Cuplikan layar daftar alat khusus SQL yang dikontribusikan oleh ekstensi MSSQL dalam Mode Agen Copilot.

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 Membuat koneksi database menggunakan profil koneksi yang disimpan atau pasangan server/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

Frasa berikut dapat digunakan 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

Cuplikan layar contoh menggunakan alat agen untuk menyambungkan ke database di obrolan 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 terhubung melalui profil tersimpan:

  1. Pengguna dapat 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 tersambung melalui spesifikasi server/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 untuk menangani berbagai skenario koneksi, meminimalkan upaya pengguna sekaligus 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

Frasa berikut dapat digunakan 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?

Cuplikan layar animasi memperlihatkan alat visualizer skema database dalam Mode Agen Copilot.

Eksekusi kueri

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

Examples

Frasa berikut dapat digunakan 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

Cuplikan layar contoh menggunakan alat agen untuk menyambungkan ke database dan mengambil data.

Cuplikan layar contoh lain menggunakan alat agen untuk menyambungkan ke database dan mengambil data.

Cara alat dikelola dalam Mode Agen

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

Saat alat dipanggil—terutama jika berinteraksi dengan komputer atau database Anda—GitHub Copilot meminta konfirmasi untuk memastikan eksekusi yang aman. Anda dapat mengizinkan alat hanya untuk sesi saat ini, ruang kerja, atau menyetujuinya secara permanen.

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

Alur kerja konfirmasi Mode Agen

Saat GitHub Copilot memilih alat, GitHub menampilkan dialog konfirmasi kepada Anda yang memperlihatkan detail tentang tindakan yang diminta. Anda harus secara eksplisit menyetujui permintaan sebelum dapat menjalankan perintah apa pun yang berinteraksi dengan komputer atau database Anda:

  • Perbolehkan dalam sesi ini
  • Perbolehkan 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.