مشاركة عبر

جهز بيئة التطوير الخاصة بك

قم بإعداد بيئة التطوير الخاصة بك لاستخدام حزمة تطوير Microsoft Foundry. تحتاج أيضا إلى Azure CLI للمصادقة حتى يتمكن كودك من access بيانات اعتماد المستخدم الخاصة بك.

في هذا المقال، تقوم بتثبيت أوقات تشغيل اللغة، Azure CLI، Azure Developer CLI، إضافة Foundry VS Code، وGit.

مهم

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

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

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

  • قم بتنزيل وتثبيت وتكوين Visual Studio Code، أو بيئة التطوير التي تختارها. لمزيد من المعلومات، راجع تحميل Visual Studio Code.

  • لإنشاء وإدارة موارد Foundry، أحد الأدوار التالية في Azure RBAC

    • Azure مدير Project الذكاء الاصطناعي (لإدارة مشاريع Foundry)
    • المالك (للحصول على صلاحيات الاشتراك). المالك ضروري لتعيينات أدوار إضافية مطلوبة في سيناريوهات أخرى في Foundry. لضمان أنك غير محجب في جميع السيناريوهات في Foundry، فإن تعيين المالك هو الدور المطلوب.

  • لاستخدام project ولكن دون إنشاء موارد جديدة، تحتاج على الأقل:

    • Azure مستخدم الذكاء الاصطناعي في المشاريع التي تستخدمها (دور أقل امتياز للتطوير)

    للمزيد من التفاصيل حول أذونات كل دور، انظر Role-based access control ل Microsoft Foundry.

تثبيت لغة البرمجة

في Visual Studio Code، أنشئ مجلد جديد project الخاص بك. افتح نافذة طرفية في هذا المجلد.

أولا، أنشئ بيئة بايثون جديدة. لا تقم بتثبيت الحزم في تثبيت Python العمومي. استخدم دائما بيئة افتراضية أو بيئة كوندا عند تثبيت حزم بايثون. وإلا، يمكنك أن تكسر تثبيت بايثون بشكل عام.

إذا لزم الأمر، قم بتثبيت Python

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

إنشاء بيئة ظاهرية

إذا كان لديك بايثون 3.10 أو أعلى مثبتا بالفعل، أنشئ بيئة افتراضية باستخدام الأوامر التالية:

py -3 -m venv .venv
.venv\scripts\activate

عند تفعيل بيئة بايثون، يتم تشغيل python أو pip من سطر الأوامر باستخدام مفسر بايثون في .venv مجلد تطبيقك.

‏‫ملاحظة‬

استخدم الأمر deactivate للخروج من البيئة الافتراضية بلغة بايثون. يمكنك إعادة تفعيله لاحقا عند الحاجة.

تثبيت إضافة بايثون ل Visual Studio Code

يدعم امتداد بايثون للعبة Visual Studio Code بايثون مع IntelliSense، والتصحيح، والتنسيق، واللينتينغ، والتنقل في الكود، وإعادة الهيكلة، ومستكشف المتغيرات، ومستكشف الاختبارات، وإدارة البيئة.

تثبيت إضافة بايثون ل Visual Studio Code.

أقام:

  • Java Development Kit (JDK) 17 أو أحدث
    • نوصي بإنشاء Microsoft ل OpenJDK، وهو توزيع مجاني Long-Term الدعم (LTS) ل OpenJDK

تثبيت حزمة Visual Studio Code Extension Pack لجافا

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

تثبيت حزمة Visual Studio كود التمديد لجافا.

قم بتثبيت Node.js (ينصح بالإصدار 18 أو أحدث).

تأكد من تركيب الأدوات اللازمة لتطوير .NET.

تثبيت حزمة تطوير .NET

تحتاج إلى مجموعة تطوير البرمجيات (.NET SDK) لإنشاء وبناء وتشغيل تطبيقات .NET. نوصي بتثبيت أحدث إصدار LTS (دعم طويل الأمد) أو إصدار أحدث إذا كان ذلك مطلوبا من قبل project الخاص بك.

  1. حمل حزمة تطوير .NET من صفحة التحميل الرسمية .NET. حدد المثبت المناسب لنظام التشغيل (Windows أو Linux أو macOS).

  2. اتبع إرشادات التثبيت لنظام التشغيل الخاص بك.

  3. تحقق من التثبيت عن طريق فتح محطة طرفية أو موجه أوامر وتشغيل:

    dotnet --version

    يجب أن تكون الاستجابة هي إصدار SDK المثبت.

