Microsoft Kurso pavyzdžių testavimas
Patikrinkite, ar pamokų užrašų knygelės ir kodo pavyzdžiai veikia su veikia
Microsoft Foundry / Azure OpenAI konfigūracija. Repozitorijoje pateiktas vykdytojas
scripts/validate-notebooks.ps1, kuris
vykdo kiekvieną Python užrašų knygelę be sąveikos ir išspausdina PASIŽIŪRĖTI/NEPASIŽIŪRĖTI matricą.
Kada naudoti
- "Patikrinti visas užrašų knygeles / pavyzdžius pagal mano Azure prenumeratą."
- "Greitas kurso testavimas po paketų atnaujinimo ar modelių keitimo."
- "Kurios pamokos dar veikia / neveikia tiesiogiai?"
Nenaudokite to AI Smoke Test GitHub Action (kuris tikrina diegtus
talpinamus agentus — žr. tests/README.md). Ši priemonė
paleidžia užrašų knygeles vietoje.
Išankstiniai reikalavimai (patikrinkite pirmiausia)
- Python 3.12+ su kurso priklausomybėmis:
python -m pip install -r requirements.txt- vykdytojui:
python -m pip install nbconvert ipykernel.
- vykdytojui:
.envfaile repo šaknyje (kopijuokite iš.env.example) turi būti bent:AZURE_AI_PROJECT_ENDPOINT— Foundry projekto galinis taškas (https://<account>.services.ai.azure.com/api/projects/<project>)AZURE_AI_MODEL_DEPLOYMENT_NAME— nepasenęs diegimas (pvz.,gpt-5-mini)AZURE_OPENAI_ENDPOINT(https://<account>.openai.azure.com) irAZURE_OPENAI_DEPLOYMENTpamokoms, kurios tiesiogiai naudoja Azure OpenAI (06 pamoka, 02-azure-openai, 14 perdavimas/žmogaus ciklas).
- Atliktas
az login— pavyzdžiai autentifikuojasi suAzureCliCredential(Entra ID, be rakto). - Patikrinkite, ar modelio diegimas egzistuoja:
az cognitiveservices account deployment list -g <rg> -n <account> -o table.
Tikrinimo vykdymas
# Visi Python užrašų knygelės (neįtraukia .NET, .venv, site-packages, vertimų, įgūdžių išteklių)
pwsh scripts/validate-notebooks.ps1
# Viena pamoka su ilgesniu laiko limitu kiekvienai ląstelei
pwsh scripts/validate-notebooks.ps1 -Filter '08-*' -Timeout 600
# Tik surašyti, kas būtų vykdoma (vykdymas nevykdomas)
pwsh scripts/validate-notebooks.ps1 -List
# Aiškus interpretatorius (jei `python` nėra PATH, pvz., Windows Store alias)
pwsh scripts/validate-notebooks.ps1 -Python "C:/path/to/python.exe"
Skriptas įrašo vykdomas kopijas, kiekvienos užrašų knygelės žurnalus ir results.json į
$env:TEMP\aiab-nbval ir išeina su nepavykusių skaičiumi.
Laikini nesėkmingi bandymai (bendros prenumeratos HTTP 429 ribos, kartais
AzureCliCredential tokeno klaidos ar timeout) automatiškai bandomi iš naujo
(-Retries, numatyta 2, su -RetryDelaySeconds pauze, numatyta 20). Jei
modelio diegimas nuolat sukelia 429 klaidą, patikrinkite prenumeratos GlobalStandard
TPM kvotą (az cognitiveservices usage list -l <region>) — atskirai didinant vieno
diegimo pajėgumą nepadeda, kai išeikvota prenumeratos kvota.
Rezultatų interpretacija
PASS— užrašų knygelė prabėgo nuo pradžios iki galo be klaidų.FAIL— rodoma pirmoji*Error/*Exceptioneilutė; atidarykite atitinkamąlog_*.txtišvesties kataloge, kad matytumėte pilną klaidos seką.- Vienos užrašų knygelės nesėkmė ribojama
-Timeout(vienam langeliui), todėl pakibusį žmogaus ciklo langelį pakeičiaStdinNotImplementedError, o ne pakimba.
Pamokos, kurioms reikalingi papildomi ištekliai (tikėtina, kad nepavyks be jų)
| Pamoka | Papildomi reikalavimai |
|---|---|
| 05 Agentic RAG | Azure AI Search (AZURE_SEARCH_SERVICE_ENDPOINT, raktas) — turi atminties atsarginį kelią |
| 11 MCP / GitHub | GitHub MCP serveris + PAT |
| 13 atmintis (cognee) | cognee sukonfigūruotas su modelio tiekėju |
| 15 naršyklės naudojimas | Įdiegti Playwright naršyklės (playwright install) + AZURE_OPENAI_CHAT_DEPLOYMENT_NAME |
| 17 vietinis agentas | Foundry Local vykdymo aplinka + atsisiųstas Qwen modelis (vietoje, be debesies) |
*-dotnet-* užrašų knygelės |
.NET Interactive branduolys (pagal nutylėjimą išimtas; naudokite -IncludeDotnet) |
Ataskaitos grąžinimas
Apibendrinkite PASIŽIŪRĖTI/NEPASIŽIŪRĖTI lentelę suskirstytą pagal pamokas. Atskirai nurodykite tikras regresijas
(kodo / konfigūracijos klaidas) nuo aplinkos trūkumų (neprieinamos Search/Foundry Local/PAT),
ir paminėkite raspiančius log_*.txt failus kiekvienam tikram nesklandumui.
Atsakomybės apribojimas: Šis dokumentas buvo išverstas naudojant dirbtinio intelekto vertimo paslaugą Co-op Translator. Nors siekiame tikslumo, prašome atkreipti dėmesį, kad automatiniai vertimai gali turėti klaidų ar netikslumų. Originalus dokumentas jo gimtąja kalba laikomas autoritetingu šaltiniu. Svarbiai informacijai rekomenduojama naudoti profesionalų žmogiškąjį vertimą. Mes neatsakome už jokius nesusipratimus ar neteisingą interpretaciją, kilusią naudojantis šiuo vertimu.
Source: microsoft/ai-agents-for-beginners → translations/lt/.agents/skills/testing-course-samples/SKILL.md