בנו, בדקו ופרסמו סוכני בינה מלאכותית ל-Microsoft Foundry Agent Service כ-סוכנים מתארחים - הכל מתוך VS Code באמצעות תוסף Microsoft Foundry ו-Foundry Toolkit.
סוכנים מתארחים נמצאים כרגע במצב תצוגה מוקדמת. האזורים הנתמכים מוגבלים - ראה זמינות אזור.
תיקיית
agent/בתוך כל מעבדה נוצרת באוטומציה על ידי תוסף Foundry - לאחר מכן אתה מתאים את הקוד, בודק מקומית ומפרסם.
ערבית | בנגלית | בולגרית | בורמזית (מיאנמר) | סינית (מפושטת) | סינית (מסורתית, הונג קונג) | סינית (מסורתית, מקאו) | סינית (מסורתית, טייוואן) | קרואטית | צ'כית | דנית | הולנדית | אסטונית | פינית | צרפתית | גרמנית | יוונית | עברית | הינדית | הונגרית | אינדונזית | איטלקית | יפנית | קאנדה | חמרית | קוריאנית | ליטאית | מלאית | מלאלאית | מרטהית | נפאלית | פיג'ין ניגרית | נורווגית | פרסית (פרסי) | פולנית | פורטוגזית (ברזיל) | פורטוגזית (פורטוגל) | פונג'אבית (ג'ורמוכי) | רומנית | רוסית | סרבית (קירילית) | סלובקית | סלובנית | ספרדית | סווויהילי | שוודית | טגלוג (פיליפינית) | טמילית | טלוגו | תאית | טורקית | אוקראינית | אורדו | ויאטנמית
מעדיף לשכפל מקומית?
מאגר זה כולל יותר מ-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"]
FoundryToolkit["תוסף Foundry Toolkit"]
Scaffold["קוד סוכן מסודר
(main.py · agent.yaml · Dockerfile)"]
Inspector["בודק סוכן
(בדיקות מקומיות)"]
FE -- "צור סוכן חדש
מתארח" --> Scaffold
Scaffold -- "ניפוי שגיאות F5" --> Inspector
FoundryToolkit -.- Inspector
end
subgraph Cloud["Microsoft Foundry"]
direction TB
ACR["מרשם מכולות Azure"]
AgentService["שירות סוכן Foundry
(סביבת הרצת סוכן מתארח)"]
Model["Azure OpenAI
(gpt-4.1 / gpt-4.1-mini)"]
Playground["מגרש משחקים Foundry
& מגרש משחקים VS Code"]
ACR --> AgentService
AgentService -- "/responses API" --> Model
AgentService --> Playground
end
Scaffold -- "פריסה
(בניית Docker + דחיפה)" --> ACR
Inspector -- "POST /responses
(localhost:8088)" --> Scaffold
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 סוכנים משתפים פעולה לדירוג התאמת קורות החיים וליצירת מסלול למידה | ✅ זמין |
בסדנה זו תבנה את ה-"הסבר כאילו אני מנהל בכיר" - סוכן בינה מלאכותית שלוקח מונחים טכניים מסובכים ומתרגם אותם לסיכומים רגועים, מתאימים לחדר ישיבות. כי בואו נהיה כנים, אף אחד ברמת המנהלים לא רוצה לשמוע על "התשה של Thread Pool שנגרמה מקליטות סינכרוניות שהוכנסו בגרסה v3.2."
בניתי את הסוכן הזה אחרי יותר מדי מקרים שבהם הפוסט-מורמתי שהכנתי היטב קיבל את התגובה: "אז... האם האתר לא עובד או כן?"
אתה מזין עדכון טכני. הסוכן מחזיר סיכום מנהלים - שלוש נקודות, בלי ז'רגון, בלי עקבות שרת, בלי ייאוש קיומי. פשוט מה קרה, השפעה עסקית, ו-השלב הבא.
אתה אומר:
"השהיית ה-API עלתה עקב התשה של thread pool שנגרמה מקליטות סינכרוניות שהוכנסו בגרסה v3.2."
הסוכן משיב:
סיכום מנהלים:
- מה קרה: אחרי העדכון האחרון, המערכת התעכבה.
- השפעה עסקית: חלק מהמשתמשים חוו עיכובים בעת השימוש בשירות.
- השלב הבא: השינוי בוטל ותיקון מוכן לפני הפצה מחודשת.
זה סוכן פשוט, למטרות ספציפיות - מושלם ללמידה של תהליך העבודה של סוכן מתארח מקצה לקצה בלי להסתבך בשרשראות כלים מורכבות. וכנות? כל צוות הנדסה היה יכול להשתמש באחד כזה.
📂 Foundry_Toolkit_for_VSCode_Lab/
├── 📄 README.md ← You are here
├── 📂 ExecutiveAgent/ ← Standalone hosted agent project
│ ├── agent.yaml
│ ├── Dockerfile
│ ├── main.py
│ └── requirements.txt
└── 📂 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-install-foundry-toolkit.md
│ │ ├── 02-create-foundry-project.md
│ │ ├── 03-create-hosted-agent.md
│ │ ├── 04-configure-and-code.md
│ │ ├── 05-test-locally.md
│ │ ├── 06-deploy-to-foundry.md
│ │ ├── 07-verify-in-playground.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
└── 📂 PersonalCareerCopilot/ ← 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הפעל אותה:
- ווינדוס (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>
MODEL_DEPLOYMENT_NAME=<your-model-deployment-name>כל מעבדה היא עצמאית עם המודולים שלה. התחל עם מעבדה 01 כדי ללמוד את היסודות, ואז המשך ל-מעבדה 02 לתהליכי עבודה מרובי סוכנים.
מעבדה 01 - סוכן יחיד (הוראות מלאות)
| # | מודול | קישור |
|---|---|---|
| 1 | קרא את דרישות המערכת | 00-prerequisites.md |
| 2 | התקן את Foundry Toolkit ותוסף Foundry | 01-install-foundry-toolkit.md |
| 3 | צור פרויקט Foundry | 02-create-foundry-project.md |
| 4 | צור סוכן מתארח | 03-create-hosted-agent.md |
| 5 | הגדר הוראות וסביבה | 04-configure-and-code.md |
| 6 | בדוק מקומית | 05-test-locally.md |
| 7 | פרסם ל-Foundry | 06-deploy-to-foundry.md |
| 8 | אמת ב-playground | 07-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 | אימות בשדה המשחק | 07-verify-in-playground.md |
| 9 | פתרון בעיות (מספר סוכנים) | 08-troubleshooting.md |
 שיוואם גואיאל |
| תרחיש | תפקידים נדרשים |
|---|---|
| יצירת פרויקט Foundry חדש | Azure AI Owner על משאב Foundry |
| פריסה לפרויקט קיים (משאבים חדשים) | Azure AI Owner + Contributor במנוי |
| פריסה לפרויקט מכוון במלואו | Reader על חשבון + Azure AI User על הפרויקט |
חשוב: תפקידי
Ownerו-Contributorב-Azure כוללים רק הרשאות ניהול, לא הרשאות פיתוח (פעולות על נתונים). דרוש Azure AI User או Azure AI Owner לבניית סוכנים ופריסתם.
- התחלה מהירה: פריסת הסוכן המתארח הראשון שלך (VS Code)
- מהם סוכנים מתארחים?
- יצירת זרימות עבודה לסוכנים מתארחים ב-VS Code
- פריסת סוכן מתארח
- RBAC עבור Microsoft Foundry
- דוגמת סוכן לסקירת ארכיטקטורה - סוכן מתארח ממוחשב עם כלי MCP, דיאגרמות Excalidraw, ופריסת כפולה
כתב ויתור: מסמך זה תורגם באמצעות שירות התרגום בינה מלאכותית Co-op Translator. למרות שאנו שואפים לדיוק, יש לזכור כי תרגומים אוטומטיים עלולים להכיל שגיאות או אי דיוקים. יש להתייחס למסמך המקורי בשפתו המקורית כמקור הסמכותי. למידע קריטי מומלץ תרגום מקצועי על ידי אדם. אנו לא נושאים באחריות לכל אי הבנות או פרשנויות שגויות הנובעות משימוש בתרגום זה.