Aracılığıyla paylaş

Hızlı Başlangıç: İlk Dökümhane kaynağınızı ayarlama

Bu hızlı başlangıçta bir Microsoft Foundry kaynağı oluşturacak ve erişimi doğrulaacaksınız.

Foundry kaynağı oluşturmayı ve yönetmeyi öğrenin. Bu, Azure'daki aracılar dahil olmak üzere üretken yapay zeka modellerini ve uygulamalarını oluşturmak, dağıtmak ve yönetmek için kullanılan birincil Azure kaynak türüdür .

Azure'daki hizmetleri kullanmak ve yönetmek için bir Azure kaynağı gereklidir. Erişimi, ağ, faturalama ve izleme gibi güvenliği yapılandırma kapsamını tanımlar.

Dökümhane kaynağı, eski "Döküm Araçları"nın sonraki sürümü ve yeniden adlandırılmasıdır. Aracılarınızı, model dağıtımlarınızı, değerlendirmelerinizi ve daha fazlasını barındırmak için uygulama ortamı sağlar.

Dökümhane kaynağı, birden çok kullanım örneği için çalışmayı düzenleyebilir ve genellikle benzer bir iş veya veri etki alanındaki kullanım örnekleri üzerinde çalışan bir geliştirici ekibi arasında paylaşılır . Projeler, ilgili işleri gruplandırmak için klasör görevi görür.

Her birinde dağıtım ve bağlantı bulunan birden çok proje içeren Dökümhane kaynağını gösteren diyagram.

Uyarı

Dökümhane (yeni) portalında yalnızca varsayılan proje kullanılabilir. Dökümhane kaynağındaki diğer tüm projelerle etkileşime geçmek için Dökümhane (klasik) portalını kullanın.

Foundry'yi gelişmiş güvenlik ayarlarıyla yapılandırmak mı arıyorsunuz? Bkz. gelişmiş Dökümhane oluşturma seçenekleri

İlk kaynağınızı oluşturma

Temel Azure ayarlarıyla ilk kaynağınızı oluşturmak için Azure portalı, Azure CLI veya PowerShell kullanarak aşağıdaki adımları izleyin.

Önkoşullar

  • Geçerli bir Azure aboneliği - Ücretsiz bir abonelik oluşturun.
  • Kaynak oluşturmak için Azure RBAC rolü. Azure aboneliğinizde veya kaynak grubunuzda aşağıdaki rollerden birinin atanmış olması gerekir:
    • Katılımcı
    • Sahibi
    • Özel rol Microsoft.CognitiveServices/accounts/write izniyle

Yeni bir Microsoft Foundry kaynağı oluşturma

Kuruluşunuzda alternatif adlar, güvenlik denetimleri veya maliyet etiketleri gibi özelleştirilmiş Azure yapılandırmaları gerekiyorsa, kuruluşunuzun Azure İlkesi uyumluluğuna uymak için Azure portalını veya şablon seçeneklerini kullanmanız gerekebilir.

Foundry kaynağı, Azure portalında Dökümhane>Dökümhanesi altında listelenir. API türü AIServices'tir. Burada gösterildiği gibi logoyu arayın.

Azure portalındaki Dökümhane kaynağının ekran görüntüsü.

İpucu

Dökümhane portalı , temel, varsayılan ayarlarla yeni bir Dökümhane kaynağı oluşturmanın bir yolunu sağlar.

Azure portalında bir Dökümhane kaynağı oluşturmak için şu yönergeleri izleyin:

  1. Şu Foundry kaynağı bağlantısını seçin: https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry

  2. Oluştur sayfasında aşağıdaki bilgileri sağlayın:

    Proje ayrıntıları Açıklama
    Abonelik Kullanılabilir Azure aboneliklerinizden birini seçin.
    Kaynak Grubu Foundry kaynağınızı içerecek Azure kaynak grubu. Yeni bir grup oluşturabilir veya önceden var olan bir gruba ekleyebilirsiniz.
    Bölge Döküm Aracı örneğinizin konumu. Farklı konumlar gecikmeye neden olabilir, ancak kaynağınızın çalışma zamanı kullanılabilirliğini etkilemez.
    İsim Dökümhane kaynağınız için açıklayıcı bir ad. Örneğin, MyAIServicesResource.

  3. Kaynağınız için diğer ayarları gerektiği gibi yapılandırın, koşulları okuyup kabul edin (uygunsa) ve ardından Gözden geçir ve oluştur'u seçin.

