Hızlı Başlangıç: Microsoft Dökümhane kaynaklarını ayarlama

Bu hızlı başlangıçta bir Microsoft Foundry projesi oluşturacak ve bir model dağıtacaksınız. Bir ekibi yönetiyorsanız, ekip üyelerine de erişim izni verirsiniz. Bu adımları tamamladıktan sonra, siz veya ekibiniz dağıtılan modeli kullanarak yapay zeka uygulamaları oluşturmaya başlayabilirsiniz.

Ipucu

Bu hızlı başlangıçta, temel bir kurulumla aracı oluşturmak için nasıl kaynak oluşturulacağı gösterilmektedir. Kendi kaynaklarınızı kullanan daha gelişmiş senaryolar için bkz. Aracı geliştirme için ortamınızı ayarlama.

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

    Important

    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.

Aşağıdaki sekmeleri kullanarak tercih ettiğiniz yöntemi seçin:

Azure CLI

• Azure CLI sürüm 2.67.0 veya üzerini yükleyin (az version ile denetleyin).

• Azure oturum açın:

  az login
  

Dökümhane portalı

• Microsoft Foundry portalına erişim.

Proje oluşturma

Çalışmanızı düzenlemek için bir Dökümhane projesi oluşturun. Proje, ekibinizin kullandığı modelleri, aracıları ve diğer kaynakları içerir.

Ipucu

Anlık model (önizleme) denemek istiyorsanız projenizi Batı ABD 3 bölgesinde oluşturun.

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ı

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. Proje oluşturma.

   • Foundry'yi ilk kez kullanıyorsanız devam etmek için proje oluşturmanız veya aramanız istenir. Açılan listeden Yeni proje oluştur'u seçin.
   • Zaten yüklenmiş bir projeniz varsa, sol üst köşedeki proje adını seçin ve ardından Yeni proje oluştur'u seçin.

3. Gibi my-foundry-projectbir proje adı girin.

4. Kaynak grubunu ve konumu yapılandırmak için Gelişmiş seçenekler'i seçin:

   • Kaynak grubu: Yeni bir kaynak grubu oluşturun veya var olan bir kaynak grubunu seçin. Yeni bir kaynak grubu oluşturursanız projeyi ve tüm kaynaklarını birlikte daha kolay yönetebilirsiniz.
   • Konum: Ekibinize en yakın bölgeyi seçin.

5. Proje oluştur'u seçin.

   Projenin oluşturulmasını bekleyin. Projeye genel bakış sayfası görüntülendiğinde projeniz hazır durumdadır.

Modeli dağıt

Kullanabileceğiniz bir model dağıtın. Bu örnekte gpt-5.1-mini kullanılır, ancak kullanılabilir herhangi bir modeli seçebilirsiniz.

Ipucu

Anlık modeli (önizleme) denemek istiyorsanız bu adımı tamamen atlayabilirsiniz.

Azure CLI

az cognitiveservices account deployment create \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-5.1-mini \
    --model-name gpt-5.1-mini \
    --model-version "2025-04-14" \
    --model-format OpenAI \
    --sku-capacity 10 \
    --sku-name Standard

Dağıtımın başarılı olduğunu doğrulayın:

az cognitiveservices account deployment show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-5.1-mini

Dağıtım hazır olduğunda, çıktıda "provisioningState": "Succeeded" gösterilir.

Başvuru: az bilişsel hizmetler hesap dağıtımı

Dökümhane portalı

1. Sağ üst köşede Keşfet'i, ardından sol panelde Modeller'i seçin.
2. gpt-5.1-mini için arama.
3. Dağıt>Varsayılan ayarlar'ı seçerek projenize ekleyin.
4. Dağıtım adını (örneğin, gpt-5.1-mini) not edin. Ekibinizin modeli kullanması için bu isme ihtiyacı var.

Proje bağlantı ayrıntılarınızı alma

Koddan bağlanmak için proje uç noktanızın olması gerekir. Bu projeyi başkaları için yönetiyorsanız, dağıtım adıyla birlikte onlara bu uç noktayı gönderin.

1. Azure hesabınızı kullanarak Microsoft Foundry'de oturum açın.
2. Projenizi seçin.
3. Projenizin uç noktasını proje karşılama ekranında bulabilirsiniz.
4. Uç nokta değerini kopyalayın. Bu değeri diğer hızlı başlangıçlarda ve öğreticilerde kullanırsınız.

Yöneticiler için - erişim izni verme

Bir ekibi yönetiyorsanız, projeyi ve dağıtılan modelleri kullanabilmeleri için Ekip üyelerine DökümHane Kullanıcısı rolünü 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 Rol tabanlı erişim denetimi

Important

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.

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:

   Important

   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

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.

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.

Dağıtılan modelin kullanılabilir olduğunu onaylamak için, ekip üyesine sağ üst gezinme çubuğundan Oluştur'u, ardından sol panelde Modeller'i seçmesini söyleyin.

Kaynakları temizleme

Bu projeyi artık istemediğinizde, kaynak grubunu silip onunla ilişkili tüm kaynakları silin.

Azure CLI

az group delete --name my-foundry-rg --yes --no-wait

Dökümhane portalı

Azure portalında kaynak grubunuzu bulun ve seçin. Sil'i seçin ve kaynak grubunu ve ilişkili tüm kaynaklarını silmek için onaylayın.

Sonraki adım

Microsoft Foundry başlangıç kılavuzu