Tutorial: Membuat keterampilan di Azure SRE Agent

Dalam tutorial ini, Anda membuat keterampilan khusus yang menambahkan pengetahuan domain dan panduan tugas ke agen Anda. Keterampilan adalah kemampuan modular yang dimuat agen Anda secara otomatis jika relevan, seperti memecahkan masalah layanan tertentu atau menjalankan prosedur diagnostik.

Dalam tutorial ini, Anda akan belajar cara:

  • Membuat kemampuan di pembangun subagen
  • Menulis instruksi keterampilan di SKILL.md
  • Menambahkan file dan alat pendukung
  • Menguji keterampilan dalam obrolan atau taman bermain
  • Mengedit keterampilan yang ada

Perkiraan waktu: 10 menit

Petunjuk / Saran

Dokumen tentang keterampilan dan pengetahuan saling melengkapi. Keterampilan mengajarkan agen Anda cara melakukan sesuatu (prosedur, playbook, instruksi langkah demi langkah). Dokumen pengetahuan mengajarkan kepada agen Anda apa yang perlu diketahuinya (data referensi, dokumen arsitektur, runbook). Anda juga dapat melampirkan dokumen referensi langsung ke keahlian sebagai file pendukung. Untuk alur unggahan pengetahuan, lihat Mengunggah dokumen pengetahuan.

Prasyarat

Sebelum memulai, pastikan Anda memiliki prasyarat berikut:

  • Agen yang dibuat di portal Agen Azure SRE.
  • Pemahaman yang jelas tentang prosedur atau pengetahuan domain yang ingin Anda kodekan.

Buka pembuat subagen di mana Anda membuat dan mengelola kemampuan.

  1. Buka portal Agen SRE.
  2. Pilih agen Anda.
  3. Pilih Penyusun di navigasi kiri.
  4. Pilih Pembangun subagen.

Mulai pembuatan keahlian

Mulai proses pembuatan keterampilan dari toolbar.

  1. Pilih menu dropdown Buat di toolbar.
  2. Pilih Keterampilan.

Dialog pembuatan keterampilan terbuka dengan tata letak dua kolom. Bidang formulir di satu sisi dan editor kode di sisi lain memperlihatkan SKILL.md.

Masukkan nama dan deskripsi

Berikan nama dan deskripsi yang membantu agen memutuskan kapan harus menggunakan keterampilan ini.

Bidang Contoh nilai
Nama high-cpu-troubleshooting
Deskripsi "Prosedur pemecahan masalah untuk pemberitahuan CPU tinggi pada aplikasi kontainer. Memeriksa dependensi upstream, kumpulan koneksi, dan penyebaran terbaru."

Nama harus unik untuk setiap keterampilan Anda. Deskripsi muncul dalam daftar keterampilan dan membantu agen memutuskan kapan harus menggunakan keterampilan ini.

Petunjuk / Saran

Pilih Edit di samping teks deskripsi untuk beralih ke mode edit. Setelah selesai, pilih Simpan.

Instruksi keterampilan tulis

Editor tengah menunjukkan SKILL.md, yang berisi instruksi keterampilan. File dimulai dengan templat default.

---
name:
description:
---

<!-- Add your skill instructions here -->

Front matter YAML (name, description, tools) tetap sinkron dengan kolom formulir di sebelah kiri. Tulis instruksi Anda di Markdown di bawah materi depan:

---
name: high-cpu-troubleshooting
description: Troubleshooting procedure for high CPU alerts on container apps
tools:
  - kusto_query
---

## When to use this skill
Use this skill when you receive a high CPU alert on any container app.

## Steps
1. Check upstream dependencies for cascading failures
2. Query connection pool metrics for the last hour
3. Review deployments in the last 24 hours
4. If a recent deployment correlates with CPU spike, identify the commit
5. Recommend rollback or fix based on findings

## Expected output
Structured report with: affected resource, root cause, recommended action, and evidence.

Menambahkan file pendukung

Bagian File di satu sisi memperlihatkan browser file. Di luar default SKILL.md, Anda dapat menambahkan data referensi, templat, dan contoh kueri.

  • Pilih ikon file baru untuk menambahkan file.
  • Pilih ikon folder baru untuk mengatur file ke dalam direktori.
  • Seret dan letakkan folder ke zona drop, atau pilih tautan Unggah folder untuk mengunggah seluruh struktur folder.