İpucu

Aboneliğiniz Bir Foundry kaynağı oluşturmanıza izin vermiyorsa Azure portalı, PowerShell komutunu veya Azure CLI komutunu kullanarak bu Azure kaynak sağlayıcısının ayrıcalığını etkinleştirmeniz gerekebilir. Abonelik sahibi değilseniz, Sahip veya Yönetici rolüne sahip birinden kaydı sizin yerinize tamamlamasını isteyin veya hesabınıza /register/action ayrıcalıklarının verilmesini isteyin.

Kaynakları temizle

Bir Dökümhane kaynağını temizlemek ve kaldırmak istiyorsanız, kaynağı veya kaynak grubunu silebilirsiniz. Kaynak grubunun silinmesi, grupta yer alan diğer tüm kaynakları da siler.

  1. Azure portalında sol taraftaki menüyü genişleterek hizmet menüsünü açın ve kaynak gruplarınızın listesini görüntülemek için Kaynak Grupları'nı seçin.
  2. Silinecek kaynağı içeren kaynak grubunu bulun.
  3. Kaynak grubunun tamamını silmek istiyorsanız kaynak grubu adını seçin. Sonraki sayfada Kaynak grubunu sil'i seçin ve onaylayın.
  4. Yalnızca Dökümhane kaynağını silmek istiyorsanız, içindeki tüm kaynakları görmek için kaynak grubunu seçin. Sonraki sayfada, silmek istediğiniz kaynağı seçin, bu satırın üç nokta menüsünü seçin ve Sil'i seçin.

Azure Komut Satırı Arabirimi (CLI) komutlarını kullanarak bir Foundry kaynağı oluşturmak için bu hızlı başlangıç kılavuzunu kullanın.

Önkoşullar

  • Geçerli bir Azure aboneliği - Ücretsiz bir abonelik oluşturun .
  • Azure CLI sürüm 2.0 veya üzeri.
  • Kaynak oluşturmak için Azure RBAC rolü. Azure aboneliğinizde veya kaynak grubunuzda aşağıdaki rollerden birinin atanmış olması gerekir:
    • Katılımcı
    • Sahibi
    • Özel rol Microsoft.CognitiveServices/accounts/write izniyle

Azure CLI'yi yükleyin ve oturum açın

Azure CLI’yi yükleyin. YEREL CLI yüklemenizde oturum açmak için az login komutunu çalıştırın:

az login

Yeni kaynak grubu oluşturma

Bir Dökümhane kaynağı oluşturmadan önce, kaynağı içerecek bir Azure kaynak grubunuz olmalıdır. Yeni bir kaynak oluşturduğunuzda, yeni bir kaynak grubu oluşturabilir veya mevcut bir kaynak grubunu kullanabilirsiniz. Bu makalede yeni bir kaynak grubunun nasıl oluşturulacağı gösterilmektedir.

Kaynak oluşturmak için aboneliğiniz için kullanılabilir Azure konumlarından birine ihtiyacınız vardır. az account list-locations komutuyla kullanılabilir konumların listesini alabilirsiniz. Döküm Araçları'nın çoğuna çeşitli konumlardan erişilebilir. Size en yakın olanı seçin veya hizmet için hangi konumların kullanılabilir olduğunu görün.

Önemli

  • Microsoft Foundry kaynaklarını çağırırken ihtiyacınız olacağı için Azure konumunuzu unutmayın.
  • Bazı Döküm Araçları'nın kullanılabilirliği bölgeye göre farklılık gösterebilir. Daha fazla bilgi için bkz. Bölgeye göre Azure ürünleri.
az account list-locations --query "[].{Region:name}" --out table

Azure konumunuzu aldıktan sonra az group create komutunu kullanarak Azure CLI'da yeni bir kaynak grubu oluşturun. Aşağıdaki örnekte Azure konumunu westus2 aboneliğiniz için kullanılabilen Azure konumlarından biriyle değiştirin.

