# 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

ប្រើនៅពេលត្រូវបានស្នើឱ្យផ្ទៀងផ្ទាត់ ពិសោធន៍ ពិសោធន៍ស្ពឹក ឬរត់សៀវភៅកំណត់ត្រានិងគំរូកូដនៃវគ្គសិក្សាពីលើការកំណត់ Microsoft Foundry / Azure OpenAI ដែលកំពុងដំណើរការ។ គ្របដណ្ដប់ការតំឡើងបរិយាកាស (.env, az login, packages), កម្មវិធីរត់ scripts/validate-notebooks.ps1, ការបកស្រាយលទ្ធផល PASS/FAIL, និងមេរៀនណាដែលត្រូវការធនធានបន្ថែម (Azure AI Search, GitHub MCP, Foundry Local, Playwright)।

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

# ការធ្វើតេស្តគំរូវគ្គសិក្សា

ផ្ទៀងផ្ទាត់ថា សៀវភៅកំណត់ត្រាបង្រៀននិងគំរូកូដរត់បានលើការតំឡើង Microsoft Foundry / Azure OpenAI ត៌មានជាក់លាក់មួយ។ ឃ្លាំងកូដផ្ដល់ឧបករណ៌ដំណើរការនៅ
[`scripts/validate-notebooks.ps1`](../../../../../scripts/validate-notebooks.ps1) ដែល
អនុវត្តសៀវភៅកំណត់ត្រា Python ទាំងអស់ដោយគ្មានការបង្ហាញ UI និងបោះពុម្ពមាត្រលេខ PASS/FAIL។


- "ផ្ទៀងផ្ទាត់សៀវភៅកំណត់ត្រា / គំរូទាំងអស់នៅលើការជាវ Azure របស់ខ្ញុំ។"
- "ធ្វើតេស្តសម្រាប់ការបើកវគ្គបណ្តុះបណ្តាល បន្ទាប់ពីធ្វើបច្ចុប្បន្នភាពកញ្ចប់ឬប្ដូរម៉ូដែល។"
- "មេរៀនណាដែលនៅតែឆ្លងតេស្ត / បរាជ័យនៅលើប្រព័ន្ធតូច?"


កុំប្រើនេះសម្រាប់សកម្មភាព AI Smoke Test GitHub (ដែលធ្វើការត្រួតពិនិត្យ *បានបញ្ចូន*
អ្នកតំណាងដែលភ្ជាប់រួច, មើល [`tests/README.md`](../../../tests/README.md))។ ជំនាញនេះ
ប្រតិបត្ដិការវិចសៀវបណ្ណនៅក្នុងកន្លែង។

## លក្ខខណ្ឌមុន (ត្រួតពិនិត្យមុន)
1. **Python 3.12+** ជាមួយ deps តាមវគ្គ៖ `python -m pip install -r requirements.txt`
   បូកបន្ថែមអ្នកប្រតិបត្ដិការ៖ `python -m pip install nbconvert ipykernel`។
2. **`.env` នៅឬបាតដើម repo** (ចម្លងពី [`.env.example`](../../../../../.env.example)) ជាមួយយ៉ាងហោចណាស់៖
   - `AZURE_AI_PROJECT_ENDPOINT`, ចំណុចបញ្ចប់ផែនការរបស់ Foundry
     (`https://<account>.services.ai.azure.com/api/projects/<project>`)
   - `AZURE_AI_MODEL_DEPLOYMENT_NAME`, ការដាក់បង្ហាញមិនត្រូវបានចាកចេញ (ឧ. `gpt-5-mini`)
   - `AZURE_OPENAI_ENDPOINT` (`https://<account>.openai.azure.com`) និង `AZURE_OPENAI_DEPLOYMENT`
     សម្រាប់មេរៀនដែលហៅ Azure OpenAI តាមរយៈផ្ទាល់ (មេរៀន 06, 02-azure-openai, 14 handoff/human-loop)។
3. **`az login`** បានបញ្ចប់, គំរូត្រូវបាន Authenticate ជាមួយ `AzureCliCredential` (Entra ID, keyless)។
4. ត្រួតពិនិត្យមើលការដាក់បង្ហាញម៉ូដែលមានអត់៖
   `az cognitiveservices account deployment list -g <rg> -n <account> -o table`។

## ការប្រតិបត្ដិការត្រួតពិនិត្យ
```powershell
# All Python notebooks (skips .NET, .venv, site-packages, translations, skill assets)
pwsh scripts/validate-notebooks.ps1

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