Aracılığıyla paylaş


Azure OpenAI Hizmeti kaynağı oluşturma ve dağıtma

Bu makalede, Azure OpenAI Hizmeti'ni kullanmaya nasıl başlandığı açıklanır ve kaynak oluşturma ve model dağıtmaya yönelik adım adım yönergeler sağlanır. Azure'da çeşitli yollarla kaynak oluşturabilirsiniz:

  • Azure portalı
  • REST API'leri, Azure CLI, PowerShell veya istemci kitaplıkları
  • Azure Resource Manager (ARM) şablonları

Bu makalede, Azure portalında ve Azure CLI ile kaynak oluşturma ve dağıtma örneklerini gözden geçireceksiniz.

Önkoşullar

Kaynak oluşturma

Aşağıdaki adımlarda Azure portalda Bir Azure OpenAI kaynağının nasıl oluşturulacağı gösterilmektedir.

Kaynağı tanımlama

  1. Azure portalında Azure aboneliğinizle oturum açın.

  2. Kaynak oluştur'u seçin ve Azure OpenAI'yi arayın. Hizmeti bulurken Oluştur'u seçin.

    Azure portalında yeni bir Azure OpenAI Hizmeti kaynağının nasıl oluşturulacağını gösteren ekran görüntüsü.

  3. Azure OpenAI Oluştur sayfasında, Temel Bilgiler sekmesindeki alanlar için aşağıdaki bilgileri sağlayın:

    Alan Açıklama
    Abonelik Azure OpenAI Hizmeti ekleme uygulamanızda kullanılan Azure aboneliği.
    Kaynak grubu Azure OpenAI kaynağınızı içeren Azure kaynak grubu. Yeni bir grup oluşturabilir veya önceden var olan bir grubu kullanabilirsiniz.
    Bölge Örneğinizin konumu. Farklı konumlar gecikmeye neden olabilir, ancak kaynağınızın çalışma zamanı kullanılabilirliğini etkilemez.
    Ad Azure OpenAI Hizmeti kaynağınız için MyOpenAIResource gibi açıklayıcı bir ad.
    Fiyatlandırma Katmanı Kaynağın fiyatlandırma katmanı. Şu anda Azure OpenAI Hizmeti için yalnızca Standart katman kullanılabilir. Fiyatlandırma hakkında daha fazla bilgi için Azure OpenAI fiyatlandırma sayfasını ziyaret edin

    Azure portalında Bir Azure OpenAI kaynağının nasıl yapılandırıldığını gösteren ekran görüntüsü.

  4. İleri'yi seçin.

Ağ güvenliğini yapılandırma

sekmesi güvenlik Türü için üç seçenek sunar:

  • Seçenek 1: İnternet de dahil olmak üzere tüm ağlar bu kaynağa erişebilir.
  • Seçenek 2: Seçili ağlar, Azure AI hizmetleri kaynağınız için ağ güvenliğini yapılandırın.
  • Seçenek 3: Devre dışı, hiçbir ağ bu kaynağa erişemez. Bu kaynağa erişmenin özel yolu olacak özel uç nokta bağlantıları yapılandırabilirsiniz.

Azure portalında bir Azure OpenAI kaynağının ağ güvenlik seçeneklerini gösteren ekran görüntüsü.

Seçtiğiniz seçeneğe bağlı olarak ek bilgi sağlamanız gerekebilir.

1. Seçenek: Tüm ağlara izin ver

İlk seçenek, İnternet de dahil olmak üzere tüm ağların kaynağınıza erişmesine izin verir. Bu seçenek varsayılan ayardır. Bu seçenek için ek ayar gerekmez.

2. Seçenek: Yalnızca belirli ağlara izin ver

İkinci seçenek, kaynağınıza erişebilecek belirli ağları belirlemenize olanak tanır. Bu seçeneği belirlediğinizde, sayfa aşağıdaki gerekli alanları içerecek şekilde güncelleştirilir:

Alan Açıklama
Sanal ağ Kaynağınıza erişimine izin verilen sanal ağları belirtin. Azure portalında varsayılan sanal ağ adını düzenleyebilirsiniz.
Alt ağlar Kaynağınıza erişimine izin verilen alt ağları belirtin. Azure portalında varsayılan alt ağ adını düzenleyebilirsiniz.

Azure OpenAI kaynağı için ağ güvenliğini yalnızca belirli ağlara izin verecek şekilde yapılandırmayı gösteren ekran görüntüsü.

