Testing Course Samples

Kursuse näidete testimine

Kontrolli, kas õppetunni märkmikud ja koodinäited töötavad otse Microsoft Foundry / Azure OpenAI keskkonnas. Repos on kaasas käivitaja fail scripts/validate-notebooks.ps1, mis käivitab kõik Python märkmikud ilma kasutajaliideseta ja kuvab Läbi/Ebaõnnestus tabeli.

Millal kasutada

• "Kontrolli kõiki märkmikke / näiteid minu Azure tellimuse peal."
• "Tee kursuse suitsetest pärast pakettide uuendamist või mudelite muutmist."
• "Millised õppetunnid töötavad või ebaõnnestuvad otse?"

Ära kasuta seda AI suitsetesti GitHub Actioni jaoks (mis kontrollib paigaldatud teenuseid — vaata tests/README.md). See oskus käivitab märkmikud kohapeal.

Eeldused (esiteks kontrolli)

1. Python 3.12+ koos kursuse sõltuvustega: python -m pip install -r requirements.txt pluss käitaja: python -m pip install nbconvert ipykernel.
2. .env fail repo juurikas (kopeerida .env.example) vähemalt järgmistega:
   • AZURE_AI_PROJECT_ENDPOINT — Foundry projekti lõpp-punkt (https://<account>.services.ai.azure.com/api/projects/<project>)
   • AZURE_AI_MODEL_DEPLOYMENT_NAME — mitte-vananenud juurutus (nt gpt-5-mini)
   • AZURE_OPENAI_ENDPOINT (https://<account>.openai.azure.com) ja AZURE_OPENAI_DEPLOYMENT õppetundide jaoks, mis kutsuvad Azure OpenAI otse (Lesson 06, 02-azure-openai, 14 handoff/human-loop).
3. az login tehtud — näited autentivad AzureCliCredential abil (Entra ID, ilma võtmeta).
4. Kontrolli, et mudeli juurutus eksisteerib: az cognitiveservices account deployment list -g <rg> -n <account> -o table.

Kinnituse jooksutamine

# Kõik Pythoni märkmikud (välja arvates .NET, .venv, site-packages, tõlked, oskuste ressursid)
pwsh scripts/validate-notebooks.ps1

# Üksik õppetund, pikema rakuraku aikaviitega
pwsh scripts/validate-notebooks.ps1 -Filter '08-*' -Timeout 600

# Loetle lihtsalt, mis tööle pandaks (ilma täitmiseta)
pwsh scripts/validate-notebooks.ps1 -List

# Selgesõnaline interpreter (kui `python` ei ole PATH-is, nt Windows Store-i aliase puhul)
pwsh scripts/validate-notebooks.ps1 -Python "C:/path/to/python.exe"

Skript kirjutab täidetud koopiad, märkmiku-põhised logid ja results.json asukohta $env:TEMP\aiab-nbval ning väljub ebaõnnestumiste arvuga.

Ajutised vead (jagunatud tellimuse HTTP 429 kiirusepiirangud, mõni AzureCliCredential tokeni tõrge või aegumine) proovitakse automaatselt uuesti (-Retries, vaikimisi 2, koos -RetryDelaySeconds tagasilangemisega, vaikimisi 20). Kui mudeli juurutus annab pidevalt 429, kontrolli tellimuse GlobalStandard TPM kvooti (az cognitiveservices usage list -l <region>) — ühe juurutuse võimsuse tõstmine ei aita, kui tellimuse kvoot on ammendatud.

Tulemuste tõlgendamine

• PASS — märkmik jooksis lõpuni ilma lahtrivigadeta.
• FAIL — kuvatakse esimene *Error / *Exception rida; ava sobiv log_*.txt väljundkaustas täispildi jaoks.
• Ühe märkmiku ebaõnnestumine on piiratud -Timeout-ga (lahtri kohta), nii et kinni jäänud inimese kaasamise lahter näitab StdinNotImplementedError asemel kinni püsimist.

Õppetunnid, mis vajavad lisavahendeid (eeldatav ebaõnnestumine ilma nendeta)

Tagasiside andmine

Võta kokku Läbi/Ebaõnnestus tabelina rühmitatuna õppetunni järgi. Eralda tegelikud regressioonid (koodi/konfiguratsiooni vead, mida parandada) keskkonna puudujääkidest (puuduvad Search/Foundry Local/PAT), ning tsiteeri iga reaalse ebaõnnestumise korral log_*.txt faili.

Lahtiütlus: See dokument on tõlgitud kasutades AI tõlketeenust Co-op Translator. Kuigi me püüdleme täpsuse poole, palun pange tähele, et automatiseeritud tõlgetes võib esineda vigu või ebatäpsusi. Originaaldokument selle emakeeles tuleks pidada autoriteetseks allikaks. Olulise teabe puhul soovitatakse kasutada professionaalset inimtõlget. Me ei vastuta selle tõlkega seotud eksimustest või valesti mõistmistest.