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

Bir Dökümhane projesi oluşturmak ve aracılar, değerlendirmeler ve dosyalar oluşturmaya başlamadan önce ortamınızın hazır olduğunu onaylamak için bu makaleyi kullanın.

Bu makalede, Microsoft Foundry içinde bir Dökümhane projesinin nasıl oluşturulacağı açıklanır. Durum yapılı uygulamalar oluştururken ve yeni fikirleri keşfederken aracılar, değerlendirmeler ve dosyalar gibi çalışmalarınızı düzenlemenize olanak tanır projeler.

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.

• Projeyi kendiniz oluşturuyorsanız:

  • Abonelikte veya kaynak grubunda, Azure Account AI 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

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
   

2. 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 \
      --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 çapta benzersiz olmalıdır. "my-foundry-resource alınmışsa, daha benzersiz 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 cognitiveservices 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 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ölmesinden Çalıştır'ı seçin.
  2. Sol bölmede Yönetici'yi seçin.
  3. Proje eklemek istediğiniz Üst kaynağı seçin.
  4. 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 çalıştır'ı seçin.
2. Sol bölmede Yönetici'yi seçin.
3. Tabloda proje adınızı 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" \
       --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
• Foundry Project Manager: 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

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 ç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ı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

Referanslar: az cognitiveservices account project delete.

Önemli

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

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

İlgili içerik

• Microsoft Foundry Hızlı Başlangıcı
• Foundry nedir?
• Bicep şablonu kullanarak kaynak oluşturma