Microsoft Foundry için proje oluşturma

Bu makalede Microsoft Foundry'de bir Foundry projesinin nasıl oluşturulacağı açıklanır. Projeler, dosyalar, aracılar ve değerlendirmeler gibi çalışmalarınızı düzenlemenizi sağlarken, durum odaklı uygulamalar oluşturup yeni fikirleri keşfetmenize olanak tanır.

Kuruluşunuz alternatif adlar, güvenlik denetimleri veya maliyet etiketleri gibi özelleştirilmiş Azure yapılandırmaları gerektiriyorsa, kuruluşunuzun Azure İlkesi gereksinimlerine uymak için Azure portalını veya şablon seçeneklerini kullanmanız gerekebilir.

Önkoşullar

• Aktif bir aboneliğe sahip bir Azure hesabı. Hesabınız yoksa ücretsiz deneme aboneliği içeren ücretsiz bir Azure hesabı oluşturun.

• Bir abonelikte veya kaynak grubunda Azure Hesabı Yapay Zeka Sahibi veya Azure AI Sahibi gibi bir Dökümhane kaynağı oluşturmanıza olanak tanıyan bir role erişim. İzinler hakkında daha fazla bilgi için bkz. Microsoft Foundry için rol tabanlı erişim denetimi.

• Foundry projesi oluşturmak için kullanmak istediğiniz yöntemi seçmek için aşağıdaki sekmeleri kullanın:

  Dökümhane portalı

  • Aktif bir aboneliğe sahip bir Azure hesabı. Hesabınız yoksa ücretsiz deneme aboneliği içeren ücretsiz bir Azure hesabı oluşturun.

  Python SDK'sı

  • Geliştirme ortamınızı ayarlama

  • Kodu çalıştırmadan önce ortamınızda az login veya az login --use-device-code'i çalıştırın.

  • Hızlı doğrulama: Proje oluşturmadan önce istemciyi test ederek SDK'nızın ve kimlik doğrulamanızın çalıştığını doğrulayın:

    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.")
    

  • Python betiğinizi başlatmak için şu adımları tamamlayın:

    1. Paketleri yükleyin: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0b1. Not defteri hücresindeyseniz, bunun yerine %pip install kullanın.

    2. Sürümünüzün 13.7 veya üzeri olup olmadığını denetlemek için kullanın pip show azure-mgmt-cognitiveservices .

    3. Bu makale boyunca kullanılan bağlantıyı ve değişkenleri oluşturmak client için betiğinizi aşağıdaki kodla başlatın. Bu örnek projeyi Doğu ABD'de oluşturur:

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

    4. (İsteğe bağlı) Birden çok hesabınız varsa, kullanmak istediğiniz Microsoft Entra Kimliğinin kiracı kimliğini içine DefaultAzureCredentialekleyin.

       DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
       

  Azure CLI

  • Azure CLI’yi yükleyin.

  • için subscriptionvarsayılan değerleri ayarlayın.

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

Dökümhane projesi oluşturma

Dökümhane portalı

Bu adımlar temel, varsayılan ayarlarla yeni bir Azure kaynağı oluşturmanın bir yolunu sağlar.

Dökümhane projesi oluşturmak için şu adımları izleyin:

1. Microsoft Foundry'de oturum açın. Yeni Dökümhane anahtarının açık olduğundan emin olun. Bu aşamalar Foundry (yeni) konusuna yöneliktir.

   

2. Üzerinde çalıştığınız proje sol üst köşede görünür.

3. Yeni proje oluşturmak için proje adını ve ardından Yeni proje oluştur'u seçin.

4. Projenize bir ad verin ve Proje oluştur'u seçin. Gelişmiş seçenekler için sonraki bölüme de göz atabilirsiniz.

Gelişmiş seçenekler

1. Bir Foundry kaynağında dökümhane projesi oluşturursunuz. Projeyi oluşturduğunuzda portal bu kaynağı otomatik olarak oluşturur. Kullanılacak mevcut bir Kaynak grubunu seçin veya yeni bir kaynak grubu oluşturmak için varsayılan olarak bırakın.

   Tavsiye

   Özellikle başlangıç için projeniz için yeni bir kaynak grubu oluşturun. Kaynak grubu, projeyi ve tüm kaynaklarını birlikte yönetmeyi kolaylaştırır.

2. Bir Konum seçin veya varsayılanı kullanın. Konum, proje kaynaklarının barındırıldığı bölgedir.

3. Oluştur'i seçin. Kaynak oluşturma işleminin ilerleme durumunu görürsünüz. İşlem tamamlandığında proje oluşturulur.

Python SDK'sı

Foundry projesi oluşturmak için:

• Önkoşullar'dan değişkenleri ve client bağlantıyı kullanarak bir Foundry projesi oluşturmak için aşağıdaki kodu ekleyin.

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

  Referanslar: CognitiveServicesManagementClient.

Azure CLI

1. Bir kaynak grubu oluşturun veya var olan bir grubu kullanın. Örneğin, my-foundry-rg içinde eastus oluşturun:

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

2. Foundry kaynağını oluşturun. Örneğin, my-foundry-resource kaynağını my-foundry-rg kaynak grubunda oluşturun.

   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 bayrağı bu kaynak içinde proje oluşturmayı etkinleştirir.

