Gunakan Azure OpenAI dengan Copilot di SSMS

Copilot di SQL Server Management Studio (SSMS) menggunakan titik akhir dan penyebaran di Azure OpenAI. Artikel ini menyediakan langkah-langkah untuk membuat sumber daya Azure OpenAI yang diperlukan. Untuk informasi selengkapnya, lihat Membuat dan menyebarkan Azure OpenAI di sumber daya Model Azure AI Foundry.

Akses ke penyebaran dapat disediakan menggunakan autentikasi Microsoft Entra, atau Kunci API. Autentikasi Microsoft Entra direkomendasikan sebagai opsi yang lebih aman.

Biaya Copilot di SSMS tergantung pada penggunaan sumber daya Azure OpenAI yang disediakan, serta model yang dipilih. Tagihan ini akan dibebankan pada langganan Azure yang menghosting sumber daya. Untuk informasi selengkapnya, lihat Gambaran umum harga Azure OpenAI Service.

Membuat titik akhir

Pembuatan titik akhir dilakukan di portal Microsoft Azure.

1. Masuk ke portal Microsoft Azure.

2. Buka Layanan.

3. Pilih layanan Azure AI, yang tercantum di bawah AI + Machine Learning.

4. Dalam layanan Azure AI*, pilih akun Azure OpenAI.

5. Pilih + Buat untuk membuat layanan Azure OpenAI baru.

6. Pada halaman Dasar , lengkapi semua detail yang diperlukan.

   1. Nama digunakan dalam URL titik akhir.
   2. Satu-satunya opsi yang saat ini tersedia untuk tingkat Harga adalah Standar S0.

7. Pilih Selanjutnya.

8. Pada halaman Jaringan , pilih Semua Jaringan kecuali Anda menggunakan Virtual Private Network (VPN). SQL Server Management Studio (SSMS) harus dapat mencapai titik akhir agar Copilot di SQL Server Management Studio (SSMS) berfungsi.

   1. Jika Anda menggunakan VPN, di bawah Jenis, periksa jaringan yang dipilih, konfigurasikan keamanan jaringan untuk opsi sumber daya layanan Azure AI Anda lalu pilih jaringan virtual dan subnet yang sesuai.

   2. Tambahkan rentang IP yang sesuai untuk aturan firewall.

9. Pilih Selanjutnya.

10. Pada halaman Tag , atur tag apa pun yang digunakan organisasi Anda. Tag tidak diperlukan untuk Copilot di SSMS, tetapi harus ditetapkan sesuai dengan kebijakan perusahaan Anda. Misalnya, perusahaan Anda mungkin memerlukan semua sumber daya untuk menggunakan tag Pemilik.

11. Pilih Selanjutnya.

12. Pada halaman Tinjau + kirim tinjau informasi lalu pilih Buat.

13. Pesan Penyebaran sedang berlangsung akan muncul, kemudian pesan Penyebaran Anda telah selesai ketika proses penyiapan selesai.

14. Pilih Pergi ke sumber daya.

15. Dalam sumber daya, perluas Manajemen Sumber Daya, lalu pilih Kunci dan Titik Akhir.

16. Catat nilai untuk Titik Akhir pada halaman Kunci dan Titik Akhir karena akan digunakan saat Anda mengonfigurasi Copilot di SSMS.

    Note

    Selama konfigurasi awal Copilot di SSMS, masukkan Titik Akhir dalam dialog Titik Akhir Azure OpenAI .

17. Jika Anda menggunakan akses kunci API, maka Kunci 1 atau Kunci 2 dapat digunakan saat Anda mengonfigurasi Copilot di SSMS. Akses kunci API bersifat opsional; Autentikasi Microsoft Entra direkomendasikan sebagai opsi yang lebih aman.

    Note

    Selama konfigurasi awal Copilot di SSMS, masukkan Key 1 atau Key 2 dalam dialog Azure OpenAI API Key jika menggunakan akses kunci API.

Menggunakan ID Microsoft Entra untuk akses

Jika Anda ingin menggunakan Microsoft Entra untuk mengautentikasi ke Azure OpenAI for Copilot di SSMS, langkah-langkah berikut diperlukan.

1. Dalam sumber daya titik akhir, pilih Kontrol Akses (IAM).

2. Dari halaman Kontrol Akses , pilih + Tambahkan untuk menambahkan penetapan peran.

3. Pada halaman Peran , dalam daftar peran fungsi Pekerjaan, temukan Pengguna OpenAI Cognitive Services dan pilih, lalu pilih Berikutnya.

4. Pada halaman Anggota , tambahkan anggota yang sesuai dengan memasukkan pengguna, grup, perwakilan layanan, atau identitas terkelola.

5. Gunakan +Pilih anggota untuk membuka panel Pilih anggota .

6. Pilih ID yang sesuai dari daftar, lalu Pilih.

