Gunakan Skill Microsoft Foundry dalam agen coding

Microsoft Foundry Skill memberikan panduan yang dapat digunakan kembali kepada agen pengkodean untuk alur kerja agen Foundry. Gunakan ini untuk membantu menstandardisasi deployment, evaluasi, pengoptimalan prompt, kurasi dataset berdasarkan trace, dan tugas pemecahan masalah di berbagai lingkungan pengembangan yang mendukung agen.

Prasyarat

  • Sebuah akun Azure dengan langganan aktif. Jika Anda tidak memilikinya, buat akun Azure gratis.

  • Host agen pemrograman, seperti GitHub Copilot di Visual Studio Code, Copilot CLI, atau Claude Code.

  • Node.js 18 atau yang lebih baru di PATH Anda. Plugin menggunakan npx untuk memulai server MCP di host yang kompatibel.

  • Git, agar host dapat mengunduh konten plugin dan skill.

  • Azure CLI diinstal dan diautentikasi:

    az login

  • Azure Developer CLI diinstal dan diautentikasi jika Anda berencana menggunakan alur kerja penyebaran azd:

    azd auth login

  • Proyek Microsoft Foundry jika Anda ingin agen memeriksa atau memodifikasi sumber daya cakupan proyek. Untuk langkah-langkah penyiapan, lihat Membuat proyek.

Yang disediakan oleh Foundry Skill

Keterampilan ini microsoft-foundry adalah keterampilan meta untuk pekerjaan Foundry. Ini membantu agen pemrograman memilih alur kerja Foundry yang tepat, memuat subkeahlian yang sesuai, memeriksa alat MCP Foundry yang tersedia, dan menjaga konteks deployment dan evaluasi tetap konsisten di setiap giliran.

Gunakan ini saat Anda ingin agen membantu dalam bidang kapabilitas berikut:

Bidang kapabilitas Apa yang keterampilan membantu agen melakukan
Orientasi Foundry Buat atau sambungkan ke proyek Foundry, provisikan sumber daya Foundry, pilih penyiapan publik atau terisolasi jaringan, dan siapkan ruang kerja untuk pengembangan agen.
Akses dan kapasitas Periksa penugasan RBAC, identitas terkelola, prinsipal layanan, kuota, ketersediaan model, kapasitas wilayah, dan prasyarat penyebaran.
Penerapan model Sebarkan model dengan preset cepat atau pengaturan kustom seperti versi, SKU, kapasitas, dan konfigurasi AI yang bertanggung jawab.
Kustomisasi model Sempurnakan model dengan fine-tuning terawasi, optimisasi preferensi langsung, atau alur kerja fine-tuning berbasis penguatan.
Pembuatan agen Buat aplikasi agen yang dihosting yang menggunakan kerangka kerja agen Microsoft, LangGraph, atau kerangka kerja kustom di Python atau C#.
Penyebaran agen Kontainerisasi agen, buat dan dorong gambar ke Azure Container Registry, buat atau perbarui penyebaran agen yang dihosting, dan sebarkan ulang setelah perubahan kode.
Pemanggilan dan pengujian Kirim pesan bergiliran tunggal atau multi-giliran ke agen yang disebarkan, menguji agen prompt, dan menguji agen yang dihosting yang menggunakan protokol berbasis HTTP atau WebSocket.
Evaluasi dan pengoptimalan Jalankan evaluasi batch, siapkan evaluasi berkelanjutan, bandingkan versi, optimalkan perintah, tingkatkan instruksi agen, dan siapkan pekerjaan Pengoptimal Agen.
Pelacakan dan penggunaan dataset Telusuri jejak, analisis latensi atau kegagalan, korelasikan hasil evaluasi dengan respons, dan kurasi dataset evaluasi dari trace produksi.
Troubleshooting Periksa log agen yang dihosting, kueri telemetri, diagnosis kegagalan deployment atau runtime, dan rencanakan siklus perbaikan dan penyebaran ulang.

Skill yang diinstal mencakup sub-keterampilan khusus untuk area-area tersebut. Anda biasanya tidak perlu memberi nama sub-keterampilan secara langsung. Sampaikan hasil yang Anda inginkan, dan agen pemrograman menggunakan petunjuk keterampilan untuk mengarahkan tugas.

Installation

Ekstensi Foundry Toolkit untuk VISUAL Code dilengkapi dengan Foundry Skill. Untuk menginstal ekstensi, lihat Bekerja dengan ekstensi Microsoft Foundry untuk Visual Studio Code.

Setelah penginstalan, muat ulang Visual Studio Code jika diminta. Buka Copilot Chat, beralih ke mode agen, dan konfirmasikan bahwa keterampilan Foundry tersedia. Saat diminta, masuk dengan akun Azure yang memiliki akses ke proyek Foundry Anda.

Untuk informasi selengkapnya tentang penyiapan MCP di Visual Studio Code, lihat Mulai dengan Azure MCP Server dan Mulai dengan Foundry MCP Server.

