Bekerja dengan Microsoft Foundry Toolkit untuk ekstensi Visual Studio Code

Dalam artikel ini, pelajari cara menginstal dan menggunakan Microsoft Foundry Toolkit untuk ekstensi Visual Studio Code. Buat proyek, sebarkan model dari katalog model Foundry, dan berinteraksi dengan taman bermain model dari dalam Visual Studio Code.

Prasyarat

• Langganan Azure. Buat satu secara gratis.
• Visual Studio Code terinstal.
• Langganan Anda harus berada di bawah batas kuota Anda untuk menyebarkan model baru di artikel ini. Jika Anda sudah mencapai batas kuota, Anda harus memiliki model obrolan yang disebarkan.
• Izin RBAC yang sesuai untuk membuat dan mengelola sumber daya Foundry. Untuk informasi selengkapnya, lihat Kontrol akses berbasis peran untuk Foundry.

Menginstal ekstensi

Untuk menggunakan kemampuan Foundry di Visual Studio Code, instal Microsoft Foundry Toolkit untuk ekstensi Visual Studio Code. Instal dari Visual Studio Code Marketplace atau langsung dari dalam Visual Studio Code.

Menginstal dari Visual Studio Code Marketplace

Gunakan marketplace untuk menginstal ekstensi tanpa membuka Visual Studio Code terlebih dahulu.

1. Buka halaman ekstensi Microsoft Foundry Toolkit untuk Visual Studio Code.
2. Pilih tombol Instal .
3. Ikuti perintah untuk menginstal ekstensi di Visual Studio Code.
4. Setelah penginstalan, buka Visual Studio Code dan verifikasi ekstensi berhasil diinstal dari pesan status.
5. Ikon Foundry Toolkit muncul di bilah navigasi utama di sisi kiri Visual Studio Code.

Instal dari dalam Visual Studio Code

Atau, cari ekstensi langsung dari tampilan ekstensi Visual Studio Code.

1. Buka Visual Studio Code.

2. Pilih Ekstensi dari panel kiri.

3. Pilih ikon Pengaturan dari kanan atas pada panel ekstensi.

4. Cari dan pilih Foundry Toolkit untuk Visual Studio Code.

5. Pilih Instal.

6. Setelah penginstalan selesai, pesan status mengonfirmasi ekstensi diinstal. Ikon Foundry Toolkit muncul di bilah navigasi kiri.

Menyambungkan ke sumber daya Azure Anda

Setelah Anda menginstal ekstensi, masuk ke langganan Azure Anda dan buka proyek Foundry untuk mulai bekerja dengan model, agen, dan taman bermain.

Catatan

Untuk daftar lengkap fitur yang tersedia dalam ekstensi, gunakan palet perintah. Pilih F1 untuk membuka palet perintah dan cari Foundry Toolkit. Cuplikan layar berikut menunjukkan beberapa perintah yang tersedia.

Masuk ke sumber daya Anda

Masuk ke langganan Azure Anda sehingga ekstensi dapat mengakses proyek Foundry dan model yang disebarkan.

1. Pilih ikon Azure pada bilah navigasi Visual Studio Code.

2. Pilih Sign ke Azure... dalam tampilan Azure Resources.

3. Di bawah bagian Resources, pilih langganan dan grup sumber daya Azure Anda.

4. Pilih Foundry dan klik kanan proyek Anda.

5. Pilih Buka di Ekstensi Toolkit Foundry.

   Sumber daya proyek Foundry Anda muncul di tampilan ekstensi, dan ikon Foundry ditampilkan di bilah navigasi Visual Studio Code.

Menavigasi antarmuka ekstensi

Microsoft Foundry Toolkit untuk ekstensi Visual Studio Code mengatur ruang kerja Anda menjadi tiga bagian utama.

Bagian	Isinya	Kapan menggunakannya
Sumber Daya Saya	Model yang disebarkan, agen deklaratif, agen yang dihosting, koneksi, dan penyimpanan vektor untuk proyek Foundry Anda.	Lihat dan kelola sumber daya proyek Anda.
Alat Pengembang	Katalog Model, Taman Bermain Model, Taman Bermain Agen (jarak jauh dan lokal), Visualizer Lokal, dan Sebarkan Agen yang Dihosting.	Sebarkan model baru, perintah pengujian, dan berinteraksi dengan agen.
Bantuan dan Umpan Balik	Dokumentasi, repositori GitHub, Pernyataan Privasi Microsoft, dan tautan komunitas.	Dapatkan bantuan atau berikan umpan balik.

Membuat proyek

Buat proyek Foundry baru langsung dari ekstensi untuk mengatur model dan sumber daya Anda.

