Skip to content
Skills Library
Programming · Testing

testing-course-samples

/testing-course-samples

Use when asked to validate, test, smoke-test, or run the course's notebook and code samples against a live Microsoft Foundry / Azure OpenAI configuration. Covers environment setup (.env, az login, packages), the scripts/validate-notebooks.ps1 runner, interpreting PASS/FAIL results, and which lessons need extra resources (Azure AI Search, GitHub MCP, Foundry Local, Playwright).

Licence
MIT
Last repository change
06.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
2
URLs in SKILL.md
3
Deprecation

No signals detected. Repository changed on 06.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • SKILL.md zawiera komentarze HTML (2). Nie widać ich w podglądzie Markdown, a model je czyta.

What it does and when to use it

Use when asked to validate, test, smoke-test, or run the course's notebook and code samples against a live Microsoft Foundry / Azure OpenAI configuration. Covers environment setup (.env, az login, packages), the scripts/validate-notebooks.ps1 runner, interpreting PASS/FAIL results, and which lessons need extra resources (Azure AI Search, GitHub MCP, Foundry Local, Playwright).

Original author description

Use when asked to validate, test, smoke-test, or run the course's notebook and code samples against a live Microsoft Foundry / Azure OpenAI configuration. Covers environment setup (.env, az login, packages), the scripts/validate-notebooks.ps1 runner, interpreting PASS/FAIL results, and which lessons need extra resources (Azure AI Search, GitHub MCP, Foundry Local, Playwright).

How it works

  1. Milloin käyttää
  2. Esivaatimukset (tarkista ensin)
  3. Vahvistuksen suorittaminen
  4. Tulosten tulkinta
  5. Oppitunnit, jotka tarvitsevat lisäresursseja (epäonnistuvat ilman niitä)
  6. Raportointi
Original SKILL.md headings · 81 lines, 510 words
SKILL.md preview
---
name: testing-course-samples
description: "Use when asked to validate, test, smoke-test, or run the course's notebook and code samples against a live Microsoft Foundry / Azure OpenAI configuration. Covers environment setup (.env, az login, packages), the scripts/validate-notebooks.ps1 runner, interpreting PASS/FAIL results, and which lessons need extra resources (Azure AI Search, GitHub MCP, Foundry Local, Playwright)."
---
# Kurssinäytteiden testaaminen

Varmista, että oppituntien muistiinpanot ja koodinäytteet toimivat live-
Microsoft Foundry / Azure OpenAI -ympäristössä. Repossa on runner osoitteessa
[`scripts/validate-notebooks.ps1`](../../../../../scripts/validate-notebooks.ps1), joka
suorittaa kaikki Python-muistiinpanot ilman käyttöliittymää ja tulostaa PASS/FAIL-matriisin.

## Milloin käyttää
- "Varmista, että kaikki muistiinpanot / näytteet toimivat Azure-tilauksessani."
- "Tee savutesti kurssille päivitysten tai mallien vaihdon jälkeen."
- "Mitkä oppitunnit läpäisevät / epäonnistuvat livenä?"

Älä käytä tätä AI Smoke Test -GitHub-toiminnossa (joka validoi *asennetut*
isännöidyt agentit — katso [`tests/README.md`](../../../tests/README.md)). Tämä taito
suorittaa muistiinpanot paikallisesti.

## Esivaatimukset (tarkista ensin)
1. **Python 3.12+** kurssin riippuvuuksilla: `python -m pip install -r requirements.txt`
   plus suoritin: `python -m pip install nbconvert ipykernel`.
2. **`.env` repossa juuressa** (kopioi [`.env.example`](../../../../../.env.example)) vähintään:
   - `AZURE_AI_PROJECT_ENDPOINT` — Foundry-projektin päätepiste
     (`https://<account>.services.ai.azure.com/api/projects/<project>`)
   - `AZURE_AI_MODEL_DEPLOYMENT_NAME` — ei vanhentunut käyttöönotto (esim. `gpt-5-mini`)
   - `AZURE_OPENAI_ENDPOINT` (`https://<account>.openai.azure.com`) ja `AZURE_OPENAI_DEPLOYMENT`
     oppitunneille, jotka kutsuvat Azure OpenAI:ta suoraan (Oppitunti 06, 02-azure-openai, 14 handoff/human-loop).
3. **`az login`** suoritettu — näytteet todennetaan `AzureCliCredential` (Entra ID, avaineton).
4. Varmista, että mallin käyttöönotto on olemassa:
   `az cognitiveservices account deployment list -g <rg> -n <account> -o table`.

## Vahvistuksen suorittaminen
```powershell
# All Python notebooks (skips .NET, .venv, site-packages, translations, skill assets)
pwsh scripts/validate-notebooks.ps1

# A single lesson, with a longer per-cell timeout
pwsh scripts/validate-notebooks.ps1 -Filter '08-*' -Timeout 600

# Just list what would run (no execution)
pwsh scripts/validate-notebooks.ps1 -List

# Explicit interpreter (if `python` is not on PATH, e.g. Windows Store alias)
pwsh scripts/validate-notebooks.ps1 -Python "C:/path/to/python.exe"
```
Skripti kirjoittaa suoritetut kopiot, muistiinpanokohtaiset lokit ja `results.json` osoitteeseen
`$env:TEMP\aiab-nbval` ja sulkeutuu epäonnistumisten lukumäärällä.

