مشاركة عبر


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

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

نصيحة

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

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

  • حساب Azure مع اشتراك نشط. إذا لم يكن لديك واحد، أنشئ حساب Azure مجاني مجاني، يشمل اشتراكا تجريبيا مجانيا.
  • إذا كنت تنشئ project لنفسك:
    • Access إلى دور يسمح لك بإنشاء مورد في Foundry، مثل Azure مالك الحساب الذكي أو Azure مالك الذكاء الاصطناعي في مجموعة الاشتراك أو الموارد. لمزيد من المعلومات حول الأدوان، راجع Role-based access control ل Microsoft Foundry.
  • إذا كنت تنشئ project لفريق:
    • Access إلى دور يسمح لك بإكمال تعيينات الأدوار، مثل Owner. لمزيد من المعلومات حول الأدوان، راجع Role-based access control ل Microsoft Foundry.
    • قائمة بعناوين البريد الإلكتروني للمستخدمين أو معرفات مجموعات الأمان في Microsoft Entra لأعضاء الفريق الذين يحتاجون إلى access.

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

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

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

    az login
    

إنشاء project

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

  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 \
       --allow-project-management
    

    علم --allow-project-management يتيح project إنشاء الإنشاء ضمن هذا المصدر.

  3. أنشئ نطاقا فرعيا مخصصا للمورد. يجب أن يكون اسم custom domain فريدا عالميا. إذا my-foundry-resource كان يشغل، جرب اسما أكثر تميزا.

    az cognitiveservices account update \
        --name my-foundry-resource \
        --resource-group my-foundry-rg \
        --custom-domain my-foundry-resource
    
  4. أنشئ project. على سبيل المثال، أنشئ 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
    
  5. تأكد من إنشاء project:

    az cognitiveservices account project show \
        --name my-foundry-resource \
        --resource-group my-foundry-rg \
        --project-name my-foundry-project
    

    يعرض الإخراج خصائص project، بما في ذلك معرف المورد الخاص به.

المرجع: az cognitiveservices account

توزيع النموذج

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

az cognitiveservices account deployment create \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-4.1-mini \
    --model-name gpt-4.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-4.1-mini

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

المرجع: az cognitiveservices account deployment

احصل على تفاصيل project connection الخاصة بك

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

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

للمسؤولين - منح access

إذا كنت تدير فريقا، قم بتعيين دور المستخدم الذكاء الاصطناعي ><Azure لأعضاء الفريق ليتمكنوا من استخدام project والنماذج المنتشرة. يوفر هذا الدور الحد الأدنى من الأذونات اللازمة لبناء واختبار تطبيقات الذكاء الاصطناعي. بالنسبة للأدوار الأخرى التي قد تحتاج إلى تعيينها، انظر Role-based access control ل Microsoft Foundry

  1. احصل على معرف الموارد الخاص ب project:

    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. تعيين دور المستخدم الذكي Azure لأحد أعضاء الفريق:

    az role assignment create \
        --role "Azure AI User" \
        --assignee "user@contoso.com" \
        --scope $PROJECT_ID
    

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

    az role assignment create \
        --role "Azure AI User" \
        --assignee-object-id "<security-group-object-id>" \
        --assignee-principal-type Group \
        --scope $PROJECT_ID
    
  3. تحقق من تعيين الدور:

    az role assignment list \
        --scope $PROJECT_ID \
        --role "Azure AI User" \
        --output table
    

المصدر: <تعيين الأدوار c0>az

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

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

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

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

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

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

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