az group create --name ai-services-resource-group --location westus2

Dökümhane kaynağı oluştur

Yeni bir Foundry kaynağı oluşturmak ve abone olmak için az cognitiveservices account create komutunu kullanın. Bu komut, daha önce oluşturduğunuz kaynak grubuna yeni bir faturalanabilir kaynak ekler. Yeni kaynağınızı oluştururken, fiyatlandırma katmanı (veya SKU) ve bir Azure konumuyla birlikte kullanmak istediğiniz hizmet türünü bilmeniz gerekir.

Önemli

Azure, Döküm Araçları için birden fazla kaynak türü sağlar. ile bir tane oluşturduğunuzdan kindAIServicesemin olun.

Aşağıdaki komutla adlı foundry-multi-service-resource bir Dökümhane kaynağı oluşturabilirsiniz.

az cognitiveservices account create --name foundry-multi-service-resource --resource-group ai-services-resource-group  --kind AIServices --sku S0 --location westus2 --yes

İpucu

Aboneliğiniz Bir Foundry kaynağı oluşturmanıza izin vermiyorsa Azure portalı, PowerShell komutunu veya Azure CLI komutunu kullanarak bu Azure kaynak sağlayıcısının ayrıcalığını etkinleştirmeniz gerekebilir. Abonelik sahibi değilseniz, Sahip veya Yönetici rolüne sahip birinden kaydı sizin yerinize tamamlamasını isteyin veya hesabınıza /register/action ayrıcalıklarının verilmesini isteyin.

Kaynağınız için geçerli kota kullanımını alma

Kaynağınızın kullanımını almak için az cognitiveservices account list-usage komutunu kullanın.

az cognitiveservices account list-usage --name foundry-multi-service-resource --resource-group ai-services-resource-group --subscription subscription-name

Kaynakları temizle

Dökümhane kaynağını temizlemek ve kaldırmak istiyorsanız, kaynağı veya kaynak grubunu silebilirsiniz. Kaynak grubunun silinmesi, grupta yer alan diğer tüm kaynakları da siler.

Kaynak grubunu ve ilişkili kaynaklarını kaldırmak için kullanın az group delete command.

az group delete --name ai-services-resource-group

Azure PowerShell komutlarını kullanarak bir Dökümhane kaynağı oluşturmak için bu hızlı başlangıcı kullanın.

Önkoşullar

  • Geçerli bir Azure aboneliği - Ücretsiz bir abonelik oluşturun .
  • Azure PowerShell sürüm 5.0 veya üzeri.
  • Kaynak oluşturmak için Azure RBAC rolü. Azure aboneliğinizde veya kaynak grubunuzda aşağıdaki rollerden birinin atanmış olması gerekir:
    • Katılımcı
    • Sahibi
    • Özel rol Microsoft.CognitiveServices/accounts/write izniyle

Azure PowerShell'i yükleme ve oturum açma

Azure PowerShell'i yükleyin. Oturum açmak için Connect-AzAccount komutunu çalıştırın:

Connect-AzAccount

Yeni bir Microsoft Foundry kaynak grubu oluşturma

Bir Dökümhane kaynağı oluşturmadan önce, kaynağı içerecek bir Azure kaynak grubunuz olmalıdır. Yeni bir kaynak oluşturduğunuzda, yeni bir kaynak grubu oluşturabilir veya mevcut bir kaynak grubunu kullanabilirsiniz. Bu makalede yeni bir kaynak grubunun nasıl oluşturulacağı gösterilmektedir.

Kaynak oluşturmak için aboneliğiniz için kullanılabilir Azure konumlarından birine ihtiyacınız vardır. Get-AzLocation komutuyla kullanılabilir konumların listesini alabilirsiniz. Döküm Araçları'nın çoğuna çeşitli konumlardan erişilebilir. Size en yakın olanı seçin veya hizmet için hangi konumların kullanılabilir olduğunu görün.