Jika host Anda sudah memiliki konfigurasi server MCP dan Anda hanya memerlukan konten keterampilan, instal keterampilan microsoft-foundry langsung:

npx skills add https://github.com/microsoft/azure-skills --skill microsoft-foundry

Jalur khusus keterampilan mengunduh panduan alur kerja Foundry. Gunakan plugin Azure Skills jika Anda ingin skill, konfigurasi Azure MCP Server, dan konfigurasi Foundry MCP Server diinstal sekaligus.

Memverifikasi penyiapan

Setelah penginstalan, coba pemeriksaan ini dari agen pengkodian Anda:

  • Tanyakan What AI models are available in Microsoft Foundry? Respons harus menggunakan alat Foundry alih-alih ringkasan generik.
  • Tanyakan List my Azure resource groups. Respons harus menggunakan alat MCP Azure setelah Anda mengautentikasi.
  • Dalam proyek agen Foundry, tanyakan Use the Microsoft Foundry Skill to review this agent for deployment readiness. Respons harus mengidentifikasi pemeriksaan alur kerja seperti konfigurasi, akses proyek, penyebaran model, data evaluasi, dan validasi penyebaran.

Jika pemeriksaan gagal, muat ulang host, konfirmasikan plugin berhasil diinstal, dan verifikasi bahwa az login menggunakan langganan yang berisi sumber daya Foundry Anda.

Menggunakan keterampilan dalam proyek

Buka folder yang berisi kode agen Foundry Anda. Mintalah hasil yang Anda inginkan, dan sertakan proyek target, lingkungan, folder agen, atau nama penyebaran jika Anda sudah mengetahuinya.

Gunakan pola prompt ini untuk memanggil kemampuan keterampilan:

Maksud Contoh tanggapan Alur kerja umum
Menyiapkan Foundry untuk agen baru Use the Microsoft Foundry Skill to create a public Foundry project, deploy a model, and scaffold a hosted agent. Penyiapan proyek, penerapan model, pembuatan agen, penerapan, dan pemanggilan.
Menyiapkan lingkungan privat Use the Microsoft Foundry Skill to plan a network-isolated Foundry deployment for this project. Perencanaan jaringan privat, pemilihan templat, pemeriksaan penyebaran, dan validasi.
Terapkan agen terhosting yang ada Use the Microsoft Foundry Skill to prepare this hosted agent for deployment to my dev environment. Penyelesaian konteks ruang kerja, pembuatan kontainer, pengiriman ke ACR, penyebaran agen terhosting, dan uji asap.
Menyebarkan ulang setelah perubahan kode Use the Microsoft Foundry Skill to redeploy this agent and verify it still responds correctly. Tindak lanjut pembaruan, pemanggilan, dan evaluasi penyebaran.
Uji agen Use the Microsoft Foundry Skill to invoke this agent with a short multi-turn test conversation. Pencarian agen, pemanggilan, dan tinjauan respons.
Mengevaluasi kualitas Use the Microsoft Foundry Skill to create an evaluation plan for this agent from eval.yaml. Penyiapan rangkaian evaluasi, pemeriksaan himpunan data dan evaluator, evaluasi batch, dan ringkasan hasil.
Mengoptimalkan instruksi Use the Microsoft Foundry Skill to improve the agent instructions based on recent evaluation results. Analisis evaluasi, pengoptimalan prompt, peninjauan kandidat, dan evaluasi tindak lanjut.
Membangun himpunan data evaluasi Use the Microsoft Foundry Skill to create an evaluation dataset from the last seven days of production traces. Lacak kueri, kurasi himpunan data, penerapan versi, dan pelacakan silsilah data.
Mengatasi kegagalan Use the Microsoft Foundry Skill to troubleshoot why this hosted agent deployment is failing. Pemeriksaan pemanggilan, log, telemetri, analisis akar masalah, rencana perbaikan, deploy ulang, dan uji ulang.
Memeriksa akses atau kapasitas Use the Microsoft Foundry Skill to check RBAC and quota blockers before I deploy this model. Tinjauan penetapan peran, pencarian kuota, perencanaan kapasitas, dan langkah-langkah remediasi.
Mengoptimalkan model. Use the Microsoft Foundry Skill to plan a supervised fine-tuning workflow for this training dataset. Kesiapan himpunan data, penyiapan pelatihan, tinjauan titik pemeriksaan, penyebaran model, dan evaluasi.

Sebelum Anda menyetujui perubahan atau perintah, tinjau rencana, file yang dihasilkan, dan sumber daya Azure yang diusulkan agen untuk dibuat atau dimodifikasi. Untuk tugas penerapan, penyesuaian, dan penyediaan, pastikan penetapan peran dan sumber daya yang menanggung biaya sebelum agen menjalankan perintah.

Menggunakan keterampilan Foundry Toolkit dalam Visual Studio Code

