إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
خدمة وكلاء فاوندري هي منصة مدارة لبناء ونشر وتوسيع وكلاء الذكاء الاصطناعي. استخدم أي إطار عمل، أي نموذج مدعوم من كتالوج نماذج Foundry، وواجهة برمجة تطبيقات الاستجابات كنقطة دخول واحدة.
أنت تختار مقدار المنصة التي تريدها:
- وكلاء المطالبات — قم بكتابة وكيل المطالبات في بوابة Foundry أو تعريفه باستخدام SDKs وREST، وتقوم Foundry بتشغيله لك. لا يوجد كود تطبيق للصيانة، ولا حوسبة للدفع، ولا حاويات أو حزم لتحسين أو توسيع أو تحديث.
- Hosted agents — اكتب كود وكيل الوكيل باستخدام Agent Framework، LangGraph، OpenAI Agents SDK، Anthropic Agent SDK، GitHub Copilot SDK، أو كودك الخاص، تغلفه كحاوية، ويسمح ل Foundry بتشغيله مع نقطة نهاية مدارة، وتكبير، وهوي، وقابلية للملاحظة.
هل لديك كود وكيل يعمل خارج Foundry؟ اتصل بواجهة برمجة التطبيقات Responses من عمليتك الحالية للحصول على نماذج Foundry وأدوات المنصة دون الحاجة لنقل الكود.
ما هو الوكيل؟
الوكيل هو تطبيق ذكاء اصطناعي يستخدم نموذجا من كتالوج نماذج Foundry لتحليل طلبات المستخدمين واتخاذ إجراءات مستقلة لتلبيتها. على عكس روبوت الدردشة البسيط الذي يولد فقط نصوصا، يمكن للوكيل استدعاء الأدوات، والوصول إلى البيانات الخارجية، واتخاذ قرارات عبر عدة خطوات لإتمام المهمة. في بعض الحالات، يعمل الوكلاء بدون واجهة دردشة على الإطلاق — يعملون بشكل مستقل في الخلفية، يتم تفعيله بواسطة أحداث النظام، لإنجاز المهام نيابة عن المستخدم أو المنظمة.
يجمع كل وكيل بين ثلاثة مكونات أساسية:
- النموذج: نموذج من كتالوج نماذج Foundry يوفر قدرات التفكير واللغة.
- التعليمات: حدد الأهداف، القيود، والسلوك. في Foundry، يمكن أن تكون التعليمات قائمة على التعليمات أو أن تكون مشفرة في وكيل مستضاف.
- الأدوات: توفر الوصول إلى البيانات أو الإجراءات، مثل البحث، عمليات الملفات، أو استدعاءات API.
خدمة الوكلاء من نظرة سريعة
| المكون | ما الذي تفعله |
|---|---|
| واجهة برمجة التطبيقات للردود | نقطة دخول واحدة لكل نوع من الوكلاء. يمنح أي إطار عمل أو عملية أو وقت تشغيل إلى نماذج Foundry بالإضافة إلى أدوات المنصة (البحث عن الملفات، مفسر الكود، الذاكرة، البحث على الويب، خوادم MCP). |
| وقت تشغيل العميل | المضيفون والمتوسعون يقدمون وكلاء الأوامر والوكلاء المستضافين. يدير المحادثات، واستدعاءات الأدوات، ودورة حياة الوكيل. |
| الأدوات | أدوات مدمجة تشمل البحث عبر الويب، والبحث عن الملفات، والذاكرة، ومفسر الكود، وخوادم MCP، والوظائف المخصصة. تشمل المصادقة المدارة بيانات الاعتماد المدارة من قبل الخدمة وتشغيلBehalf-Of (OBO). |
| النماذج | يعمل مع العديد من النماذج من كتالوج نماذج Foundry، مثل GPT-4o وLlama وDeepSeek. بدل النماذج دون تغيير رمز الوكيل. |
| قابلية الرصد | تتبع من البداية إلى النهاية، والمقاييس، وتكامل Application Insights مع المعلومات. شاهد كل قرار يتخذه وكيلك. |
| الهوية والأمان | هوية Microsoft Entra، RBAC، مرشحات المحتوى، وعزل الشبكة الافتراضية. ثقة على مستوى المؤسسات مبنية. |
| النشر | وكلاء الإصدارات، إنشاء نقاط نهاية مستقرة، ومشاركتها عبر Microsoft Teams وMicrosoft 365 Copilot وسجل وكلاء Entra. |
ابدأ مع الوكلاء
اختر طريقك بناء على ما تحاول القيام به:
- هل أنت جديد على الوكلاء؟ابدأ بوكيل التوجيه — أنشئ وكيلا في بوابة Foundry، اختر نموذجا، أرفق الأدوات، ثم استدعه من الكود. لا يوجد كود وقت تشغيل للكتابة أو الصيانة — Foundry يشغل الوكيل نيابة عنك.
- هل ترغب في بناء وكيل يعتمد على الشيفرة في Foundry؟نشر وكيل مستضاف — اكتب لوكيلك باستخدام إطار عمل الوكلاء، أو LangGraph، أو حزمة تطوير OpenAI Agents، أو كودك الخاص، وقم بتغليفه كحاوية، ودع Foundry يشغله مع نقطة نهاية مدارة، وتحجيم، وهوي.
- هل ترغب في استخدام نماذج وأدوات Foundry من كود وكيل تقوم بتشغيله بالفعل في أماكن أخرى؟اتصل بواجهة برمجة التطبيقات Responses من عمليتك الحالية للحصول على نماذج Foundry وأدوات المنصة دون الحاجة لنقل الكود.
أنواع الوكلاء
هناك نوعان رئيسيان من الوكلاء في خدمة الوكلاء:
- وكلاء المطالبات — المؤلف في البوابة أو الكود، وقت تشغيل مدار بالكامل.
- الوكلاء المستضافين — كود وكيلك، الذي تديره Foundry.
وكلاء التحفيز
يتم تعريف وكلاء الأوامر بالكامل من خلال التكوين — التعليمات، اختيار النماذج، والأدوات. تقوم بتأليفها في بوابة Foundry لبدء سريع، أو تحددها برمجيا باستخدام SDKs أو واجهة برمجة تطبيقات REST لتتكامل مع سير عمل CI/CD الخاص بك. في كلتا الحالتين، يدير Foundry الوكيل نيابة عنك — لا يوجد كود تطبيق يجب صيانته، ولا حوسبة تدفع مقابلها، ولا حاويات أو حزم لتحسين أو توسيع أو مراقبة الأمان.
هناك مساران للبدء:
- البوابة أولا — أنشئ وكيلا تفاعليا في بوابة Foundry، اختبره في الملعب، ثم استدعائه من كود التطبيق الخاص بك.
- الكود أولا — حدد الوكيل الذي يستخدم SDK أو واجهة برمجة التطبيقات REST في خط أنابيب النشر الخاص بك، مما يتيح التحكم في الإصدارات، ومراجعة الكود، والنشر الآلي.
الأفضل ل: البدء السريع، الأدوات الداخلية، وكلاء الإنتاج الذين لا يحتاجون إلى منطق تنسيق مخصص، والفرق التي تريد وقت تشغيل مدار بدون عبء بنية تحتية.
الوكلاء المستضافون
Hosted Agents هي وكلاء معتمدين على الشيفرة تعتمد على Agent Framework، LangGraph، OpenAI Agents SDK، Anthropic Agent SDK، GitHub Copilot SDK, أو قانونك الخاص. أرسل وكيل اللعبة إما كصورة حاوية أو كرمز بريد من كود المصدر — Foundry يبني الصورة لك عندما تحضر ملف مضغوط — ويشغل Foundry الصورة مع نقطة نهاية مدارة، وتحجيم تلقائي، وهوية Microsoft Entra مخصصة، واستمرارية حالة على مستوى الجلسة، وقابلية الملاحظة من البداية إلى النهاية.
في الخلف، يستدعي كود الوكيل الخاص بك <واجهة برمجة التطبيقات c0>Responses في نقطة نهاية مشروع Foundry الخاص بك لاستنتاج النماذج وتنسيق الأدوات، مما يمنحك الوصول إلى نماذج Foundry من الكتالوج ومجموعة موحدة من أدوات المنصة — أدوات OpenAI القياسية مثل البحث عن الملفات، مفسر الكود، والبحث على الويب، بالإضافة إلى أدوات حصرية ل Foundry مثل SharePoint. WorkIQ و Fabric IQ.
الأفضل ل: الوكلاء الذين يستدعون كودك المخصص الخاص؛ ثانيا، منطق التنسيق المخصص، أنظمة متعددة الوكلاء، وبروتوكولات مخصصة (webhooks، voice، AG-UI) حيث تريد التحكم الكامل في منطق الوكلاء مع السماح ل Foundry بإدارة الاستضافة، والتوسيع، والهوية.
إذا كنت تفضل الاستمرار في تشغيل كود الوكيل خارج Foundry — على سبيل المثال، مدمجا في تطبيق موجود — يمكنك الحصول على نماذج Foundry وأدوات المنصة الخاصة بها عن طريق استدعاء واجهة برمجة تطبيقات Responses مباشرة من عمليتك. انظر استخدام واجهة برمجة تطبيقات الاستجابات من كودك الخاص.
قارن أنواع الوكلاء
| وكلاء التحفيز | الوكلاء المستضافون | |
|---|---|---|
| سطح التأليف | Portal، SDK، أو REST | Agent Framework، LangGraph، OpenAI Agents SDK، Anthropic Agent SDK، GitHub Copilot SDK، كود مخصص |
| نماذج المسبك + أدوات المنصة | نعم | نعم (عبر واجهة برمجة تطبيقات الاستجابات على نقطة نهاية مشروع Foundry) |
| دعم المهارات | نعم | نعم |
| كود وقت التشغيل للصيانة | لا شيء | نعم — منطق وكيل الوكيل الخاص بك |
| الحساب للإدارة | لا شيء — تم التحكم فيه بالكامل | الحوسبة الحاوية، تدار بواسطة المصنع |
| نقطة نهاية مدارة | نعم | نعم |
| التحجيم التلقائي | أوتوماتيك، تدار من قبل المصنع؛ يتدرج مع حجم الطلب | أوتوماتيك، تدار من قبل المصنع؛ يقوم بمقياس نسخ الحاويات لكل جلسة وحجم الطلب |
| هوية الوكيل (إنترا) | نعم | أوتوماتيكي، مخصص لكل وكيل |
| نموذج التكلفة | الاستدلال لكل استدعاء + استخدام الأداة | الاستدلال لكل استدعاء + استخدام الأداة + حساب الحاوية |
| الأفضل ل | بداية سريعة، وكلاء إنتاج بدون تنسيق مخصص | وكلاء يستدعون إلى كود مخصص؛ ثانيا، منطق التوزيع المخصص |
استخدم واجهة برمجة التطبيقات Responses من كودك الخاص
واجهة برمجة تطبيقات الردود هي النموذج الوحيد ونقطة النهاية الوحيدة وراء كل نوع من الوكلاء. يمكنك استدعاؤها مباشرة من كودك الخاص للحصول على نماذج Foundry وأدوات المنصة دون إنشاء مورد وكيل في Foundry. هذا النمط إضافة إلى الوكلاء المستضافين وليس بديلا — يمكن لنفس كود إطار عمل الوكلاء استدعاء واجهة برمجة تطبيقات الاستجابات من عمليتك الخاصة اليوم ويتم تغليفه كوكيل مستضاف حاوية لاحقا عندما تريد نقطة نهاية تديرها Foundry.
انظر البدء السريع: استخدم واجهة برمجة تطبيقات الاستجابات لخيارات نقاط النهاية والعينات من البداية إلى النهاية.
دعم النماذج
تعمل خدمة الوكلاء مع العديد من النماذج المتوفرة في كتالوج نماذج Foundry. للاطلاع على القائمة الكاملة، انظر الحصص، الحدود، والدعم الإقليمي.
الأدوات
يوفر Agent Service أدوات مدمجة ويدعم أدوات مخصصة حتى يتمكن وكلائك من اتخاذ الإجراءات والوصول إلى البيانات. للحصول على قائمة كاملة، راجع كتالوج أدوات Foundry. لأنماط اختيار الأدوات المتقدمة، راجع أفضل ممارسات الأدوات.
يدعم Foundry خوادم MCP البعيدة التي يمكنك إضافتها من كتالوج Add Tools في بوابة Foundry. على سبيل المثال، يمكن إضافة خادم Azure DevOps MCP (المعاينة العامة) مباشرة من الكتالوج. قم بربط منظمة Azure DevOps الخاصة بك لتمكين وصول الوكلاء، وقم بتكوين مجموعة فرعية من الأدوات المتاحة للتحكم في الإجراءات التي يمكن للوكلاء تنفيذها. يمكنك أيضا توصيل خوادم MCP المخصصة المستضافة على دالات Azure باستخدام نقطة نهاية Webhook الخاصة ب Functions MCP (/runtime/webhooks/mcp) لعرض أدوات مخصصة لوكلائك.
تشمل خيارات المصادقة المدعومة لخوادم MCP واتصالات الأدوات الأخرى:
- الوصول القائم على المفاتيح
- Microsoft Entra (باستخدام هوية الوكيل المدارة أو هوية المشروع المدارة)
- تمرير هوية OAuth (أون-Behalf-Of)
- الوصول غير المصادق عليه، حيثما كان ذلك مناسبا
تنطبق هذه الخيارات أيضا عند توصيل خوادم MCP البعيدة، مع إدارة بيانات الاعتماد والنطاقات في تكوين الأداة.
صندوق الأدوات
يتيح لك Toolbox تحديد مجموعة أدوات مختارة مرة واحدة، وإدارتها مركزيا في Foundry، وعرضها من خلال نقطة نهاية متوافقة مع MCP. أي وكيل متوافق مع MCP يمكن أن يستهلك صندوق أدوات، بغض النظر عن الإطار الذي تستخدمه. إصدار Toolbox يمنحك تحكما صريحا في موعد حدوث التغييرات — أنشئ نسخة جديدة، اختبرها، وقم بترقيتها إلى الوضع الافتراضي عندما تكون مستعدا.
ملاحظة
بعض الأدوات، بما في ذلك الذاكرة والبحث على الويب، في وضع المعاينة. للاطلاع على التوفر حسب المنطقة وحالة المعاينة، راجع دعم الأدوات حسب المنطقة والنموذج.
دورة حياة التطوير
يدعم خدمة الوكيل سير العمل الكامل للبناء-الاختبار-النشر-المراقبة:
- إنشاء — حدد وكيل المطالبات في البوابة أو مع مجموعة تطوير البرمجيات، أو اكتب وكيل مستضاف يستدعي واجهة برمجة التطبيقات للاستجابات.
- الاختبار — تحدث مع وكيلك في ملعب الوكلاء أو قم بالعمل محليا. يمكن ممارسة تكاملات خوادم MCP، بما في ذلك خوادم MCP المخصصة المستضافة على دالات Azure، مباشرة في الملعب للتحقق من اتصال الأدوات، والأذونات، والسلوك قبل النشر.
- التتبع — افحص كل استدعاء نموذج، استدعاء أداة، وقرار باستخدام تتبع الوكيل.
- التقييم — قم بإجراء تقييمات لقياس الجودة واكتشاف الانحدارات.
- التحسين — قم تلقائيا بتحسين تعليمات وكيلك المستضاف باستخدام محسن الوكيل.
- النشر — قم بترقية وكيلك إلى مورد مدار بنقطة نهاية مستقرة.
- المراقبة — تتبع الأداء والموثوقية باستخدام مقاييس الخدمة ولوحات المعلومات.
للحصول على دليل مفصل، راجع دورة حياة تطوير الوكلاء.
قدرات المؤسسات
يوفر خدمة الوكلاء بنية تحتية على مستوى المؤسسة لكل وكيل تقوم بنشره:
- Agent identity — يمكن لكل وكيل أن يكون لديه هوية Microsoft Entra مخصصة، مما يتيح وصولا آمنا ومحدودا إلى الموارد وواجهات برمجة التطبيقات دون مشاركة بيانات الاعتماد. يمكن لهويات الوكلاء التحقق من صحتها على خوادم MCP الخارجية، بما في ذلك تلك المستضافة على دالات Azure، ويدعم تمرير OAuth On-Behalf-Of (OBO) عند التكوين.
- Private networking — شغل وكلاء داخل شبكتك الافتراضية Azure لعزل الشبكة بالكامل والامتثال لمتطلبات إقامة البيانات. الشبكات الخاصة متاحة لوكلاء الطلبات. يدعم الوكلاء المستضيفون الشبكة الافتراضية في Azure (BYO VNet) الذي يجلب لك الخاصية (Bring Your Own Virtual Network)، حيث تعمل كل جلسة في صندوق رمل معزول من الآلات الافتراضية متصل بجهاز VNet الخاص بك.
- التحكم في الوصول القائم على الأدوار — صلاحيات دقيقة عبر Microsoft Entra و Azure RBAC. التحكم في من يمكنه إنشاء واستدعاء وإدارة الوكلاء.
- سلامة المحتوى — تساعد مرشحات المحتوى المدمجة في تقليل مخاطر حقن الفوري (بما في ذلك الحقن المتقاطع) ومنع المخرجات غير الآمنة.
للحصول على تعليمات إعداد البيئة، راجع إعداد بيئتك.
النشر والمشاركة
توفر خدمة الوكلاء نظام الإصدار والنشر المدمجين حتى يتمكن وكلائك من الانتقال من التطوير إلى الإنتاج بثقة.
- الإصدار — أثناء تكرارك على وكيلك، يتم التقاط الإصدارات تلقائيا. قم بالعودة إلى أي إصدار سابق أو قارن التغييرات بين الإصدارات.
- النشر — ترقية وكيل إلى مورد مدار بنقطة نهاية مستقرة. يرث الوكلاء المنشورون هوية المؤسسة وضوابط الوصول المهيأة لمشروعك ويمكن استدعاؤهم برمجيا.
- Distribution — شارك الوكلاء المنشورين عبر Microsoft 365 Copilot وTeams وسجل وكلاء إنترا، مما يضع وكلائك في المكان الذي يعمل فيه مستخدموك بالفعل. تدعم خدمة وكلاء فاوندري بروتوكولات OpenResponses وActivity للنشر Microsoft 365، وبروتوكول Invics لدمج نقاط النهاية المرن مع التطبيقات والخدمات المخصصة، وبروتوكول A2A (المعاينة) للتواصل بين الوكيل.
الأمان والخصوصية والامتثال
تم تصميم خدمة الوكلاء لأحمال العمل المؤسسية حيث تحتاج إلى ضوابط قوية على الهوية، والشبكات، والتعامل مع البيانات، والسلامة.
- ضوابط السلامة: استخدم حواجز حماية مدمجة للمساعدة في تقليل المخارج غير الآمنة والتقليل من مخاطر الحقن الفوري، بما في ذلك هجمات الحقن المتقاطعة (XPIA).
- عزل الشبكة وضوابط إقامة البيانات: استخدم الشبكات الافتراضية وجلب مواردك الخاصة لتلبية متطلباتك.
- أحضر مواردك الخاصة: استخدم مواردك Azure الخاصة (مثل التخزين، البحث باستخدام الذكاء الاصطناعي في Azure، و Azure Cosmos DB لحالة المحادثة) لتلبية احتياجات الامتثال والتشغيل. انظر: استخدم مواردك الخاصة.
- إرشادات الذكاء الاصطناعي المسؤول: للحصول على مجموعة أوسع من التوصيات وموارد الحوكمة، انظر الذكاء الاصطناعي المسؤول ل Microsoft Foundry.
محتوى ذو صلة
- جهز بيئتك
- دورة حياة تطوير الوكيل
- نشر أول وكيل مستضاف لك
- كتالوج الأدوات
- الحصص، الحدود، والدعم الإقليمي
- للحصول على المساعدة أو للتواصل مع المجتمع، انضم إلى Microsoft على ديسكورد.