قم ببناء، اختبار، ونشر وكلاء الذكاء الاصطناعي إلى خدمة وكلاء Microsoft Foundry كـ وكلاء مستضافين - كل ذلك من خلال VS Code باستخدام امتداد Microsoft Foundry وFoundry Toolkit.
الوكلاء المستضافين حالياً في المرحلة التجريبية. المناطق المدعومة محدودة - انظر توفر المنطقة.
مجلد
agent/داخل كل مختبر يتم إنشاؤه تلقائياً بواسطة امتداد Foundry - ثم تقوم بتخصيص الكود، اختبار محليًا، ونشره.
العربية | البنغالية | البلغارية | البورمية (ميانمار) | الصينية (المبسطة) | الصينية (التقليدية، هونغ كونغ) | الصينية (التقليدية، ماكاو) | الصينية (التقليدية، تايوان) | الكرواتية | التشيكية | الدنماركية | الهولندية | الإستونية | الفنلندية | الفرنسية | الألمانية | اليونانية | العبرية | الهندية | الهنغارية | الإندونيسية | الإيطالية | اليابانية | الكانادية | الخميرية | الكورية | الليتوانية | الماليزية | المليالمية | الماراثية | النيبالية | البيجن النيجيرية | النرويجية | الفارسية (الفرسية) | البولندية | البرتغالية (البرازيل) | البرتغالية (البرتغال) | البنجابية (غيرموخي) | الرومانية | الروسية | الصربية (السيريلية) | السلوفاكية | السلوفينية | الإسبانية | السواحيلية | السويدية | التاغالوغية (الفلبينية) | التاميلية | التيلجو | التايلاندية | التركية | الأوكرانية | الأردية | الفيتنامية
تفضل الاستنساخ محليًا؟
يشمل هذا المستودع ترجمات بأكثر من 50 لغة مما يزيد بشكل كبير من حجم التنزيل. للاستنساخ بدون الترجمات، استخدم السحب الجزئي:
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 (ويندوز):
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["امتداد ميكروسوفت فاوندري"]
FoundryToolkit["امتداد مجموعة أدوات فاوندري"]
Scaffold["كود الوكيل المُهيكل
(main.py · agent.yaml · Dockerfile)"]
Inspector["مفتش الوكيل
(الاختبار المحلي)"]
FE -- "إنشاء وكيل مستضاف جديد" --> Scaffold
Scaffold -- "تصحيح F5" --> Inspector
FoundryToolkit -.- Inspector
end
subgraph Cloud["ميكروسوفت فاوندري"]
direction TB
ACR["سجل الحاويات أزور"]
AgentService["خدمة وكيل فاوندري
(وقت تشغيل الوكيل المستضاف)"]
Model["أزور أوبن إيه آي
(gpt-4.1 / gpt-4.1-mini)"]
Playground["ملعب فاوندري
وملعب VS Code"]
ACR --> AgentService
AgentService -- "/responses API" --> Model
AgentService --> Playground
end
Scaffold -- "نشر
(بناء ودفع دوكر)" --> 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 وكلاء يتعاونون لتقييم ملاءمة السيرة الذاتية وتوليد خارطة طريق تعليمية | ✅ متاح |
في هذه الورشة ستبني وكيل "اشرحه كأنني مسؤول تنفيذي" - وكيل ذكاء اصطناعي يحول المصطلحات التقنية المعقدة إلى ملخصات هادئة وجاهزة لمجلس الإدارة. لأنه بصراحة، لا أحد في المستوى التنفيذي يريد سماع "نفاد مجموعة الخيوط بسبب المكالمات المتزامنة التي أُدخلت في الإصدار 3.2."
بنيت هذا الوكيل بعد العديد من الحوادث التي تلقى فيها تقرير التحليل التفصيلي الرد: "هل الموقع متوقف أم لا؟"
تعطيه تحديثًا تقنيًا. يعيد لك ملخصًا تنفيذيًا - ثلاث نقاط، بدون مصطلحات فنية معقدة، لا تتبع الأخطاء، أو قلق وجودي. فقط ما حدث، تأثير العمل، والخطوة التالية.
أنت تقول:
"زادت كمون واجهة برمجة التطبيقات بسبب نفاد مجموعة الخيوط الناتج عن المكالمات المتزامنة التي أُدخلت في الإصدار 3.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 / لينكس:
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 | التحقق في الملعب | 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 على مورد Foundry |
| النشر في مشروع قائم (موارد جديدة) | مالك Azure AI + مساهم على الاشتراك |
| النشر في مشروع مهيأ بالكامل | قارئ على الحساب + مستخدم Azure AI على المشروع |
مهم: أدوار Azure
مالكومساهمتشمل فقط أذونات الإدارة، وليس أذونات التطوير (إجراءات البيانات). تحتاج إلى مستخدم Azure AI أو مالك Azure AI لبناء ونشر الوكلاء.
- البدء السريع: نشر وكيل مستضاف أول لك (VS Code)
- ما هي الوكلاء المستضافة؟
- إنشاء سير عمل وكيل مستضاف في VS Code
- نشر وكيل مستضاف
- إدارة الوصول القائمة على الأدوار في Microsoft Foundry
- مثال وكيل مراجعة العمارة - وكيل مستضاف واقعي مع أدوات MCP، ومخططات Excalidraw، ونشر مزدوج
إخلاء المسؤولية:
تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية Co-op Translator. بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الموثوق به. للمعلومات الهامة، يُنصح بالاعتماد على الترجمة البشرية المهنية. نحن غير مسؤولين عن أي سوء فهم أو تفسيرات خاطئة تنشأ عن استخدام هذه الترجمة.