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.

Aracı geliştirmek için, aracı izlemelerini depolamak üzere Azure İzleyici Application Insights'a da bağlanın.

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.
• Aracı izlemelerini görüntülemek için: Log Analytics Reader gibi bağlı Application Insights kaynağına okuma erişimi gerekir. Bir yönetici bu erişimi verebilir. Korumalı tablo ve çalışma alanı gereksinimleri için İzlemelere erişim verme bölümüne bakın.
• İzleme okuyucusu rollerini atamak için: hedef kapsamda Microsoft.Authorization/roleAssignments/write izni. Katkıda bulunan tek başına bu izni vermez. Rol atayamıyorsanız, yöneticiden gerekli erişimi atamasını isteyin.

Portal yerine Azure CLI kullanırsanız, kaynak grubundaki Katkıda Bulunan veya Sahip rolü kaynağı ve projeyi oluşturmak için yeterlidir. Ekip üyelerine erişim vermek için sahip gibi roller atayabilen bir role yine de ihtiyacınız vardır.

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

Azure CLI

• Azure CLI 2.80.0 veya sonraki bir sürümü yükleyin. az version ile sürümünüzü denetleyin ve daha yeni bir sürüme ihtiyacınız varsa az upgrade komutunu çalıştırın.

  Sürüm 2.80.0, bu adımlarda kullanılan az cognitiveservices account project komutlarını ekledi. Daha eski bir sürümde, komutlar 'project' is misspelled or not recognized by the system veya unrecognized arguments ile başarısız olur.

• 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

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

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.

Aracı izleme için Application Insights'ı bağlayın

aracı hızlı başlangıcını çalıştırmadan önce, bu kurulumu Foundry portalında tamamlayın.

İzlemeyi etkinleştirmeden önce izleme güvenliği ve gizliliğini ve veri saklama ve maliyeti gözden geçirin.

Application Insights'ı Foundry projenize bağlama adımlarını izleyin. Mevcut bir bağlantıyı doğrulayın ve yeniden kullanın.

Note

Mevcut bağlantınız Project Managed Identity kullanıyorsa veya kuruluşunuz yalnızca Entra alımı gerektiriyorsa, onaylanan yapılandırmanızı koruyun. Bkz. İzleme alımı için Microsoft Entra kimlik doğrulamasını yapılandırma.

Foundry tarafından barındırılan ajanlar için bağlantı, sunucu tarafı izlemeyi etkinleştirir. Kendi uygulamanızda çalışan aracılar için istemci tarafı izlemeyi de yapılandırın.

İzlere erişim ver

İzlemeleri görüntüleyen kişi veya grup, bağlı Application Insights kaynağında Log Analytics Reader veya eşdeğer devralınan erişime ihtiyaç duyar. Korumalı izleme tabloları için Privileged Monitoring Data Reader'ı da verin.

Ayrıntılı yönergeler için bkz. İzleme önkoşulları ve Azure portalını kullanarak Azure rolleri atama.

Çalışma alanı kapsamındaki sorgular veya çalışma alanı izinleri gerektiren çalışma alanları için bkz. Log Analytics çalışma alanlarına erişimi yönetme.

İlk agent trace’inizi doğrulayın

Model dağıtımına veya aracı hızlı başlangıcına devam edin. İlk ajan isteğinizden sonra, yeni bir izlemenin göründüğünü onaylamak için İzlemenin çalıştığını doğrulayın'ı izleyin. Tek başına başarılı bir yanıt, izlemelerin depolandığını onaylamaz.

İzleme görünmüyorsa bkz. İzleme sorunlarını giderme.

Modeli dağıt

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

Ipucu

Anlık erişim modelini (önizleme) denemek için bu adımı atlayabilirsiniz.

Azure CLI

1. Model adını ve sürümünü onaylamak için bölgenizde kullanılabilen modelleri listeleyin:

   az cognitiveservices model list \
       --location eastus \
       --query "[?model.name=='gpt-5-mini'].{version:model.version,skus:join(',',model.skus[].name)}" \
       --output table
   

2. Modeli dağıtın:

   az cognitiveservices account deployment create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --deployment-name gpt-5-mini \
       --model-name gpt-5-mini \
       --model-version "2025-08-07" \
       --model-format OpenAI \
       --sku-capacity 10 \
       --sku-name GlobalStandard
   

   komutu ile DeploymentModelNotSupportedbaşarısız olursa model, sürüm veya SKU bölgenizde kullanılamaz. Desteklenen bir birleşim seçmek için önceki adımın çıktısını kullanın.

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

   Çıktı, dağıtım hazır olduğunda Succeeded gösterir.

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

Dökümhane portalı

1. Oluştur>> bölümüne gidin.
2. gpt-5-mini için arama.
3. Dağıt>Varsayılan ayarlar'ı seçerek projenize ekleyin.
4. Dağıtım adını (örneğin, gpt-5-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.

Azure CLI

Proje uç noktasını alın:

az cognitiveservices account project show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --project-name my-foundry-project \
    --query 'properties.endpoints."AI Foundry API"' --output tsv

Çıktı, https://my-foundry-resource.services.ai.azure.com/api/projects/my-foundry-project biçimindeki proje uç noktanızdır. Bu değeri diğer hızlı başlangıçlarda ve öğreticilerde kullanın.

Dökümhane portalı

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 Role tabanlı erişim denetimi.

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

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.

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

Silme işlemi arka planda çalışır. Kaynak grubunun gittiğini onaylamak için şunu çalıştırın:

az group exists --name my-foundry-rg

Silme işlemi tamamlandığında çıktıda false görüntülenir.

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