Keterampilan Agen Azure

Azure Agent Skills adalah katalog keterampilan yang dapat dibaca AI pihak pertama yang ditulis Microsoft untuk pengembangan Azure. Setiap keterampilan adalah indeks terstruktur konten Microsoft Learn otoritatif, dikemas sehingga asisten pengodean AI dapat menemukan dan menggunakannya untuk memberikan panduan yang akurat dan terkini tentang layanan Azure.

Keterampilan tersebut mengikuti standar terbuka Agent Skills dan berfungsi dengan asisten pengodean AI yang kompatibel, termasuk GitHub Copilot, Claude Code, Cursor, Gemini CLI, Codex CLI, dan lainnya.

Gunakan kasus

• Memberikan panduan Azure tingkat ahli kepada asisten pengkodean AI yang berdasarkan dokumentasi resmi
• Meningkatkan akurasi dan kelengkapan respons agen untuk tugas pengembangan Azure
• Memungkinkan pengembang untuk mendapatkan praktik terbaik, alur pemecahan masalah, pola arsitektur, dan panduan keamanan langsung di editor mereka
• Memberikan pengetahuan terstruktur dan terkini yang mengimbangi alat data langsung seperti server MCP

Cara kerja Keterampilan Agen

Keahlian Agen adalah modul kemampuan ringan dan efisien yang berbasis sistem file. Setiap keterampilan adalah folder yang berisi file dengan frontmatter YAML (nama, deskripsi, kompatibilitas) dan konten terstruktur yang diatur berdasarkan kategori (Pemecahan Masalah, Praktik Terbaik, Arsitektur, Keamanan, Konfigurasi, dan banyak lagi).

Keterampilan menggunakan pengungkapan progresif untuk memuat konten secara efisien:

1. Penemuan — Asisten AI membaca keterampilan dan dari frontmatter YAML untuk menentukan relevansi
2. Instruksi — Saat dipicu, asisten memuat konten lengkap , yang berisi tautan dokumentasi yang dikumpulkan yang diatur berdasarkan topik
3. Ambil — Asisten mengambil konten terbaru dari Microsoft Learn menggunakan Learn MCP Server atau alat ambil web

Arsitektur ini memisahkan indeks pengetahuan (apa yang harus dicari dan kapan) dari pengiriman konten (mengambil dokumen terbaru pada waktu kueri), memastikan keterampilan tetap terkini seiring berkembangnya dokumentasi.

Katalog keterampilan secara otomatis dihasilkan dan dikelola oleh alur yang dibuat khusus yang memindai dokumentasi produk Azure, mengidentifikasi konten prosedural dan pengambilan keputusan bernilai tinggi, dan mengubahnya menjadi file keterampilan terstruktur. Pipeline secara berkelanjutan mengevaluasi perubahan konten upstream dan menghasilkan pembaruan bertahap.

Katalog keterampilan

Repositori berisi 193 keterampilan yang mencakup layanan inti Azure dalam kategori berikut.

Bundel yang dikumpulkan berbasis peran tersedia untuk skenario umum (Esensial, Infrastruktur, Rekayasa Data, AI/ML, Keamanan, DevOps).

Katalog keterampilan lengkap tersedia di docs/CATALOG.md.

Persyaratan

• Akses jaringan diperlukan. URL dokumentasi keterampilan referensi Microsoft Learn yang diakses oleh asisten AI saat kueri.
• Asisten pengkodian AI yang kompatibel yang mendukung standar terbuka Keterampilan Agen ( format).
• Direkomendasikan: Microsoft Learn MCP Server untuk pengambilan dokumentasi yang optimal. Jika Server Learn MCP tidak tersedia, kemampuan dapat memanfaatkan kembali fungsi pengambilan web yang telah dibangun ke dalam sebagian besar asisten AI.

Tidak ada autentikasi yang diperlukan untuk menggunakan keterampilan itu sendiri. Keterampilan ini adalah file statis yang dioperasikan secara lokal di lingkungan pengembangan Anda.

Memulai Langkah Pertama

Penginstalan

1. Klon pada repositori:

   git clone https://github.com/MicrosoftDocs/agent-skills.git
   

