Deploying Scalable Agents Microsoft

---
name: deploying-scalable-agents
description: "فعّل هذه المهارة عندما يرغب المتعلم في: - نشر وكيل على Microsoft Foundry كـ وكيل مستضاف وجعله قابلًا للإصدار والملاحظة. - الاختيار بين أنماط النشر المستضافة على العميل، الوكيل المستضاف، وتدفق عمل الوكيل. - إضافة توجيه النموذج، تخزين الاستجابات مؤقتًا، أو التزامن المحدود للتحكم في زمن الاستجابة والتكلفة. - إضافة بوابة تقييم حتى لا يتم شحن نسخة وكيل سيئة. - إضافة خطوة موافقة بشرية في الحلقة للإجراءات عالية المخاطر."
category: ai-agents-and-harness
source_repo: microsoft/ai-agents-for-beginners
source_path: "translations/ar/.agents/skills/deploying-scalable-agents/SKILL.md"
source_url: https://github.com/microsoft/ai-agents-for-beginners/blob/HEAD/translations/ar/.agents/skills/deploying-scalable-agents/SKILL.md
---
# نشر عوامل قابلة للتوسع باستخدام Microsoft Foundry

> مهارة مرافق لدروس [الدرس 16 – نشر عوامل قابلة للتوسع](../../../16-deploying-scalable-agents/README.md).
> استخدمها لمساعدة المتعلم على نقل وكيل من النموذج الأولي إلى نشر إنتاجي قابل للتوسع وقابل للملاحظة.
> استند إلى كل توصية على محتوى الدرس ودفتر الملاحظات القابل للتشغيل؛ لا تخترع واجهات برمجة تطبيقات Foundry.


## المحفزات

فعّل هذه المهارة عندما يرغب المتعلم في:
- نشر وكيل على Microsoft Foundry كـ **وكيل مستضاف** وجعله قابلًا للإصدار والملاحظة.
- الاختيار بين أنماط النشر **المستضافة على العميل، الوكيل المستضاف، وتدفق عمل الوكيل**.
- إضافة **توجيه النموذج**، **تخزين الاستجابات مؤقتًا**، أو **التزامن المحدود** للتحكم في زمن الاستجابة والتكلفة.
- إضافة **بوابة تقييم** حتى لا يتم شحن نسخة وكيل سيئة.
- إضافة خطوة **موافقة بشرية في الحلقة** للإجراءات عالية المخاطر.
- تجهيز وكيل بـ **OpenTelemetry** للتتبع من أجل الملاحظة في الإنتاج.
- إجراء **اختبار دخان** لوكيل تم نشره كحاجز سريع بعد النشر.

## النموذج الذهني الأساسي

الوكيل الإنتاجي هو في الغالب الهيكل التشغيلي *حول* النموذج (~80%),
وليس النموذج نفسه. اربط كل توصية بأحد هذه المخاوف:

| القلق | من النموذج الأولي → الإنتاج |
|---------|------------------------|
| الاستضافة | دفتر ملاحظات → خدمة مستضافة ومُصدّرة |
| الهوية | تسجيل دخول `az` الخاص بك → هوية مُدارة + التحكم في الوصول المبني على الدور (RBAC) محدد النطاق |
| الحالة | في الذاكرة → تخزين الموضوع/الذاكرة خارجي |
| الفشل | تتبع الأخطاء → إعادة المحاولة، الارتداد، التنبيهات |
| التكلفة | "بضع سنتات" → تتبع، توجيه، تخزين مؤقت، ميزانية |
| الجودة | التحقق البصري → بوابة تقييم آلية |
| الثقة | أنت توافق → سياسة + بشري في الحلقة |

## أنماط النشر (اختر واحدًا، أو دمج)

1. **مستضاف على العميل** — حلقة التفكير تعمل في عمليتك. تحكم كامل؛ تمتلك التوسع/الحالة.
2. **وكيل مستضاف (خدمة وكيل Foundry)** — تستضيف Foundry الحلقة، تخزن المواضيع، تفرض RBAC/سلامة المحتوى، تعرض الوكيل في البوابة. تحكم أقل، سطح تشغيلي أقل بكثير.
3. **تدفق عمل الوكيل** — عدة وكلاء/أدوات مركبة في رسم بياني مع تفرعات، وعقد موافقة، ونقاط تحقق دائمة.

## دورة الحياة (الحلقة التي تشحن الوكيل)