Pilih file apa pun di browser untuk mengeditnya di editor kode. Editor mendukung penyorotan sintaks untuk skrip Markdown, JSON, YAML, KQL, Python, dan shell.

Pilih alat

Secara opsional, lampirkan alat yang digunakan kemampuan selama pelaksanaan.

  1. Pilih Pilih alat di bagian Alat .
  2. Telusuri atau cari alat. Filter menurut jenis (Alat Kustom, Alat MCP) atau cari berdasarkan nama.
  3. Periksa alat yang dibutuhkan keterampilan ini (misalnya, kusto_query atau azure_resource_health).
  4. Tutup panel.

Alat yang dipilih muncul sebagai pil yang dapat dilepas. Alat-alat ini tersedia secara dinamis saat keterampilan diaktifkan.

Nota

Alat yang ditambahkan ke keterampilan tersedia secara dinamis saat keterampilan diaktifkan. Untuk perilaku yang lebih konsisten, konfigurasikan alat langsung pada subagen sebagai gantinya.

Untuk membuat alat kustom, lihat Membuat alat Kusto atau Membuat alat Python. Untuk informasi selengkapnya tentang alat, lihat Alat.

Membuat keterampilan

Pilih Buat untuk menyimpan keterampilan Anda.

Keterampilan Anda muncul di tab Keterampilan pada penyusun subagen. Agen sekarang dapat menggunakan keterampilan secara otomatis ketika menemukan situasi yang relevan.

Menguji keterampilan

Agen utama dapat menggunakan keterampilan secara default, sehingga Anda dapat mengujinya langsung dalam obrolan tanpa membuat subagen terlebih dahulu.

Menguji dalam obrolan baru

Gunakan utas obrolan baru untuk memverifikasi bahwa agen telah mengaktifkan kemampuan Anda.

  1. Pilih Utas obrolan baru pada bilah samping.
  2. Ketik perintah yang akan memicu keterampilan Anda. Misalnya: "Kami melihat CPU tinggi di aplikasi kontainer kami, dapatkah Anda menyelidiki?"
  3. Verifikasi agen mengaktifkan kemampuan dan mengikuti prosedur yang Anda tentukan.

Uji di taman bermain

Gunakan lingkungan uji untuk menguji kemampuan melalui subagen.

  1. Buat subagen dan tetapkan keterampilan ini ke dalamnya.
  2. Pada toolbar penyusun subagen, pilih saklar tampilan Test playground.
  3. Pilih subagen, ketik perintah pengujian, dan verifikasi bahwa ia menggunakan keterampilan dengan benar.

Untuk informasi selengkapnya, lihat Playground Agen.

Mengedit fitur

Anda dapat mengubah keterampilan yang ada untuk memperbarui instruksi, alat, atau file pendukungnya.

  1. Di tab Keterampilan, pilih nama keterampilan atau klik Edit.

  2. Dialog edit terbuka dengan semua nilai saat ini telah diisi sebelumnya. Ubah bidang yang Anda butuhkan:

    Apa yang harus diubah Di mana memperbarui
    Ketika agen menggunakannya Deskripsi dan instruksi SKILL.md
    Prosedur apa yang harus diikuti Konten SKILL.md di dalam editor
    Alat mana yang tersedia Alat> Pilih alat
    Data referensi File> menambahkan, mengedit, atau menghapus file

  3. Pilih Simpan.

Tips untuk menulis keterampilan yang efektif

Gunakan panduan berikut untuk membuat keterampilan yang dapat digunakan agen Anda secara efektif.

  • Spesifik tentang kapan harus menggunakannya. Agen membaca deskripsi dan instruksi untuk memutuskan relevansi.
  • Sertakan prosedur langkah demi langkah. Langkah-langkah bernomor memberi agen panduan yang jelas.
  • Tentukan output yang diharapkan. Beri tahu agen dalam format apa hasilnya harus disajikan.
  • Tambahkan data referensi. Unggah templat kueri, garis besar konfigurasi, atau nilai yang dikenal bagus sebagai file pendukung.
  • Tetapkan alat yang relevan. Jika keterampilan memerlukan alat tertentu seperti kueri Kusto atau tindakan Azure, tambahkan alat tersebut.

Langkah selanjutnya

Pelajari tentang keterampilan

Konten terkait

  • Last updated on