العمل مع إضافة Microsoft Foundry لإضافة Visual Studio Code

في هذا المقال، تعرف على كيفية تثبيت واستخدام Microsoft Foundry لإضافة Visual Studio Code. أنشئ مشاريع، ونشر نماذج من كتالوج نماذج Foundry، وتفاعل مع ملاعب النماذج من داخل VS Code.

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

• اشتراك في Azure. أنشئ واحدا مجانا.
• تم تثبيت Visual Studio Code.
• يجب أن يكون اشتراكك أقل من الحد الأقصى للحصة لنشر نموذج جديد في هذا المقال. إذا كنت قد وصلت بالفعل إلى حد الحصة، تحتاج إلى نموذج دردشة منتشر.
• صلاحيات RBAC المناسبة لإنشاء وإدارة موارد Foundry. لمزيد من المعلومات، راجع access control Role-based ل Foundry.

ثبتالملحق

لاستخدام قدرات Foundry في VS Code، قم بتثبيت إضافة Foundry for Visual Studio Code. قم بالتثبيت من Visual Studio Code Marketplace أو مباشرة من داخل VS Code.

التثبيت من سوق Visual Studio Code

استخدم السوق لتثبيت الإضافة دون فتح VS Code أولا.

1. افتح صفحة Foundry لكود Visual Studio الإضافية.
2. حدد الزر تثبيت.
3. اتبع التعليمات لتثبيت الإضافة في Visual Studio Code.
4. بعد التثبيت، افتح Visual Studio Code وتحقق من تثبيت الإضافة بنجاح من خلال رسائل الحالة.
5. تظهر أيقونة Foundry في شريط التنقل الأساسي على الجانب الأيسر من VS Code.

التثبيت من داخل Visual Studio Code

بدلا من ذلك، ابحث عن الامتداد مباشرة من عرض توسعات كود VS.

1. افتح VS Code.

2. حدد Extensions من الجزء الأيمن.

3. حدد أيقونة الإعدادات من أعلى اليمين في جزء الملحقات.

4. ابحث عن Foundry واختر Foundry.

5. حدد تثبيت.

6. بعد اكتمال التثبيت، تظهر رسالة حالة تؤكد أن الإضافة مثبتة. تظهر أيقونة Foundry في شريط التنقل الأيسر.

اتصل بموارد Azure الخاصة بك

بعد تثبيت الإضافة، سجل الدخول إلى اشتراكك في Azure وافتح project Foundry لتبدأ العمل مع النماذج، والوكلاء، والملاعب.

‏‫ملاحظة‬

للحصول على قائمة كاملة بالميزات المتوفرة في الملحق، استخدم لوحة الأوامر. اختر F1 لفتح لوحة الأوامر وابحث في Foundry. تظهر لقطة الشاشة التالية بعض الأوامر المتاحة.

تسجيل الدخول إلى مواردك

سجل الدخول إلى اشتراكك في Azure حتى يتمكن الامتداد من access إلى مشاريع Foundry والنماذج المنشورة الخاصة بك.

1. اختر أيقونة Azure في شريط التنقل الخاص ب VS Code.

2. اختر تسجيل الدخول إلى Azure... في عرض Azure الموارد.

3. في قسم Resources، اختر اشتراك Azure ومجموعة الموارد الخاصة بك.

4. اختر Foundry وانقر بزر الفأرة الأيمن على project.

5. اختر خيار الفتح في امتداد Foundry.

   تظهر موارد Foundry project الخاصة بك في عرض الامتداد، وتظهر أيقونة Foundry على شريط التنقل الخاص ب VS Code.

التنقل في واجهة الامتداد

ينظم امتداد Foundry مساحة عملك إلى ثلاثة أقسام رئيسية.

