thedixitjain کورس کے نمونوں کی جانچ
تصدیق کریں کہ اسباق کے نوٹ بکس اور کوڈ کے نمونے ایک فعال
Microsoft Foundry / Azure OpenAI سیٹ اپ کے خلاف چل رہے ہیں۔ ریپو میں ایک رنر شامل ہے
scripts/validate-notebooks.ps1 جو
ہر پائتھن نوٹ بک کو ہیڈلیس طریقے سے چلاتا ہے اور PASS/FAIL ماتریس پرنٹ کرتا ہے۔
کب استعمال کریں
- "اپنی Azure سبسکرپشن کے خلاف تمام نوٹ بکس / نمونوں کی تصدیق کریں۔"
- "پیکجز کو اپ گریڈ کرنے یا ماڈلز میں تبدیلی کے بعد کورس کا سمورک ٹیسٹ کریں۔"
- "کون سے سبق اب بھی زندہ چل رہے ہیں یا ناکام ہو رہے ہیں؟"
AI Smoke Test GitHub ایکشن کے لئے اسے استعمال نہ کریں (جو تعینات شدہ
ہوسٹ کیے گئے ایجنٹس کی تصدیق کرتا ہے — دیکھیں tests/README.md)۔ یہ مہارت
نوٹ بکس کو مقامی طور پر چلاتی ہے۔
ضروریات (پہلے چیک کریں)
- Python 3.12+ کورس کی dependencies کے ساتھ:
python -m pip install -r requirements.txtاور ایگزیکیوٹر کے لئے:python -m pip install nbconvert ipykernel۔ - رپو کے روٹ پر
.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)۔
az loginمکمل ہو چکا ہو — نمونےAzureCliCredential(Entra ID, keyless) کے ساتھ تصدیق کرتے ہیں۔- ماڈل کی تعیناتی موجود ہے یہ تصدیق کریں:
az cognitiveservices account deployment list -g <rg> -n <account> -o table۔
تصدیق چلانا
# تمام پائتھن نوٹ بکس (.NET، .venv، site-packages، translations، skill assets کو چھوڑ کر)
pwsh scripts/validate-notebooks.ps1
# ایک واحد سبق، ہر سیل کے لیے زیادہ طویل ٹائم آؤٹ کے ساتھ
pwsh scripts/validate-notebooks.ps1 -Filter '08-*' -Timeout 600
# صرف فہرست بنائیں کہ کیا چلے گا (کوئی عملدرآمد نہیں)
pwsh scripts/validate-notebooks.ps1 -List
# واضح مفسر (اگر `python` PATH پر نہیں ہے، مثلاً Windows Store الیاس)
pwsh scripts/validate-notebooks.ps1 -Python "C:/path/to/python.exe"
اسکرپٹ چلائی گئی کاپیاں، فی نوٹ بک لاگز، اور results.json کو لکھتا ہے
$env:TEMP\aiab-nbval میں اور نقصانات کی تعداد کے ساتھ باہر نکلتا ہے۔
نتائج کی تشریح
PASS— نوٹ بک بغیر کسی سیل کی غلطی کے مکمل چل گئی۔FAIL— پہلی*Error/*Exceptionلائن دکھائی جاتی ہے؛ مکمل ٹریس بیک کے لیے آؤٹ پٹ ڈائریکٹری میں مطابقت رکھنے والاlog_*.txtکھولیں۔- ایک نوٹ بک کی ناکامی
-Timeout(فی سیل) سے محدود ہوتی ہے، لہٰذا رکا ہوا human-in-the-loop سیلStdinNotImplementedErrorکے طور پر ظاہر ہوتا ہے بجائے رکے رہنے کے۔
اسباق جن کو اضافی وسائل کی ضرورت ہے (ان کے بغیر ناکام ہونے کی توقع ہے)
| سبق | اضافی ضرورت |
|---|---|
| 05 Agentic RAG | Azure AI سرچ (AZURE_SEARCH_SERVICE_ENDPOINT, key) — ایک ان میموری بیک اپ راستہ موجود ہے |
| 11 MCP / GitHub | GitHub MCP سرور + PAT |
| 13 میموری (cognee) | cognee ماڈل فراہم کنندہ کے ساتھ ترتیب دیا گیا |
| 15 browser-use | Playwright براؤزرز انسٹال کیے گئے (playwright install) + AZURE_OPENAI_CHAT_DEPLOYMENT_NAME |
| 17 local agent | Foundry Local رن ٹائم + ڈاؤن لوڈ شدہ Qwen ماڈل (آلے پر، بغیر کلاؤڈ) |
*-dotnet-* نوٹ بکس |
.NET Interactive کرنل (ڈیفالٹ میں شامل نہیں؛ استعمال کریں -IncludeDotnet) |
رپورٹنگ
سبق کے مطابق گروپ بندی کی گئی PASS/FAIL ٹیبل کے طور پر خلاصہ کریں۔ حقیقی ریگریشنز
(کوڈ/کنفیگریشن کی خرابیوں کی درستگی) کو ماحول کے خلا (مثلاً Search/Foundry Local/PAT کی کمی) سے الگ کریں،
اور ہر حقیقی ناکامی کے لیے ناکام log_*.txt کا حوالہ دیں۔
ڈس کلیمر: یہ دستاویز AI ترجمہ سروس Co-op Translator کے ذریعے ترجمہ کی گئی ہے۔ جبکہ ہم درستگی کے لیے کوشاں ہیں، براہ کرم اس بات سے آگاہ رہیں کہ خودکار ترجمے میں غلطیاں یا عدم درستیاں ہو سکتی ہیں۔ اصل دستاویز اپنے مادری زبان میں مستند ماخذ سمجھی جائے گی۔ حساس معلومات کے لیے پیشہ ور انسانی ترجمہ کی سفارش کی جاتی ہے۔ اس ترجمے کے استعمال سے پیدا ہونے والی کسی بھی غلط فہمی یا غلط تشریح کی ذمہ داری ہم قبول نہیں کرتے۔
Source: microsoft/ai-agents-for-beginners → translations/ur/.agents/skills/testing-course-samples/SKILL.md