testing-course-samples

Validate course notebook and code samples against live Microsoft Foundry and Azure OpenAI configurations.

73.6k|24.3k|Updated Nov 28, 2024
One-click install
npx skills add https://github.com/microsoft/ai-agents-for-beginners --skill testing-course-samples
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: testing-course-samples
Source: https://github.com/microsoft/ai-agents-for-beginners/tree/main/.agents/skills/testing-course-samples
Command: npx skills add https://github.com/microsoft/ai-agents-for-beginners --skill testing-course-samples

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, nbconvert, ipykernel, and includes scripts (resource) components.

What problem does it solve?

This Skill addresses the challenge of verifying that educational code samples and Jupyter notebooks remain functional against evolving cloud environments, preventing broken learning experiences due to API changes or configuration drift.

Core Features & Use Cases

  • Automated Validation: Executes Python notebooks headlessly to generate a PASS/FAIL matrix for course content.
  • Environment Diagnostics: Checks prerequisites like Azure CLI authentication, model deployment availability, and required environment variables.
  • Use Case: Use this after updating local dependencies or changing model versions to ensure all course lessons, such as Agentic RAG or browser-use modules, still execute correctly against your Azure subscription.

Quick Start

Run the validation script in the terminal using pwsh scripts/validate-notebooks.ps1 to test all course notebooks against your current environment.

Frequently Asked Questions about testing-course-samples

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate all course notebooks at once?

Execute the validation runner using 'pwsh scripts/validate-notebooks.ps1' from the repository root. This script automatically discovers and runs all Python notebooks, providing a summary matrix of results.

What should I do if a notebook fails during validation?

Check the generated log files in the output directory specified by the script. The logs contain the full traceback for each failed cell, which helps distinguish between code regressions and environment configuration issues.

Can I test a specific lesson instead of the entire course?

Yes, use the -Filter parameter with the script, such as 'pwsh scripts/validate-notebooks.ps1 -Filter '08-*'', to target specific lesson folders or notebook patterns.

Why do some lessons require extra resources like GitHub MCP?

Certain advanced lessons depend on external services or specific local runtimes. Lessons involving MCP, browser-use, or local agents require pre-configured credentials or installed dependencies to pass validation.

Does this skill support .NET notebooks?

The validation script excludes .NET notebooks by default. You must explicitly use the -IncludeDotnet flag if you wish to validate .NET Interactive kernels alongside the Python samples.