Öğretici: Azure SRE Aracısı'nda beceri oluşturma

Bu öğreticide, aracınıza etki alanı bilgisi ve görev playbook'ları ekleyen özel bir beceri oluşturacaksınız. Beceriler, belirli bir hizmette sorun giderme veya tanılama yordamı çalıştırma gibi ilgili durumlarda aracınızın otomatik olarak yüklediği modüler özelliklerdir.

Bu eğitimde şunları öğreniyorsunuz:

Tahmini süre: 10 dakika

Önkoşullar

Başlamadan önce aşağıdaki önkoşullara sahip olduğunuzdan emin olun:

• Azure SRE Aracısı portalında oluşturulan bir aracı.
• Kodlamak istediğiniz yordamı veya etki alanı bilgisini net bir şekilde anlama.

Alt ajan oluşturucusuna git

Becerileri oluşturup yönettiğiniz alt aracı oluşturucuyu açın.

1. SRE Aracısı portalını açın.
2. Temsilcinizi seçin.
3. Sol gezinti bölmesinde Oluşturucu'ya tıklayın.
4. Subagent builder'ı seçin.

Beceri oluşturmaya başlama

Araç çubuğundan beceri oluşturma işlemini başlatın.

1. Araç çubuğunda Oluştur menüsünü seçin.
2. Beceri'yi seçin.

Beceri oluşturma iletişim kutusu iki sütunlu bir düzende açılır. Bir tarafta form alanları, diğer tarafta SKILL.md öğesini gösteren bir kod düzenleyicisi.

Ad ve açıklama girin

Aracının bu beceriyi ne zaman kullaneceğine karar vermesine yardımcı olacak bir ad ve açıklama sağlayın.

Ad, becerilerinizde benzersiz olmalıdır. Açıklama beceri listesinde görünür ve aracının bu beceriyi ne zaman kullaneceğine karar vermesine yardımcı olur.

Beceri yönergeleri yazma

Merkez düzenleyici, becerinin yönergelerini içeren SKILL.md öğesini gösterir. Dosya varsayılan bir şablonla başlar.

---
name:
description:
---

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

YAML ön bilgi (name, description, tools) soldaki form alanlarıyla senkronize kalır. Yönergelerinizi markdown'da ön konunun altına yazın:

---
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.

Destekleyici dosyalar ekleme

Bir taraftaki Dosyalar bölümünde bir dosya tarayıcısı gösterilir. Varsayılan SKILL.mddeğerinin ötesinde başvuru verileri, şablonlar ve örnek sorgular ekleyebilirsiniz.

• Dosya eklemek için yeni dosya simgesini seçin.
• Dosyaları dizinler halinde düzenlemek için yeni klasör simgesini seçin.
• Klasörü bırakma bölgesine sürükleyip bırakın veya klasör yapısının tamamını karşıya yüklemek için Klasörü karşıya yükle bağlantısını seçin.

Kod düzenleyicisinde düzenlemek için tarayıcıda herhangi bir dosyayı seçin. Düzenleyici, Markdown, JSON, YAML, KQL, Python ve kabuk komut dosyaları için söz dizimi vurgulamasını destekler.

Araçları seçme

İsteğe bağlı olarak, becerinin yürütme sırasında kullandığı araçları ekleyin.

1. Araçlar bölümünde Araçları seç'i seçin.
2. Araçlara göz atın veya arayın. Türe göre filtreleyin (Özel Araç, MCP Aracı) veya ada göre arama yapın.
3. Bu becerinin ihtiyaç duyduğu araçları denetleyin (örneğin, kusto_query veya azure_resource_health).
4. Paneli kapatın.

Seçili araçlar çıkarılabilir haplar olarak görünür. Beceri etkinleştirildiğinde bu araçlar dinamik olarak kullanılabilir.

Özel araçlar oluşturmak için bkz. Kusto aracı oluşturma veya Python aracı oluşturma. Araçlar hakkında daha fazla bilgi için bkz. Araçlar.

Beceriyi oluşturma

Becerinizi kaydetmek için Oluştur'u seçin.

Beceriniz, alt temsilci oluşturucusunun Beceriler sekmesinde görünür. Aracı, artık ilgili bir durumla karşılaştığında, beceriyi otomatik olarak kullanabilir.

Beceriyi test edin

Ana aracı varsayılan olarak becerileri kullanabilir, böylece bunları önce bir alt aracı oluşturmadan doğrudan sohbette test edebilirsiniz.

Yeni bir sohbette test edin

Bir ajanın becerinizi etkinleştirdiğini doğrulamak amacıyla yeni bir sohbet oturumu kullanın.

1. Kenar çubuğunda Yeni sohbet yazışması'nı seçin.
2. Becerinizi tetiklemesi gereken bir istem yazın. Örneğin: "Kapsayıcı uygulamamızda yüksek CPU görüyoruz, araştırabilir misiniz?"
3. Doğrulamak amacıyla temsilcinin beceriyi etkinleştirip tanımladığınız prosedürleri izlediğinden emin olun.

Oyun alanında test edin

Yetenekleri bir alt temsilci aracılığıyla test etmek için oyun alanını kullanın.

1. Bir alt aracı oluşturun ve bu beceriyi ona atayın.
2. Alt acente oluşturucu araç çubuğunda Oyun alanı testi görünüm düğmesini seçin.
3. Alt aracıyı seçin, bir test istemi yazın ve beceriyi doğru kullandığını doğrulayın.

Daha fazla bilgi için Aracı oyun alanı bölümüne bakın.

Beceriyi düzenleme

Mevcut bir beceriyi değiştirerek yönergelerini, araçlarını veya destekleyici dosyalarını güncelleştirebilirsiniz.

1. Beceriler sekmesinde beceri adını seçin veya seçin ve Düzenle'yi seçin.

2. Düzenle iletişim kutusu açılır ve tüm mevcut değerler önceden doldurulmuş şekilde gelir. İhtiyacınız olan alanları değiştirin:

   Değiştirilmesi gerekenler	Güncelleştirme yeri
   Ajan bunu kullandığında	Açıklama ve SKILL.md yönergeleri
   Hangi yordamları izlemeli?	SKILL.md dosyasının içeriği düzenleyicide
   Hangi araçlar kullanılabilir?	Araçları> Araçları seçme
   Referans verileri	Dosyaları> dosya ekleme, düzenleme veya kaldırma

3. Kaydetseçeneğini seçin.

Etkili beceriler yazmak için ipuçları

Aracınızın etkili bir şekilde kullanabileceği beceriler oluşturmak için aşağıdaki yönergeleri kullanın.

• Ne zaman kullanılacağı konusunda belirli olun. Aracı, ilgili olup olmadığını belirlemek için açıklamayı ve yönergeleri okur.
• Aşamaları adım adım ekleyin. Numaralandırılan adımlar aracıya net bir yol haritası sunar.
• Beklenen çıkışı belirtin. Aracıya sonuçların hangi formatta olması gerektiğini söyleyin.
• Referans verisi ekleyin. Sorgu şablonlarını, yapılandırma temel hatlarını veya bilinen geçerli değerleri destek dosyaları olarak karşıya yükleyin.
• İlgili araçları atayın. Becerinin Kusto sorguları veya Azure eylemleri gibi belirli araçlara ihtiyacı varsa bunları ekleyin.

Sonraki adım

İlgili içerik

• Beceri
• Bilgi belgelerini karşıya yükleme
• Alt Ajanlar
• Temsilci oyun alanı
• Tools
• Kusto aracı oluşturma
• Python aracı oluşturma
• Zamanlanmış görevler oluşturma
• Oyun alanında bir aracı test edin