إنشاء مشروع ل Microsoft Foundry

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

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

إذا كانت مؤسستك تحتاج إلى إعدادات Azure مخصصة مثل الأسماء البديلة، أو ضوابط الأمان، أو علامات التكاليف، فقد تحتاج إلى استخدام Azure portal أو خيارات template للامتثال لمتطلبات نهج Azure لمنظمتك.

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

• حساب 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 لأعضاء الفريق الذين يحتاجون إلى الوصول.

استخدم علامات التبويب التالية لاختيار الطريقة التي تريد استخدامها لإنشاء مشروع Foundry:

بوابة المصنع

• لا حاجة لأي متطلبات أخرى عند استخدام البوابة.

Python SDK

• قم بإعداد بيئة التطوير الخاصة بك.

• شغل az login أو az login --use-device-code في بيئتك قبل تشغيل الكود.

• تثبيت الحزم: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0. إذا كنت في خلية دفتر ملاحظات، استخدمها %pip install بدلا من ذلك.

• استخدمها pip show azure-mgmt-cognitiveservices للتحقق من أن نسختك 13.7 أو أعلى.

• التحقق السريع: قبل إنشاء مشروع، تحقق من SDK والمصادقة من خلال اختبار العميل:

  from azure.identity import DefaultAzureCredential
  from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
  
  # Test authentication by instantiating the client
  credential = DefaultAzureCredential()
  subscription_id = "<your-subscription-id>"  # Replace with your subscription ID
  client = CognitiveServicesManagementClient(credential, subscription_id)
  print("✓ Authentication successful! Ready to create a project.")
  

• ابدأ سكريبتيك بالكود التالي لإنشاء client الاتصال والمتغيرات المستخدمة في هذا المقال. هذا المثال يخلق المشروع في شرق الولايات المتحدة:

  from azure.identity import DefaultAzureCredential
  from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
  
  subscription_id = 'your-subscription-id'
  resource_group_name = 'your-resource-group-name'
  foundry_resource_name = 'your-foundry-resource-name'
  foundry_project_name = 'your-foundry-project-name'
  location = 'eastus'
  
  client = CognitiveServicesManagementClient(
      credential=DefaultAzureCredential(), 
      subscription_id=subscription_id,
      api_version="2025-04-01-preview"
  )
  

• (اختياري) إذا كان لديك عدة حسابات، أضف معرف المستأجر Microsoft Entra ID الذي تريد استخدامه في DefaultAzureCredential:

  DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
  

• قم بتثبيت Azure CLI.
• قم بتعيين القيمة الافتراضية ل subscription.

# Set your default subscription
az account set --subscription "{subscription-name}"

إنشاء مشروع مسبك

استخدم إحدى الطرق التالية.

بوابة المصنع

توفر هذه الخطوات طريقة لإنشاء مورد Azure جديد بإعدادات افتراضية أساسية.

لإنشاء مشروع Foundry، اتبع الخطوات التالية:

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

   

2. المشروع الذي تعمل عليه يظهر في الزاوية العلوية اليسرى.

3. لإنشاء مشروع جديد، اختر اسم المشروع، ثم اختر إنشاء مشروع جديد.

4. أعط مشروعك اسما واختر إنشاء مشروع. أو راجع القسم التالي للخيارات المتقدمة.

الخيارات المتقدمة

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

   نصيحة

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

2. اختر موقعا أو استخدم الافتراضي. الموقع هو المنطقة التي تستضيف فيها موارد المشروع.

3. اختر الإنشاء. ترى تقدم إنشاء الموارد. يتم إنشاء المشروع عند اكتمال العملية.

Python SDK

لإنشاء مشروع Foundry:

• أضف الكود التالي لإنشاء مشروع Foundry باستخدام المتغيرات والاتصال client من قسم المتطلبات المسبقة.

  # Create resource
  resource = client.accounts.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      account={
          "location": location,
          "kind": "AIServices",
          "sku": {"name": "S0",},
          "identity": {"type": "SystemAssigned"},
          "properties": {
              "allowProjectManagement": True,
              "customSubDomainName": foundry_resource_name
          }
      }
  )
  
  # Wait for the resource creation to complete
  resource_result = resource.result()
  
  # Create default project
  project = client.projects.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      project_name=foundry_project_name,
      project={
          "location": location,
          "identity": {
              "type": "SystemAssigned"
          },
          "properties": {}
      }
  )
  

  المراجع: CognitiveServices ManagementClient.

ملحوظة

تتطلب هذه الخطوات دور 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الإخراج .

