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ğrulayacaksınız.

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

Azure'da hizmetleri kullanmak ve yönetmek için bir Azure kaynağı gereklidir. Erişim, güvenlik, ağ gibi, faturalama ve izleme yapılandırmalarının 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.

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şturma.
• 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şunuz alternatif adlar, güvenlik denetimleri veya maliyet etiketleri gibi özelleştirilmiş Azure yapılandırmaları gerektiriyorsa, kuruluşunuzun Azure İlkesi uyumluluğuna uyum sağlamak için Azure portal veya template seçenekleri kullanmanız gerekebilir.

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

İpucu

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

Azure portalında bir Foundry kaynağı oluşturmak için şu talimatları izleyin:

1. Bu Foundry kaynak 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:

   Project ayrıntıları	Açıklama
   Abonelik	Kullanılabilir Azure aboneliklerinizden birini seçin.
   Kaynak Grubu	Dökümhane 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 komutu< veya Azure CLI komutu kullanarak Azure/c0> 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, 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ı 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 - Bir ücretsiz olarak oluştur.
• 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 yükleme ve oturum açma

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

az login

Yeni kaynak grubu oluşturma

Bir Foundry 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 konumlardan birine ihtiyacınız vardır. kullanılabilir konumların listesini az account list-locations komutuyla 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 yeni bir kaynak grubu oluşturun. Aşağıdaki örnekte, westus2 Azure konumunu aboneliğiniz için kullanılabilen Azure konumlardan biriyle değiştirin.

az group create --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 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 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 komutu< veya Azure CLI komutu kullanarak Azure/c0> 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 - Bir ücretsiz olarak oluştur.
• 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 yükleme ve oturum açma

Azure PowerShell 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 Foundry 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 konumlardan 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

• Azure konumunuzu unutmayın; dökümhane kaynaklarını çağırırken buna ihtiyacınız olacaktır.
• 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, westus2 Azure konumunu aboneliğiniz için kullanılabilen Azure konumlardan 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 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 komutu< veya Azure CLI komutu kullanarak Azure/c0> 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şin

İlk kaynağınız oluşturulduğunda, buna UX prototipleme için Foundry portalı, geliştirme için Foundry SDK'sı veya yönetimsel yönetim için Azure portalı üzerinden 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 basit ö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:

• AIProjectClient sınıfı
• DefaultAzureCredential sınıfı

Geliştirici izinleri verme veya alma

Azure Rol Tabanlı Access Control (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 project yönetim izinleri verir. Diğer kullanıcıları 'Azure AI Kullanıcısı' rolüyle bir projede işbirliği yapmaya davet edebilir.
Azure AI Kullanıcı	Geliştirme izinleri verir.
Azure AI Hesabı Sahibi	Yapay zeka projelerini ve hesaplarını yönetmek için tam erişim izni verir. Diğer kullanıcıları 'Azure AI Kullanıcısı' rolüyle bir projede işbirliği yapmaya davet edebilir.
Azure AI Sahibi	Yönetilen yapay zeka projelerine ve hesaplarına tam erişim verir ve projeler üzerinde inşa eder ve geliştirir.

Uyarı

Azure Yapay Zeka Sahibi rolü yakında Azure ve Foundry portalında atanabilecek.

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

Yalnızca yetkili kullanıcılar (çoğunlukla Azure abonelik veya kaynak grubu sahibi), [Azure portal](Azure portal bağlantısı) veya [Yönetici aracılığıyla Foundry portalı](Dökümhane portalı bağlantısı) aracılığıyla rol atayabilir. Rol tabanlı access control 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 inşa etmeye başlayın

İzinlerin ayarlanmasıyla artık Foundry oluşturmaya başlamaya hazırsınız. Foundry portalında açın veya ilk projenizi 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
Foundry Temsilci Hizmeti	Oluşturucu yapay zeka modellerinin gücünü, aracıların gerçek dünya veri kaynaklarına erişim sağlamasına ve etkileşim kurmasına olanak tanıyan araçlarla birleştirin.
Azure Model Çıkarsaması	Foundry model kataloğunda amiral gemisi modelleri için model çıkarımı gerçekleştirir.
Azure OpenAI	Çok çeşitli doğal dil görevleri gerçekleştirin.
İçerik Güvenliği	İstenmeyen içerikleri tespit eden bir Dökümhane Aracı.
Belge Yönetim Bilgileri	Belgeleri akıllı veri odaklı çözümlere dönüştürün.
Dil	Sektör lideri doğal dil anlama özellikleriyle uygulamalar oluşturun.
Konuşma	Metne konuşma, text to speech, çeviri ve konuşmacı tanıma.
Çevirici	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

• Çalışmanızı düzenlemek için project oluşturma.
• Daha zengin uygulamalar oluşturmak için araçları bağlayın.
• Çalışma ortamınıza başkalarını davet etmek için Foundry'deki erişim kontrolü hakkında bilgi edinin.
• Özel ağ kullanarak kaynağınızın güvenliğini sağlama