Foundry Toolkit for Visual Studio Code juga menyediakan kemampuan khusus Foundry di VS Code. Keterampilan ini, seperti vscode-microsoft-foundry dan foundrytk-quick-start, berfokus pada pengalaman pengembangan VS Code: proses orientasi ke Foundry Toolkit, menjelajahi model, membangun agen, memilih model, menerapkan agen, mengevaluasi kinerja, dan mengelola toolbox. Mereka berbeda dari keterampilan inti microsoft-foundry , yang menyediakan pangkalan pengetahuan yang lebih luas dan detail alur kerja konkret untuk manajemen sumber daya Foundry, RBAC, kuota, penyebaran model, penyebaran agen yang dihosting, evaluasi, pelacakan, dan pemecahan masalah. Instal Foundry Toolkit untuk Visual Studio Code untuk membuat keterampilan yang disediakan ekstensi ini tersedia dalam pengalaman agen Visual Studio Code Anda.

Cara kerja fitur

Saat agen pemrograman menggunakan Microsoft Foundry Skill, agen tersebut mengikuti beberapa pola umum:

  1. Ini dimulai dengan penemuan Foundry MCP sehingga tahu alat dan parameter Foundry mana yang tersedia di lingkungan Anda.
  2. Ini memuat sub-keterampilan yang cocok dengan alur kerja Anda, seperti pembuatan, penyebaran, pemanggilan, evaluasi, pelacakan, pemecahan masalah, RBAC, kuota, atau penyebaran model.
  3. Ini menyelesaikan konteks proyek dan agen dari ruang kerja Anda sebelum mengusulkan perubahan atau perintah.
  4. Sistem ini lebih memilih alat Foundry yang terstruktur dan alat MCP Azure saat tersedia.
  5. Ini hanya meminta nilai yang belum ada ketika nilai tersebut tidak dapat ditentukan dari prompt Anda, file di ruang kerja, atau konteks Azure terautentikasi.

Keterampilan ini mendukung dua jenis agen umum:

Jenis agen Skenario penggunaan
Agen prompt Agen berbasis LLM yang menggunakan penerapan model dan konfigurasi prompt.
Agen yang dihosting Agen berbasis kontainer yang menjalankan kode kustom di Foundry Agent Service.

Untuk alur kerja agen yang dihosting, skill ini juga dapat berfungsi dengan agen yang menggunakan protokol responses, invocations, atau invocations_ws. Gunakan invocations_ws untuk skenario WebSocket real time atau dupleks, seperti agen suara atau interaksi streaming.

File ruang kerja yang digunakan oleh keahlian

Fitur ini mencari konteks proyek Foundry dan agen dalam file workspace umum. Pertahankan file-file ini tetap terkini sehingga agen pengkodian Anda dapat membuat rekomendasi spesifik yang dapat diulang.

File atau folder Bagaimana keterampilan menggunakannya
azure.yaml azd Menemukan layanan, folder proyek agen, pengaturan host penyebaran, dan pengikatan lingkungan.
.azure/<environment>/.env Menentukan nilai lingkungan azd yang terautentikasi seperti langganan, grup sumber daya, endpoint proyek, nama agen, registri, dan string koneksi Application Insights.
.foundry/agent-metadata.yaml Menyimpan status overlay khusus Foundry seperti referensi suite evaluasi, referensi set data, jalur cache lokal, ringkasan hasil, dan penggantian non-azd.
.foundry/agent-metadata.<env>.yaml Menyimpan status overlay khusus lingkungan untuk target seperti produksi atau CI.
agent.yaml Menyediakan konfigurasi agen lokal untuk membuat, menyebarkan, memanggil, dan mengevaluasi alur kerja.
eval.yaml Menentukan niat evaluasi lokal, seperti file himpunan data, nama evaluator, ambang batas, jumlah sampel, pencarian jejak, dan instruksi pembuatan.

Untuk alur kerja deployment dan evaluasi, sebaiknya gunakan .foundry/agent-metadata.yaml untuk status overlay nonrahasia. Jangan simpan rahasia dalam .foundry file. Jika azd sudah memberikan nilai penyebaran, seperti titik akhir proyek atau registri, biarkan agen pengodean menggunakan azd nilai alih-alih menduplikasinya dalam metadata.

Troubleshooting

Masalah Resolution
Host tidak menemukan keterampilan. Konfirmasikan plugin berhasil diinstal, lalu muat ulang atau mulai ulang host sehingga mengindeks ulang konten plugin.
Alat MCP tidak muncul. Konfirmasikan Node.js diinstal, npx berfungsi, dan entri server Azure dan Foundry MCP ditambahkan untuk host Anda.
Permintaan Azure gagal karena kesalahan autentikasi. Jalankan az login lagi. Untuk alur kerja azd, jalankan juga azd auth login.
Agen menggunakan langganan yang salah. Atur langganan Azure yang dimaksudkan di Azure CLI sebelum Anda mencoba kembali permintaan.
Operasi proyek Foundry gagal. Konfirmasikan akun Anda memiliki akses ke proyek Foundry dan peran RBAC Azure yang diperlukan.

Konten terkait

  • Last updated on