Güvenlik Duvarı bölümü, kaynağın güvenlik duvarı ayarlarını yapılandırmak için kullanabileceğiniz isteğe bağlı bir Adres aralığı alanı sağlar.

Seçenek 3: Ağ erişimini devre dışı bırakma

Üçüncü seçenek, kaynağınıza ağ erişimini devre dışı bırakmanızı sağlar. Bu seçeneği belirlediğinizde, sayfa Özel uç nokta tablosunu içerecek şekilde güncelleştirilir.

Azure portalında bir Azure OpenAI kaynağı için ağ güvenliğinin nasıl devre dışı bırakıldığını gösteren ekran görüntüsü.

Bir seçenek olarak, kaynağınıza erişim için özel bir uç nokta ekleyebilirsiniz. Özel uç nokta ekle'yi seçin ve uç nokta yapılandırmasını tamamlayın.

Yapılandırmayı onaylayın ve kaynağı oluşturun

  1. İleri'yi seçin ve kaynağınız için istediğiniz etiketleri yapılandırın.

  2. İşlemin son aşamasına geçmek için İleri'yi seçin: Gözden geçir + gönder.

  3. Yapılandırma ayarlarınızı onaylayın ve Oluştur'u seçin.

  4. Azure portalı, yeni kaynak kullanılabilir olduğunda bir bildirim görüntüler. Kaynağa git’i seçin.

    Azure portalında Kaynağa git düğmesini gösteren ekran görüntüsü.

Model dağıtma

Metin veya çıkarım oluşturabilmeniz için önce bir model dağıtmanız gerekir. Azure OpenAI Studio'daki çeşitli kullanılabilir modellerden birini seçebilirsiniz.

Modeli dağıtmak için şu adımları izleyin:

  1. Azure OpenAI Studio'da oturum açın.

  2. Çalışmak için aboneliği ve Azure OpenAI kaynağını seçin ve kaynağı kullan'ı seçin.

  3. Yönetim'in altında Dağıtımlar'ı seçin.

  4. Yeni dağıtım oluştur'u seçin ve aşağıdaki alanları yapılandırın:

    Alan Açıklama
    Bir model seçin Modelin kullanılabilirlik durumu bölgeye göre değişir. Bölge başına kullanılabilir modellerin listesi için bkz . Model özet tablosu ve bölge kullanılabilirliği.
    Dağıtım adı Bir adı dikkatle seçin. Dağıtım adı, kodunuzda istemci kitaplıklarını ve REST API'lerini kullanarak modeli çağırmak için kullanılır.
    Dağıtım türü Standart, Genel Toplu, Genel-Standart, Sağlanan-Yönetilen. Dağıtım türü seçenekleri hakkında daha fazla bilgi edinin.
    Gelişmiş seçenekler (İsteğe bağlı) Kaynağınız için gerekli olan isteğe bağlı gelişmiş ayarları ayarlayabilirsiniz.
    - İçerik Filtresi için dağıtımınıza bir içerik filtresi atayın.
    - Dakika Başına Belirteç Hız Sınırı için Dakika Başına Belirteçleri (TPM) ayarlayarak dağıtımınız için geçerli hız sınırını ayarlayın. Kotalar menüsünü kullanarak istediğiniz zaman bu değeri değiştirebilirsiniz. Dinamik Kota , ek kapasite kullanılabilir olduğunda daha fazla kotadan yararlanmanızı sağlar.
  5. Açılan listeden bir model seçin.

  6. Modeli tanımlamak için bir dağıtım adı girin.

    Önemli

    Modele API aracılığıyla eriştiğinizde, OpenAI ile Azure OpenAI arasındaki temel farklardan biri olan API çağrılarında temel model adı yerine dağıtım adına başvurmanız gerekir. OpenAI yalnızca model adını gerektirir. Azure OpenAI, model parametresini kullanırken bile her zaman dağıtım adı gerektirir. Belgelerimizde, hangi modelin belirli bir API uç noktasıyla çalıştığını belirtmeye yardımcı olmak için genellikle dağıtım adlarının model adlarıyla aynı olarak gösterildiği örnekler bulunur. Sonuç olarak dağıtım adlarınız, kullanım örneğiniz için en uygun adlandırma kuralını izleyebilir.

  7. İlk dağıtımınız için Gelişmiş seçenekler'i varsayılan olarak bırakın.

  8. Oluştur'u belirleyin.

Dağıtımlar tablosu, yeni oluşturduğunuz modele karşılık gelen yeni bir girdi gösterir.

