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

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

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

مهم

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

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

حساب Azure مع اشتراك نشط. إذا لم يكن لديك واحد، أنشئ حساب Azure مجاني مجاني، يشمل اشتراكا تجريبيا مجانيا.
قم بتنزيل وتثبيت وتكوين تعليمة Visual Studio برمجية، أو بيئة التطوير التي تختارها. لمزيد من المعلومات، انظر تحميل تعليمة Visual Studio برمجية.
لإنشاء وإدارة موارد Foundry، أحد الأدوار التالية في Azure RBAC
- Foundry Project Manager (لإدارة مشاريع Foundry)
  
  مهم
  
  تم تغيير اسم أدوار RBAC في Foundry مؤخرا. Foundry User، Foundry Owner، Foundry Account Owner، وFoundry Project Manager تم تسميتها سابقا Azure مستخدم الذكاء الاصطناعي، ومالك الذكاء الاصطناعي Azure، ومالك حساب Azure الذكاء الاصطناعي، ومدير Project الذكاء الاصطناعي Azure. قد ترى الأسماء السابقة في بعض الأماكن أثناء صدور إعادة التسمية. معرفات الأدوار والأذونات الأساسية لم تتغير عند إعادة الاسم.
- المالك (للحصول على صلاحيات الاشتراك). المالك ضروري لتعيينات أدوار إضافية مطلوبة في سيناريوهات أخرى في Foundry. لضمان أنك غير محجب في جميع السيناريوهات في Foundry، فإن تعيين المالك هو الدور المطلوب.
لاستخدام project ولكن دون إنشاء موارد جديدة، تحتاج على الأقل:
- مستخدم Foundry في المشاريع التي تستخدمها (دور أقل امتيازات للتطوير)
للحصول على تفاصيل حول صلاحيات كل دور، انظر التحكم في الوصول القائم على الأدوار ل Microsoft Foundry.

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

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

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

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

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

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

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

Windows
Linux
macOS

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

python3 -m venv .venv
source .venv/bin/activate

python3 -m venv .venv
source .venv/bin/activate

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

‏‫ملاحظة‬

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

تثبيت إضافة Python ل تعليمة Visual Studio برمجية

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

قم بتركيب امتداد Python ل تعليمة Visual Studio برمجية.

أقام:

مجموعة تطوير Java (JDK) 17 أو أحدث
- نوصي ب Microsoft Build من أجل OpenJDK، وهو توزيع مجاني لدعم Long-Term (LTS) من OpenJDK

تثبيت حزمة تعليمة Visual Studio برمجية Extension Pack للعبة Java

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

قم بتركيب حزمة التمديد تعليمة Visual Studio برمجية ل Java.

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

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

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

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

حمل حزمة تطوير .NET من صفحة التحميل الرسمية .NET. اختر المثبت المناسب لنظام التشغيل الخاص بك (Windows، Linux، أو macOS).
اتبع إرشادات التثبيت لنظام التشغيل الخاص بك.
تحقق من التثبيت عن طريق فتح محطة طرفية أو موجه أوامر وتشغيل:
```
dotnet --version
```
يجب أن تكون الاستجابة هي إصدار SDK المثبت.

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

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

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

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

يمكنك إنشاء مشروع .NET جديد باستخدام الطرفية المدمجة في تعليمة 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 عبر Foundry.

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

Windows
Linux
macOS

winget install -e --id Microsoft.AzureCLI

curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

brew update && brew install azure-cli

يمكنك اتباع التعليمات كيفية تثبيت 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 برمجية نشر النماذج، وبناء تطبيقات الذكاء الاصطناعي، والعمل مع الوكلاء مباشرة من واجهة 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`. استخدم بيئة افتراضية بدلا من ذلك.