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 Azure Hesap Yapay Zeka Sahibi veya Azure Yapay Zeka Sahibi gibi bir Dökümhane 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.
  • 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 sürüm 2.67.0 veya üzerini yükleyin (az version ile denetleyin).

  • Azure oturum açın:

    az login

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.

  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-resource içinde my-foundry-project 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ı

Modeli dağıt

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.

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

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. Uç nokta URL'si ve kopyalama düğmesini gösteren Microsoft Foundry Models karşılama 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ı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

  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ısı rolünü 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ç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.

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

Sonraki adım

Microsoft Foundry başlangıç kılavuzu

  • Last updated on