Dağıtım tamamlandığında model dağıtım durumunuz başarılı olarak değişir.

Önkoşullar

Azure CLI'da oturum açma

Aşağıdaki adımlarda Azure CLI'da oturum açın veya CloudShell'i Aç'ı seçin.

Azure kaynak grubu oluşturma

Azure OpenAI kaynağı oluşturmak için bir Azure kaynak grubuna ihtiyacınız vardır. Azure CLI aracılığıyla yeni bir kaynak oluşturduğunuzda, yeni bir kaynak grubu da oluşturabilir veya Azure'a var olan bir grubu kullanmasını bildirebilirsiniz. Aşağıdaki örnekte az group create komutuyla OAIResourceGroup adlı yeni bir kaynak grubunun nasıl oluşturulacağı gösterilmektedir. Kaynak grubu Doğu ABD konumunda oluşturulur.

az group create \
--name OAIResourceGroup \
--location eastus

Kaynak oluşturma

Kaynak grubunda bir Azure OpenAI kaynağı oluşturmak için az cognitiveservices account create komutunu kullanın. Aşağıdaki örnekte, OAIResourceGroup kaynak grubunda MyOpenAIResource adlı bir kaynak oluşturursunuz. Örneği denediğinizde, azure abonelik kimliği <abonelik kimliğinizle> birlikte kaynak grubu ve kaynak adı için istediğiniz değerleri kullanmak üzere kodu güncelleştirin.

az cognitiveservices account create \
--name MyOpenAIResource \
--resource-group OAIResourceGroup \
--location eastus \
--kind OpenAI \
--sku s0 \
--subscription <subscriptionID>

Kaynak hakkındaki bilgileri alma

Kaynağı oluşturduktan sonra, Azure OpenAI Hizmeti örneğiniz hakkında yararlı bilgiler bulmak için farklı komutları kullanabilirsiniz. Aşağıdaki örneklerde REST API uç nokta temel URL'sinin ve yeni kaynağın erişim anahtarlarının nasıl alınıp alınıp alınmayacakları gösterilmektedir.

Uç nokta URL'sini alma

Kaynağın REST API uç nokta tabanı URL'sini almak için az cognitiveservices account show komutunu kullanın. Bu örnekte, değeri bulmak için komut çıkışını jq JSON işlemcisi .properties.endpoint üzerinden yönlendireceğiz.

Örneği denediğinizde, kodu myResourceGroupName kaynak grubu ve myResourceName> kaynağı <için değerlerinizi kullanacak şekilde güncelleştirin>.<

az cognitiveservices account show \
--name <myResourceName> \
--resource-group  <myResourceGroupName> \
| jq -r .properties.endpoint

Birincil API anahtarını alma

Kaynağın erişim anahtarlarını almak için az cognitiveservices account keys list komutunu kullanın. Bu örnekte, değeri bulmak için komut çıkışını jq JSON işlemcisi .key1 üzerinden yönlendireceğiz.

Örneği denediğinizde, kaynak grubu ve kaynak için değerlerinizi kullanmak üzere kodu güncelleştirin.

az cognitiveservices account keys list \
--name <myResourceName> \
--resource-group  <myResourceGroupName> \
| jq -r .key1

Model dağıtma

Modeli dağıtmak için az cognitiveservices account deployment create komutunu kullanın. Aşağıdaki örnekte, modelin bir örneğini text-embedding-ada-002 dağıtıp MyModel adını verirsiniz. Örneği denediğinizde, kaynak grubu ve kaynak için değerlerinizi kullanmak üzere kodu güncelleştirin. , model-format veya sku-capacityve sku-name değerlerini değiştirmeniz model-versiongerekmez.

az cognitiveservices account deployment create \
--name <myResourceName> \
--resource-group  <myResourceGroupName> \
--deployment-name MyModel \
--model-name text-embedding-ada-002 \
--model-version "1"  \
--model-format OpenAI \
--sku-capacity "1" \
--sku-name "Standard"

--sku-name şu dağıtım türlerini kabul eder: Standard, GlobalBatch, GlobalStandardve ProvisionedManaged. Dağıtım türü seçenekleri hakkında daha fazla bilgi edinin.

Önemli