7. Pilih Tinjau + tetapkan, dan pada halaman Tinjau + tetapkan, tinjau anggota, lalu pilih Tinjau + tetapkan lagi untuk menetapkan anggota ke pengiriman.

8. Pemberitahuan bahwa peran telah ditambahkan muncul.

9. Ulangi langkah 2 hingga 8 untuk Kontributor Cognitive Services dari OpenAI. Semua anggota, baik pengguna, grup, perwakilan layanan, atau identitas terkelola, harus ditambahkan ke kedua peran.

Peran Kontributor OpenAI Cognitive Services memiliki izin untuk membaca dan menulis serta kemampuan untuk memodifikasi endpoint. Atau, Anda dapat menetapkan peran Kontributor OpenAI Cognitive Services kepada individu yang mengelola titik akhir (harus ditetapkan ke setidaknya satu orang), dan hanya menetapkan peran Pengguna OpenAI Cognitive Services kepada anggota lain. Peran Pengguna OpenAI Cognitive Services memiliki hak istimewa yang lebih rendah dan menyediakan akses baca-saja ke titik akhir.

Buat penyebaran

Langkah terakhir yang diperlukan adalah membuat penerapan.

1. Di dalam sumber daya titik akhir, buka halaman Gambaran Umum .

2. Pilih Jelajahi portal Azure AI Foundry, yang meluncurkan portal terpisah.

3. Peringatan bahwa Anda meninggalkan portal Microsoft Azure muncul. Pilih Lanjutkan.

4. Dalam portal Azure AI Foundry, pilih Penyebaran di bawah Sumber daya bersama.

5. Pilih + Sebarkan model, lalu pilih Sebarkan model dasar.

6. Dalam panel Pilih model , pilih model gpt-4o (Penyelesaian obrolan), lalu pilih Konfirmasi.

   Note

   gpt-4o adalah satu-satunya model yang didukung untuk pratinjau.

7. Pada halaman Sebarkan model , pilih Kustomisasi.

8. Dalam dialog kustomisasi, masukkan nilai untuk Nama penyebaran.

9. Perhatikan nilai untuk Nama penyebaran karena akan digunakan saat Anda mengonfigurasi Copilot di SSMS.

   Note

   Selama konfigurasi awal Copilot di SSMS, masukkan Nama penyebaran dalam dialog Penyebaran Azure OpenAI .

10. Atur Jenis penyebaran. Setiap jenis penyebaran menyertakan deskripsi tentang performa versus residensi data. Penyebaran dengan 'standar' dalam nama disarankan untuk pratinjau. Jika residensi data tidak menjadi perhatian, maka Global Standard menawarkan performa terbaik. Standar Zona Data memberikan keseimbangan trade-off, dan Standar mengoptimalkan untuk wilayah tertentu dengan potensi biaya latensi tambahan.

11. Versi Model harus 2024-11-20, dan lokasi sumber daya harus diatur secara default (diwarisi dari titik akhir yang sudah Anda buat).

12. Atur Batas Tarif Token per Menit ke nilai maksimum yang tersedia. Ini dapat dimodifikasi di portal Azure AI Foundry kapan saja, jika Anda memutuskan untuk menurunkan batas. Semakin rendah nilainya, semakin sedikit pertanyaan per menit yang dapat dijawab oleh Copilot. Untuk informasi selengkapnya, lihat Azure OpenAI dalam kuota dan batasan model-model di Azure AI Foundry.

13. Biarkan Filter konten pada nilai default DefaultV2, kecuali perusahaan Anda memiliki kebijakan sendiri mengenai filter konten AI.

14. Pilih Buat sumber daya dan sebarkan.

15. Saat penyebaran selesai, halaman detail akan muncul. Di dalam bagian Memulai , Anda dapat menemukan titik akhir dan penyebaran dalam kode untuk Menjalankan sampel kode dasar:

    

16. Gunakan nilai dan titik akhir berikut saat mengonfigurasi Copilot di SSMS:

    

17. Jika Anda perlu mengedit pengaturan penyebaran apa pun, seperti Batas tarif (Token per menit), akses halaman detail untuk penyebaran.

Memantau biaya

Biaya Copilot dalam SSMS bervariasi berdasarkan penggunaan dan mengikuti model penagihan prabayar. Karena biayanya bukan nilai tetap dan berulang, sebaiknya pantau pengeluaran sumber daya secara teratur untuk mengurangi kejutan dalam penagihan. Untuk informasi selengkapnya, lihat Merencanakan untuk mengelola biaya untuk Azure OpenAI di Model Azure AI Foundry.

Konten terkait

• Memecahkan masalah dengan Copilot di SQL Server Management Studio
• Apa itu Azure OpenAI di Model Azure AI Foundry?
• Menggunakan jendela obrolan untuk Copilot di SQL Server Management Studio
• Bantuan kode untuk Copilot di SQL Server Management Studio