أنشئ عدة مشاريع على نفس المورد

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

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

بينما ليست كل قدرات Foundry تدعم تنظيم العمل في المشاريع بعد، فإن المشروع "الافتراضي" الأول لمصدرك يكون أكثر قوة. يمكنك التعرف عليه من خلال الوسم "default" في تجارب تجربة المستخدم وخاصية المورد "is_default" عند استخدام خيارات الكود.

الميزة	المشروع الافتراضي	مشاريع أخرى
استنتاج النموذج	✅	✅
الملاعب	✅	✅
الوكلاء	✅	✅
التقييمات	✅	✅
التتبع	✅	✅
مجموعات البيانات	✅	✅
الفهارس	✅	✅
حزمة تطوير اللعبة وواجهة برمجة التطبيقات (API) لفاوندري	✅	✅
فهم المحتوى	✅	✅
حزمة تطوير البرمجيات وواجهة برمجة التطبيقات OpenAI	✅	الردود، الملفات، المحادثات
دفعة OpenAI، الضبط الدقيق، إكمال التخزين	✅	-
الضبط الدقيق للغة	✅	✅
ضبط الكلام بدقة	✅	-
الروابط	✅	✅

• لإضافة مشروع إلى مورد من Foundry:

  بوابة المصنع

  1. حدد إدارة في التنقل العلوي الأيمن.
  2. حدد Resource details في الجزء الأيمن.
  3. اختر إضافة مشروع.

  Python SDK

  أضف هذا الكود إلى سكريبتيك لإنشاء مشروع جديد على موردك الحالي:

  # Create additional project
  new_project_name = 'your-new-project-name'
  
  project = client.projects.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      project_name=new_project_name,
      project={
          "location": location,
          "identity": {
              "type": "SystemAssigned"
          },
          "properties": {}
      }
  )
  

  لإضافة مشروع جديد إلى my-foundry-resource:

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

• إذا حذفت المشروع الافتراضي لمورد Foundry الخاص بك، سيصبح المشروع التالي الذي تم إنشاؤه هو المشروع الافتراضي.

عرض إعدادات المشروع

بوابة المصنع

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

Python SDK

# Get project
project = client.projects.get(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    project_name=foundry_project_name
)
print(project)

المراجع: CognitiveServices ManagementClient.

لعرض إعدادات المشروع، استخدم الأمر az cognitiveservices account project show . على سبيل المثال:

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

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

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

مهم

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

مهم

لإكمال توزيع الأدوار، تحتاج إلى دور مثل المالك في المشروع. لمزيد من المعلومات، راجع التحكم في الوصول القائم على الأدوار ل Microsoft Foundry.

بوابة المصنع

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

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

نصيحة

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

Python SDK

استخدم بوابة Azure CLI أو Foundry لإدارة تعيينات الأدوار. حزمة تطوير تطوير Python لا تدعم عمليات تعيين الأدوار.

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

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

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

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

حذف المشاريع

بوابة المصنع

1. سجل الدخول إلى Microsoft Foundry. تأكد من تفعيل مفتاح New Foundry . تشير هذه الخطوات إلى Foundry (جديد).
2. في شريط التنقل العلوي الأيمن، حدد إدارة.
3. في الجزء الأيمن، حدد Project التفاصيل.
4. في أعلى اليمين، اختر أيقونة سلة المهملات لحذف المشروع.

Python SDK

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

client.projects.begin_delete(
    resource_group_name, foundry_resource_name, foundry_project_name
)

المراجع: CognitiveServices ManagementClient.

حذف مورد من Foundry وجميع مشاريعه:

# Delete projects
projects = client.projects.list(resource_group_name, foundry_resource_name)

for project in projects: 
    print("Deleting project:", project.name)
    client.projects.begin_delete(resource_group_name, foundry_resource_name,
        project_name=project.name.split('/')[-1]
    ).wait()

# Delete resource
print("Deleting resource:", foundry_resource_name)
client.accounts.begin_delete(resource_group_name, foundry_resource_name).wait()

المراجع: CognitiveServices ManagementClient.

شغل الأمر التالي:

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

المراجع: az cognitiveservices حساب مشروع حذف.

مهم

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

أنشئ أول اتصال لك

محتوى ذو صلة

• المهام ذات الأدوار المرتفعة في Microsoft Foundry — متطلبات الأدوار لإنشاء الموارد والمشاريع.
• التشغيل السريع Microsoft Foundry
• ما هو Foundry؟
• إنشاء الموارد باستخدام قالب Bicep