Modele API aracılığıyla eriştiğinizde, OpenAI ile Azure OpenAI arasındaki temel farklardan biri olan API çağrılarında temel model adı yerine dağıtım adına başvurmanız gerekir. OpenAI yalnızca model adını gerektirir. Azure OpenAI, model parametresini kullanırken bile her zaman dağıtım adı gerektirir. Belgelerimizde, hangi modelin belirli bir API uç noktasıyla çalıştığını belirtmeye yardımcı olmak için genellikle dağıtım adlarının model adlarıyla aynı olarak gösterildiği örnekler bulunur. Sonuç olarak dağıtım adlarınız, kullanım örneğiniz için en uygun adlandırma kuralını izleyebilir.

Kaynağınızdan model silme

az cognitiveservices account deployment delete komutuyla kaynağınızdan dağıtılan tüm modelleri silebilirsiniz . Aşağıdaki örnekte MyModel adlı bir modeli silebilirsiniz. Örneği denediğinizde kodu kaynak grubu, kaynak ve dağıtılan model için değerlerinizi kullanacak şekilde güncelleştirin.

az cognitiveservices account deployment delete \
--name <myResourceName> \
--resource-group  <myResourceGroupName> \
--deployment-name MyModel

Kaynak silme

Bu alıştırmalardan sonra temizlemek istiyorsanız, Kaynağı Azure CLI aracılığıyla silerek Azure OpenAI kaynağınızı kaldırabilirsiniz. Kaynak grubunu da silebilirsiniz. Kaynak grubunu silmeyi seçerseniz, gruptaki tüm kaynaklar da silinir.

Kaynak grubunu ve ilişkili kaynaklarını kaldırmak için az cognitiveservices account delete komutunu kullanın.

Bu alıştırmalarda oluşturulan kaynakları kullanmaya devam etmeyecekseniz, kaynak grubunuzu silmek için aşağıdaki komutu çalıştırın. Kaynak grubu ve kaynak için değerlerinizi kullanmak üzere örnek kodu güncelleştirin.

az cognitiveservices account delete \
--name <myResourceName> \
--resource-group  <myResourceGroupName>

Önkoşullar

Azure PowerShell'de oturum açma

Aşağıdaki adımlarda Azure PowerShell'de oturum açın veya CloudShell'i Aç'ı seçin.

Azure kaynak grubu oluşturma

Azure OpenAI kaynağı oluşturmak için bir Azure kaynak grubuna ihtiyacınız vardır. Azure PowerShell aracılığıyla yeni bir kaynak oluşturduğunuzda, yeni bir kaynak grubu oluşturabilir veya Azure'a var olan bir grubu kullanmasını bildirebilirsiniz. Aşağıdaki örnekte, New-AzResourceGroup komutuyla OAIResourceGroup adlı yeni bir kaynak grubunun nasıl oluşturulacağı gösterilmektedir. Kaynak grubu Doğu ABD konumunda oluşturulur.

New-AzResourceGroup -Name OAIResourceGroup -Location eastus

Kaynak oluşturma

New-AzCognitiveServicesAccount komutunu kullanarak kaynak grubunda bir Azure OpenAI kaynağı oluşturun. Aşağıdaki örnekte, OAIResourceGroup kaynak grubunda MyOpenAIResource adlı bir kaynak oluşturursunuz. Örneği denediğinizde, azure abonelik kimliği <abonelik kimliğinizle> birlikte kaynak grubu ve kaynak adı için istediğiniz değerleri kullanmak üzere kodu güncelleştirin.

New-AzCognitiveServicesAccount -ResourceGroupName OAIResourceGroup -Name MyOpenAIResource -Type OpenAI -SkuName S0 -Location eastus

Kaynak hakkındaki bilgileri alma

Kaynağı oluşturduktan sonra, Azure OpenAI Hizmeti örneğiniz hakkında yararlı bilgiler bulmak için farklı komutları kullanabilirsiniz. Aşağıdaki örneklerde REST API uç nokta temel URL'sinin ve yeni kaynağın erişim anahtarlarının nasıl alınıp alınıp alınmayacakları gösterilmektedir.

Uç nokta URL'sini alma

Kaynağın REST API uç nokta temel URL'sini almak için Get-AzCognitiveServicesAccount komutunu kullanın. Bu örnekte, değeri bulmak için select-Object cmdlet'i aracılığıyla komut çıkışını endpoint yönlendireceğiz.

Örneği denediğinizde, kaynak grubu <myResourceGroupName> ve kaynağı <myResourceName>için değerlerinizi kullanmak üzere kodu güncelleştirin.

Get-AzCognitiveServicesAccount -ResourceGroupName OAIResourceGroup -Name MyOpenAIResource |
  Select-Object -Property endpoint

