בדיקת דוגמאות הקורס

אמתו שהמחברות והדוגמאות של השיעור רצות נגד הגדרת
Microsoft Foundry / Azure OpenAI חיה. המאגר כולל ראנר ב-
`scripts/validate-notebooks.ps1` שמבצע
הפעלה שקטה של כל מחברת פייתון ומדפיס מטריצת PASS/FAIL.

מתי להשתמש

• "אמת את כל המחברות / הדוגמאות מול מנוי Azure שלי."
• "בצע בדיקת תפקוד ראשונית בקורס לאחר שדרוג חבילות או שינוי דגמים."
• "אילו שיעורים עדיין עוברים / נכשלים בזמן אמת?"

אל תשתמשו בזה עבור GitHub Action של AI Smoke Test (שמאמת סוכנים מופעלים —
ראו `tests/README.md`). מיומנות זו
מריצה את המחברות באופן מקומי.

דרישות מוקדמות (בדקו קודם)

1. Python 3.12+ עם התלויות של הקורס: python -m pip install -r requirements.txt
   בנוסף המפעיל: python -m pip install nbconvert ipykernel.
2. .env בשורש המאגר (העתק מ-`.env.example`) עם לפחות:
   • AZURE_AI_PROJECT_ENDPOINT — נקודת קצה של פרויקט Foundry
     (https://<account>.services.ai.azure.com/api/projects/<project>)
   • AZURE_AI_MODEL_DEPLOYMENT_NAME — פריסת מודל שאינה מיושנת (למשל gpt-4.1-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 הושלמה — דוגמאות מאמתות עם AzureCliCredential (Entra ID, ללא מפתח).
4. אמתו שקיים פריסת המודל:
   az cognitiveservices account deployment list -g <rg> -n <account> -o table.

הרצת האימות

# כל פנקסי הפייתון (מדלג על .NET, .venv, site-packages, תרגומים, נכסי מיומנות)
pwsh scripts/validate-notebooks.ps1

# שיעור יחיד, עם זמן קצוב ארוך יותר לכל תא
pwsh scripts/validate-notebooks.ps1 -Filter '08-*' -Timeout 600

# רק לרשום מה ירוץ (ללא ביצוע)
pwsh scripts/validate-notebooks.ps1 -List

# מפרש מוצהר (אם `python` לא נמצא ב-PATH, לדוגמה קיצור חנות ווינדוס)
pwsh scripts/validate-notebooks.ps1 -Python "C:/path/to/python.exe"

הסקריפט כותב עותקים מוקצים, לוגים לכל מחברת ו- results.json אל
$env:TEMP\aiab-nbval ויוצא עם מספר הכשלים.

פירוש התוצאות

• PASS — המחברת רצה מקצה לקצה ללא שגיאת תא.
• FAIL — מוצגת שורת השגיאה/חריגה הראשונה *Error / *Exception; פתח את הקובץ המתאים
  log_*.txt בתיקיית הפלט לקבלת המעקב המלא.
• כישלון של מחברת אחת מוגבל על ידי הגבלה של -Timeout (לכל תא), כך שתא תלוי
  עם התערבות אדם יופיע כ- StdinNotImplementedError במקום להיתקע.

שיעורים שדורשים משאבים נוספים (צפויים להיכשל בלעדיהם)

שיעור	דרישה נוספת
05 Agentic RAG	Azure AI Search (AZURE_SEARCH_SERVICE_ENDPOINT, מפתח) — כולל דרך תחזית בזיכרון
11 MCP / GitHub	שרת MCP של GitHub + PAT
13 memory (cognee)	cognee מוגדר עם ספק מודל
15 browser-use	דפדפני Playwright מותקנים (playwright install) + AZURE_OPENAI_CHAT_DEPLOYMENT_NAME
17 local agent	Foundry Local runtime + מודל Qwen שהורד (במכשיר, ללא ענן)
מחברות *-dotnet-*	ליבת .NET Interactive (מוחרג כברירת מחדל; השתמש ב- -IncludeDotnet)

דיווח חזרה

סכם בטבלת PASS/FAIL מקובצת לפי שיעור. הפרד בין נסיגות אמתיות
(באגים בקוד/הגדרות לתיקון) לבין פערי סביבה (חסר חיפוש / Foundry Local / PAT),
וציין את ה- log_*.txt הכושלים עבור כל כשל אמיתי.

---

כתב ויתור:
מסמך זה תורגם באמצעות שירות תרגום אוטומטי Co-op Translator. למרות שאנו שואפים לדיוק, יש לקחת בחשבון שתרגומים אוטומטיים עלולים להכיל שגיאות או אי-דיוקים. יש להחשיב את המסמך המקורי בשפתו הטבעית כמקור הסמכות. למידע קריטי מומלץ להשתמש בתרגום מקצועי על ידי מתרגם אדם. אנו לא אחראים לכל אי-הבנה או פירוש שגוי הנובע מהשימוש בתרגום זה.