2. Salin folder keterampilan dari ke direktori keterampilan asisten AI Anda:

   Asisten AI	Jalur tingkat proyek	Jalur global
   GitHub Copilot	{project}/.github/skills/	~/.copilot/skills/
   Kode Claude	{project}/.claude/skills/	~/.claude/skills/
   Codex CLI	{project}/.codex/skills/	~/.codex/skills/
   Cursor	{project}/.cursor/skills/	—
   Gemini CLI	{project}/.gemini/skills/	—

   Penting

   Salin folder di dalam (misalnya, , ), bukan folder itu sendiri.

3. Pengguna VS Code: Aktifkan Chat: Gunakan Skill Agen () di Pengaturan.

4. Mulailah mengajukan pertanyaan kepada asisten AI Azure Anda. Keterampilan diaktifkan secara otomatis berdasarkan kueri Anda.

Penggunaan

Setelah diinstal, ajukan pertanyaan asisten AI Anda secara alami:

• "Bantu saya menyiapkan Azure Functions menggunakan Durable Functions"
• "Apa praktik terbaik untuk Azure Container Apps?"
• Saya mengalami kesalahan batas akses di akun penyimpanan saya — bagaimana saya dapat mendiagnosis masalah ini?

Asisten akan secara otomatis menemukan keterampilan yang relevan, memuat panduan terstruktur, dan mengambil dokumentasi terbaru dari Microsoft Learn untuk memberikan jawaban yang akurat dan membumi.

Compatibility

Keterampilan ini bekerja dengan asisten pengkodian AI apa pun yang mendukung spesifikasi Keterampilan Agen:

Hubungan dengan Server Learn MCP

Keterampilan Agen dan Server Learn MCP saling melengkapi:

• Pelajari MCP Server menyediakan alat — pencarian, pengambilan, dan pengambilan sampel kode terhadap konten Microsoft Learn
• Keterampilan Agen memberikan pengetahuan — panduan terstruktur tentang apa yang harus dicari, kapan, dan cara menerapkannya

Keterampilan menggunakan Learn MCP Server (atau kemampuan pengambilan yang setara) sebagai mekanisme untuk menyampaikan konten. Bersama-sama, mereka memberi asisten AI penilaian untuk mengidentifikasi apa yang relevan dan kemampuan untuk mengambil konten otoritatif terbaru.

Ketersediaan dan harga

Azure Agent Skills tersedia untuk umum sebagai repositori sumber terbuka dengan lisensi ganda:

• Konten dokumentasi: Creative Commons Atribution 4.0 International
• Kode: Lisensi MIT

Tidak ada biaya untuk menggunakan keterampilan.

Keterbatasan

• Keterampilan memerlukan akses jaringan untuk mengambil dokumentasi dari Microsoft Learn. Tanpa akses jaringan, keterampilan menyediakan indeks tautan yang dikumpulkan tetapi tidak dapat mengambil konten lengkap.
• Katalog keterampilan saat ini mencakup 193 layanan Azure. Cakupan terus berkembang setiap kali alur pipa dijalankan, seiring dengan diterbitkannya dokumentasi baru.
• Keterampilan dihasilkan dari dokumentasi Microsoft Learn yang tersedia untuk umum. Konten dari modul pelatihan, jalur pembelajaran, dan kursus yang dipimpin instruktur tidak disertakan saat ini.
• Alur pembuatan berjalan secara bertahap. Mungkin ada penundaan singkat antara pembaruan dokumentasi di Microsoft Learn dan pembaruan keterampilan yang sesuai.

Cara memberikan umpan balik

• GitHub Masalah: https://github.com/MicrosoftDocs/agent-skills/issues (lebih disukai untuk bug, celah, atau permintaan fitur)
• Kontribusi: Repositori menyambut pull request. Lihat panduan kontribusi di README.

Langkah selanjutnya

• Mulai menggunakan Learn MCP Server di Visual Studio Code
• Spesifikasi standar terbuka Kemampuan Agen
• Repositori Kemampuan Agen Azure
• Bundel keterampilan yang dikurasi berdasarkan peran