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

Bu öğreticide, Azure SRE Aracınız için SLA uyumluluğunu hesaplayan çalışan bir Python aracı oluşturacaksınız. Aracın amacını düz İngilizce olarak açıklar, yapay zekanın kodu oluşturmasına, sonucu test etmesine ve aracınızı kullanması için dağıtmasına izin verirsiniz.

Bu eğitimde şunları öğreniyorsunuz:

  • Araç işlevselliğini düz İngilizce olarak açıklama
  • Yapay zeka kullanarak Python kodu oluşturma
  • Dağıtmadan önce aracı gerçek girişlerle test etme
  • Aracı ajanın kullanması için kaydet

Tahmini süre: 10 dakika

Önkoşullar

Başlamadan önce aşağıdaki kaynaklara ve izinlere sahip olduğunuzdan emin olun:

Python aracı iletişim kutusunu açma

"Agent Canvas"e gidin ve bir Python aracı oluşturmaya başlayın.

  1. SRE Aracısı portalını açın ve aracınızı seçin.
  2. Sol gezinti bölmesinde Oluşturucu'ya tıklayın.
  3. Builder'ı genişletin ve Agent Canvas'ı seçin.
  4. Oluştur>Araç>Python aracı'nı seçin.

Araç ve Python araç seçeneklerini gösteren Oluştur menüsünün ekran görüntüsü.

Python aracı iletişim kutusu üç sekmeyle açılır: Kod, Test oyun alanı ve Kimlik.

Aracın ne yapması gerektiğini açıklama

Açıklama alanında, aracın yapmak istediklerinizi düz İngilizce olarak yazın. Girişler, çıkışlar ve mantık hakkında özel olun.

Aşağıdaki açıklamayı girin:

Calculate SLA compliance percentage from total uptime minutes and downtime
minutes. Return whether the SLA meets a target threshold (default 99.9%).
Include the calculated percentage and a status message.

Açıklamanın girilmiş olduğu Python aracı iletişim kutusunun ekran görüntüsü.

Tip

En iyi sonuçlar için giriş parametrelerini ve bunların türlerini belirtin, hesaplamayı veya mantığı açıklayın, çıkışın içermesi gerekenleri belirtin ve uygun olduğunda varsayılan değerlerden bahsedin.

Kodu oluşturma

Yapay zekanın açıklamanızdan Python işlevini oluşturmasını sağlamak için Oluştur'u seçin.

Yapay zeka açıklamanızı analiz eder ve aşağıdakilerle bir Python işlevi oluşturur:

  • Girdilerinizle eşleşen yazılan parametreler
  • Mantığı açıklayan bir docstring
  • Sınır durumları için hata işleme
  • JSON serileştirilebilir dönüş değeri

Aşağıdaki örnekte oluşturulan kod gösterilmektedir:

def main(total_uptime_minutes: int, total_downtime_minutes: int,
         target_sla_percent: float = 99.9) -> dict:
    """Calculate SLA compliance from uptime and downtime minutes.

    Computes SLA as (uptime / (uptime + downtime)) * 100.
    Returns the SLA percentage, whether it meets the target,
    and a status message.
    """
    total_minutes = total_uptime_minutes + total_downtime_minutes

    if total_minutes == 0:
        sla_percent = 100.0
    else:
        sla_percent = (total_uptime_minutes / total_minutes) * 100

    meets_target = sla_percent >= target_sla_percent

    return {
        "sla_percent": round(sla_percent, 4),
        "target_sla_percent": target_sla_percent,
        "meets_target": meets_target,
        "status": "Meets SLA" if meets_target else "Below SLA"
    }

Oluşturulan Python işlevini gösteren Kod sekmesinin ekran görüntüsü.

Kod sekmesinde, yazılan parametrelere sahip bir main() işlev gösterilir. Araç adı açıklamanızdan gelir.

Gerçek girişlerle test edin

Aracı oluşturmadan önce gerçek değerleri kullanarak test edin.

  1. Test oyun alanı sekmesini seçin.
  2. Aşağıdaki test değerlerini girin:
    • total_uptime_minutes: 43185
    • total_downtime_minutes: 15
    • target_sla_percent: 99.9
  3. Test'i seçin.

Başarılı yürütmeyi gösteren test oyun alanının ekran görüntüsü.

Aşağıdaki örnekte beklenen sonuç gösterilmektedir:

{
  "sla_percent": 99.9653,
  "target_sla_percent": 99.9,
  "meets_target": true,
  "status": "Meets SLA"
}

Testte yeşil bir başarı göstergesi gösterilir ve JSON çıkışı beklenen değerlerle eşleşir.

Aracı oluştur

Testler geçtikten sonra Araç oluştur'u seçin.

Aracınız artık kullanılabilir. Bir görev aracın açıklamasıyla eşleştiğinde, temsilci aracı otomatik olarak çağırabilir.

Aracı doğrula

Yeni bir sohbet yazışmasında aracınıza aracı tetikleyen bir soru sorun:

What's my SLA for last month? We had 43185 minutes of uptime and 15 minutes of downtime.

Ajan, bu sorunun aracınıza uygun olduğunu algılar ve sonucu hesaplamak için aracı çağırır.

Sorun giderme

Yaygın sorunları çözmek için aşağıdaki bilgileri kullanın.

Test düğmesi devre dışı

Test düğmesi şunları gerektirir:

  • Geçerli Python kodu bir main() işleviyle
  • Doldurulan tüm gerekli parametre alanları

Kodunuzda söz dizimi hatası olup olmadığını ve tüm parametrelerin değerleri olup olmadığını denetleyin.

Kod amacınızla eşleşmiyor

Açıklama alanını seçin, metninizi iyileştirin ve yeniden Oluştur'a tıklayın. Şu konularda daha ayrıntılı olun:

  • Parametre adları ve türleri
  • Hesaplama mantığı
  • Beklenen çıkış biçimi

Test bir hata döndürür

Sonuçlar panelinde hata iletisini denetleyin. Bazı yaygın sorunlar aşağıdakileri içermektedir:

  • Sıfıra bölme (kenar durumları için işleme ekleme)
  • Yanlış parametre türleri (girişlerin beklenen türlerle eşleştiğinden emin olun)
  • İçeri aktarma hataları (kitaplıkların kullanılabilir olup olmadığını denetleyin)

Aracı düzenleme veya silme

Araçları doğrudan Ajan Tuvali üzerinden değiştirebilir veya kaldırabilirsiniz.

Edit

  1. Aracı Tuvali'nde araç düğümünü seçerek bilgi panelini açın.
  2. Panel üst bilgisinde düzenle (kalem) simgesini seçin.
  3. Düzenle iletişim kutusu açılır. Açıklamayı, kodu veya parametreleri değiştirin.
  4. Kaydetseçeneğini seçin.

Delete

  1. Bilgi panelini açmak için araç düğümünü seçin.
  2. Panel üst bilgisinde ⋯ (diğer eylemler) menüsünü seçin.
  3. Silme Aracı'nı seçin.
  4. silme işlemini iletişim kutusunda onaylayın.

Sonraki adım

Oyun alanında aracınızı test edin

İlgili içerik

  • Last updated on