Microsoft Dökümhanesi için proje oluşturma

Microsoft Foundry'de proje oluşturmak ve ortamınızın hazır olduğunu onaylamak için bu makaleyi kullanın. Projeler, durum korumalı uygulamalar oluştururken ve yeni fikirleri keşfederken ajanları, değerlendirmeleri ve dosyaları düzenlemenizi sağlar.

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.

Bir projeyi ayarlarken, Microsoft Döküm Becerisi ortamınızı hazırlamanıza ve ilgili aracı, değerlendirme ve dosya iş akışlarını tamamlamanıza yardımcı olabilir.

Ö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.

• Projeyi kendiniz oluşturuyorsanız:

  • Abonelikte veya kaynak grubunda, Foundry Account Owner ya da Foundry Owner gibi bir Foundry 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.

    Önemli

    Foundry RBAC rolleri yakın zamanda yeniden adlandırıldı. Foundry User, Foundry Owner, Foundry Hesabı Sahibi ve Foundry Project Manager daha önce Azure Yapay Zeka Kullanıcısı, Azure Yapay Zeka Sahibi, Azure Yapay Zeka Hesabı Sahibi ve Azure Yapay Zeka Project Yöneticisi olarak adlandırıldı. Yeniden adlandırma kullanıma sunulmaya devam ederken bazı yerlerde önceki adları görmeye devam edebilirsiniz. Rol kimlikleri ve temel izinler yeniden adlandırma ile değiştirilmez.

• Projeyi bir ekip için oluşturuyorsanız:

  • Sahip gibi rol atamalarını tamamlamanı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.
  • Erişime ihtiyacı olan ekip üyeleri için kullanıcı e-posta adreslerinin veya Microsoft Entra güvenlik grubu kimliklerinin listesi.

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ı

• Portalı kullanırken başka bir önkoşul gerekmez.

Python SDK'sı

• Geliştirme ortamınızı ayarlayın.

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

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

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

• Hızlı doğrulama: Proje oluşturmadan önce istemciyi test ederek SDK'nızı ve kimlik doğrulamanızı 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.")
  

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

