Microsoft Foundry için proje oluşturma (klasik)

Uyarı

Bu belge , Microsoft Foundry (klasik) portalını ifade eder.

Yeni portal hakkında bilgi edinmek için Microsoft Foundry (yeni) belgelerini görüntüleyin.

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.

• Foundry projesi, Microsoft Foundry kaynağı altında yönetilir. Erişim yönetimi, veri yükleme ve tümleştirme ile izleme için bir kapsayıcıdır. Bu, ek Azure kaynakları oluşturmanıza gerek kalmadan çalışmanızı kullanım örnekleri arasında ayrı tutmanızı sağlar.

• Açık kaynak modellerine veya PromptFlow'a erişmeniz gerekiyorsa, bunun yerine bir hub proje türü oluşturun .

• Farklı proje türleri hakkında daha fazla bilgi için bkz. Proje türleri.

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 veya template seçenekleri kullanmanız gerekebilir.

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Hesabınız yoksa ücretsiz deneme aboneliği içeren bir free Azure hesabı oluşturun.

• Abonelikte veya kaynak grubunda Azure Hesap Yapay Zeka Sahibi veya Azure Yapay Zeka 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.

  Bu rol yoksa abonelik yöneticinizden bir Foundry kaynağı oluşturmasını isteyin ve ardından Aynı kaynakta birden çok proje oluşturma bölümüne atlayın.

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

  • Etkin aboneliği olan bir Azure hesabı. Hesabınız yoksa ücretsiz deneme aboneliği içeren bir free Azure hesabı oluşturun.

  Python SDK

  • Geliştirme ortamınızı ayarlama

  • Kodu çalıştırmadan önce ortamınızda veya '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: . Not defteri hücresindeyseniz, bunun yerine kullanın.

    2. Sürümünüzün 13.7 veya üzeri olup olmadığını denetlemek için kullanın .

    3. Bu makale boyunca kullanılan bağlantıyı ve değişkenleri oluşturmak 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 ID kiracı kimliğini DefaultAzureCredential ekleyin.

       DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
       

    5. (İsteğe bağlı) Azure Kamu - ABD veya Azure tarafından sağlanan 21Vianet bölgelerinde çalışıyorsanız, kimlik doğrulaması yapmak istediğiniz bölgeyi belirtin. Bu örnek Azure Kamu - ABD bölgesinde kimlik doğrulaması yapar:

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

  Azure CLI

  • Azure CLI yükleyin.

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

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

Dökümhane projesi oluşturma

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 açma/kapama düğmesinin kapalı olduğundan emin olun. Bu adımlar Foundry (klasik) için geçerlidir.

   

2. Bundan sonra yapmanız gerekenler, nerede olduğunuzla bağlıdır:

   • Mevcut projeniz yoksa: İlk projenizi oluşturmak için Hızlı Başlangıç: Microsoft Foundry'yi kullanmaya başlama makalesindeki adımları izleyin.

   • Bir projedeyseniz: Proje içerik haritasını seçin ve ardından Yeni kaynak oluştur'u seçin.

     İçerik haritasından yeni proje oluşturmayı gösteren ekran görüntüsü.

   • Projede değilseniz: Yeni bir Foundry projesi oluşturmak için sağ üstteki Yeni oluştur'u seçin

     Foundry'de yeni proje oluşturma adımlarını gösteren ekran görüntüsü.

3. Dökümhane kaynağını ve ardından İleri seçin.

4. Projeniz için bir ad girin ve Oluştur'u seçin. Gelişmiş seçenekler için sonraki bölüme de bakabilirsiniz.

Gelişmiş seçenekler

1. Bir 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

Foundry projesi oluşturmak için:

• Önkoşullar'dan değişkenleri ve 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, içinde oluşturun:

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

2. Foundry kaynağını oluşturun. Örneğin, kaynağını 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
   

   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. 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, içinde 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 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 yeteneğine ihtiyaç duyduğu kısıtlı Azure abonelikleri için idealdir.

Bir ekibin dökümhane kaynağındaki birden çok projeyle kaynak erişimini nasıl paylaşabileceğini gösteren diyagram.

Azure alt kaynağı olarak Foundry projelerine kendi erişim denetimleri atanabilir, ancak üst kaynaklarından ağ güvenliği, dağıtımlar ve Azure araç bütünleştirmesi gibi ortak ayarları paylaşırlar.

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:

  Tavsiye

  Microsoft Foundry portalında sol bölmeyi özelleştirebildiğiniz için, bu adımlarda gösterilenden farklı öğeler görebilirsiniz. Aradığınızı görmüyorsanız ... seçeneğini belirleyin. Sol bölmenin en altında daha fazlası.

  1. Microsoft Foundry'de oturum açın. Yeni Dökümhane açma/kapama düğmesinin kapalı olduğundan emin olun. Bu adımlar Foundry (klasik) için geçerlidir.

     

  2. Dökümhane projesini veya ilişkili kaynağını seçin.

  3. Sol bölmede Yönetim merkezi'ni seçin.

  4. Kaynak bölümünde Genel Bakış'ı seçin.

  5. Yeni proje'yi seçin ve bir ad belirtin.

     Mevcut bir kaynakta ikinci bir projenin nasıl oluşturulacağını gösteren ekran görüntüsü.

  Python SDK

  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

  öğesine yeni bir proje eklemek için :

   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

Giriş projesi sayfasında proje hakkında bilgi bulabilirsiniz.

• Ad: Projenin adı sol üst köşede görünür.
• Abonelik: Projeyi barındıran hub'ı barındıran abonelik.
• Kaynak grubu: Projeyi barındıran hub'ı barındıran kaynak grubu.

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)

Referanslar: CognitiveServicesManagementClient.

Azure CLI

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

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

Projeleri silme

1. Microsoft Foundry'de oturum açın. Yeni Dökümhane açma/kapama düğmesinin kapalı olduğundan emin olun. Bu adımlar Foundry (klasik) ile ilgilidir.
2. Projenizi açın.
3. Yönetim merkezi'ne tıklayın.
4. Kaynak'ın altında Genel Bakış'ı seçin.
5. Artık saklamak istemediğiniz projeleri seçin.
6. Projeyi sil'i seçin.

Foundry kaynağını ve tüm projelerini silmek için:

1. Yönetim merkezinde Genel Bakış bölümünden kaynak adını seçerek Azure portalına gidin.
2. Azure portalında Delete öğesini seçerek kaynağı ve ilişkili tüm projelerini silin.

Python SDK

Bu kod, Önkoşullar'dan ve 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?