إنشاء project ل Microsoft Foundry

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

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

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

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

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

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

استخدم علامات التبويب التالية لاختيار الطريقة التي تريد استخدامها لإنشاء project 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 التالية لإنشاء الاتصال والمتغيرات المستخدمة خلال هذه المقالة. هذا المثال ينشئ project في شرق الولايات المتحدة:

  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}"

إنشاء project Foundry

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

بوابة المسبك

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

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

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

   

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

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

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

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

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

   نصيحة

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

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

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

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

لإنشاء project 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": {}
      }
  )
  

  المراجع: CognitiveServicesManagementClient.

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

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

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

يوضح

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

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

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

• لإضافة project إلى مورد في Foundry:

  بوابة المسبك

  1. حدد تشغيل في شريط التنقل العلوي الأيسر.
  2. حدد المسؤول في الجزء الأيمن.
  3. اختر المورد الأصلي الذي تريد إضافة مشروع إليه.
  4. اختر إضافة مشروع.

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

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

  # 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": {}
      }
  )
  

  لإضافة project جديد إلى my-foundry-resource:

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

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

عرض إعدادات project

بوابة المسبك

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

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

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

المراجع: CognitiveServicesManagementClient.

لعرض إعدادات project، استخدم أمر 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. اختر project الخاص بك.
5. في أعلى اليمين، اختر أيقونة صندوق المهملات لحذف project.

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

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

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

المراجع: CognitiveServicesManagementClient.

حذف مورد من 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()

المراجع: CognitiveServicesManagementClient.

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

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

المراجع: <حساب project cognitiveservices c0>az delete.

مهم

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

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

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

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