تثبيت مجموعة تطوير C# لكود Visual Studio

للحصول على أفضل تجربة تطوير C# في VS Code، قم بتثبيت ملحق C# Dev Kit الرسمي:

  1. افتح Visual Studio Code.
  2. انتقل إلى طريقة عرض الملحقات (Ctrl+Shift+X أو Cmd+Shift+X).
  3. ابحث عن C# Dev Kit.
  4. تثبيت الملحق المنشور بواسطة Microsoft. سيؤدي هذا أيضا إلى تثبيت ملحق C# الأساسي إذا لم يكن لديك بالفعل.

أنشئ .NET Project جديدة

يمكنك إنشاء .NET project جديد باستخدام الطرفية المدمجة في رمز Visual Studio (الطرفية الطرفية الجديدة).

على سبيل المثال، لإنشاء تطبيق وحدة تحكم جديد:

# Navigate to the directory where you want to create your project
# cd path/to/your/projects

# Create a new console application in a subfolder named MyConsoleApp
dotnet new console -o MyConsoleApp

# Navigate into the newly created project folder
cd MyConsoleApp

يمكنك الآن فتح هذا المجلد MyConsoleApp في VS Code (ملف > Open Folder...) لتبدأ العمل على project C# الخاص بك. كود VS، مع إضافة C# Dev Kit، سيكتشف project تلقائيا، مما يتيح ميزات مثل IntelliSense، والتصحيح، ومهام البناء.

تثبيت Azure CLI وتسجيل الدخول

تقوم بتثبيت Azure CLI وتسجيل الدخول من بيئة التطوير المحلية الخاصة بك، بحيث يمكنك استخدام بيانات اعتماد المستخدم الخاصة بك للاستدعاء Azure OpenAI في Microsoft Foundry Models.

في معظم الحالات يمكنك تثبيت Azure CLI من جهازك الطرفي باستخدام الأمر التالي:

winget install -e --id Microsoft.AzureCLI

يمكنك اتباع التعليمات كيفية تثبيت Azure CLI إذا لم تعمل هذه الأوامر مع نظام التشغيل أو إعدادك الخاص.

بعد تثبيت Azure CLI، سجل الدخول باستخدام أمر az login وسجل الدخول باستخدام المتصفح:

az login

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

az login --use-device-code

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

تثبيت واجهة سطر Azure Developer

واجهة Azure Developer CLI (azd) هي أداة مفتوحة المصدر تساعدك في إعداد ونشر موارد التطبيقات على Azure. يوفر أوامر بسيطة للمراحل الرئيسية من التطوير، سواء كنت تستخدم طرفية، أو بيئة تطوير (IDE)، أو CI/CD pipelines. قم بتثبيت واجهة المطور Azure لمنصتك.

تتضمن العديد من قوالب حلول الذكاء الاصطناعي خيار نشر باستخدام azd.

تثبيت امتداد Foundry VS Code

يتيح لك إضافة Foundry للعبة Visual Studio Code نشر النماذج، وبناء تطبيقات الذكاء الاصطناعي، والعمل مع الوكلاء مباشرة من واجهة VS Code. قم بتثبيت إضافة Foundry VS Code.

تثبيت Git

يتطلب Git استنساخ عينات SDK من Foundry. إذا لم يكن Git مثبتا لديك ، فاتبع التعليمات الخاصة بالنظام الأساسي الخاص بك وحدد نظام التشغيل الخاص بك.

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

مشكلة الحل
لم يتم العثور على الأمر بعد التثبيت أغلق وأعد فتح جهازك الطرفي، أو أعد تشغيل VS Code، حتى تدخل تغييرات PATH حيز التنفيذ.
az login فشل بسبب خطأ في المتصفح شغل az login --use-device-code المصادقة باستخدام تدفق كود الجهاز بدلا من ذلك.
لم يتم العثور على Python استخدمها python3 بدلا من python macOS/Linux، أو قم بتثبيت نسخة مدعومة (3.9 أو أحدث).
تم رفض الإذن أثناء التثبيت على نظام macOS/Linux، تجنب sudo pip install. استخدم بيئة افتراضية بدلا من ذلك.

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

  • Last updated on