Önemli

  • Foundry kaynaklarını çağırırken ihtiyacınız olacağı için Azure konumunuzu unutmayın.
  • Bazı Döküm Araçları'nın kullanılabilirliği bölgeye göre farklılık gösterebilir. Daha fazla bilgi için bkz. Bölgeye göre Azure ürünleri.
Get-AzLocation | Select-Object -Property Location, DisplayName

Azure konumunuzu aldıktan sonra New-AzResourceGroup komutunu kullanarak Azure PowerShell'de yeni bir kaynak grubu oluşturun. Aşağıdaki örnekte Azure konumunu westus2 aboneliğiniz için kullanılabilen Azure konumlarından biriyle değiştirin.

New-AzResourceGroup -Name ai-services-resource-group -Location westus2

Dökümhane kaynağı oluştur

Yeni bir Dökümhane kaynağı oluşturmak ve abone olmak için New-AzCognitiveServicesAccount komutunu kullanın. Bu komut, daha önce oluşturduğunuz kaynak grubuna yeni bir faturalanabilir kaynak ekler. Yeni kaynağınızı oluştururken, fiyatlandırma katmanı (veya SKU) ve bir Azure konumuyla birlikte kullanmak istediğiniz "hizmet türünü" bilmeniz gerekir:

Önemli

Azure, Döküm Araçları için birden fazla kaynak türü sağlar. Type türünde bir tane oluşturduğunuzdan AIServices emin olun.

Aşağıdaki komutla adlı foundry-multi-service-resource bir Dökümhane kaynağı oluşturabilirsiniz.

New-AzCognitiveServicesAccount -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource -Type AIServices -SkuName S0 -Location westus2

İpucu

Aboneliğiniz Bir Foundry kaynağı oluşturmanıza izin vermiyorsa Azure portalı, PowerShell komutunu veya Azure CLI komutunu kullanarak bu Azure kaynak sağlayıcısının ayrıcalığını etkinleştirmeniz gerekebilir. Abonelik sahibi değilseniz, Sahip veya Yönetici rolüne sahip birinden kaydı sizin yerinize tamamlamasını isteyin veya hesabınıza /register/action ayrıcalıklarının verilmesini isteyin.

Kaynağınız için geçerli kota kullanımını alma

Kaynağınızın kullanımını almak için Get-AzCognitiveServicesAccountUsage komutunu kullanın.

Get-AzCognitiveServicesAccountUsage -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource

Kaynakları temizle

Dökümhane kaynağını temizlemek ve kaldırmak istiyorsanız, kaynağı veya kaynak grubunu silebilirsiniz. Kaynak grubunun silinmesi, grupta yer alan diğer tüm kaynakları da siler.

Kaynak grubunu ve ilişkili kaynaklarını kaldırmak için Remove-AzResourceGroup komutunu kullanın.

Remove-AzResourceGroup -Name ai-services-resource-group

Kaynağınıza erişme

İlk kaynağınız oluşturulduktan sonra, UX prototipi için Foundry portalı, geliştirme için Döküm SDK'sı veya yönetim yönetimi için Azure portalı aracılığıyla erişebilirsiniz.

Kurulumunuzu doğrulama

Projeleri bağlamak ve listelemek için Azure AI Projeleri SDK'sını kullanarak kaynağınızın doğru şekilde ayarlandığını doğrulayabilirsiniz. Bu en küçük örnek, kimlik doğrulama ve erişimi onaylar.

# Install the SDK: pip install azure-ai-projects azure-identity
from azure.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential

# Replace with your actual values from Azure portal
client = AIProjectClient(
    subscription_id="<your-subscription-id>",
    resource_group_name="<your-resource-group>",
    project_name="<your-project-name>",
    credential=DefaultAzureCredential()
)

# List projects to verify connection
projects = client.projects.list()
print(f"Successfully connected. Found {len(list(projects))} projects.")

Beklenen çıkış: Successfully connected. Found X projects. burada X kaynağınızdaki proje sayısıdır.

Referanslar:

Geliştirici izinleri verme veya alma

Azure Rol Tabanlı Erişim Denetimi (RBAC), yönetim ve geliştirme eylemleri arasındaki izinleri ayırt eder. Foundry ile derlemek için kullanıcı hesabınıza geliştirici izinleri ("veri eylemleri") atanmalıdır. Yerleşik RBAC rollerinden birini veya özel bir RBAC rolü kullanabilirsiniz.

