Aracılığıyla paylaş

Hızlı Başlangıç: Microsoft Foundry 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.

Tavsiye

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

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

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

  • Azure'da oturum açın:

    az login

Proje oluştur

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

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

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

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

    --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. my-foundry-resource 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, 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 bilişsel servisler hesabı

Bir model dağıtın

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

az cognitiveservices account deployment create \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-4.1-mini \
    --model-name gpt-4.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-4.1-mini

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

Referans: az cognitiveservices account deployment

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. Projenin hoş geldiniz ekranında proje uç noktanızı bulun. Uç nokta URL'sini ve kopyala düğmesini gösteren Microsoft Foundry Modelleri hoş geldiniz ekranının ekran görüntüsü.
  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 Azure AI Kullanıcı 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

  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. Azure AI Kullanıcı rolünü bir ekip üyesine atayın:

    az role assignment create \
    --role "Azure AI User" \
    --assignee "user@contoso.com" \
    --scope $PROJECT_ID

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

    az role assignment create \
    --role "Azure AI User" \
    --assignee-object-id "<security-group-object-id>" \
    --assignee-principal-type Group \
    --scope $PROJECT_ID

  3. Rol atamasını doğrulayın:

    az role assignment list \
    --scope $PROJECT_ID \
    --role "Azure AI User" \
    --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çerek ve dağıtılan modelin Derleme>Modelleri altında göründüğünü onaylayarak 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.

Kaynakları temizle

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

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

Sonraki adım

Microsoft Foundry hızlı başlangıç kılavuzu

  • Last updated on