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

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

نصيحة

Foundry DevPack هي الطريقة الموصى بها لتثبيت أدوات المطور في أمر واحد. يمكنك أيضا تثبيت كل أداة بشكل منفصل.

مهم

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

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

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

  • قم بتنزيل تعليمة Visual Studio برمجية وتثبيتها وتكوينها أو استخدام IDE الذي تختاره.

  • لإنشاء موارد Foundry وإدارتها، استخدم أحد أدوار RBAC Azure هذه:

    • Foundry Project Manager لإدارة مشاريع Foundry.

    مهم

    تم تغيير اسم أدوار RBAC في Foundry مؤخرا. Foundry User، Foundry Owner، Foundry Account Owner، وFoundry Project Manager تم تسميتها سابقا Azure مستخدم الذكاء الاصطناعي، ومالك الذكاء الاصطناعي Azure، ومالك حساب Azure الذكاء الاصطناعي، ومدير Project الذكاء الاصطناعي Azure. قد ترى الأسماء السابقة في بعض الأماكن أثناء صدور إعادة التسمية. معرفات الأدوار والأذونات الأساسية لم تتغير عند إعادة الاسم.

    • مالك الأذونات على مستوى الاشتراك وتعيينات الأدوار المطلوبة من قبل بعض السيناريوهات.

  • لاستخدام مشروع موجود دون إنشاء موارد، تحتاج على الأقل Foundry User على المشروع.

للحصول على تفاصيل حول كل دور، راجع التحكم في الوصول المستند إلى الدور ل Microsoft Foundry.

تثبيت Foundry DevPack

يقوم Foundry DevPack بتثبيت أدوات مطور Foundry للمحرر والمحطة الطرفية وعامل الترميز. قم بتشغيل الأمر لنظام التشغيل الخاص بك.

Windows

winget install Microsoft.FoundryDevPack

ماك أو إس

brew install --cask microsoft/foundry/devpack && foundry-devpack install

Linux

curl -fsSL https://aka.ms/foundry-devpack-install.sh | bash

يثبت DevPack هذه الأدوات:

الأداة ما يمكنك القيام به
Microsoft مجموعة أدوات Foundry ل تعليمة Visual Studio برمجية إنشاء واختبار وتقييم ونشر من تعليمة Visual Studio برمجية.
azd وazd ai دعم ونشر وتقييم وأتمتة من المحطة الطرفية.
لوحة المكتشف (معاينة) تصميم ونشر العوامل المستضافة باستخدام لوحة Copilot موجهة.
Microsoft مهارة المسبك امنح وكلاء الترميز إرشادات قابلة لإعادة الاستخدام لسير عمل Foundry.

تابع الأقسام التالية لإعداد لغة البرمجة الخاصة بك، وتسجيل الدخول باستخدام Azure CLI، وتثبيت Git.

العمل باستخدام لغة برمجة

استخدم اللغة التي يتطلبها التطبيق الخاص بك. قم بتوسيع مقطع إذا كنت بحاجة إلى تثبيت وقت التشغيل الخاص به أو ملحق تعليمة Visual Studio برمجية.

بايثون

قم بتثبيت Python 3.10 أو أحدث. Python 3.9 هو الحد الأدنى من الإصدار المدعوم. قم بإنشاء بيئة ظاهرية لمشروعك بدلا من تثبيت الحزم عالميا.

Windows

py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1

macOS وLinux

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

للحصول على دعم المحرر، قم بتثبيت ملحق Python تعليمة Visual Studio برمجية.

Java

تثبيت JDK 17 أو أحدث. Microsoft Build من أجل OpenJDK هو توزيع مجاني لدعم Long-Term. للحصول على دعم المحرر، قم بتثبيت حزمة ملحق تعليمة Visual Studio برمجية Java.

JavaScript/TypeScript

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

C#‎

قم بتثبيت أحدث إصدار من دعم Long-Term من .NET SDK. للحصول على دعم المحرر، قم بتثبيت C# Dev Kit ل تعليمة Visual Studio برمجية.

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

تقوم بتثبيت Azure CLI وتسجيل الدخول من بيئة التطوير المحلية لديك حتى يتمكن كودك من استخدام بيانات اعتماد المستخدم لاستدعاء خدمات Azure عبر Foundry.

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

winget install -e --id Microsoft.AzureCLI

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

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

az login

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

az login --use-device-code

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

تثبيت Git

لاستنساخ عينات Foundry SDK، تحتاج إلى Git. إذا لم يكن Git مثبتا لديك، فقم بتنزيله وتثبيته من موقع Git على الويب.

تثبيت أدوات المطور بشكل فردي

إذا كنت لا تستخدم Foundry DevPack، فقم بتثبيت كل أداة مطور بشكل منفصل:

  1. تثبيت Azure Developer CLI.
  2. تثبيت كافة ملحقات Foundry ل azd: 
    azd ext install microsoft.foundry
    لتثبيت الملحقات الفردية بدلا من ذلك، راجع تثبيت ملحقات Azure Developer CLI Foundry.
  3. تثبيت أدوات المحرر وعامل الترميز:

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

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

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

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

  • Last updated on