استخدم مهارة Microsoft Foundry في برمجة وكلاء الترميز

مهارة Foundry Microsoft تقدم إرشادات قابلة لإعادة الاستخدام لعملاء Foundry Practice. استخدمه للمساعدة في توحيد النشر، والتقييم، وتحسين الطلبات، وتنظيم مجموعات البيانات من المسارات، ومهام استكشاف الأخطاء عبر بيئات التطوير الممكنة من قبل الوكلاء.

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

  • حساب Azure مع اشتراك نشط. إذا لم يكن لديك واحد، أنشئ حسابا Azure مجانيا.

  • مضيف وكيل ترميز، مثل GitHub Copilot في تعليمة Visual Studio برمجية، Copilot CLI، أو Claude Code.

  • Node.js 18 أو أكثر في .PATH تستخدم npx الإضافة لتشغيل خوادم MCP في مستضيفات متوافقة.

  • Git، حتى يتمكن المضيف من تحميل محتوى الإضافات والمهارة.

  • Azure CLI مثبتة ومصادقة:

    az login

  • Azure مطور CLI تم تثبيته والتحقق منه إذا كنت تخطط لاستخدام سير عمل النشر azd:

    azd auth login

  • مشروع Microsoft Foundry إذا كنت تريد من الوكيل فحص أو تعديل الموارد المحددة ضمن نطاق المشروع. لخطوات الإعداد، انظر إنشاء مشروع.

ما الذي توفره مهارة الصاهر

المهارة microsoft-foundry هي مهارة ميتا لعمل Foundry. يساعد وكيل البرمجة على اختيار سير عمل Foundry المناسب، وتحميل المهارة الفرعية المطابقة، وفحص أدوات MCP المتاحة في Foundry، والحفاظ على اتساق سياق النشر والتقييم عبر الأدوار.

استخدمه عندما تريد من الوكيل المساعدة في هذه المجالات الممكنة:

مجال القدرات ما الذي تساعد المهارة العميل على فعله
الانضمام إلى المصنع أنشئ أو اتصل بمشروع Foundry، وفر مورد Foundry، واختر إعدادا عاما أو معزولا للشبكة، وجهز مساحة العمل لتطوير الوكلاء.
الوصول والسعة تحقق من تعيينات RBAC، الهويات المدارة، مبادئ الخدمة، الحصص، توفر النماذج، سعة المنطقة، ومتطلبات النشر.
نشر النماذج نشر نماذج ذات إعدادات مسبقة سريعة أو إعدادات مخصصة مثل الإصدار، وحدة التخزين (SKU)، السعة، وتكوين الذكاء الاصطناعي المسؤول.
تخصيص النموذج ضبط النماذج بدقة مع ضبط دقيق تحت إشراف، تحسين التفضيل المباشر، أو تعزيزات سير العمل الدقيقة.
إنشاء عامل أنشئ تطبيقات وكلاء مستضافة تستخدم Microsoft Agent Framework أو LangGraph أو أطر عمل مخصصة بلغة Python أو C#‎.
نشر الوكيل قم بتحويل وكيل إلى حاويات، وبناء ودفع الصور إلى Azure Container Registry، وإنشاء أو تحديث نشرات الوكلاء المستضافين، وإعادة النشر بعد تغييرات الكود.
الاستدعاء والاختبار إرسال رسائل بدور واحد أو متعدد إلى الوكلاء المنتشرين، ووكلاء الاختبار، واختبار الوكلاء المستضافين الذين يستخدمون بروتوكولات HTTP أو WebSocket.
التقييم والتحسين تشغيل تقييمات دفعات، إعداد تقييم مستمر، مقارنة الإصدارات، تحسين المطالبات، تحسين تعليمات الوكلاء، وتحضير وظائف محسن الوكلاء.
العمل على التتبع ومجموعة البيانات استعلام التتبعات، وتحليل التأخير أو الإخفاقات، وربط نتائج التقييم بالاستجابات، وتنظيم مجموعات بيانات التقييم من مسارات الإنتاج.
Troubleshooting افحص سجلات الوكلاء المستضافة، استعلام بيانات التليمترية، شخص فشل النشر أو وقت التشغيل، وخطط لحلقة إصلاح وإعادة نشر.

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

التثبيت

إضافة مجموعة أدوات Foundry لكود VS تأتي مع مهارة Foundry. لتثبيت الامتداد، راجع العمل مع Microsoft Foundry لإضافة تعليمة Visual Studio برمجية.

بعد التثبيت، أعد تحميل تعليمة Visual Studio برمجية إذا تمت مطالبتك. افتح Copilot Chat، وانتقل إلى وضع الوكيل، وتأكد من توفر مهارات Foundry. عند طلب ذلك، سجل الدخول باستخدام حساب Azure الذي لديه حق الوصول إلى مشروع Foundry الخاص بك.

لمزيد من المعلومات حول إعداد MCP في تعليمة Visual Studio برمجية، راجع ابدأ مع خادم MCP Azure و ابدأ مع Foundry MCP Server.