قسم	ما الذي يحتويه	متى يتم استخدامها
موارد	نماذج منشورة، وكلاء إعلانيين، وكلاء مستضافة، اتصالات، ومخازن متجهات لجهاز Foundry الخاص بك project.	عرض وإدارة موارد project الخاصة بك.
أدوات	كتالوج النماذج، ملعب النماذج، ملاعب الوكلاء (البعيدة والمحلية)، الvisualizer المحلي، ونشر الوكلاء المستضافين.	نشر نماذج جديدة، واختبارات التوجيه، والتفاعل مع الوكلاء.
المساعدة والتغذية الراجعة	الوثائق، مستودع GitHub، بيان الخصوصية الخاص بمايكروسوفت، وروابط المجتمع.	احصل على المساعدة أو قدم ملاحظاتك.

إنشاء project

أنشئ project Foundry جديد مباشرة من الإضافة لتنظيم نماذجك ومواردك.

1. اختر أيقونة الجمع بجانب الموارد في قسم الموارد في عرض التوسعات في Foundry.

   يمكنك إما إنشاء مجموعة موارد جديدة أو تحديد مجموعة موجودة.

2. لإنشاء مجموعة موارد جديدة:

   1. اختر إنشاء مجموعة موارد جديدة واضغط على إدخال.

   2. أدخل اسم مجموعة الموارد Azure في مربع النص Enter new resource group واضغط على Enter.

   3. اختر الموقع الذي تريد استخدامه من قائمة المواقع المتاحة واضغط على إدخال.

3. لاستخدام مجموعة موارد موجودة:

   • اختر مجموعة الموارد التي تريد استخدامها من قائمة مجموعات الموارد المتاحة واضغط إدخال.

4. أدخل اسم project المسبك في مربع النص Enter project name واضغط على Enter.

بعد project النشر، تظهر نافذة منبثقة تظهر الرسالة Project تم النشر بنجاح.

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

بدل project الافتراضي

عندما تفتح project في امتداد Foundry، يتم تعيين ذلك project كproject الافتراضي الخاص بك. لتغيير project الافتراضي:

1. انقر بزر الفأرة الأيمن على project Foundry واختر Project الافتراضي Switch في خيار Azure Extension.

2. اختر project Foundry الذي تريد استخدامه من قائمة المشاريع المتاحة واضغط Enter.

يعرض project المختار الآن Default بعد اسم project.

نصيحة

انقر بزر الفأرة الأيمن على اسمك project access نقطة النهاية project أو مفتاح واجهة برمجة التطبيقات project.

العمل مع النماذج

يتيح لك امتداد Foundry اكتشاف ونشر والتفاعل مع نماذج من كتالوج نماذج Foundry مباشرة في VS Code.

تصفح كتالوج النماذج

يوفر كتالوج النماذج access إلى نماذج من مايكروسوفت، OpenAI، ميتا، ديب سيك، ومزودين آخرين. يمكنك فتح كتالوج النماذج بعدة طرق:

• شغل أمر Foundry: Open Model Catalog من لوحة الأوامر.
• اختر أيقونة الزائد بجانب النماذج في قسم الموارد في عرض امتداد Foundry.
• اختر رابط كتالوج النماذج في قسم الأدوات في عرض الامتداد في Foundry.

افتح كتالوج النموذج من لوحة الأوامر

استخدم لوحة الأوامر لفتح كتالوج النماذج دون الحاجة للتنقل في عرض الامتداد.

1. حدد F1 لفتح لوحة الأوامر.

2. ادخل Foundry: افتح كتالوج النماذج واضغط زر Enter.

3. صفحة كتالوج النماذج تفتح.

   

4. فلتر كتالوج Model Catalog حسب Hosted by، Publisher، Feature، أو Type باستخدام المنسدلة في أعلى الصفحة. اختر مفتاح دعمFine-Tuning لتصفية النماذج التي تدعم الضبط الدقيق.

5. ابحث عن نموذج معين باستخدام شريط البحث في أعلى وسط الصفحة.

فتح كتالوج النموذج من قسم الموارد

في عرض امتداد Foundry، اختر أيقونة الزائد بجانب النماذج لفتح كتالوج النماذج.

نصيحة

يمكنك أيضا النقر بزر الفأرة الأيمن على النماذج واختيار نشر نموذج ذكاء اصطناعي جديد للانتقال مباشرة إلى تدفق النشر.

