البدء السريع: إعداد موارد Microsoft Foundry

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

نصيحة

تظهر لك هذه البداية السريعة كيفية إنشاء موارد لبناء وكيل بإعداد أساسي. للسيناريوهات الأكثر تقدما التي تستخدم مواردك الخاصة، راجع إعداد بيئتك لتطوير الوكلاء.

المتطلبات الأساسية

• حساب Azure مع اشتراك نشط. إذا لم يكن لديك واحد، أنشئ حساب Azure مجاني مجاني، يشمل اشتراكا تجريبيا مجانيا.
• إذا كنت تنشئ المشروع لنفسك:
  • الوصول إلى دور يسمح لك بإنشاء مورد في Foundry، مثل مالك حساب Foundry أو Foundry Owner على مجموعة الاشتراك أو الموارد. لمزيد من المعلومات حول الأذونات، راجع التحكم في الوصول القائم على الأدوار ل Microsoft Foundry.

    مهم

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

• إذا كنت تنشئ المشروع لفريق:
  • الوصول إلى دور يسمح لك بإكمال تعيينات الأدوار، مثل المالك. لمزيد من المعلومات حول الأذونات، راجع التحكم في الوصول القائم على الأدوار ل Microsoft Foundry.
  • قائمة بعناوين البريد الإلكتروني للمستخدمين أو معرفات مجموعات الأمان في Microsoft Entra لأعضاء الفريق الذين يحتاجون إلى الوصول.

اختر طريقتك المفضلة باستخدام علامات التبويب التالية:

• قم بتثبيت الإصدار 2.67.0 أو الإصدار Azure CLI (تحقق من az version).

• تسجيل الدخول إلى Azure:

  az login
  

بوابة المصنع

• الوصول إلى بوابة Microsoft Foundry.

أنشئ مشروعا

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

نصيحة

أنشئ مشروعك في منطقة غرب الولايات المتحدة 3 إذا أردت تجربة نموذج فوري (معاينة).

ملحوظة

تتطلب هذه الخطوات دور Azure CLI ودور المساهم أو المالك في مجموعة الموارد. اذهب az login لتسجيل الدخول قبل أن تبدأ. للمناطق المدعومة، انظر دعم المناطق.

1. أنشئ مجموعة موارد أو استخدم مجموعة موجودة. على سبيل المثال، إنشاء my-foundry-rg في eastus:

   az group create --name my-foundry-rg --location eastus
   

2. أنشئ مورد Foundry مع تفعيل إدارة المشروع. على سبيل المثال، إنشاء my-foundry-resource في my-foundry-rg مجموعة الموارد:

   az cognitiveservices account create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --kind AIServices \
       --sku S0 \
       --location eastus \
       --custom-domain my-foundry-resource \
       --allow-project-management
   

   اضبط العلم --allow-project-management لتمكين إدارة المشروع. لا يمكنك تغيير هذا العلم بعد إنشاء الموارد. يجب أن تكون القيمة --custom-domain فريدة عالميا - إذا my-foundry-resource تم أخذها بالفعل، اختر اسما مختلفا.

3. أنشئ مشروعا. على سبيل المثال، إنشاء my-foundry-project في :my-foundry-resource

   az cognitiveservices account project create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --project-name my-foundry-project \
       --location eastus
   

4. تحقق من أن المورد موجه لها:

   az cognitiveservices account show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --query properties.provisioningState --output tsv
   

   يجب أن يظهر Succeededالإخراج . إذا أظهر الناتج حالة مختلفة، تحقق من الأذونات، وتوفر المنطقة، وحصص الموارد. لمزيد من المساعدة، راجع إنشاء مورد متعدد الخدمات.

5. تحقق من إنشاء المشروع:

   az cognitiveservices account project show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --project-name my-foundry-project \
       --query properties.provisioningState --output tsv
   

   يجب أن يظهر Succeededالإخراج .

بوابة المصنع

1. سجل الدخول إلى Microsoft Foundry. تأكد من تفعيل مفتاح New Foundry . تشير هذه الخطوات إلى Foundry (جديد).

   

2. أنشئ مشروعا.

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

3. أدخل اسم المشروع، مثل my-foundry-project.

4. اختر الخيارات المتقدمة لتكوين مجموعة الموارد والموقع:

   • مجموعة الموارد: أنشئ مجموعة موارد جديدة أو اختر مجموعة موجودة. إذا أنشأت مجموعة موارد جديدة، يمكنك إدارة المشروع وجميع موارده معا بسهولة أكبر.
   • الموقع: اختر المنطقة الأقرب إلى فريقك.

5. اختر إنشاء مشروع.

   انتظر حتى يتم إنشاء المشروع. عندما تظهر صفحة نظرة عامة على المشروع، يكون مشروعك جاهزا.

