مشاركة عبر

العمل مع وكلاء Foundry وأدوات خوادم MCP في كود Visual Studio (الكلاسيكي)

ينطبق فقط على:بوابة Foundry (كلاسيكية). هذه المقالة غير متاحة لبوابة Foundry الجديدة. تعرف على المزيد حول البوابة الجديدة.

‏‫ملاحظة‬

بعض الروابط في هذا المقال قد تفتح محتوى في وثائق Microsoft Foundry الجديدة بدلا من وثائق Foundry (الكلاسيكية) التي تشاهدها الآن.

في هذا المقال، تضيف وتستخدم أدوات خوادم بروتوكول سياق النموذج (MCP) مع الوكلاء في خدمة وكلاء Foundry. تستخدم إضافة Microsoft Foundry for Visual Studio Code لتكوين واختبار وكلاء استدعاء أدوات MCP.

‏‫ملاحظة‬

تشير هذه المقالة إلى النسخة الكلاسيكية من واجهة برمجة تطبيقات الوكلاء.

بعد بناء وكيل في خدمة الوكيل باستخدام إضافة كود فيجوال ستوديو (VS Code)، يمكنك إضافة أدوات MCP إلى وكيلك. إضافة خادم MCP يسمح لوكيلك ب:

  • الوصول إلى معلومات up-toتاريخ من واجهات برمجة التطبيقات والخدمات الخاصة بك.
  • استرجع السياق ذي الصلة لتحسين جودة الاستجابات من نماذج الذكاء الاصطناعي الخاصة بك.

المتطلبات المسبقه

أنشئ وكيلا في المصمم

لإنشاء وكيل، اتبع الخطوات في إنشاء وكيل في المصمم.

إضافة أداة خادم MCP إلى الوكيل

بعد إنشاء الوكيل الخاص بك، يمكنك إضافة أدوات إليه، بما في ذلك أدوات MCP. لمزيد من المعلومات حول الأدوات المتاحة، راجع أدوات الوكلاء.

يمكنك إحضار عدة خوادم MCP عن بعد عن طريق إضافتها كأدوات. لكل أداة، تحتاج إلى توفير قيمة تسمية خادم فريدة داخل نفس العامل وقيمة عنوان URL للخادم تشير إلى خادم MCP البعيد.

تحذير

خوادم MCP البعيدة التي تستخدمها مع أداة MCP في هذه المقالة ليست من Microsoft. لا تختبر Microsoft هذه الخوادم أو تتحقق منها. للحصول على التفاصيل، راجع اعتبارات استخدام الخدمات والخوادم غير التابعة ل Microsoft.

لإضافة أداة خادم MCP إلى وكيلك، اتبع الخطوات التالية:

  1. في المصمم، في الزاوية العلوية اليمنى من قسم TOOL ، حدد الزر إضافة أداة . في القائمة المنسدلة، حدد أداة خادم MCP .

  2. ابحث عن خادم MCP البعيد الذي تريد الاتصال به، مثل خادم GitHub MCP. إنشاء أو تحديث وكيل Foundry باستخدام أداة MCP باستخدام المعلومات التالية:

    1. عنوان URL للخادم: عنوان URL لخادم MCP؛ على سبيل المثال ، https://gitmcp.io/Azure/azure-rest-api-specs.

    2. تسمية الخادم: معرف فريد لخادم MCP هذا للوكيل؛ على سبيل المثال ، fetch_rest_api_docs.

  3. في القائمة المنسدلة الأدوات المسموح بها ، اختر الأدوات التي يمكن لخادم MCP استخدامها.

  4. بعد إدخال المعلومات المطلوبة، حدد الزر إنشاء أداة . تظهر أداة MCP في قسم الأدوات في مصمم الوكلاء.

نشر العميل إلى المصنع

بعد إضافة أداة MCP، قم بنشر الوكيل في Foundry ليكون متاحا للاختبار والاستخدام.

  1. في المصمم، اختر زر إنشاء وكيل في مايكروسوفت فاوندري .

  2. في VS Code، قم بتحديث عرض الموارد . يظهر الوكيل المنشور في قسم العملاء الكلاسيكيين .

عرض تفاصيل الوكيل المنشور

بعد نشر وكيل، يمكنك فحص تكوينه والتفاعل معه. اختر الوكيل المنشور في عرض الموارد لفتح لوحة تفضيلات الوكيل في وضع العرض فقط. يمكنك:

  • حدد الزر تحرير العامل لعرض مصمم الوكيل وتعريف .yaml للعامل للتحرير.
  • اختر زر عرض الكود لإنشاء ملف كود نموذجي يستخدم الوكيل.
  • حدد الزر فتح الملعب لفتح ملعب الوكيل.

تعديل وكيل تم نشره

لتعديل تكوين وكيلك بعد النشر، اتبع الخطوات التالية:

  1. في جزء تفضيلات العامل ، حدد الزر تحرير العامل . يفتح مصمم الوكيل بملف .yaml الخاص بالوكيل.

  2. قم بتحرير تكوين العامل، مثل النموذج والأدوات والإرشادات.

  3. بعد الانتهاء من التحرير، اختر زر Update Agent في Microsoft Foundry لحفظ التغييرات. يتم نشر التكوين المحدث على Foundry.

