العمل مع Microsoft Foundry لإضافة Visual Studio Code (الكلاسيكية)

المشاهدة الحالية:نسخة - التحويل إلى النسخة الخاصة ببوابة Foundry الجديدة

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

مهم

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

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

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

ثبتالملحق

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

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

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

1. افتح صفحة Foundry لصفحة Visual Studio Code التوسعة.
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 وافتح مشروع Foundry لتبدأ العمل مع النماذج، والوكلاء، والملاعب.

‏‫ملاحظة‬

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

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

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

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

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

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

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

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

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

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

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

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

‏‫ملاحظة‬

لمعرفة المزيد عن كيفية العمل مع الوكلاء في امتداد Foundry، راجع العمل مع خدمة الوكلاء في Visual Studio Code.

إنشاء مشروع

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

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

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

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

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

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

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

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

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

4. أدخل اسم مشروع Foundry في مربع النص Enter اسم المشروع واضغط Enter.

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

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

تغيير المشروع الافتراضي

عندما تفتح مشروعا في امتداد Foundry، يتم تعيين ذلك المشروع كمشروعك الافتراضي. لتغيير مشروعك الافتراضي:

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

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

يعرض المشروع المختار الآن خيار الافتراضي بعد اسم المشروع.

نصيحة

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

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

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

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

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

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

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

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

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

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

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

   

4. فلتر كتالوج النماذج حسب المستضافة، الناشر، الميزة، أو نوع النموذج باستخدام القوائم المنسدلة في أعلى الصفحة. اختر مفتاح دعمFine-Tuning لتصفية النماذج التي تدعم الضبط الدقيق.

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

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

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

نصيحة

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

حذف موارد Azure

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

تحذير

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

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

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

• العمل مع خدمة الوكلاء في Visual Studio Code
• استكشف نماذج Foundry
• نشر النماذج مع Foundry