نشر نموذج

نشر نموذجا يمكنك استخدامه. يستخدم هذا المثال gpt-5.1-mini، لكن يمكنك اختيار أي موديل متاح.

نصيحة

لتجربة نموذج وصول فوري (معاينة)، يمكنك تخطي هذه الخطوة.

az cognitiveservices account deployment create \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-5.1-mini \
    --model-name gpt-5.1-mini \
    --model-version "2025-04-14" \
    --model-format OpenAI \
    --sku-capacity 10 \
    --sku-name Standard

تحقق من نجاح النشر:

az cognitiveservices account deployment show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-5.1-mini

عندما يكون النشر جاهزا، يظهر "provisioningState": "Succeeded"الناتج .

المرجع: az cognitiveservices account deployment

بوابة المصنع

1. اختر اكتشاف في التنقل العلوي الأيمن، ثم النماذج في اللوحة اليسرى.
2. ابحث عن gpt-5.1-mini.
3. اختر إعدادات النشر>الافتراضية لإضافتها إلى مشروعك.
4. لاحظ اسم النشر (على سبيل المثال، gpt-5.1-mini). فريقك يحتاج هذا الاسم لاستخدام النموذج.

احصل على تفاصيل الاتصال بمشروعك

تحتاج إلى أن تتصل نقطة نهاية مشروعك من الكود. إذا كنت تدير هذا المشروع للآخرين، أرسل لهم هذه النقطة النهائية مع اسم النشر.

1. سجل الدخول إلى Microsoft Foundry باستخدام حسابك Azure.
2. اختر مشروعك.
3. ابحث عن نقطة نهاية مشروعك في شاشة الترحيب بالمشروع.
4. انسخ قيمة نقطة النهاية. تستخدم هذه القيمة في البدء السريع والدروس الأخرى.

للمسؤولين - منح الوصول

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

مهم

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

1. احصل على معرف مورد المشروع:

   PROJECT_ID=$(az cognitiveservices account project show \
     --name my-foundry-resource \
     --resource-group my-foundry-rg \
     --project-name my-foundry-project \
     --query id -o tsv)
   

2. تعيين دور مستخدم المسبك لأحد أعضاء الفريق:

   مهم

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

   az role assignment create \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --assignee "user@contoso.com" \
       --scope $PROJECT_ID
   

ملحوظة

نظرا لأن أدوار RBAC في Foundry تم إعادة تسميتها مؤخرا، استخدم معرف تعريف الأدوار (GUID) بدلا من اسم الدور في كودك لتجنب المشاكل أثناء طرح إعادة التسمية:

• مستخدم المسبك: 53ca6127-db72-4b80-b1b0-d745d6d5456d
• مالك المصنع: c883944f-8b7b-4483-af10-35834be79c4a
• مالك حساب Foundry: e47c6f54-e4a2-4754-9501-8e0985b135e1
• مدير Project المسبك: eadc314b-1a2d-4efa-be10-5d325db5065e

لإضافة مجموعة أمان بدلا من مستخدم فردي:

az role assignment create \
    --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
    --assignee-object-id "<security-group-object-id>" \
    --assignee-principal-type Group \
    --scope $PROJECT_ID

1. تحقق من تعيين الدور:

   az role assignment list \
       --scope $PROJECT_ID \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --output table
   

مرجع: تعيين أدوار az

بوابة المصنع

1. في بوابة المصنع، اختر التشغيل في التنقل العلوي الأيمن.
2. اختر المسؤول في اللوحة اليسرى.
3. اختر اسم مشروعك في الجدول.
4. اختر إضافة مستخدم في أعلى اليمين.
5. أدخل عنوان البريد الإلكتروني لعضو الفريق.
6. اختر إضافة.

كرر هذه الخطوات لكل عضو في الفريق أو مجموعة أمنية.

نصيحة

لإضافة عدة مستخدمين في نفس الوقت، استخدم مجموعة أمان Microsoft Entra بدلا من عناوين البريد الإلكتروني الفردية.

تحقق من وصول أعضاء الفريق

اطلب من أحد أعضاء الفريق التحقق من وصوله بتسجيل الدخول إلى Microsoft Foundry واختيار المشروع من قائمة المشاريع.

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

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

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

عندما لا ترغب في هذا المشروع بعد الآن، قم بحذف مجموعة الموارد لحذف جميع الموارد المرتبطة بها.

az group delete --name my-foundry-rg --yes --no-wait

بوابة المصنع

في بوابة Azure، ابحث عن مجموعة الموارد الخاصة بك واخترها. اختر خيار الحذف وتأكد من حذف مجموعة الموارد وجميع الموارد المرتبطة بها.

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

Microsoft Foundry Quickstart