בנה, בדוק ופרוס סוכני בינה מלאכותית לשירות הסוכנים של Microsoft Foundry Agent Service כסוכנים Hosted Agents — הכל ישירות מ־VS Code בעזרת ההרחבה Microsoft Foundry ו־Foundry Toolkit.
Hosted Agents נמצאים כרגע בבטא. האזורים הנתמכים מוגבלים - ראה זמינות האזור.
התיקייה
agent/בכל מעבדה נוצרת אוטומטית על ידי ההרחבה Foundry — לאחר מכן אתה מתאים את הקוד, בודק מקומית, ומפרוס.
Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Estonian | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Kannada | Khmer | Korean | Lithuanian | Malay | Malayalam | Marathi | Nepali | Nigerian Pidgin | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Tamil | Telugu | Thai | Turkish | Ukrainian | Urdu | Vietnamese
מעדיף לשכפל מקומית?
מאגר זה כולל 50+ תרגומים בשפות שמגדילים משמעותית את גודל ההורדה. כדי לשכפל בלי תרגומים, השתמש ב-sparse checkout:
Bash / macOS / Linux:
git clone --filter=blob:none --sparse https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git cd Foundry_Toolkit_for_VSCode_Lab git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'CMD (Windows):
git clone --filter=blob:none --sparse https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git cd Foundry_Toolkit_for_VSCode_Lab git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"כך תקבל את כל מה שצריך כדי להשלים את הקורס במהירות הורדה גבוה.
flowchart TB
subgraph Local["פיתוח מקומי (VS Code)"]
direction TB
FE["Microsoft Foundry
Extension"]
FoundryToolkit["Foundry Toolkit
Extension"]
Scaffold["Scaffolded Agent Code
(main.py · agent.yaml · Dockerfile)"]
Inspector["Agent Inspector
(Local Testing)"]
FE -- "Create New
Hosted Agent" --> Scaffold
Scaffold -- "ניפוי שגיאות F5" --> Inspector
FoundryToolkit -.- Inspector
end
subgraph Cloud["Microsoft Foundry"]
direction TB
ACR["Azure Container
Registry"]
AgentService["Foundry Agent Service
(Hosted Agent Runtime)"]
Model["Azure OpenAI
(gpt-4.1 / gpt-4.1-mini)"]
Playground["Foundry Playground
& VS Code Playground"]
ACR --> AgentService
AgentService -- "/responses API" --> Model
AgentService --> Playground
end
Scaffold -- "Deploy
(Docker build + push)" --> ACR
Inspector -- "POST /responses
(localhost:8088)" --> שלד
Playground -- "בדוק בקשות" --> AgentService
style Local fill:#f0f4ff,stroke:#4a6cf7,stroke-width:2px
style Cloud fill:#fff4e6,stroke:#f59e0b,stroke-width:2px
זרימה: הרחבת Foundry יוצרת את הסוכן → אתה מתאים קוד והוראות → בודק מקומית עם Agent Inspector → מפרוס ל־Foundry (תמונת Docker נדחפת ל-ACR) → מאמת ב-Playground.
| מעבדה | תיאור | מצב |
|---|---|---|
| מעבדה 01 - סוכן יחיד | בנה את סוכן ה־"הסבר כאילו אני מנהל בכיר", בדוק מקומית ופרוס ל־Foundry | ✅ זמין |
| מעבדה 02 - זרימת עבודה רב-סוכנים | בנה את ה־"מגיש קורות חיים → מעריך התאמת משרה" – 4 סוכנים עובדים יחד כדי לדרג התאמת קורות חיים וליצור מפת דרכים ללמידה | ✅ זמין |
בסדנה זו תבנה את סוכן ה־"הסבר כאילו אני מנהל בכיר" — סוכן AI שלוקח ז'רגון טכני מסובך ומתרגם אותו לסיכומים שקטים ומוכנים לחדר ישיבות. כי בוא נהיה כנים, אף אחד מבכירות ההנהלה לא רוצה לשמוע על "מיצוי מאגר תהליכים בגלל קריאות סינכרוניות שהוכנסו בגרסה 3.2."
בניתי את הסוכן הזה אחרי יותר מדי מקרים שבהם הפוסט-מורטם המושלם שלי קיבל את התגובה: "אז… האתר קרס או לא?"
אתה מזין עדכון טכני. הסוכן מחזיר סיכום מנהלים — שלוש נקודות מפתח, בלי ז'רגון, בלי עקבות שגיאה, בלי פחד קיומי. רק מה קרה, השפעה עסקית, והצעד הבא.
אתה אומר:
"השהיית ה-API עלתה בגלל מיצוי מאגר תהליכים שנגרם מקריאות סינכרוניות שהוכנסו בגרסה 3.2."
הסוכן עונה:
סיכום מנהלים:
- מה קרה: לאחר השחרור האחרון, המערכת האטה.
- השפעה עסקית: חלק מהמשתמשים חוו עיכובים בזמן השימוש בשירות.
- הצעד הבא: השינוי בוטל ומתכוננת תיקון לפני הפריסה מחדש.
זה סוכן פשוט, חד-תכליתי — מושלם ללמידת תהליך זרימת העבודה של סוכן Hosted מקצה לקצה בלי להסתבך בשרשראות כלים מורכבות. וכנות? כל צוות הנדסה יכול להרוויח אחד כזה.
📂 Foundry_Toolkit_for_VSCode_Lab/
├── 📄 README.md ← You are here
└── 📂 workshop/
├── 📂 lab01-single-agent/ ← Full lab: docs + agent code
│ ├── README.md ← Hands-on lab instructions
│ ├── 📂 docs/ ← Step-by-step tutorial modules
│ │ ├── 00-prerequisites.md
│ │ ├── 01-setup.md
│ │ ├── 02-create-hosted-agent.md
│ │ ├── 03-configure-and-code.md
│ │ ├── 04-test-locally.md
│ │ ├── 05-deploy-to-foundry.md
│ │ ├── 06-verify-in-playground.md
│ │ ├── 07-summary.md
│ │ └── 08-troubleshooting.md
│ └── 📂 agent/ ← Reference solution (auto-scaffolded by Foundry extension)
│ ├── agent.yaml
│ ├── Dockerfile
│ ├── main.py
│ └── requirements.txt
└── 📂 lab02-multi-agent/ ← Resume → Job Fit Evaluator
├── README.md ← Hands-on lab instructions (end-to-end)
├── 📂 docs/ ← Step-by-step tutorial modules
│ ├── 00-prerequisites.md
│ ├── 01-understand-multi-agent.md
│ ├── 02-scaffold-multi-agent.md
│ ├── 03-configure-agents.md
│ ├── 04-orchestration-patterns.md
│ ├── 05-test-locally.md
│ ├── 06-deploy-to-foundry.md
│ ├── 07-verify-in-playground.md
│ └── 08-troubleshooting.md
└── 📂 PersonalCareerCopilotCompleted/ ← Reference solution (multi-agent workflow)
├── agent.yaml
├── Dockerfile
├── main.py
└── requirements.txt
הערה: התיקייה
agent/בתוך כל מעבדה היא מה שההרחבה Microsoft Foundry יוצרת כשמריציםMicrosoft Foundry: Create a New Hosted Agentמפלטת הפקודות. קבצים אלו מותאמים לאחר מכן עם ההוראות, הכלים וההגדרות של הסוכן שלך. מעבדה 01 מלווה אותך בתהליך בניית זה מאפס.
git clone https://github.com/microsoft-foundry/Foundry_Toolkit_for_VSCode_Lab.git
cd Foundry_Toolkit_for_VSCode_Labpython -m venv venvהפעל אותה:
- Windows (PowerShell):
.\venv\Scripts\Activate.ps1
- macOS / Linux:
source venv/bin/activate
pip install -r workshop/lab01-single-agent/agent/requirements.txtהעתק את קובץ הדוגמה .env שבתיקיית הסוכן ומלא את הערכים שלך:
cp workshop/lab01-single-agent/agent/.env.example workshop/lab01-single-agent/agent/.envערוך את הקובץ workshop/lab01-single-agent/agent/.env:
AZURE_AI_PROJECT_ENDPOINT=https://<your-account>.services.ai.azure.com/api/projects/<your-project>
AZURE_AI_MODEL_DEPLOYMENT_NAME=<your-model-deployment-name>כל מעבדה היא עצמאית עם המודולים שלה. התחל עם מעבדה 01 ללמידת היסודות, ואז עבור ל־מעבדה 02 לזרימות עבודה רב-סוכנים.
מעבדה 01 - סוכן יחיד (הוראות מלאות)
| # | מודול | קישור |
|---|---|---|
| 1 | קריאת דרישות מוקדמות | 00-prerequisites.md |
| 2 | התקנת Foundry Toolkit וההרחבה Foundry | 01-setup.md |
| 3 | יצירת פרויקט Foundry | 01-setup.md |
| 4 | יצירת סוכן Hosted | 02-create-hosted-agent.md |
| 5 | הגדרת הוראות וסביבה | 03-configure-and-code.md |
| 6 | בדיקה מקומית | 04-test-locally.md |
| 7 | פריסה ל־Foundry | 05-deploy-to-foundry.md |
| 8 | אימות ב־playground | 06-verify-in-playground.md |
| 9 | פתרון בעיות | 08-troubleshooting.md |
מעבדה 02 - זרימת עבודה רב-סוכנים (הוראות מלאות)
| # | מודול | קישור |
|---|---|---|
| 1 | דרישות מוקדמות (מעבדה 02) | 00-prerequisites.md |
| 2 | הבנת ארכיטקטורת רב-סוכנים | 01-understand-multi-agent.md |
| 3 | יצירת פרויקט רב-סוכנים | 02-scaffold-multi-agent.md |
| 4 | קביעת הגדרות הסוכנים והסביבה | 03-configure-agents.md |
| 5 | תבניות ארכיטקטורה | 04-orchestration-patterns.md |
| 6 | בדיקה מקומית (רב-סוכנים) | 05-test-locally.md |
| 7 | פריסה ל-Foundry | 06-deploy-to-foundry.md | | 8 | אימות ב-playground | 07-verify-in-playground.md | | 9 | פתרון בעיות (רב-סוכנים) | 08-troubleshooting.md |
 שיוואם גויאל |
| תרחיש | תפקידים נדרשים |
|---|---|
| יצירת פרויקט Foundry חדש | בעלים של Azure AI על משאב Foundry |
| פריסה לפרויקט קיים (משאבים חדשים) | בעלים של Azure AI + משתתף במנוי |
| פריסה לפרויקט שהוגדר במלואו | קורא בחשבון + משתמש Azure AI בפרויקט |
חשוב: תפקידי
בעליםומשתתףשל Azure כוללים רק הרשאות ניהול, לא הרשאות פיתוח (פעולת נתונים). אתה צריך משתמש Azure AI או בעלים של Azure AI על מנת לבנות ולפרוס סוכנים.
- התחלה מהירה: פריסה של הסוכן המתארח הראשון שלך (VS Code)
- מהם סוכנים מתארחים?
- יצירת זרמי עבודה לסוכנים מתארחים ב-VS Code
- פריסה של סוכן מתארח
- RBAC עבור Microsoft Foundry
- דוגמת סוכן לסקירת ארכיטקטורה - סוכן מתארח מעשי עם כלי MCP, דיאגרמות Excalidraw, ופריסה כפולה
כתב ויתור: מסמך זה תורגם באמצעות שירות תרגום אוטומטי Co-op Translator. למרות שאנו שואפים לדיוק, יש לקחת בחשבון שתרגומים אוטומטיים עלולים להכיל שגיאות או אי-דיוקים. יש להחשיב את המסמך המקורי בשפתו הטבעית כמקור הסמכות. למידע קריטי מומלץ להשתמש בתרגום מקצועי על ידי מתרגם אדם. אנו לא אחראים לכל אי-הבנה או פירוש שגוי הנובע מהשימוש בתרגום זה.