قم بتثبيت مهارة الصب فقط

إذا كان مضيفك لديه بالفعل إعداد خادم MCP وتحتاج فقط إلى محتوى المهارة، قم بتثبيت المهارة microsoft-foundry مباشرة:

npx skills add https://github.com/microsoft/azure-skills --skill microsoft-foundry

المسار المهوري فقط يقوم بتنزيل إرشادات سير عمل Foundry. استخدم إضافة Azure Skills عندما تريد تثبيت المهارة، وتكوين Azure MCP Server، وتكوين Foundry MCP Server معا.

تحقق من الإعداد

بعد التثبيت، جرب هذه الفحوصات من وكيل الترميز الخاص بك:

  • اسأل What AI models are available in Microsoft Foundry? يجب أن يستخدم الرد أدوات Foundry بدلا من ملخص عام.
  • اسأل List my Azure resource groups. يجب أن يستخدم الرد أدوات MCP Azure بعد المصادقة.
  • في مشروع وكيل Foundry، اسأل Use the Microsoft Foundry Skill to review this agent for deployment readiness. يجب أن يحدد الرد فحوصات سير العمل مثل الإعدادات، الوصول إلى المشروع، نشر النماذج، بيانات التقييم، والتحقق من صحة النشر.

إذا فشل الفحص، أعد تحميل المضيف، وتأكد من تثبيت الإضافة بنجاح، وتحقق من أنها az login تستخدم الاشتراك الذي يحتوي على موارد Foundry الخاصة بك.

استخدم المهارة في مشروع

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

استخدم هذه أنماط التوجيه لاستدعاء قدرات المهارة:

الهدف مثال على المطالبة سير العمل النموذجي
أنشأ Foundry لوكيل جديد Use the Microsoft Foundry Skill to create a public Foundry project, deploy a model, and scaffold a hosted agent. إعداد Project، نشر النماذج، إنشاء الوكيل، النشر، والاستدعاء.
إنشاء بيئة خاصة Use the Microsoft Foundry Skill to plan a network-isolated Foundry deployment for this project. تخطيط الشبكات الخاصة، اختيار القالب، فحوصات النشر، والتحقق.
نشر وكيل مستضاف موجود Use the Microsoft Foundry Skill to prepare this hosted agent for deployment to my dev environment. حل سياق مساحة العمل، بناء الحاويات، دفع ACR، نشر الوكلاء المستضاف، واختبار الدخان.
إعادة النشر بعد تغييرات الكود Use the Microsoft Foundry Skill to redeploy this agent and verify it still responds correctly. تحديث النشر، الاستدعاء، ومتابعة التقييم.
اختبر وكيل Use the Microsoft Foundry Skill to invoke this agent with a short multi-turn test conversation. البحث عن الوكيل، الاستدعاء، ومراجعة الرد.
تقييم الجودة Use the Microsoft Foundry Skill to create an evaluation plan for this agent from eval.yaml. إعداد مجموعة التقييم، فحوصات مجموعات البيانات والمقيمين، تقييم الدفعات، وملخص النتائج.
تحسين التعليمات Use the Microsoft Foundry Skill to improve the agent instructions based on recent evaluation results. تحليل التقييم، تحسين السرعة، مراجعة المرشحين، وتقييم المتابعة.
بناء مجموعة بيانات تقييم Use the Microsoft Foundry Skill to create an evaluation dataset from the last seven days of production traces. استعلام التتبع، تنسيق مجموعات البيانات، إصدار الإصدارات، وتتبع السلال.
حل المشكلة في مشكلة Use the Microsoft Foundry Skill to troubleshoot why this hosted agent deployment is failing. فحص الاستدعاء، السجلات، التليمترية، تحليل السبب الجذري، خطة الإصلاح، إعادة النشر، وإعادة الاختبار.
تحقق من الوصول أو السعة Use the Microsoft Foundry Skill to check RBAC and quota blockers before I deploy this model. مراجعة تعيين الأدوار، البحث عن الحصص، تخطيط القدرات، وخطوات المعالجة.
ضبط نموذج بدقة Use the Microsoft Foundry Skill to plan a supervised fine-tuning workflow for this training dataset. جاهزية مجموعة البيانات، إعداد التدريب، مراجعة نقاط التفتيش، نشر النماذج، والتقييم.

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

استخدم مهارات مجموعة أدوات Foundry في كود VS

Foundry Toolkit for تعليمة Visual Studio برمجية تتيح أيضا المهارات الخاصة ب Foundry في VS Code. تركز هذه المهارات، مثل vscode-microsoft-foundry و foundrytk-quick-start، على تجربة تطوير كود VS: الانضمام إلى مجموعة أدوات Foundry، استكشاف النماذج، بناء الوكلاء، اختيار نموذج، نشر وكيل، تقييم الأداء، وإدارة صناديق الأدوات. تختلف عن المهارة الأساسية microsoft-foundry التي توفر قاعدة معرفة أوسع وتفاصيل سير عمل ملموسة لإدارة موارد Foundry، وRBAC، والحصص، ونشر النماذج، ونشر الوكلاء المستضافين، والتقييم، والتتبع، وحل المشكلات. قم بتثبيت Foundry Toolkit for VS Code لجعل هذه المهارات المقدمة من الامتداد متاحة في تجربة وكيل VS Code الخاص بك.