فتح كتالوج النموذج من قسم الأدوات

في قسم الأدوات في عرض امتداد Foundry، انقر مرتين على رابط كتالوج النماذج .

نشر نموذج من كتالوج النموذج

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

1. اختر زر النشر بجانب اسم الطراز المختار.

2. تفتح صفحة نشر النموذج .

3. أدخل اسم نشر النموذج في مربع نص اسم النشر Enter واضغط على Enter.

4. اختر نوع النشر في قائمة أنواع النشر .

5. اختر نسخة النموذج في قائمة إصدار النموذج .

6. (اختياري) قم بضبط الرموز في الدقيقة باستخدام شريط تمرير الرموز في الدقيقة .

7. اختر زر النشر في Foundry في الزاوية السفلية اليسرى.

8. في مربع الحوار الخاص بالتأكيد، اختر النشر.

9. بعد اكتمال النشر، يظهر النموذج باسم النشر تحت قسم Models في project الخاص بك.

عرض وإدارة النماذج المنتشرة

قم بتوسيع قسم Models في عرض الامتداد الخاص ب Foundry لرؤية جميع النماذج المنشورة في project الخاص بك.

عرض معلومات بطاقة النموذج

اختر نموذجا تم نشره لفتح لوحة تحتوي على التفاصيل التالية:

• معلومات النشر: الاسم، حالة التزويد، نوع النشر، حد المعدل، معلومات الإصدار، اسم الطراز، وإصدار الطراز.
• معلومات نقطة النهاية: رابط URI المستهدف، نوع المصادقة، والمفتاح.
• روابط مفيدة: عينات من مستودع الكود وروابط الدروس لتطوير تطبيقات الذكاء الاصطناعي.

تحديث إعدادات نشر النموذج

لتحديث إعدادات النشر مثل حدود المعدل:

1. اختر زر التعديل في أعلى يمين بطاقة الطراز.
2. حدث الحقول القابلة للتعديل.
3. اختر زر الحفظ لتطبيق التغييرات.

توليد نموذج كود لنموذج

أنشئ ملف كود مبتدئ لنموذجك المنشور لتسريع تطوير التطبيق.

1. انقر بزر الفأرة الأيمن على النموذج الذي تم نشره واختر Open Code file.

2. اختر مجموعة تطوير التطوير المفضلة لديك في قائمة اختيار مجموعة تطوير مفضلة .

3. اختر لغتك المفضلة في قائمة اختيار اللغة .

4. اختر طريقة المصادقة المفضلة لديك في قائمة اختيار طريقة المصادقة .

5. يفتح ملف كود نموذجي في تبويب جديد في VS Code.

تظهر لقطة الشاشة التالية عينة مولدة بلغة بايثون تقوم باستدعاء متزامن لواجهة برمجة التطبيقات للاستجابات:

تفاعل مع العارضات في ساحة اللعب

استخدم ساحة النماذج للدردشة التفاعلية مع النموذج الذي تم نشره، وضبط الإعدادات، وتعديل تعليمات النظام.

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

1. صفحة الملعب تفتح.

2. اكتب المحفز الخاص بك وراجع النتائج.

3. اختر عرض الكود في الزاوية العلوية اليمنى لترى كيفية access نشر النموذج بشكل برمجي.

4. اختر رابط التاريخ في أعلى يسار الملعب لعرض سجل محادثتك.

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

إذا واجهت مشاكل أثناء استخدام إضافة Foundry، تحقق من المشاكل الشائعة التالية:

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

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

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

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

1. في شريط التنقل الخاص ب VS Code، قم بتحديث امتداد Foundry. في قسم الموارد ، قم بتوسيع قسم النماذج .

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

حذف موارد Azure

لحذف مجموعة الموارد وجميع الموارد الداخلية، يتم إذا:

تحذير

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

1. افتح Azure portal.
2. انتقل إلى مجموعة الموارد التي تحتوي على project Foundry الخاص بك.
3. اختر حذف مجموعة الموارد وأكد الحذف.

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

• استكشف نماذج Foundry
• نشر النماذج مع Foundry