أنشئ مشروعا ل Microsoft Foundry (الكلاسيكي)

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

المشاهدة الحالية:نسخة - التحويل إلى النسخة الخاصة ببوابة Foundry الجديدة

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

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

• إذا كنت بحاجة إلى الوصول إلى نماذج مفتوحة المصدر أو PromptFlow، أنشئ نوع مشروع مركزي بدلا من ذلك.

• لمزيد من المعلومات حول أنواع المشاريع المختلفة، راجع أنواع المشاريع.

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

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

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

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

  إذا كنت تفتقر لهذا الدور، اطلب من مسؤول الاشتراك إنشاء مورد في Foundry ثم تخطي إنشاء عدة مشاريع على نفس المصدر.

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

بوابة المسبك

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

حزمة تطوير التطوير الخاصة لبايثون

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

• قم بتشغيل 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 Government - الولايات المتحدة أو Azure التي تديرها مناطق 21Vianet، حدد المنطقة التي تريد المصادقة عليها. هذا المثال يتحقق من صحة Azure Government - منطقة الولايات المتحدة:

  from azure.identity import AzureAuthorityHosts
  DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
  

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

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

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

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

بوابة المسبك

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

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

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

   

2. يعتمد ما تقوم به بعد ذلك على مكان تواجدك:

   • إذا لم تكن في مشروع أو لم يكن لديك أي مشاريع بعد: اختر إنشاء جديد في أعلى اليمين لإنشاء مشروع Foundry جديد

     

   • إذا كنت في مشروع: حدد مسار التنقل للمشروع، ثم حدد إنشاء مورد جديد.

     

3. اختر مورد Foundry، ثم اختر التالي.

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

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

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

   نصيحة

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

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

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

حزمة تطوير التطوير الخاصة لبايثون

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

• أضف الكود التالي لإنشاء مشروع 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.

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 إنشاء المشاريع ضمن هذا المصدر.

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

   az cognitiveservices account update \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --custom-domain my-foundry-resource
   

4. إنشاء المشروع. على سبيل المثال، إنشاء 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. تحقق من إنشاء المشروع:

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

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

المرجع: حساب az cognitiveservices

إنشاء مشاريع متعددة على نفس المورد

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

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

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

الميزة	المشروع الافتراضي	مشاريع أخرى
الاستدلال النموذجي	✅	✅
Playgrounds	✅	✅
Agents	✅	✅
Evaluations	✅	✅
Tracing	✅	✅
Datasets	✅	✅
الفهارس	✅	✅
Foundry SDK وواجهة برمجة التطبيقات	✅	✅
فهم المحتوى	✅	✅
OpenAI SDK وواجهة برمجة التطبيقات	✅	الردود، الملفات، المحادثات
دفعة OpenAI ، الضبط الدقيق ، الإكمال المخزنة	✅	-
الضبط الدقيق للغة	✅	✅
ضبط الكلام	✅	-
Connections	✅	✅

• لإضافة مشروع إلى مورد مسبك:

  بوابة المسبك

  نصيحة

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

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

     

  2. اختر إما مشروع Foundry أو المورد المرتبط به.

  3. في الجزء الأيمن، حدد مركز الإدارة.

  4. في قسم المورد، حدد نظرة عامة.

  5. حدد مشروع جديد وأدخل اسما.

     

  حزمة تطوير التطوير الخاصة لبايثون

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

  # 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، فسيصبح المشروع التالي الذي تم إنشاؤه هو المشروع الافتراضي.

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

بوابة المسبك

في صفحة المشروع الرئيسية ، ستجد معلومات عن المشروع.

• الاسم: يظهر اسم المشروع في الزاوية العلوية اليسرى.
• الاشتراك: الاشتراك الذي يستضيف المورد الذي يستضيف المشروع.
• مجموعة الموارد: مجموعة الموارد التي تستضيف المورد الذي يستضيف المشروع.

حزمة تطوير التطوير الخاصة لبايثون

# 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

حذف المشاريع

بوابة المسبك

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

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

1. في مركز الإدارة، اختر اسم المورد من قسم النظرة العامة للذهاب إلى بوابة Azure.
2. في بوابة Azure، اختر Delete لحذف المورد وجميع المشاريع المرتبطة به.

حزمة تطوير التطوير الخاصة لبايثون

يستخدم هذا الكود المتغيرات والربط 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 حساب مشروع حذف.

مهم

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

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

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

• مايكروسوفت فاوندري كويك ستارت
• ما هو Foundry؟
• إنشاء موارد باستخدام قالب بايسيب