1. Pilih + Buat Project di bagian Sumber Daya Saya bagian Microsoft Foundry Toolkit untuk tampilan ekstensi Visual Studio Code.

   Anda dapat membuat grup sumber daya baru atau memilih grup sumber daya yang sudah ada.

2. Untuk membuat grup sumber daya baru:

   1. Pilih Buat grup sumber daya baru dan tekan Enter.

   2. Masukkan nama grup sumber daya Azure di kotak teks Buat grup sumber daya baru dan tekan Enter.

   3. Pilih lokasi yang ingin Anda gunakan dari daftar lokasi yang tersedia dan tekan Enter.

3. Untuk menggunakan grup sumber daya yang sudah ada:

   • Pilih grup sumber daya yang ingin Anda gunakan dari daftar grup sumber daya yang tersedia dan tekan Enter.

4. Masukkan nama proyek Foundry di kotak teks Masukkan nama proyek dan tekan Enter.

Setelah penyebaran project, popup muncul dengan pesan Project berhasil disebarkan.

Untuk menyebarkan model ke proyek yang baru dibuat, pilih tombol Sebarkan model di popup. Tindakan ini membuka halaman Katalog Model tempat Anda dapat memilih model yang diinginkan untuk disebarkan.

Mengalihkan proyek default

Saat Anda membuka proyek di Microsoft Foundry Toolkit untuk ekstensi Visual Studio Code, proyek tersebut ditetapkan sebagai proyek default Anda. Untuk mengalihkan proyek default Anda:

1. Klik kanan pada proyek Foundry dan pilih opsi Switch Default Project di Azure Extension.

2. Pilih proyek Foundry yang ingin Anda gunakan dari daftar proyek yang tersedia dan tekan Enter.

Proyek yang dipilih sekarang menampilkan Default setelah nama proyek.

Tips

Klik kanan pada nama proyek Anda untuk mengakses titik akhir proyek atau kunci API proyek.

Bekerja dengan model

Ekstensi Microsoft Foundry Toolkit for Visual Studio Code memungkinkan Anda menemukan, menyebarkan, dan berinteraksi dengan model dari katalog model Foundry langsung di Visual Studio Code.

Telusuri katalog model

Katalog model menyediakan akses ke model dari Microsoft, OpenAI, Meta, DeepSeek, dan penyedia lainnya. Anda dapat membuka katalog model dengan beberapa cara:

• Jalankan perintah Foundry Toolkit: Tampilkan katalog model dari palet perintah.
• Pilih ikon plus di samping Models di bagian Sumber Daya Saya dari Microsoft Foundry Toolkit untuk tampilan ekstensi Visual Studio Code.
• Pilih tautan Model Catalog di bagian Developer Tools dari Microsoft Foundry Toolkit untuk tampilan ekstensi Visual Studio Code.

Buka katalog model dari palet perintah

Gunakan palet perintah untuk membuka katalog model tanpa menavigasi tampilan ekstensi.

1. Pilih F1 untuk membuka palet perintah.

2. Masukkan Foundry Toolkit: tampilkan katalog model dan tekan Enter.

3. Halaman Katalog Model terbuka.

   

4. Filter Model Catalog menurut Dihosting oleh, Penerbit, Fitur, atau jenis Model dengan menggunakan dropdown di bagian atas halaman. Pilih tombol dukungan Fine-Tuning untuk memfilter model yang mendukung fine-tuning.

5. Cari model tertentu menggunakan bilah pencarian di bagian tengah atas halaman.

Buka katalog model dari bagian Sumber Daya

Di Microsoft Foundry Toolkit untuk tampilan ekstensi Visual Studio Code, pilih ikon plus di samping Models untuk membuka katalog model.

Tips

Anda juga dapat mengklik kanan Model dan memilih Sebarkan model AI baru untuk langsung masuk ke alur penyebaran.

Buka katalog model dari bagian Alat

Di bagian Developer Tools Microsoft Foundry Toolkit untuk tampilan ekstensi Visual Studio Code, klik dua kali tautan Model Catalog.

Menyebarkan model dari katalog model

Setelah Anda menemukan model di katalog, sebarkan ke proyek Foundry Anda sehingga Anda dapat menggunakannya di aplikasi Anda.

1. Pilih tombol Sebarkan di samping nama model yang dipilih.

2. Halaman Penyebaran model terbuka.

3. Masukkan nama penyebaran model di kotak teks Masukkan nama penyebaran dan tekan Enter.

4. Pilih jenis penyebaran di menu dropdown Jenis penyebaran .

5. Pilih versi model di menu dropdown Versi model .

6. (Opsional) Sesuaikan token per menit menggunakan Penggeser Token per Menit.

7. Pilih tombol Sebarkan di Foundry di sudut kiri bawah.