اختبر الوكيل باستخدام أدوات MCP في الملعب

استخدم ملعب الوكلاء للتحقق من أن أدوات خادم MCP تعمل بشكل صحيح مع الوكيل المنشور.

  1. انقر بزر الماوس الأيمن فوق الوكيل المنشور الذي يحتوي على أداة خادم MCP ، ثم حدد الخيار فتح الملعب . يبدأ هذا الإجراء سلسلة رسائل مع وكيلك حتى تتمكن من إرسال الرسائل.

  2. في صفحة ملعب الوكلاء البعيدين ، أدخل تنبيه مثل أعطني مثالا لإنشاء تطبيق حاوية وأرسله.

  3. حدد طريقة المصادقة لأداة خادم MCP وتابع. تختلف طرق المصادقة حسب خادم MCP. تشمل الخيارات الشائعة مفتاح API أو OAuth أو عدم وجود مصادقة للخوادم العامة.

  4. حدد تفضيل الموافقة لأداة خادم MCP والمتابعة. يمكنك اختيار خيار السؤال في كل مرة لمراجعة كل استدعاء أداة، أو السماح دائما للسماح للوكيل بتفعيل أدوات MCP تلقائيا.

  5. إذا اخترت اسأل في كل مرة للحصول على تفضيل الموافقة، يجب عليك الموافقة أو رفض كل استدعاء أداة قبل أن يتابع الوكيل.

  6. يستخدم الوكيل النموذج وأدوات خادم MCP التي قمت بتكوينها لاسترجاع المعلومات. بعد انتهاء الوكيل من المعالجة، يظهر الرد في ساحة اللعب. يظهر مصدر المعلومات في قسم التعليقات التوضيحية للوكيل.

استكشاف أخطاء اتصالات خوادم MCP

إذا واجهت مشاكل عند استخدام أدوات خادم MCP مع وكيل اللعبة، جرب الحل التالية.

مشكلة الحل
رابط خادم MCP غير قابل للوصول تحقق من صحة الرابط وأن الخادم يعمل. تحقق من اتصال الشبكة وأي قواعد جدار حماية قد تمنع الطلبات الصادرة من VS Code.
حالات فشل المصادقة تأكد من أنك اخترت طريقة المصادقة الصحيحة لخادم MCP. إذا كان الخادم يتطلب مفتاح API أو رمز OAuth، تحقق من صحة بيانات الاعتماد وعدم انتهاء صلاحيتها.
الأدوات لا تظهر في قائمة الأدوات المسموح بها قم بتحديث قائمة الأدوات عن طريق إغلاق وإعادة فتح مربع أدوات MCP. تحقق من أن خادم MCP يعرض أدواته بشكل صحيح من خلال بروتوكول MCP القياسي.
يرجع الوكيل أخطاء عند استدعاء أداة MCP تحقق من تعليقات الوكلاء في ساحة اللعب للحصول على تفاصيل الأخطاء. قد يكون خادم MCP يرد استجابة خطأ. تحقق من صحة الخادم وأن معلمات استدعاء الأداة صحيحة.

تنظيف الموارد

تتم فوترة موارد Azure التي قمت بإنشائها في هذه المقالة إلى اشتراك Azure الخاص بك. إذا كنت لا تتوقع أن تحتاج إلى هذه الموارد في المستقبل، فاحذفها لتجنب تكبد المزيد من الرسوم.

حذف وكلائك

لإزالة العوامل التي لم تعد بحاجة إليها:

  1. في VS Code، قم بتحديث عرض الموارد . قم بتوسيع قسم الوكلاء الكلاسيكيين لعرض قائمة الوكلاء المنتشرين.

  2. انقر بزر الفأرة الأيمن على الوكيل المنشور الذي تريد حذفه، ثم اختر حذف.

حذف النماذج الخاصة بك

لإزالة النماذج المنشورة التي لم تعد بحاجة إليها:

  1. في VS Code، قم بتحديث عرض الموارد . قم بتوسيع القسم الفرعي Models لعرض قائمة النماذج المنشورة.

  2. انقر بزر الماوس الأيمن فوق النموذج المنشور الذي تريد حذفه، ثم حدد حذف.

حذف أدواتك المتصلة

لإزالة موارد الأدوات المتصلة التي لم تعد بحاجة إليها، قم بحذفها بشكل فردي من بوابة Azure:

  1. افتح مدخل Azure.

  2. اذهب إلى مجموعة الموارد التي تحتوي على مشروع Foundry الخاص بك.

  3. ابحث عن الأداة المحددة التي تريد حذفها، واخترها.

  4. اختر زر الحذف وأكد الحذف.

تحذير

لا تحذف مجموعة الموارد بالكامل إلا إذا أردت إزالة كل الموارد داخلها. حذف مجموعة موارد يزيل جميع الموارد التي تحتويها، بما في ذلك مشروع Foundry والنماذج المنشورة.

المحتوى ذو الصلة

  • Last updated on