مشاركة عبر


الدرس التعليمي: ابدأ مع خادم MCP الخاص بصندوق تطوير مايكروسوفت

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

في هذا البرنامج التعليمي، سوف تتعلّم:

  • اتصل بموارد صندوق التطوير الخاص بك من خلال وكيل الذكاء الاصطناعي
  • قم بإدراج واستكشاف مشاريعك وصناديق التطوير المتاحة لديك
  • تنفيذ العمليات الأساسية لصندوق التطوير باستخدام أوامر المحادثة
  • تحقق من إتمام عملياتك بنجاح

المتطلبات الأساسية

قبل أن تبدأ هذا البرنامج التعليمي، تأكد من أن لديك:

Requirement التفاصيل
تم تثبيت خادم MCP في صندوق التطوير اتبع خطوات التثبيت في مستودع خادم MCP الخاص بصندوق التطوير
موارد صندوق التطوير - على الأقل مشروع صندوق تطوير واحد مع مجموعة مهيأة
- صناديق تطوير موجودة للإدارة (اختيارية ولكن موصى بها)
Authentication تسجيل الدخول عبر Azure CLI أو Visual Studio Code أو Windows SSO
الصلاحيات المطلوبة دور مستخدم صندوق المطور أو أعلى في موارد صندوق التطوير الخاص بك

الخطوة 1: افتح وكيل الذكاء الاصطناعي الخاص بك واختبر الاتصال

ابدأ بفتح وكيل الذكاء الاصطناعي الخاص بك واختبار الاتصال بموارد صندوق التطوير الخاص بك.

  1. افتح دردشة GitHub Copilot في بيئة التطوير الخاصة بك (VS Code أو Visual Studio)

  2. اختبر اتصال خادم MCP بإدخال هذا المطلوب:

    List my Dev Box projects
    
  3. تحقق من الرد: يجب أن ترى قائمة بالمشاريع التي لديك وصول إليها. إذا ظهرت لك خطأ، تحقق من أنك مصادق عبر Azure CLI (az login) أو Windows SSO.

النتائج المتوقعة: قائمة تعرض أسماء مشاريعك، ووصفها، ومجموعات الموارد.

الخطوة 2: استكشف بيئة صندوق التطوير الخاصة بك

الآن بعد أن أكدت الاتصال، استكشف موارد صندوق التطوير لفهم بيئتك.

عرض صناديق المطورين الخاصة بك عبر جميع المشاريع:

Show me all my dev boxes

احصل على تفاصيل حول مشروع معين (استبدل "YourProjectName" باسم مشروع فعلي):

Show me details about the YourProjectName project

قائمة بمجموعات صناديق التطوير المتاحة في مشروع:

What dev box pools are available in the YourProjectName project?

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

الخطوة 3: تنفيذ العمليات الأساسية لصندوق التطوير

مارس مهام إدارة صناديق التطوير الشائعة باستخدام أوامر اللغة الطبيعية.

حدد حالة صندوق التطوير

تحقق من حالة مربع تطوير معين:

What's the status of my DevBoxName dev box?

احصل على معلومات مفصلة عن صندوق المطورين:

Show me detailed information about DevBoxName including its configuration and current state

بدء أو إيقاف صندوق تطوير

ابدأ صندوق تطوير متوقف:

Start my DevBoxName dev box

إيقاف صندوق مطور يعمل:

Stop my DevBoxName dev box

إشعار

بدء وإيقاف صناديق التطوير هي عمليات طويلة الأمد قد تستغرق عدة دقائق لإكمالها.

العمل مع الجداول الزمنية

تحقق من جداول الإغلاق:

When is my DevBoxName dev box scheduled to shut down?

تأجيل الإغلاق المجدول:

Delay the shutdown of my DevBoxName dev box until 6 PM today

الخطوة 4: تحقق من عملك

تأكد من أن عملياتك قد اكتملت بنجاح من خلال التحقق من النتائج.

تحقق من حالة التشغيل للمهام طويلة الأمد:

What's the status of the operation I just started?

تحقق من تغييرات حالة صندوق المطور:

Show me the current status of DevBoxName

تأكيد تغييرات الجدول:

Show me the updated schedule for DevBoxName

ما الذي يجب البحث عنه:

  • يجب أن تظهر حالة "ناجح" عند الانتهاء من العمليات
  • يجب أن تعكس حالات الطاقة في صندوق المطور أوامر التشغيل/الإيقاف الخاصة بك
  • يجب أن تكون تعديلات الجدول مرئية في معلومات الجدول

الخطوة 5: جرب السيناريوهات المتقدمة (اختيارية)

بمجرد أن تشعر بالراحة مع العمليات الأساسية، جرب هذه السيناريوهات المتقدمة:

إنشاء صندوق تطوير جديد

Create a new dev box called "FeatureWork" in the DevelopmentProject using the StandardPool

تَطبِيق التخصيصَات

What customization tasks are available for my project?
Install the development tools customization on my FeatureWork dev box

راقب تقدم التخصيص

What's the status of the customization running on my FeatureWork dev box?

استكشاف الأخطاء وإصلاحها

إذا واجهت مشاكل أثناء هذا الدرس:

مشاكل المصادقة

  • تحقق من تسجيل الدخول: az account show
  • تحقق من أذوناتك في بوابة Azure
  • حاول تسجيل الخروج والدخول مرة أخرى: az logoutaz login

أخطاء تسجيل الأدوات

  1. اضغط Ctrl+Shift+P (VS Code) أو Ctrl+Shift+P (Visual Studio)
  2. تشغيل MCP: إعادة ضبط الأدوات المخزنة مؤقتا
  3. أعد تشغيل بيئة التطوير الخاصة بك

إخفاقات التشغيل

  • تحقق من صحة أسماء صناديق المطور وأسماء المشاريع
  • تحقق من أن لديك الأذونات المناسبة للعملية
  • بعض العمليات قد تستغرق وقتا - تحقق من حالة التشغيل بشكل دوري

تنظيف الموارد (اختياري)

إذا أنشأت موارد اختبار خلال هذا الدرس:

احذف صناديق تطوير الاختبار التي لم تعد بحاجة إليها:

Delete the FeatureWork dev box from DevelopmentProject

توقف عن تشغيل صناديق التطوير لتوفير التكاليف:

Stop all my running dev boxes

الخطوات التالية

الآن بعد أن أنهيت الدرس التعليمي، يمكنك:

  • استكشف النطاق الكامل للعمليات المدعومة
  • دمج أوامر خادم MCP في صندوق المطور في سير عمل التطوير اليومي الخاص بك
  • شارك أوامر اللغة الطبيعية مع فريقك للعمليات المشتركة