Birincil API anahtarını alma

Kaynağın erişim anahtarlarını almak için Get-AzCognitiveServicesAccountKey komutunu kullanın. Bu örnekte, değeri bulmak için select-Object cmdlet'i aracılığıyla komut çıkışını Key1 yönlendireceğiz.

Örneği denediğinizde, kaynak grubu ve kaynak için değerlerinizi kullanmak üzere kodu güncelleştirin.

Get-AzCognitiveServicesAccountKey -Name MyOpenAIResource -ResourceGroupName OAIResourceGroup |
  Select-Object -Property Key1

Model dağıtma

Modeli dağıtmak için New-AzCognitiveServicesAccountDeployment komutunu kullanın. Aşağıdaki örnekte, modelin bir örneğini text-embedding-ada-002 dağıtıp MyModel adını verirsiniz. Örneği denediğinizde, kaynak grubu ve kaynak için değerlerinizi kullanmak üzere kodu güncelleştirin. , model-format veya sku-capacityve sku-name değerlerini değiştirmeniz model-versiongerekmez.

$model = New-Object -TypeName 'Microsoft.Azure.Management.CognitiveServices.Models.DeploymentModel' -Property @{
    Name = 'text-embedding-ada-002'
    Version = '2'
    Format = 'OpenAI'
}

$properties = New-Object -TypeName 'Microsoft.Azure.Management.CognitiveServices.Models.DeploymentProperties' -Property @{
    Model = $model
}

$sku = New-Object -TypeName "Microsoft.Azure.Management.CognitiveServices.Models.Sku" -Property @{
    Name = 'Standard'
    Capacity = '1'
}

New-AzCognitiveServicesAccountDeployment -ResourceGroupName OAIResourceGroup -AccountName MyOpenAIResource -Name MyModel -Properties $properties -Sku $sku

Name değişkeninin $sku özelliği şu dağıtım türlerini kabul eder: Standard, GlobalBatch, GlobalStandardve ProvisionedManaged. Dağıtım türü seçenekleri hakkında daha fazla bilgi edinin.

Önemli

Modele API aracılığıyla eriştiğinizde, OpenAI ile Azure OpenAI arasındaki temel farklardan biri olan API çağrılarında temel model adı yerine dağıtım adına başvurmanız gerekir. OpenAI yalnızca model adını gerektirir. Azure OpenAI, model parametresini kullanırken bile her zaman dağıtım adı gerektirir. Belgelerimizde, hangi modelin belirli bir API uç noktasıyla çalıştığını belirtmeye yardımcı olmak için genellikle dağıtım adlarının model adlarıyla aynı olarak gösterildiği örnekler bulunur. Sonuç olarak dağıtım adlarınız, kullanım örneğiniz için en uygun adlandırma kuralını izleyebilir.

Kaynağınızdan model silme

Kaynağınızdan dağıtılan tüm modelleri Remove-AzCognitiveServicesAccountDeployment komutuyla silebilirsiniz. Aşağıdaki örnekte MyModel adlı bir modeli silebilirsiniz. Örneği denediğinizde kodu kaynak grubu, kaynak ve dağıtılan model için değerlerinizi kullanacak şekilde güncelleştirin.

Remove-AzCognitiveServicesAccountDeployment -ResourceGroupName OAIResourceGroup -AccountName MyOpenAIResource -Name MyModel

Kaynak silme

Bu alıştırmalardan sonra temizlemek istiyorsanız, Kaynağı Azure PowerShell aracılığıyla silerek Azure OpenAI kaynağınızı kaldırabilirsiniz. Kaynak grubunu da silebilirsiniz. Kaynak grubunu silmeyi seçerseniz, gruptaki tüm kaynaklar da silinir.

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

Bu alıştırmalarda oluşturulan kaynakları kullanmaya devam etmeyecekseniz, kaynak grubunuzu silmek için aşağıdaki komutu çalıştırın. Kaynak grubu ve kaynak için değerlerinizi kullanmak üzere örnek kodu güncelleştirin.

Remove-AzCognitiveServicesAccount -Name MyOpenAIResource -ResourceGroupName OAIResourceGroup

Sonraki adımlar

  • Azure OpenAI Hizmeti hızlı başlangıçlarıyla API çağrıları yapın ve metin oluşturun.
  • Azure OpenAI Hizmeti modelleri hakkında daha fazla bilgi edinin.
  • Fiyatlandırma hakkında bilgi için Azure OpenAI fiyatlandırma sayfasını ziyaret edin