# Testing Course Samples

Runs the course notebooks and code samples against a live Foundry or Azure OpenAI setup.

- Repository: https://github.com/microsoft/ai-agents-for-beginners (78611 stars)
- Category: Testing
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add microsoft/ai-agents-for-beginners --skill testing-course-samples -g -a claude-code -y`
Codex: `npx skills add microsoft/ai-agents-for-beginners --skill testing-course-samples -g -a codex -y`
Cursor: `npx skills add microsoft/ai-agents-for-beginners --skill testing-course-samples -g -a cursor -y`
Gemini CLI: `npx skills add microsoft/ai-agents-for-beginners --skill testing-course-samples -g -a gemini-cli -y`

## Description

Koristite kada se zatraži validacija, testiranje, smoke-test ili pokretanje bilježnica i primjera koda tečaja protiv aktivne Microsoft Foundry / Azure OpenAI konfiguracije. Obuhvaća postavljanje okruženja (.env, az login, pakete), pokretač scripts/validate-notebooks.ps1, tumačenje PASS/FAIL rezultata i koje lekcije zahtijevaju dodatne resurse (Azure AI Search, GitHub MCP, Foundry Local, Playwright).

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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`](../../../../../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`](../../../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`](../../../../../.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
```powershell
# 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

The rest: https://github.com/microsoft/ai-agents-for-beginners/blob/HEAD/translations/hr/.agents/skills/testing-course-samples/SKILL.md