• (İ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>")
  

Azure CLI

• Azure CLI yükleyin.
• için subscriptionvarsayılan değerini ayarlayın.

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

Dökümhane projesi oluşturma

Aşağıdaki yöntemlerden birini kullanın.

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 oturum açın. Yeni Dökümhane anahtarının açık olduğundan emin olun. Bu adımlar Foundry (yeni)'ye atıfta bulunur.

   

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 bakabilirsiniz.

Gelişmiş seçenekler

1. Bir Foundry kaynakta bir Foundry 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.

   Ipucu

   Ö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'u 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 bölümündeki değişkenleri ve client bağlantıyı kullanarak bir Dökümhane 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

Note

Bu adımlar, Azure CLI sürüm 2.80.0 veya üzerini ve kaynak grubundaki Katkıda Bulunan veya Sahip rolünü gerektirir. Sürümünüzü kontrol etmek için az upgrade ve daha yeni bir sürüme ihtiyacınız varsa az version çalıştırın. Başlamadan önce oturum açmak için komutunu çalıştırın az login . Desteklenen bölgeler için bkz . Bölge desteği.

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

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

   Kaynak grubunun mevcut olduğunu doğrulayın:

   az group show --name my-foundry-rg --query properties.provisioningState --output tsv
   

   Çıktı Succeeded gösterir.

2. Proje yönetimi etkinleştirilmiş Foundry kaynağını oluşturun. Örneğin, my-foundry-resource oluşturun, my-foundry-rg kaynak grubunda.

   az cognitiveservices account create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --kind AIServices \
       --sku S0 \
       --location eastus \
       --custom-domain my-foundry-resource \
       --assign-identity \
       --allow-project-management true
   

   Şu değerleri kullanın:

   Parametre	Purpose
   --assign-identity	Proje yönetiminin gerektirdiği yönetilen kimliği oluşturur. Bu olmadan, proje oluşturma işlemi kaynakta yönetilen kimliğin etkinleştirilmesi gerektiği hatasıyla başarısız olur.
   --allow-project-management	Proje yönetimini etkinleştirir. Kaynağı oluşturduktan sonra bu ayarı değiştiremezsiniz.
   --custom-domain	Genel olarak benzersiz olması gerekir. my-foundry-resource alınmışsa, komut CustomDomainInUse hatasıyla başarısız olur. Farklı bir ad seçin ve komutu yeniden çalıştırın.

3. Bir proje oluştur. Ö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
   

4. Kaynağın sağlandığını doğrulayın:

   az cognitiveservices account show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --query properties.provisioningState --output tsv
   

   Çıktıda Succeeded gösterilmelidir. Çıktı farklı bir durum gösteriyorsa izinlerinizi, bölge kullanılabilirliğinizi ve kaynak kotalarınızı denetleyin. Daha fazla yardım için bkz. Çok hizmetli kaynak oluşturma.

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 \
       --query properties.provisioningState --output tsv
   

   Çıktıda Succeeded gösterilmelidir. Komut, yönetilen kimliğin etkinleştirilmesi gerektiğini belirten bir iletiyle başarısız olursa, kaynağı --assign-identity ile oluşturduğunuzu doğrulayın.

Referans: az cognitiveservices account project

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

Azure'un alt kaynakları olarak Foundry projeleri, kendi erişim kontrol ayarlarına atanabilir, ancak ağ güvenliği, dağıtımlar ve Azure araç entegrasyonu gibi üst kaynaklarından gelen 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.

Özelliği	Varsayılan proje	Diğer projeler
Model tahmini	✅	✅
Oyun alanları	✅	✅
Temsilciler	✅	✅
Değerlendirme	✅	✅
İzleme	✅	✅
Veri Setleri	✅	✅
Dizinler	✅	✅
Foundry SDK ve API	✅	✅
İçerik anlama	✅	✅
OpenAI SDK ve API	✅	Yanıtlar, Dosyalar, Konuşmalar
OpenAI Batch, İnce Ayarlama, Depolanan tamamlamalar	✅	-
Dil ayarı	✅	✅
Konuşmada ince ayarlama	✅	-
Bağlantı	✅	✅

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

  Dökümhane portalı

  1. Sağ üst gezinti bölmesinde Yönet'i seçin.
  2. Sol bölmede Kaynak ayrıntıları'nı seçin.
  3. Proje ekle'yi seçin.

  Python SDK'sı

  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 my-foundry-resource:

   az cognitiveservices account project create \
   --name my-foundry-resource \
   --resource-group my-foundry-rg \
   --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 project show . Örneğin:

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

Ekip üyelerine erişim izni verme

Projeyi bir ekip için oluşturduysanız, projeyi ve kaynaklarını kullanabilmeleri için Dökümhane Kullanıcısı rolünü ekip üyelerine atayın. Bu rol, yapay zeka uygulamaları oluşturmak ve test etmek için gereken en düşük izinleri sağlar. Atamanız gerekebilecek diğer roller için bkz. Microsoft Foundry için Role tabanlı erişim denetimi.

Önemli

Foundry RBAC rolleri yakın zamanda yeniden adlandırıldı. Foundry User, Foundry Owner, Foundry Hesabı Sahibi ve Foundry Project Manager daha önce Azure Yapay Zeka Kullanıcısı, Azure Yapay Zeka Sahibi, Azure Yapay Zeka Hesabı Sahibi ve Azure Yapay Zeka Project Yöneticisi olarak adlandırıldı. Yeniden adlandırma kullanıma sunulmaya devam ederken bazı yerlerde önceki adları görmeye devam edebilirsiniz. Rol kimlikleri ve temel izinler yeniden adlandırma ile değiştirilmez.

Önemli

Rol atamalarını tamamlamak için projede Sahip gibi bir role ihtiyacınız vardır. Daha fazla bilgi için bkz: Microsoft Foundry için Rol tabanlı erişim denetimi.

Dökümhane portalı

1. Dökümhane portalında sağ üst gezinti bölmesinde Yönet'i seçin.
2. Sol bölmede Project ayrıntıları seçin.
3. Kullanıcılar sekmesini seçin.
4. Sağ üstteki Kullanıcı ekle'yi seçin.
5. Ekip üyesinin e-posta adresini girin.
6. Ekle'yi seçin.

Her ekip üyesi veya güvenlik grubu için bu adımları yineleyin.

Ipucu

Aynı anda birden çok kullanıcı eklemek için, tek tek e-posta adresleri yerine Microsoft Entra bir güvenlik grubu kullanın.

Python SDK'sı

Rol atamalarını yönetmek için Azure CLI veya Dökümhane portalını kullanın. Python SDK'sı rol atama işlemlerini desteklemez.

Azure CLI

1. Projenin kaynak kimliğini alın:

   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. Dökümhane Kullanıcısı rolünü bir ekip üyesine atayın:

   Önemli

   Foundry RBAC rolleri yakın zamanda yeniden adlandırıldı. Foundry User, Foundry Owner, Foundry Hesabı Sahibi ve Foundry Project Manager daha önce Azure Yapay Zeka Kullanıcısı, Azure Yapay Zeka Sahibi, Azure Yapay Zeka Hesabı Sahibi ve Azure Yapay Zeka Project Yöneticisi olarak adlandırıldı. Yeniden adlandırma kullanıma sunulmaya devam ederken bazı yerlerde önceki adları görmeye devam edebilirsiniz. Rol kimlikleri ve temel izinler yeniden adlandırma ile değiştirilmez.

   az role assignment create \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --assignee "user@contoso.com" \
       --assignee-principal-type User \
       --scope $PROJECT_ID
   

Note

Foundry RBAC rolleri yakın zamanda yeniden adlandırıldığı için, yeniden adlandırma dağıtımı sırasında sorun yaşamamak için kodunuzda rol adı yerine rol tanımı kimliğini (GUID) kullanın:

• Dökümhane Kullanıcısı: 53ca6127-db72-4b80-b1b0-d745d6d5456d
• Dökümhane Sahibi: c883944f-8b7b-4483-af10-35834be79c4a
• Döküm Hesabı Sahibi: e47c6f54-e4a2-4754-9501-8e0985b135e1
• Döküm Proje Yöneticisi: eadc314b-1a2d-4efa-be10-5d325db5065e

Tek bir kullanıcı yerine bir güvenlik grubu eklemek için:

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. Rol atamasını doğrulayın:

   az role assignment list \
       --scope $PROJECT_ID \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --output table
   

Başvuru: az role assignment

Ekip üyesi erişimini doğrulama

Bir ekip üyesinden Microsoft Foundry'de oturum açarak proje listesinden projeyi seçip erişimini doğrulamasını isteyin.

Ekip üyesi projeye erişemezse rol atamasının başarıyla tamamlandığını doğrulayın. Doğru e-posta adresini veya güvenlik grubu kimliğini kullanıp kullanmadığınıza bakın. Ekip üyesinin Azure hesabının aynı Microsoft Entra kiracısında olduğundan emin olun.

Projeleri silme

Önemli

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

Dökümhane portalı

1. Microsoft Foundry oturum açın. Yeni Dökümhane anahtarının açık olduğundan emin olun. Bu adımlar Foundry (yeni)'ye atıfta bulunur.
2. Sağ üst gezinti bölmesinde Yönet'i seçin.
3. Sol bölmede Project ayrıntıları'nı seçin.
4. Projeyi silmek için sağ üstteki çöp kutusu simgesini seçin.

Python SDK'sı

Bu kod, önkoşulların değişkenlerini ve client bağlantısını kullanır. Tek bir projeyi silmek için:

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-resource \
--resource-group my-foundry-rg \
--project-name my-foundry-project

Silme işlemini doğrulamak için aynı kaynak ve proje adlarıyla komutunu çalıştırın az cognitiveservices account project show . Komut, kaynak bulunamadı hatası döndürür.

Referanslar: az cognitiveservices account project delete.

İlk bağlantınızı oluşturma

İlgili içerik

• Microsoft Foundry'deki yükseltilmiş rol görevleri; kaynak ve proje oluşturmaya yönelik rol gereksinimleri.
• Microsoft Foundry Hızlı Başlangıcı
• Foundry nedir?
• Bicep şablonu kullanarak kaynak oluşturma