إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
يعرض Foundry MCP Server 38 أدوات عبر 10 فئات تتيح لك إدارة الوكلاء ومجموعات البيانات والتقييمات وتوزيع النماذج والمزيد — كل ذلك من خلال مطالبات المحادثة بدلا من استدعاءات واجهة برمجة التطبيقات. استخدم هذا المرجع لاستكشاف كل أداة وتجربة مطالبات المثال في project الخاصة بك.
نصيحة
قبل استخدام هذه الأدوات، أكمل إعداد خادم Foundry MCP.
ملاحظة
تُعد هذه الميزة قيد الإصدار الأولي العام في الوقت الحالي. يتم توفير هذه المعاينة دون اتفاقية على مستوى الخدمة، ولا نوصي بها لأحمال عمل الإنتاج. بعض الميزات ربما لا تكون مدعمة أو بها بعض القدرات المقيدة. لمزيد من المعلومات، راجع شروط الاستخدام Supplemental لمعاينات Microsoft Azure.
كيفية عمل الأدوات
عند كتابة مطالبة اللغة الطبيعية في عميل متوافق مع MCP (على سبيل المثال، وضع عامل GitHub Copilot)، يحدد نموذج اللغة الأداة المناسبة ويصوغ المعلمات المطلوبة نيابة عنك. لا تستدعي الأدوات مباشرة — بل تصف ما تريده، ويترجم النموذج هدفك إلى استدعاء أداة.
يتم تصنيف كل أداة كمقروءة (استرداد المعلومات) أو الكتابة (إنشاء الموارد أو تحديثها أو حذفها). تؤثر عمليات الكتابة على الموارد المباشرة والفوترة على الفور. راجع أفضل ممارسات الأمان قبل تشغيل عمليات الكتابة.
الأذونات
يتم تشغيل جميع العمليات بأذونات المستخدم المصادق عليها من خلال تدفق معرف Microsoft Entra On-Behalf-Of. تحتاج إلى الأدوار التالية:
| نوع العملية | الحد الأدنى لدور Azure | الملاحظات |
|---|---|---|
| أدوات القراءة | قارئ على مشروع أو حساب Foundry | كافية للإدراج والاستعلام والمراقبة. |
| أدوات الكتابة | المساهم في مشروع أو حساب Foundry | مطلوب لإنشاء الموارد وتحديثها وحذفها. |
| مسؤول الوصول المشروط | مسؤول الوصول المشروط في معرف الإدخال | مطلوب فقط إذا كان تكوين نهج الوصول على مستوى المستأجر. |
لمزيد من المعلومات، راجع التحكم في الوصول القائم على الأدوار لمايكروسوفت فاوندري.
معرفات المفاتيح
تتطلب العديد من الأدوات معرفات الموارد. يستخرج نموذج اللغة هذه من سياق المطالبة، ولكنه يساعد على معرفة التنسيقات:
| المعرف | تنسيق | أين يمكن العثور عليها |
|---|---|---|
| معرف مورد الصب | /subscriptions/{sub_id}/resourceGroups/{rg}/providers/Microsoft.CognitiveServices/accounts/{account} |
صفحة خصائص مدخل Microsoft Azure |
| نقطة نهاية المشروع | https://{account}.services.ai.azure.com/api/projects/{project} |
صفحة تفاصيل Foundry project |
| معرف موارد Project | /subscriptions/{sub_id}/resourceGroups/{rg}/providers/Microsoft.CognitiveServices/accounts/{account}/projects/{project} |
صفحة خصائص مدخل Microsoft Azure |
إدارة الوكيل
إدارة دورة الحياة الكاملة للوكلاء في مشروع Foundry، بما في ذلك الإنشاء والاستدعاء وتنسيق الحاوية والحذف.
أمثلة على المطالبات:
- "سرد جميع العملاء في project Foundry الخاص بي."
- "إنشاء عامل جديد باسم
faq-agentباستخدام النموذجgpt-4o-mini." - "إرسال 'مرحبا، كيف يمكنك المساعدة؟' إلى .
customer-support-agent" - "ابدأ الحاوية للعامل
triage-agentالمستضاف." - "تحقق من حالة الحاوية ل
triage-agent." - "أظهر لي مخطط تعريف العامل للوكلاء المطالبين."
- "احذف
old-test-agentمن project."
| أداة | ولوج | الوصف | المدخلات الرئيسية | مرتجعات |
|---|---|---|---|---|
agent_get |
read | سرد جميع العوامل في مشروع Foundry، أو الحصول على عامل معين بالاسم. | اسم العامل (اختياري) | قائمة العامل أو تعريف عامل واحد مع النموذج والإرشادات وتكوين الأداة. |
agent_update |
write | إنشاء عامل أو تحديثه أو استنساخه. استخدم agent_definition_schema_get لاكتشاف مخطط التعريف الكامل أولا. |
اسم العامل والنموذج والإرشادات وتعريفات الأدوات | تعريف العامل الذي تم إنشاؤه أو تحديثه. |
agent_invoke |
write | إرسال رسالة إلى عامل والحصول على استجابة. يعمل لكل من عوامل الحاوية المستندة إلى المطالبة والمستضافة. | اسم العامل، نص الرسالة | رسالة استجابة العامل. |
agent_delete |
write | حذف عامل بشكل دائم. بالنسبة للوكلاء المستضافين، يؤدي هذا أيضا إلى حذف الحاوية. | اسم العامل | تأكيد الحذف. |
agent_container_control |
write | بدء تشغيل حاوية عامل مستضافة أو إيقافها. استخدم قبل استدعاء عامل مستضاف. | اسم العامل أو الإجراء (البدء أو الإيقاف) | حالة عملية الحاوية. |
agent_container_status_get |
read | تحقق من الحالة الحالية لحاوية عامل مستضاف (بدء تشغيل وإيقاف وفشل وما إلى ذلك). | اسم العامل | حالة الحاوية الحالية. |
agent_definition_schema_get |
read | إرجاع مخطط JSON الكامل لتعريفات العامل، بما في ذلك جميع أنواع الأدوات. | لا شيء | مخطط JSON الكامل لتعريفات العامل. |
إدارة مجموعة البيانات
إنشاء مجموعات بيانات تقييم واستردادها وإصدارها في مشروع Foundry.
أمثلة على المطالبات:
- "تحميل ميزة Q&8 دعم العملاء مجموعة بيانات من عنوان URL Azure Blob Storage هذا."
- "أظهر لي جميع مجموعات البيانات في مشروع Foundry الخاص بي."
- "احصل على تفاصيل الإصدار
customer-support-qa2 من مجموعة البيانات." - "سرد جميع إصدارات مجموعة البيانات الخاصة بي
product-reviews."
| أداة | ولوج | الوصف | المدخلات الرئيسية | مرتجعات |
|---|---|---|---|---|
evaluation_dataset_create |
write | إنشاء إصدار مجموعة بيانات أو تحديثه من Azure Blob Storage URI. | اسم مجموعة البيانات، الإصدار، Blob Storage URI | بيانات تعريف مجموعة البيانات بالاسم والإصدار وURI. |
evaluation_dataset_get |
read | احصل على مجموعة بيانات حسب الاسم والإصدار، أو قم بإدراج جميع مجموعات البيانات في project. | اسم مجموعة البيانات وإصدارها (اختياري) | تفاصيل مجموعة البيانات أو قائمة بجميع مجموعات البيانات. |
evaluation_dataset_versions_get |
read | سرد جميع إصدارات مجموعة بيانات معينة. | اسم مجموعة البيانات | قائمة بأرقام الإصدارات مع بيانات التعريف. |
عمليات التقييم
قم بتشغيل تقييمات الدفعات مقابل الوكلاء أو مجموعات البيانات، ومقارنة النتائج عبر عمليات التشغيل.
أمثلة على المطالبات:
- "قم بتقييم الإصدار 2 الخاص بي
customer-support-agentباستخدام مقيمي الصلة والأرضية والاتساق." - "قم بتشغيل تقييم دفعي على مجموعة بيانات JSONL الخاصة بي باستخدام مقيمي العنف و HateUnfairness."
- "إنشاء 50 استعلامات اختبار اصطناعية وتقييم وكيلي معهم."
- "أظهر لي جميع عمليات التقييم في مشروع Foundry الخاص بي."
- "مقارنة run-baseline-123 مقابل تشغيل العلاج run-124 وrun-125."
| أداة | ولوج | الوصف | المدخلات الرئيسية | مرتجعات |
|---|---|---|---|---|
evaluation_agent_batch_eval_create |
write | إنشاء تشغيل تقييم دفعي يستدعي وكيلا معينا. يدعم المقيمين المضمنين والمخصصين، بالإضافة إلى إنشاء البيانات الاصطناعية. | اسم/إصدار العامل، أسماء المقيمين، مجموعة البيانات (اختياري للتوليد الاصطناعي)، عدد الاستعلامات الاصطناعية (اختياري) | معرف تشغيل التقييم والحالة. |
evaluation_dataset_batch_eval_create |
write | إنشاء تقييم دفعي يتم تشغيله مقابل مجموعة بيانات JSONL. يدعم المقيمين المضمنين والمخصصين. | اسم/إصدار مجموعة البيانات، أسماء المقيمين | معرف تشغيل التقييم والحالة. |
evaluation_get |
read | يتم تشغيل تقييم القائمة في مشروع Foundry. | معرف تشغيل التقييم (اختياري) | يتم تشغيل قائمة التقييم بالحالة والنتائج، أو تفاصيل تشغيل معين. |
evaluation_comparison_create |
write | إنشاء نتائج مقارنة بين تشغيل تقييم الأساس والعلاج. | معرف تشغيل الأساس، معرفات تشغيل المعالجة | معرف تحليلات المقارنة. |
evaluation_comparison_get |
read | الحصول على رؤى مقارنة التقييم أو سردها. | معرف نتيجة تحليلات المقارنة (اختياري) | نتائج المقارنة مع التحليل الإحصائي. |
كتالوج المقيم
استعرض المقيمين المضمنين وقم بإدارة المقيمين المخصصين للاستخدام في عمليات تشغيل التقييم.
أمثلة على المطالبات:
- "سرد جميع المقيمين المضمنين المتوفرين في مشروعي."
- "أرني التعريف الكامل للمقيم
coherence." - "إنشاء مقيم مخصص قائم على المطالبة يسمى
tone-checkأن يسجل الاستجابات على مقياس 1-5." - "تحديث وصف المقيم الخاص بي
tone-check." - "حذف الإصدار 1 من .
old-evaluator"
| أداة | ولوج | الوصف | المدخلات الرئيسية | مرتجعات |
|---|---|---|---|---|
evaluator_catalog_get |
read | سرد المقيمين في الكتالوج، أو الحصول على التعريف الكامل لمقيم معين. تصفية حسب النوع المضمن أو المخصص. | اسم المقيم (اختياري)، عامل تصفية النوع (مضمن أو مخصص، اختياري) | قائمة المقيم أو تعريف المقيم الكامل مع منطق تسجيل النقاط. |
evaluator_catalog_create |
write | إنشاء مقيم مخصص يستند إلى المطالبة أو يستند إلى التعليمات البرمجية. | اسم المقيم، النوع (المطالبة أو التعليمات البرمجية)، التعريف | بيانات تعريف المقيم التي تم إنشاؤها. |
evaluator_catalog_update |
write | تحديث بيانات التعريف (اسم العرض والوصف والفئة) لمقيم مخصص موجود. | اسم المقيم، الحقول المراد تحديثها | بيانات تعريف المقيم المحدثة. |
evaluator_catalog_delete |
write | حذف إصدار معين من مقيم مخصص. | اسم المقيم، الإصدار | تأكيد الحذف. |
كتالوج النموذج والتفاصيل
استكشاف والحصول على تفاصيل حول النماذج في كتالوج نموذج Foundry.
أمثلة على المطالبات:
- "أظهر لي جميع نماذج GPT-5.4 المتوفرة في الكتالوج."
- "ضع قائمة بجميع النماذج المنشورة من قبل Microsoft مع ترخيص معهد ماساتشوستس للتكنولوجيا."
- "احصل على معلومات مفصلة وعينات من التعليمات البرمجية ل GPT-5-mini."
| أداة | ولوج | الوصف | المدخلات الرئيسية | مرتجعات |
|---|---|---|---|---|
model_catalog_list |
read | سرد النماذج من كتالوج نموذج Foundry باستخدام عوامل تصفية اختيارية (الناشر والترخيص والمهمة). | البحث عن الكلمات الأساسية والناشر ونوع الترخيص ونوع المهمة (كل ذلك اختياري) | قائمة النماذج ذات الاسم والناشر والترخيص والقدرات. |
model_details_get |
read | احصل على تفاصيل النموذج الكامل وعينات التعليمات البرمجية. | اسم النموذج أو معرفه | مواصفات النموذج والتسعير والمناطق المدعومة ونماذج التعليمات البرمجية. |
إدارة توزيع النموذج
توزيع عمليات نشر النموذج وفحصها وإزالتها في حساب Foundry.
أمثلة على المطالبات:
- "انشر GPT-5-mini كما هو الحال
production-chatbotمع 20 وحدة سعة." - "أرني جميع عمليات نشر النموذج الحالية."
- "احذف
old-test-deploymentالذي لم أعد أستخدمه."
| أداة | ولوج | الوصف | المدخلات الرئيسية | مرتجعات |
|---|---|---|---|---|
model_deploy |
write | إنشاء أو تحديث نشر نموذج بسعة محددة. | اسم النموذج، واسم التوزيع، ووحدات السعة | تفاصيل التوزيع مع نقطة النهاية والسعة المتوفرة. |
model_deployment_get |
read | احصل على نشر نموذج أو أكثر من حساب Foundry. | اسم النشر (اختياري) | قائمة عمليات التوزيع أو تفاصيل التوزيع الفردية مع الحالة والحصة النسبية. |
model_deployment_delete |
write | حذف نشر نموذج معين حسب الاسم. | اسم التوزيع | تأكيد الحذف. |
تحليلات النموذج والتوصيات
قارن معايير النموذج والحصول على توصيات للتبديل إلى نماذج أكثر فعالية من حيث التكلفة أو أعلى جودة.
أمثلة على المطالبات:
- "عرض البيانات المعيارية لجميع الطرز المتاحة."
- "مقارنة الأداء المرجعي بين GPT-5.4 وGPT-4."
- "ابحث عن نماذج مشابهة لنشر GPT-4 الحالي."
- "ما هي النماذج التي ستمنحني نسبة جودة / تكلفة أفضل مما أستخدمه الآن؟"
| أداة | ولوج | الوصف | المدخلات الرئيسية | مرتجعات |
|---|---|---|---|---|
model_benchmark_get |
read | جمع بيانات المعيار لنماذج Foundry. | عوامل تصفية النموذج (اختياري) | قياسات النقاط القياسية والدقة والتكلفة وزمن الانتقال. |
model_benchmark_subset_get |
read | احصل على بيانات معيارية لاسم طراز معين وأزواج إصدارات. | اسم النموذج وأزواج الإصدار | بيانات المقارنة المعيارية للنماذج المحددة. |
model_similar_models_get |
read | ابحث عن نماذج مماثلة استنادا إلى تفاصيل التوزيع أو النموذج. | اسم التوزيع أو اسم النموذج | قائمة النماذج المماثلة مع مقارنة القدرات. |
model_switch_recommendations_get |
read | احصل على توصيات تبديل النموذج استنادا إلى البيانات المعيارية. | اسم النشر الحالي | النماذج الموصى بها مع تحليل مفاضلة الجودة/التكلفة. |
مراقبة النموذج والعمليات
تعقب صحة التوزيع ومراقبة المقاييس والتحقق من حالة الإهمال وعرض استخدام الحصة النسبية.
أمثلة على المطالبات:
- "أظهر لي مقاييس الطلب للتوزيع الخاص بي
production-chatbot." - "تحقق مما إذا كان أي من عمليات النشر الخاصة بي تستخدم إصدارات نموذج مهملة."
- "اعرض لي استخدام الحصة في جميع المناطق لاشتراكي."
| أداة | ولوج | الوصف | المدخلات الرئيسية | مرتجعات |
|---|---|---|---|---|
model_monitoring_metrics_get |
read | الحصول على مقاييس المراقبة (الطلبات وزمن الانتقال والأخطاء والحصة النسبية) لنشر نموذج. | اسم النشر، النطاق الزمني (اختياري) | عدد الطلبات، والنسب المئوية لزمن الانتقال، ومعدلات الخطأ، واستخدام الرمز المميز. |
model_deprecation_info_get |
read | احصل على معلومات النشر التي تم إثراؤها بجداول الإهمال والإيقاف. | اسم النشر (اختياري) | تفاصيل التوزيع مع تواريخ الإهمال والاستبدالات المقترحة. |
model_quota_list |
read | سرد الحصة النسبية المتوفرة للنشر والاستخدام لاشتراك في منطقة. | المنطقة (اختياري) | حدود الحصة النسبية والاستخدام الحالي والسعة المتاحة لكل عائلة نموذجية. |
اتصالات المشروع
إدارة الاتصالات بالخدمات الخارجية (Azure OpenAI وAzure Blob Storage والبحث وغيرها) داخل مشروع Foundry.
أمثلة على المطالبات:
- "سرد كافة الاتصالات في مشروع Foundry الخاص بي."
- "أظهر لي تفاصيل اتصالي
azure-search." - "ما هي أنواع الاتصال وأساليب المصادقة المدعومة؟"
- "إنشاء اتصال AzureOpenAI جديد يسمى
my-openaiباستخدام مصادقة AAD." - "احذف
old-storageالاتصال من مشروعي."
| أداة | ولوج | الوصف | المدخلات الرئيسية | مرتجعات |
|---|---|---|---|---|
project_connection_list |
read | سرد كافة الاتصالات في مشروع Foundry، مع تصفية اختيارية حسب الفئة أو الهدف. | عامل تصفية الفئة، عامل التصفية الهدف (كلاهما اختياري) | قائمة الاتصالات بالاسم والنوع والحالة. |
project_connection_get |
read | احصل على اتصال معين بالاسم. | اسم الاتصال | تفاصيل الاتصال بما في ذلك الفئة والهدف ونوع المصادقة. |
project_connection_list_metadata |
read | سرد كافة فئات الاتصال وأنواع المصادقة المدعومة. قم باستدعاء هذا أولا لاكتشاف القيم الصالحة. | لا شيء | الفئات المدعومة (على سبيل المثال، AzureOpenAI، AzureBlobStorage) وأنواع المصادقة (على سبيل المثال، AAD، المفتاح). |
project_connection_create |
write | إنشاء اتصال مشروع أو استبداله. | اسم الاتصال، الفئة، الهدف، نوع المصادقة | تفاصيل الاتصال التي تم إنشاؤها. |
project_connection_update |
write | تحديث اتصال مشروع موجود. | اسم الاتصال، الحقول المراد تحديثها | تفاصيل الاتصال المحدثة. |
project_connection_delete |
write | حذف اتصال مشروع بالاسم. | اسم الاتصال | تأكيد الحذف. |
تحسين المطالبة
تحسين مطالبات النظام ورسائل المطور للحصول على أداء LLM أفضل.
أمثلة على المطالبات:
- "تحسين موجه النظام الخاص بي: "أنت وكيل خدمة عملاء مفيد" باستخدام
gpt-5.4." - "تحسين تعليمات وكيلي للحصول على استجابات أكثر إيجازا."
- "تحسين المطالبة المحسنة للتعامل أيضا مع أسئلة المتابعة."
| أداة | ولوج | الوصف | المدخلات الرئيسية | مرتجعات |
|---|---|---|---|---|
prompt_optimize |
write | تحسين مطالبة المطور (رسالة النظام) للحصول على أداء LLM أفضل باستخدام Azure OpenAI Prompt Optimizer. | نص موجه، نموذج الهدف، إرشادات التحسين (اختياري) | نص المطالبة المحسن مع شرح للتغييرات. |
أمثلة على سير العمل
سير عمل تقييم العامل:
- "سرد جميع العملاء في مشروعي."
- "قم بتقييم الإصدار 2 الخاص بي
customer-support-agentباستخدام مقيمي الصلة والأرض والسلامة." - "قارن تقييمي الأساسي بالتشغيل الجديد."
- "أرني نتائج المقارنة ذات الدلالة الإحصائية."
توزيع النموذج وتحسينه:
- "أظهر لي جميع نماذج GPT-5.4 المتوفرة في الكتالوج."
- "انشر GPT-5.4 كما هو الحال
customer-service-botمع 15 وحدة سعة." - "مراقبة زمن انتقال الطلب لعملية النشر الجديدة."
- "التوصية ببدائل أكثر فعالية من حيث التكلفة بناء على الاستخدام الحالي."
إدارة الموارد وتنظيفها:
- "ضع قائمة بجميع عمليات النشر الحالية واستخدامها."
- "تحقق من عمليات النشر التي تستخدم إصدارات النموذج المهملة."
- "أظهر لي استخدام حصتي في جميع المناطق."
- "حذف عمليات نشر الاختبار غير المستخدمة لتحرير السعة."
قيود المعاينة
Foundry MCP Server في المعاينة العامة. تُطبق القيود التالية:
-
لا يوجد عزل للشبكة — يستخدم الخادم نقطة
https://mcp.ai.azure.comالنهاية العامة . لا يمكن الوصول إلى الموارد الموجودة خلف Azure Private Links. - موقع البيانات - قد تتم معالجة الطلبات والاستجابات في مراكز بيانات الاتحاد الأوروبي أو الولايات المتحدة. لا يخزن الخادم نفسه البيانات، ولكن يمكن أن تحدث معالجة عبر المناطق.
- لا توجد اتفاقية مستوى الخدمة - لا تتضمن ميزات المعاينة اتفاقية على مستوى الخدمة. لا تستخدم الخادم لأحمال عمل الإنتاج التي تتطلب توفرا مضمونا.
- قد تتغير مجموعة الأدوات — قد تتغير الأدوات والمعلمات والقيم المرجعة أثناء فترة المعاينة دون إشعار.
لمزيد من المعلومات، راجع شروط الاستخدام Supplemental لمعاينات Microsoft Azure.
الأخطاء الشائعة
| خطأ | السبب | القرار |
|---|---|---|
| تم رفض الوصول | دور Azure RBAC غير كاف في مشروع أو حساب Foundry. | تعيين قارئ على الأقل لأدوات القراءة أو المساهم لأدوات الكتابة. راجع RBAC ل Microsoft Foundry. |
| فشل المصادقة | الرمز المميز لمعرف Entra منتهية الصلاحية أو غير صالح. | سجل الخروج ثم سجل الدخول مرة أخرى إلى حساب Azure الخاص بك في Visual Studio Code، أو الأداة التي تستخدمها. |
| تجاوز الحصة | لا توجد سعة كافية لإنشاء توزيع أو تشغيل تقييم. | استخدم model_quota_list للتحقق من الحصة النسبية المتوفرة قبل العملية. |
| لم يتم العثور على مورد | النشر أو مجموعة البيانات أو العامل أو الاتصال المحدد غير موجود. | استخدم الأداة أو get المقابلة list للتحقق من اسم المورد. |
| نقطة النهاية الخاصة غير قابلة للوصول | تستخدم موارد Foundry ارتباطات Azure الخاصة التي لا يمكن للخادم الوصول إليها. | قم بإزالة قيود نقطة النهاية الخاصة أو استخدم واجهات برمجة تطبيقات SDKs/REST بدلا من ذلك. |
لمزيد من إرشادات استكشاف الأخطاء وإصلاحها، راجع أمان Foundry MCP Server وأفضل الممارسات.
المحتوى ذو الصلة
- Get started مع خادم MCP Foundry
- تعلم كيفية بناء خادم MCP خاص بك
- مراجعة أفضل ممارسات الأمان لخوادم MCP