Bagikan melalui


Panduan Cepat: Menggunakan Mode Agen GitHub Copilot

Mode Agen memungkinkan GitHub Copilot menggunakan alat yang tersedia di ekstensi MSSQL untuk Visual Studio Code. Saat ekstensi diinstal dan aktif, Copilot dapat mencantumkan koneksi SQL Server, menyambungkan ke server dan database, dan mengambil metadata database.

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

Tip

Anda tidak perlu mereferensikan ekstensi MSSQL (@mssql) secara eksplisit saat menggunakan Mode Agen. Jika ekstensi aktif, alatnya tersedia secara otomatis. Untuk informasi selengkapnya, lihat Alat Mode Agen.

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 tindakan terkait SQL menggunakan ekstensi MSSQL, dan konfirmasi pengguna diperlukan sebelum eksekusi.

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

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

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

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

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

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

Saat Anda memanggil alat, 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 secara permanen.

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

Alur kerja konfirmasi Mode Agen

Saat GitHub Copilot memilih alat, GitHub menampilkan kotak dialog konfirmasi yang menunjukkan 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.