Testing Course Samples

A tanfolyam mintáinak tesztelése

Ellenőrizze, hogy a leckék jegyzetei és kódmintái működnek-e egy élő Microsoft Foundry / Azure OpenAI környezettel. A repo tartalmaz egy futtatót a scripts/validate-notebooks.ps1 útvonalon, amely fej nélküli futtatással végrehajt minden Python jegyzetfüzetet, és PASS/FAIL mátrixot nyomtat.

Mikor használjuk

• "Ellenőrizze az összes jegyzetfüzetet / mintát az Azure előfizetésemhez."
• "Futtasson gyors ellenőrzést a tanfolyamon csomagfrissítés vagy modellváltoztatás után."
• "Mely leckék futnak még át / kerülnek hibára élő környezetben?"

Ne használja ezt az AI Smoke Test GitHub Actionhoz (amely a telepített hosztolt ügynököket validálja — lásd tests/README.md). Ez a skill a jegyzetfüzeteket helyben futtatja.

Előfeltételek (ellenőrizze először)

1. Python 3.12+ a tanfolyami függőségekkel: python -m pip install -r requirements.txt továbbá a futtató: python -m pip install nbconvert ipykernel.
2. .env a repo gyökérkönyvtárában (másolja a .env.example fájlból) legalább:
   • AZURE_AI_PROJECT_ENDPOINT — Foundry projekt végpontja (https://<account>.services.ai.azure.com/api/projects/<project>)
   • AZURE_AI_MODEL_DEPLOYMENT_NAME — egy nem elavult telepítés (pl. gpt-5-mini)
   • AZURE_OPENAI_ENDPOINT (https://<account>.openai.azure.com) és AZURE_OPENAI_DEPLOYMENT azokhoz a leckékhez, melyek Azure OpenAI-t közvetlenül hívnak (06. lecke, 02-azure-openai, 14 handoff/human-loop).
3. az login elvégezve — a minták az AzureCliCredential-lel hitelesítenek (Entra ID, kulcs nélküli).
4. Ellenőrizze, hogy létezik a modell telepítés: az cognitiveservices account deployment list -g <rg> -n <account> -o table.

Az ellenőrzés futtatása

# Minden Python jegyzetfüzet (kihagyva: .NET, .venv, site-packages, fordítások, készség erőforrások)
pwsh scripts/validate-notebooks.ps1

# Egyetlen lecke, hosszabb cellánkénti időkorláttal
pwsh scripts/validate-notebooks.ps1 -Filter '08-*' -Timeout 600

# Csak felsorolja, hogy mi futna (nem hajt végre)
pwsh scripts/validate-notebooks.ps1 -List

# Explicit értelmező (ha a `python` nincs a PATH-on, pl. Windows Store alias)
pwsh scripts/validate-notebooks.ps1 -Python "C:/path/to/python.exe"

A szkript végrehajtott másolatokat, jegyzetfüzetenkénti naplókat és results.json fájlt ír a $env:TEMP\aiab-nbval könyvtárba és a sikertelenek számával lép ki.

Átmeneti hibákat (közös előfizetésből eredő HTTP 429 korlátozások, alkalmi AzureCliCredential token-probléma vagy időtúllépés) automatikusan újrapróbálja (-Retries, alapértelmezett 2, -RetryDelaySeconds várakozással, alapértelmezett 20). Ha egy modell telepítés gyakran 429-et ad vissza, ellenőrizze az előfizetés GlobalStandard TPM kvótáját (az cognitiveservices usage list -l <region>) — egyetlen telepítés kapacitásának növelése nem segít, ha az előfizetés kvóta kimerült.

Eredmények értelmezése

• PASS — a jegyzetfüzet hiba nélkül lefutott végig.
• FAIL — az első *Error / *Exception sor megjelenik; a teljes tracebackhez nyissa meg a megfelelő log_*.txt fájlt a kimeneti könyvtárban.
• Egyetlen jegyzetfüzet hibája a -Timeout idővel korlátozott (cellánként), így egy lefagyott human-in-the-loop cella StdinNotImplementedError hibát ad vissza a lefagyás helyett.

Olyan leckék, amelyek extra erőforrásokat igényelnek (ezek hiányában hibára futnak)

Visszajelzés

Összegezze PASS/FAIL táblázatként leckénként csoportosítva. Válassza szét az valódi regressziókat (javítandó kód/beállítás hibák) a környezeti hiányosságoktól (hiányzó Search/Foundry Local/PAT), és hivatkozzon a hibás log_*.txt fájlokra minden valódi hiba esetén.

Jogi nyilatkozat: Ez a dokumentum az AI fordítási szolgáltatás, a Co-op Translator segítségével készült. Bár az pontosságra törekszünk, kérjük, vegye figyelembe, hogy az automatikus fordítások hibákat vagy pontatlanságokat tartalmazhatnak. Az eredeti dokumentum az anyanyelvén tekintendő hiteles forrásnak. Fontos információk esetén professzionális emberi fordítást javasolunk. Nem vállalunk felelősséget semmilyen félreértésért vagy téves értelmezésért, amely ebből a fordításból ered.

Source: microsoft/ai-agents-for-beginners → translations/hu/.agents/skills/testing-course-samples/SKILL.md