Testiranje Primjera Tečaja

Provjerite rade li bilježnice lekcija i primjeri koda u stvarnoj
Microsoft Foundry / Azure OpenAI postavci. Repozitorij sadrži pokretač u
`scripts/validate-notebooks.ps1` koji
izvršava svaku Python bilježnicu bez glave i ispisuje PASS/FAIL matricu.

Kada koristiti

• "Provjerite sve bilježnice / primjere u odnosu na moju Azure pretplatu."
• "Provedite osnovni test tečaja nakon nadogradnje paketa ili promjene modela."
• "Koje lekcije još uvijek prolaze / ne uspijevaju uživo?"

Nemojte koristiti ovo za AI Smoke Test GitHub Akciju (koja provjerava postavljene
hostirane agente — pogledajte `tests/README.md`). Ova vještina
izvršava bilježnice lokalno.

Preduvjeti (provjerite prvo)

1. Python 3.12+ s ovisnostima tečaja: python -m pip install -r requirements.txt
   plus izvršiteljem: python -m pip install nbconvert ipykernel.
2. .env u korijenu repozitorija (kopirajte iz `.env.example`) s barem:
   • AZURE_AI_PROJECT_ENDPOINT — Foundry endpoint projekta
     (https://<account>.services.ai.azure.com/api/projects/<project>)
   • AZURE_AI_MODEL_DEPLOYMENT_NAME — ne-deprecirana implementacija (npr. gpt-5-mini)
   • AZURE_OPENAI_ENDPOINT (https://<account>.openai.azure.com) i AZURE_OPENAI_DEPLOYMENT
     za lekcije koje izravno pozivaju Azure OpenAI (Lekcija 06, 02-azure-openai, 14 handoff/human-loop).
3. az login dovršen — primjeri autentificiraju se s AzureCliCredential (Entra ID, bez ključa).
4. Provjerite postoji li implementacija modela:
   az cognitiveservices account deployment list -g <rg> -n <account> -o table.

Pokretanje validacije

# Sve Python bilježnice (preskače .NET, .venv, site-packages, prijevode, vještine)
pwsh scripts/validate-notebooks.ps1

# Jedna lekcija, s duljim vremenom čekanja po ćeliji
pwsh scripts/validate-notebooks.ps1 -Filter '08-*' -Timeout 600

# Samo navedi što bi se izvršilo (bez izvođenja)
pwsh scripts/validate-notebooks.ps1 -List

# Izričiti interpreter (ako `python` nije u PATH-u, npr. Windows Store alias)
pwsh scripts/validate-notebooks.ps1 -Python "C:/path/to/python.exe"

Skripta zapisuje izvršene kopije, dnevnike po bilježnici, i results.json u
$env:TEMP\aiab-nbval i izlazi s brojem neuspjeha.

Privremene greške (ograničenja HTTP 429 na zajedničkoj pretplati, povremeni
problem s AzureCliCredential tokenom ili timeout) automatski se ponavljaju
(-Retries, zadano 2, s -RetryDelaySeconds odgodom, zadano 20). Ako
implementacija modela redovito daje 429, provjerite GlobalStandard
TPM kvotu pretplate (az cognitiveservices usage list -l <region>) — povećanje kapaciteta
pojedinačne implementacije ne pomaže ako je pretplatnička kvota iscrpljena.

Tumačenje rezultata

• PASS — bilježnica je izvršena od početka do kraja bez pogreške ćelije.
• FAIL — prikazana je prva linija *Error / *Exception; otvorite odgovarajući
  log_*.txt u izlaznom direktoriju za puni trag pogreške.
• Neuspjeh pojedine bilježnice ograničen je s -Timeout (po ćeliji), pa se ćelija
  koja čeka na angažman čovjeka prikazuje kao StdinNotImplementedError umjesto da visi.

Lekcije koje trebaju dodatne resurse (očekivano neuspješne bez njih)

Lekcija	Dodatni zahtjev
05 Agentic RAG	Azure AI Search (AZURE_SEARCH_SERVICE_ENDPOINT, ključ) — ima alternativni put u memoriji
11 MCP / GitHub	GitHub MCP poslužitelj + PAT
13 memory (cognee)	cognee konfiguriran s pružateljem modela
15 browser-use	Instalirani Playwright preglednici (playwright install) + AZURE_OPENAI_CHAT_DEPLOYMENT_NAME
17 lokalni agent	Foundry Local runtime + preuzeti Qwen model (na uređaju, bez oblaka)
*-dotnet-* bilježnice	.NET Interactive kernel (isključeno prema zadanim postavkama; koristi -IncludeDotnet)

Izvještavanje nazad

Sažmite kao PASS/FAIL tablicu grupiranu po lekciji. Odvojite stvarne regresije
(programske/konfiguracijske greške za popravak) od nedostataka u okruženju (nedostaje Search/Foundry Local/PAT),
i navedite neuspješne log_*.txt za svaki stvarni neuspjeh.

---

Napomena:
Ovaj dokument je preveden korištenjem AI prevoditeljskog servisa Co-op Translator. Iako težimo točnosti, imajte na umu da automatski prijevodi mogu sadržavati greške ili netočnosti. Izvorni dokument na izvornom jeziku treba smatrati autoritativnim izvorom. Za važne informacije preporuča se profesionalni ljudski prijevod. Nismo odgovorni za bilo kakva nesporazumevanja ili pogrešne interpretacije koje proizlaze iz korištenja ovog prijevoda.