Oktatóanyag: Python-eszköz létrehozása az Azure SRE-ügynökben

Ebben az oktatóanyagban egy működő Python-eszközt hoz létre, amely kiszámítja az Azure SRE-ügynök SLA-megfelelőségét. Az eszköz célját egyszerű angol nyelven írja le, lehetővé teszi az AI számára, hogy létrehozza a kódot, tesztelje az eredményt, és üzembe helyezze az eszközt az ügynök számára.

Ebben az oktatóanyagban a következőket sajátíthatja el:

Becsült idő: 10 perc

Előfeltételek

Mielőtt hozzákezdene, győződjön meg arról, hogy rendelkezik a következő erőforrásokkal és engedélyekkel:

• Egy Azure SRE-ügynök. További információ: Ügynök létrehozása.
• Az ügynök építői jogosultságai.
• Hozzáférés az SRE-ügynök portálhoz.

A Python eszköz párbeszédpaneljének megnyitása

Nyissa meg az Ügynökvászont, és kezdjen el Python-eszközt létrehozni.

1. Nyissa meg az SRE-ügynök portálját , és válassza ki az ügynökét.
2. A bal oldali navigációs sávon válassza a Builder lehetőséget .
3. Bontsa ki a Buildert , és válassza az Ügynökvászon lehetőséget.
4. Válassza aPython-eszköz>létrehozása>lehetőséget.

Megnyílik a Python eszköz párbeszédpanelje, amelyen három lap található: Kód, Tesztjátszótér és Identitás.

Az eszköz teendőinek ismertetése

A leírás mezőbe írja be, hogy mit szeretne az eszköznek egyszerű angol nyelven elvégezni. Legyen konkrét a bemenetekkel, kimenetekkel és logikával kapcsolatban.

Adja meg a következő leírást:

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 kód létrehozása

Válassza a Létrehozás lehetőséget , ha az AI létrehozza a Python-függvényt a leírásból.

Az AI elemzi a leírást, és létrehoz egy Python-függvényt a következőkkel:

• A bemeneteknek megfelelő beírt paraméterek
• A logikát magyarázó dokumentum
• Hibakezelés peremes esetek esetén
• JSON-szerializálható visszatérési érték

Az alábbi példa a létrehozott kódot mutatja be:

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"
    }

A Kód lap egy main() beírt paraméterekkel rendelkező függvényt jelenít meg. Az eszköz neve a leírásból származik.

Valós bemenetek tesztelése

Az eszköz létrehozása előtt tesztelje tényleges értékekkel.

1. Válassza a Tesztjátszótér lapot.
2. Adja meg a következő tesztértékeket:
   • total_uptime_minutes: 43185
   • total_downtime_minutes: 15
   • target_sla_percent: 99.9
3. Válassza ki a Teszt lehetőséget.

Az alábbi példa a várt eredményt mutatja be:

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

A teszt zöld sikermutatót jelenít meg, és a JSON-kimenet megfelel a várt értékeknek.

Az eszköz létrehozása

A tesztek elvégzése után válassza az Eszköz létrehozása lehetőséget.

Az eszköz már elérhető. Az ügynök automatikusan meghívhatja, ha egy tevékenység megfelel az eszköz leírásának.

Az eszköz ellenőrzése

Egy új csevegőszálban tegyen fel egy kérdést az ügynöknek, amely elindítja az eszközt:

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

Az ügynök felismeri ezt a kérdést, és meghívja az eszközt az eredmény kiszámításához.

Hibaelhárítás

A gyakori problémák megoldásához használja az alábbi információkat.

A Teszt gomb le van tiltva

A Teszt gombhoz a következőre van szükség:

• Érvényes Python-kód egy main() függvénnyel
• Minden kötelező paramétermező kitöltve

Ellenőrizze, hogy a kód nem tartalmaz-e szintaxishibákat, és minden paraméter rendelkezik-e értékekkel.

A kód nem egyezik a szándékkal

Jelölje ki a leírásmezőt, pontosítsa a szöveget, és válassza ismét a Létrehozás lehetőséget . Legyen pontosabb a következőről:

• Paraméternevek és -típusok
• Számítási logika
• Várt kimeneti formátum

A teszt hibát ad vissza

Ellenőrizze a hibaüzenetet az eredménypanelen. Gyakori problémák a következők:

• Osztás nullával (szélsőséges esetek kezelésének hozzáadása)
• Helytelen paramétertípusok (győződjön meg arról, hogy a bemenetek megfelelnek a várt típusoknak)
• Importálási hibák (ellenőrizze, hogy a kódtárak elérhetők-e)

Eszköz szerkesztése vagy törlése

Az eszközöket közvetlenül az ügynökvásznon módosíthatja vagy eltávolíthatja.

Edit

1. Az Ügynökvászonon válassza ki az eszközcsomópontot az információs panel megnyitásához.
2. Válassza a szerkesztés (ceruza) ikont a panel fejlécében.
3. Megnyílik a szerkesztési párbeszédpanel. Módosítsa a leírást, a kódot vagy a paramétereket.
4. Válassza az Mentésgombot.

Törlés

1. Válassza ki az eszközcsomópontot az információs panel megnyitásához.
2. Válassza a ⋯ (további műveletek) menüt a panel fejlécében.
3. Válassza a Törlés eszköz lehetőséget.
4. Erősítse meg a törlést a párbeszédpanelen.

Következő lépés

Kapcsolódó tartalom

• Python-eszközök
• Kusto-eszköz létrehozása
• Eszközök áttekintése