كيف تعمل المهارة

عندما يستخدم وكيل البرمجة مهارة Microsoft Foundry، فإنه يتبع بعض الأنماط الشائعة:

  1. يبدأ باكتشاف Foundry MCP حتى يعرف أي الأدوات والمعلمات المتوفرة في بيئتك.
  2. يقوم بتحميل المهارة الفرعية التي تتناسب مع سير عملك، مثل الإنشاء، النشر، الاستدعاء، التقييم، التتبع، استكشاف المشكلة، RBAC، الحصص، أو نشر النماذج.
  3. يقوم بحل سياق المشروع والوكيل من مساحة العمل قبل أن يقترح تغييرات أو أوامر.
  4. يفضل أدوات Foundry المنظمة وأدوات MCP Azure عندما تكون متاحة.
  5. يطلب القيم المفقودة فقط عندما لا يمكن حلها من خلال الموجه، أو ملفات مساحة العمل، أو سياق Azure المصادق.

تدعم المهارة نوعين شائعين من الوكلاء:

نوع العامل حالة الاستخدام
وكيل التوجيه وكيل مدعوم من نموذج اللغة الكبيرة يستخدم نشر نموذج وتكوين الطلب.
الوكيل المستضاف وكيل قائم على الحاوية يشغل كودا مخصصا في خدمة وكلاء المساند.

بالنسبة لسير عمل الوكلاء المستضاف، يمكن أن تعمل المهارة أيضا مع الوكلاء الذين يستخدمون ، responsesinvocationsأو invocations_ws البروتوكولات. استخدامه invocations_ws في سيناريوهات WebSocket في الوقت الحقيقي أو المزدوج، مثل وكلاء الصوت أو التفاعلات عبر البث.

ملفات مساحة العمل التي تستخدمها المهارة

تبحث المهارة عن سياق مشروع Foundry والوكيل في ملفات مساحة العمل الشائعة. حافظ على تحديث هذه الملفات حتى يتمكن وكيل البرمجة من تقديم توصيات محددة وقابلة للتكرار.

ملف أو مجلد كيف تستخدمه المهارة
azure.yaml يعثر على azd الخدمات، ومجلدات مشروع الوكلاء، وإعدادات مضيف النشر، وروابط البيئة، وتكوين الوكيل المحلي لسير العمل في الإنشاء، والنشر، والاستدعاء، والتقييم.
.azure/<environment>/.env يحل قيم بيئة azd المصادقة مثل الاشتراك، مجموعة الموارد، نقطة نهاية المشروع، اسم الوكيل، السجل، و سلسلة الاتصال رؤى التطبيق.
.foundry/agent-metadata.yaml يخزن حالات التراكب الخاصة ب Foundry مثل مراجع مجموعات التقييم، مراجع مجموعات البيانات، مسارات الذاكرة المخبأة المحلية، ملخصات النتائج، وغيرazd التجاوز.
.foundry/agent-metadata.<env>.yaml يخزن حالة التراكب الخاصة بالبيئة لهدف مثل الإنتاج أو CI.
eval.yaml يحدد نية التقييم المحلي، مثل ملفات مجموعة البيانات، أسماء المقيمين، عتبة المرور، عدد العينات، مراجعة التتبع، وتعليمات التوليد.

بالنسبة لسير عمل النشر والتقييم، أفضل .foundry/agent-metadata.yaml حالة تراكب غير سرية. لا تخزن الأسرار في .foundry الملفات. إذا azd كان يوفر بالفعل قيمة نشر، مثل نقطة نهاية المشروع أو السجل، دع وكيل الترميز يستخدم القيمة azd بدلا من تكرارها في البيانات الوصفية.

Troubleshooting

مشكلة نوع اَلْْحل
المضيف لا يجد المهارة. تأكد من تثبيت الإضافة بنجاح، ثم أعد تحميل أو أعد تشغيل المضيف لإعادة فهرسة محتوى الإضافات.
أدوات MCP لا تظهر. تأكد من تثبيت Node.js، npx يعمل، وتمت إضافة مدخلات Azure وخادم Foundry MCP لمضيفك.
طلبات Azure تفشل مع أخطاء المصادقة. شغّل az login مرة أخرى. بالنسبة azd لسير العمل، شغل azd auth loginأيضا .
الوكيل يستخدم اشتراكا خاطئا. قم بتعيين اشتراك Azure المقصود في Azure CLI قبل إعادة محاولة الطلب.
فشل عمليات مشروع المسبك. تأكد من أن حسابك لديه حق الوصول إلى مشروع Foundry والأدوار المطلوبة في Azure RBAC.

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

  • Last updated on