`إنشاء → إصدار → تقييم (بوابة) → نشر مستضاف → الملاحظة عبر الإنترنت → جمع حالات الفشل → تكرار`.
**التقييم غير المتصل بوابة، وليس فكرة لاحقة** — لا يتم شحن نسخة
ما لم تتجاوز العتبة. تغذي الملاحظة عبر الإنترنت حالات الفشل الحقيقية
مرة أخرى في مجموعة الاختبار غير المتصلة.

## روافع التوسع والتكلفة (حسب الأولوية)

1. **اختيار الحجم المناسب للنموذج** — استخدم أصغر نموذج يجتاز بوابة التقييم.
2. **التوجيه حسب التعقيد** — نموذج صغير/سريع للطلبات البسيطة، نموذج كبير للتفكير الحقيقي (مصنف بنفسك أو موجه نموذج Foundry).
3. **التخزين المؤقت** — تقديم طلبات شبه مكررة بدون استدعاء النموذج.
4. **تصميم بلا حالة + تزامن محدود** — احتفظ بالحالة خارجيًا؛ أعد المحاولة مع تراجع تدريجي.

## الأنماط الرئيسية لإعادة إنتاجها

وجه المتعلم إلى ما يلي من دفتر الملاحظات
[`16-python-agent-framework.ipynb`](../../../16-deploying-scalable-agents/code_samples/16-python-agent-framework.ipynb):

- **معالج الطلب**: تخزين مؤقت → توجيه حسب التعقيد → تتبع النطاق → تشغيل → تخزين مؤقت.
- **بوابة التقييم**: تقييم مجموعة اختبار غير متصلة؛ إرجاع `pass_rate >= threshold` ولا تنشر إلا إذا كان صحيحًا.
- **موافقة بشرية**: `@tool(approval_mode="always_require")` لإجراءات مثل استرداد مبالغ كبيرة.
- **التتبع**: غلف كل طلب في `tracer.start_as_current_span(...)` واضبط الخصائص مثل `routed.model`، `customer.id`.

## اختبار دخان لوكيل تم نشره

بعد النشر، تحقق من أن نقطة النهاية تجيب فعليًا (قد يكون نشر أخضر
صامتًا). استخدم إجراء [اختبار دخان AI](https://github.com/marketplace/actions/ai-smoke-test)
عبر [`.github/workflows/smoke-test.yml`](../../../../../.github/workflows/smoke-test.yml)
مع الكتالوج في [`tests/`](../../../tests/README.md). يرسل المشغل كل
مطالبة إلى `POST {project_endpoint}/agents/{agent_name}/endpoint/protocols/openai/responses`
ويتحقق من نص الرد. تحتاج الهوية إلى دور **مستخدم AI لـ Azure** في
نطاق مشروع Foundry؛ يجب أن يكون جمهور الرمز `https://ai.azure.com/`.

قم بتراكب البوابات: **اختبار دخان** (الوصول/الاستجابة، في كل نشر) → **تقييم غير متصل**
(جيد بما يكفي للشحن، قبل الترقية) → **تقييم عبر الإنترنت** (كيف
يعمل في الميدان، مستمر).

## ضوابط المؤسسة

- **RBAC**: امنح كل وكيل مستضاف هوية مُدارة بأقل الامتيازات.
- **MCP في الإنتاج**: عامل كل خادم MCP كحدود غير موثوق بها — ثبت الإصدار، حدد هويته، تحقق من المخرجات، حد من المعدل، لا تكشف الأسرار أبدًا.

## حواجز السلامة للمساعد

- فضل النمط الكنسي `FoundryChatClient(...)` + `provider.as_agent(...)` المستخدم في جميع أنحاء الدورة.
- لا تعد بنتائج Azure الحية التي لم تتحقق منها؛ أوصِ باستخدام سير عمل اختبار الدخان لتأكيد النشر.
- حافظ على ربط نصيحة التقييم والتكلفة معًا: التقييم يحدد الحد الأدنى للجودة، والتوجيه/التخزين المؤقت يحافظ على التكلفة بالقرب من هذا الحد الأدنى.

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**تنويه**:
تمت ترجمة هذا المستند باستخدام خدمة الترجمة بالذكاء الاصطناعي [Co-op Translator](https://github.com/Azure/co-op-translator). بينما نسعى للدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الرسمي والمعتمد. للمعلومات الهامة، يُنصح بالاستعانة بترجمة بشرية محترفة. نحن غير مسؤولين عن أي سوء فهم أو تفسير ناتج عن استخدام هذه الترجمة.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

---

**Source:** [`microsoft/ai-agents-for-beginners`](https://github.com/microsoft/ai-agents-for-beginners) → `translations/ar/.agents/skills/deploying-scalable-agents/SKILL.md`