Tilapäiset epäonnistumiset (jaetut-tilaus HTTP 429 -rajoitukset, satunnainen
`AzureCliCredential` tokenin ongelma tai aikakatkaisu) yritetään automaattisesti uudelleen
(`-Retries`, oletus 2, `-RetryDelaySeconds` takaisinkytkennällä, oletus 20). Jos
mallin käyttöönotto saa usein 429-virheitä, tarkista tilauksen GlobalStandard
TPM-quota (`az cognitiveservices usage list -l <region>`) — yhden
käyttöönoton kapasiteetin nostaminen ei auta, jos *tilauksen* quota on loppu.

## Tulosten tulkinta
- `PASS` — muistiinpano suoritettiin loppuun ilman solun virheitä.
- `FAIL` — ensimmäinen `*Error` / `*Exception` rivi näytetään; avaa vastaava
  `log_*.txt` tulostehakemistossa täydelliseen virhejäljitykseen.
- Yhden muistiinpanon epäonnistuminen rajataan `-Timeout` mukaan (solua kohti), joten jumissa oleva
  human-in-the-loop -solu näkyy `StdinNotImplementedError` eikä jää jumiin.

## Oppitunnit, jotka tarvitsevat lisäresursseja (epäonnistuvat ilman niitä)
| Oppitunti | Lisävaatimus |
|--------|-------------------|
| 05 Agentic RAG | Azure AI Search (`AZURE_SEARCH_SERVICE_ENDPOINT`, avain) — sisältää muistissa toimivan varareitin |
| 11 MCP / GitHub | GitHub MCP -palvelin + PAT |
| 13 muisti (cognee) | `cognee` asetettu mallin tarjoajalla |
| 15 selain-käyttö | Playwright-selaimet asennettuna (`playwright install`) + `AZURE_OPENAI_CHAT_DEPLOYMENT_NAME` |
| 17 paikallinen agentti | Foundry Local runtime + ladattu Qwen-malli (laitteella, ei pilvessä) |
| `*-dotnet-*` muistiinpanot | .NET Interactive kernel (pois oletuksena; käytä `-IncludeDotnet`) |

## Raportointi
Tee yhteenveto PASS/FAIL-taulukkona oppitunnittain ryhmiteltynä. Erittele aidot takaiskset
(korjattavat koodi-/konfiguraatiovirheet) ympäristöpuutteista (puuttuvat Search/Foundry Local/PAT),
ja ilmoita epäonnistuneesta `log_*.txt` jokaisessa todellisessa epäonnistumisessa.

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Vastuuvapauslauseke**:
Tämä asiakirja on käännetty käyttämällä tekoälypohjaista käännöspalvelua [Co-op Translator](https://github.com/Azure/co-op-translator). Vaikka pyrimme tarkkuuteen, otathan huomioon, että automaattiset käännökset saattavat sisältää virheitä tai epätarkkuuksia. Alkuperäinen asiakirja sen alkuperäiskielellä on virallinen lähde. Tärkeissä asioissa suositellaan ammattimaista ihmiskäännöstä. Emme ole vastuussa tämän käännöksen käytöstä aiheutuvista väärinymmärryksistä tai tulkinnoista.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

Versions

RepositoryScoreLicence
This page · microsoft/ai-agents-for-beginners100MIT
microsoft/ai-agents-for-beginners100MIT
microsoft/ai-agents-for-beginners100MIT
microsoft/ai-agents-for-beginners100MIT
microsoft/ai-agents-for-beginners100MIT

Database snapshot: 13.11.2026 · package version 8e3cb9176fbb (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 85microsoft-foundry-local
    Expert knowledge for Microsoft Foundry Local (aka Azure AI Foundry Local) development including best practices, decision making, configuration, and integrations & coding patterns. Use when compiling HF models with Olive, using Foundry Local CLI, embeddings/chat/audio APIs, or…
  • 100microsoft-development
    Microsoft docs lookup, code samples, and SDK reference for Azure, .NET, Microsoft 365, Windows, and Power Platform via Microsoft Learn MCP. Use for API reference or official MS documentation retrieval.
  • 85microsoft-foundry-local
    Expert knowledge for Microsoft Foundry Local (aka Azure AI Foundry Local) development including best practices, decision making, configuration, and integrations & coding patterns. Use when compiling HF models with Olive, using Foundry Local CLI, embeddings/chat/audio APIs, or…
  • 95microsoft-foundry-classic
    Expert knowledge for Microsoft Foundry Classic (aka Azure AI Foundry classic) development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use…
  • 100azure-microsoft-playwright-testing-ts
    Run Playwright tests at scale using Azure Playwright Workspaces (formerly Microsoft Playwright Testing). Use when scaling browser tests across cloud-hosted browsers, integrating with CI/CD pipelines, or publishing test results to the Azure portal.
  • 95microsoft-foundry
    Expert knowledge for Microsoft Foundry (aka Azure AI Foundry) development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.