3. Kaynak için özel bir alt alan adı oluşturun. Özel etki alanı adı küresel olarak benzersiz olmalıdır. my-foundry-resource alınırsa, daha özgün bir ad deneyin.

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

4. Projeyi oluşturun. Örneğin, my-foundry-project içinde my-foundry-resource oluşturun.

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

5. Projenin oluşturulduğunu doğrulayın:

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

   Çıkış, kaynak kimliği de dahil olmak üzere proje özelliklerini görüntüler.

Referans: az bilişsel servisler hesabı

Aynı kaynakta birden çok proje oluşturma

Güvenlik, dağıtımlar ve bağlı araçlar dahil olmak üzere ekip işbirliğini ve paylaşılan kaynak erişimini etkinleştirmek için mevcut Foundry bir kaynakta birden çok Dökümhane projesi oluşturun. Bu kurulum, geliştiricilerin önceden yapılandırılmış bir ortamın kurulumunda self servis keşif özelliğine ihtiyaç duyduğu kısıtlı Azure aboneliklerinde idealdir.

Azure alt kaynakları olarak Foundry projeleri, kendi erişim denetimlerine atanabilir, ancak üst kaynaklarından ağ güvenliği, dağıtım yapılandırmaları ve Azure araç entegrasyonu gibi ortak ayarları paylaşabilir.

Tüm Foundry özellikleri henüz projelerde çalışmayı düzenlemeyi desteklemese de, kaynağınızın ilk "varsayılan" projesi daha güçlüdür. Kod seçeneklerini kullanırken bunu UX deneyimlerinde "varsayılan" etiketine ve "is_default" kaynak özelliğine göre tanımlayabilirsiniz.

Özellik	Varsayılan proje	Diğer projeler
Model tahmini	✅	✅
Oyun Alanları	✅	✅
Agents	✅	✅
Evaluations	✅	✅
Takip Etme	✅	✅
Veri Setleri	✅	✅
Dizinler	✅	✅
Döküm SDK'sı ve API	✅	✅
İçerik anlama	✅	✅
OpenAI SDK ve API	✅	Yanıtlar, Dosyalar, Konuşmalar
OpenAI Batch, İnce Ayarlama, Depolanan tamamlamalar	✅	-
Dil ayarı optimizasyonu	✅	✅
Konuşmada ince ayarlama	✅	-
Bağlantılar	✅	✅

• Bir Dökümhane kaynağına proje eklemek için:

  Dökümhane portalı

  Foundry (yeni) portalı, her Foundry kaynağı için yalnızca varsayılan projeyi görüntüler. Foundry (yeni) portalında birden fazla proje oluşturamaz veya varsayılan olmayan projeleri görüntüleyemezsiniz.

  Python SDK'sı

  Bu kod kaynağa ek projeler ekleyebildiğinden, bunları Foundry (yeni) portalında görüntüleyemezsiniz. Dökümhane (yeni) portalında yalnızca kaynak için varsayılan proje kullanılabilir.
  Mevcut kaynağınızda yeni bir proje oluşturmak için bu kodu betiğinize ekleyin:

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

  Azure CLI

  Bu kod kaynağa ek projeler ekleyebildiğinden, bunları Foundry (yeni) portalında görüntüleyemezsiniz. Dökümhane (yeni) portalında yalnızca kaynak için varsayılan proje kullanılabilir. öğesine yeni bir proje eklemek için my-foundry-resource:

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

• Dökümhane kaynağınızın varsayılan projesini silerseniz, oluşturulan sonraki proje varsayılan proje olur.

Proje ayarlarını görüntüleme

Dökümhane portalı

Giriş projesi sayfasında, projenin proje uç noktasını ve API anahtarını görürsünüz. Microsoft Entra Id kimlik doğrulaması kullanıyorsanız API anahtarına ihtiyacınız yoktur.

Python SDK'sı

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

Referanslar: CognitiveServicesManagementClient.

Azure CLI

Projenin ayarlarını görüntülemek için komutunu kullanın az cognitiveservices account connection show . Örneğin:

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

Projeleri silme

Dökümhane portalı

1. Microsoft Foundry'de oturum açın. Yeni Dökümhane anahtarının açık olduğundan emin olun. Bu adımlar Foundry (yeni) ile ilgilidir.
2. Sağ üst gezinti bölmesinde çalıştır'ı seçin.
3. Sol bölmede Yönetici'yi seçin.
4. Projenizi seçin.
5. Projeyi silmek için sağ üstteki çöp kutusu simgesini seçin.

Python SDK'sı

Bu kod, Önkoşullar'dan ve client connection değişkenlerini kullanır. İlk olarak istemci bağlantısını oluşturun:

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

Referanslar: CognitiveServicesManagementClient.

Dökümhane kaynağını ve tüm projelerini silin:

# 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()

Referanslar: CognitiveServicesManagementClient.

Azure CLI

Aşağıdaki komutu çalıştırın:

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

Referanslar: az cognitiveservices account project delete.

Önemli

Dikkatli kullanın. Bir proje silindikten sonra kurtarılamaz.

İlgili içerik

• Microsoft Foundry Hızlı Başlangıç Rehberi
• Foundry nedir?