8. Dalam dialog konfirmasi, pilih Sebarkan.

9. Setelah penyebaran selesai, model muncul dengan nama penyebaran di bawah bagian Model di proyek Anda.

Melihat dan mengelola model yang disebarkan

Perluas bagian Models di Microsoft Foundry Toolkit untuk tampilan ekstensi Visual Studio Code untuk melihat semua model yang disebarkan dalam proyek Anda.

Lihat informasi kartu model

Pilih model yang disebarkan untuk membuka panel dengan detail berikut:

• Info Penyebaran: Nama, status provisi, jenis penyebaran, batas tarif, info versi, nama model, dan versi model.
• Info titik akhir: Tautan URI target, jenis autentikasi, dan kunci.
• Tautan yang berguna: Repositori sampel kode dan tautan tutorial untuk pengembangan aplikasi AI.

Memperbarui pengaturan penyebaran model

Untuk memperbarui pengaturan penyebaran seperti batas tarif:

1. Pilih tombol Edit di kanan atas kartu model.
2. Perbarui bidang yang dapat diedit.
3. Pilih tombol Simpan untuk menerapkan perubahan.

Membuat kode sampel untuk model

Buat file kode pemula untuk model yang Anda sebarkan untuk mempercepat pengembangan aplikasi.

1. Klik kanan pada model yang Anda sebarkan dan pilih Buka file kode.

2. Pilih SDK pilihan Anda di menu dropdown Pilih SDK pilihan .

3. Pilih bahasa pilihan Anda di menu dropdown Pilih bahasa .

4. Pilih metode autentikasi pilihan Anda di menu dropdown Pilih metode autentikasi .

5. File kode sampel terbuka di tab baru di Visual Studio Code.

Cuplikan layar berikut menunjukkan sampel Python yang dihasilkan yang melakukan panggilan sinkron ke API respons:

Berinteraksi dengan model di taman bermain

Gunakan taman bermain model untuk mengobrol secara interaktif dengan model yang Anda sebarkan, menyesuaikan pengaturan, dan mengubah instruksi sistem.

Untuk membuka taman bermain, klik dua kali tautan Model Playground di bagian Developer Tools dari Microsoft Foundry Toolkit untuk tampilan ekstensi Visual Studio Code. Atau, klik kanan pada model yang Anda sebarkan dan pilih Buka di taman bermain.

1. Halaman Playground terbuka.

2. Ketik perintah Anda dan tinjau outputnya.

3. Pilih Tampilkan kode di sudut kanan atas untuk melihat cara mengakses penyebaran model secara terprogram.

4. Pilih tautan Riwayat di kiri atas taman bermain untuk melihat riwayat obrolan Anda.

Memecahkan masalah umum

Jika Anda mengalami masalah saat menggunakan Microsoft Foundry Toolkit untuk ekstensi Visual Studio Code, periksa masalah umum berikut:

Masalah	Resolusi
Ekstensi tidak muncul setelah penginstalan	Mulai ulang Visual Studio Code dan verifikasi ekstensi diaktifkan dalam tampilan Ekstensi .
Gagal masuk atau langganan tidak dimuat	Verifikasi akun Azure Anda memiliki izin yang benar. Coba keluar dan masuk lagi dari tampilan Azure Resources.
Penyebaran model gagal dengan kesalahan kuota	Periksa kuota langganan Anda dan minta peningkatan atau hapus penyebaran yang tidak digunakan.

Membersihkan sumber daya

Sumber daya Azure yang Anda buat dalam artikel ini ditagihkan ke langganan Azure Anda. Jika Anda tidak mengharapkan untuk membutuhkan sumber daya ini di masa mendatang, hapus sumber daya tersebut untuk menghindari dikenakan lebih banyak biaya.

Menghapus model Anda

1. Di bilah navigasi Visual Studio Code, segarkan ekstensi Microsoft Foundry Toolkit untuk Visual Studio Code. Di bagian Sumber Daya Saya , perluas subbagian Model .

2. Klik kanan model yang disebarkan yang ingin Anda hapus dan pilih Hapus.

Menghapus sumber daya Azure

Untuk menghapus grup sumber daya dan semua sumber daya di dalamnya:

Peringatan

Menghapus grup sumber daya akan secara permanen menghapus semua sumber daya di dalamnya, termasuk proyek Foundry Anda dan model yang telah disebarkan. Tindakan ini tidak dapat dibatalkan.

1. Buka portal Azure.
2. Navigasi ke grup sumber daya yang berisi proyek Foundry Anda.
3. Pilih Hapus grup sumber daya dan konfirmasi penghapusan.

Langkah berikutnya

• Menjelajahi model Foundry
• Menyebarkan model dengan Foundry