Foundry için yerleşik Azure RBAC geliştirici rolleri şunlardır:

Rol Açıklama
Azure AI Proje Yöneticisi Geliştirme izinleri ve proje yönetimi izinleri verir. Diğer kullanıcıları proje üzerinde 'Azure AI Kullanıcısı' olarak işbirliği yapmaya davet edebilir.
Azure AI Kullanıcısı Geliştirme izinleri verir.
Azure AI Hesabı Sahibi Yapay zeka projelerini ve hesaplarını yönetmek için tam erişim verir. Diğer kullanıcıları proje üzerinde 'Azure AI Kullanıcısı' olarak işbirliği yapmaya davet edebilir.
Azure AI Sahibi Yönetilen yapay zeka projelerine ve hesaplarına tam erişim sağlar, projeleri inşa edip geliştirmeye olanak tanır.

Uyarı

Azure AI Sahibi rolü yakında Azure ve Foundry portalında atanabilecektir.

Foundry'deki yerleşik rollerin diyagramı.

Katı rol tabanlı erişim gereksinimleri olan büyük kuruluşlar için Azure AI Kullanıcı rolünü en az ayrıcalıklı geliştirici izinlerinden yararlanmanızı öneririz. Geliştiricilerin kendi kuruluşlarında kendi kendine hizmet vermelerini isteyen küçük kuruluşlar için, geliştirici izinlerinin yanı sıra kaynak oluşturma izinleri için Azure Yapay Zeka Sahibi rolünü kullanmanızı öneririz.

Yalnızca yetkili kullanıcılar (genellikle Azure aboneliği veya kaynak grubu sahibi) [Azure portalı](Azure portalı bağlantısı) veya [Yönetici aracılığıyla Foundry portalı](Foundry portalı bağlantısı) üzerinden rol atayabilir. Rol tabanlı erişim denetimi hakkında daha fazla bilgi edinin.

Önemli

Azure Sahip ve Katkıda Bulunan rolleri yalnızca yönetim izinlerini içerir, geliştirme izinlerini içermez. Foundry'deki tüm kapasite ile inşa etmek için geliştirme izinleri gereklidir.

İlk projenizde oluşturmaya başlama

İzinlerin ayarlanmasıyla artık Foundry oluşturmaya başlamaya hazırsınız. Foundry portalındailk projenizi açın veya oluşturun. Projeler, Foundry'de aracınızı ve model özelleştirme çalışmanızı düzenler ve aynı kaynak altında birden çok oluşturabilirsiniz.

Kaynağınızla birlikte gelen hizmetlerden bazılarını keşfedin:

Hizmet Açıklama
Dökümhane simgesi DökümHane Aracısı Hizmeti Oluşturucu yapay zeka modellerinin gücünü aracıların gerçek dünya veri kaynaklarına erişmesine ve veri kaynaklarıyla etkileşim kurmasına olanak sağlayan araçlarla birleştirin.
Döküm simgesi Azure Model Çıkarımı Foundry model kataloğunda amiral gemisi modelleri için model çıkarımı gerçekleştirir.
Döküm Modellerinde Azure OpenAI simgesi Azure OpenAI Çok çeşitli doğal dil görevleri gerçekleştirin.
İçerik Güvenliği simgesi İçerik Güvenliği İstenmeyen içerikleri tespit eden bir Dökümhane Aracı.
Belge Yönetim Bilgileri simgesi Belge Yönetim Bilgileri Belgeleri akıllı veri odaklı çözümlere dönüştürün.
Dil simgesi Dil Sektör lideri doğal dil anlama özellikleriyle uygulamalar oluşturun.
Konuşma simgesi Konuşma Konuşmayı metne dönüştürme, metin okuma, çeviri ve konuşmacı tanıma.
Translator simgesi Translator 100'den fazla kullanımda, risk altında ve nesli tükenmekte olan dilleri ve diyalektleri çevirmek için yapay zeka destekli çeviri teknolojisini kullanın.

Sonraki Adımlar

  • Last updated on