Hızlı Başlangıç: Azure AI hizmetleri için çok hizmetli bir kaynak oluşturma

Azure AI hizmetleri için çok hizmetli bir kaynak oluşturmayı ve yönetmeyi öğrenin. Çok hizmetli bir kaynak, tek bir anahtar ve uç nokta ile birden çok Azure AI hizmetine erişmenizi sağlar. Ayrıca, kullandığınız hizmetlerden gelen faturalamayı da birleştirir.

Azure AI hizmetlerine iki farklı kaynak üzerinden erişebilirsiniz: Çok hizmetli kaynak veya tek hizmetli bir kaynak.

• Çok hizmetli kaynak:
  • Tek bir anahtar ve uç nokta ile birden çok Azure AI hizmetine erişin.
  • Kullandığınız hizmetlerden faturalamayı birleştirir.
• Tek hizmetli kaynak:
  • Oluşturulan her hizmet için benzersiz bir anahtar ve uç nokta ile tek bir Azure AI hizmetine erişin.
  • Çoğu Azure yapay zeka hizmeti, denemek için ücretsiz bir katman sunar.

Azure yapay zeka hizmetleri, Azure aboneliğiniz altında oluşturduğunuz Azure kaynaklarıdır . Kaynak oluşturduktan sonra, uygulamalarınızın kimliğini doğrulamak için oluşturulan anahtarları ve uç noktayı kullanabilirsiniz.

Çok hizmetli bir kaynakla desteklenen hizmetler

Çok hizmetli kaynak, tek bir anahtar ve uç nokta ile aşağıdaki Azure AI hizmetlerine erişim sağlar. Kaynağınızı kullanmaya başlamak için hızlı başlangıç makalelerini, örneklerini ve daha fazlasını bulmak için bu bağlantıları kullanın.

Hizmet	Açıklama
Content Moderator (kullanımdan kaldırıldı)	Olası rahatsız edici veya istenmeyen içerikleri tespit edin.
Özel Görüntü İşleme	İşletmeniz için görüntü tanımayı özelleştirin.
Belge Yönetim Bilgileri	Belgeleri akıllı veri odaklı çözümlere dönüştürün.
Yüz Tanıma	Görüntülerdeki kişileri ve duyguları algılayıp tanımlayın.
Dil	Sektör lideri doğal dil anlama özellikleriyle uygulamalar oluşturun.
Konuşma	Konuşmayı metne dönüştürme, metin okuma, çeviri ve konuşmacı tanıma.
Çeviri	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...
Vision	Görüntülerdeki ve videolardaki içeriği analiz edin.

Önkoşullar

• Geçerli bir Azure aboneliği - Ücretsiz bir abonelik oluşturun.
• Sorumlu yapay zeka koşullarını kabul edebilmeniz ve kaynak oluşturabilmeniz için Azure hesabınızın atanmış bir Cognitive Services Contributor rolü olmalıdır. Bu rolün hesabınıza atanmasını sağlamak için Rol atama belgelerindeki adımları izleyin veya yöneticinize başvurun.

Yeni bir çok hizmetli kaynak oluşturma

Çok hizmetli kaynak, portalda Azure AI hizmetleri>Azure AI hizmetleri çok hizmetli hesabı altında listelenir. Çok hizmetli bir kaynak oluşturmak için şu yönergeleri izleyin:

1. Çok hizmetli bir kaynak oluşturmak için şu bağlantıyı seçin: https://portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne

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	Azure AI hizmetleri kaynağınızı içerecek Azure kaynak grubu. Yeni bir grup oluşturabilir veya önceden var olan bir gruba ekleyebilirsiniz.
   Bölge	Azure AI hizmet örneğinizin konumu. Farklı konumlar gecikmeye neden olabilir, ancak kaynağınızın çalışma zamanı kullanılabilirliğini etkilemez.
   Ad	Azure AI hizmetleri kaynağınız için açıklayıcı bir ad. Örneğin, MyCognitiveServicesResource.
   Fiyatlandırma katmanı	Azure AI hizmetleri hesabınızın maliyeti, seçtiğiniz seçeneklere ve kullanımınıza bağlıdır. Daha fazla bilgi için API fiyatlandırma ayrıntılarına bakın.

   

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 Azure AI hizmetleri kaynağı oluşturmanıza izin vermiyorsa Azure portalı, PowerShell komutunu veya Azure CLI komutunu kullanarak bu Azure kaynak sağlayıcısınınayrıcalığını etkinleştirmeniz gerekebilir. Aboneliğin sahibi değilseniz, Abonelik Sahibinden veya yönetici rolüne sahip olan birinden sizin için kaydı tamamlamasını isteyin ya da hesabınıza /register/action ayrıcalıkları verilmesini isteyin.

Kaynağınızın anahtarlarını alma

1. Kaynağınız başarıyla dağıtıldıktan sonra Sonraki Adımlar>Kaynağa git'i seçin.

   

2. Açılan hızlı başlangıç bölmesinden kaynak uç noktasına erişebilir ve anahtarları yönetebilirsiniz.

Kimlik doğrulaması için ortam değişkeni yapılandırma

Azure AI hizmetleri kaynaklarına erişmek için uygulamanızın kimliğinin doğrulanması gerekir. Kaynak anahtarınızın ortam değişkenini ayarlamak için bir konsol penceresi açın ve işletim sisteminizle geliştirme ortamınıza yönelik yönergeleri izleyin. Ortam değişkenini COGNITIVE_SERVICE_KEY ayarlamak için değerini kaynağınızın anahtarlarından biriyle değiştirin your-key .

Üretim için parola korumalı gizli dizi kasası gibi kimlik bilgilerinizi depolamanın ve bunlara erişmenin güvenli bir yolunu kullanın. Test için ortam değişkenine yazmak standart bir uygulamadır, ancak ortam değişkenlerinin yerel makinede düz metinde depolandığını unutmayın.

İpucu

Anahtarı doğrudan kodunuz içinde eklemeyin ve asla herkese açık olarak göndermeyin. Azure Key Vault gibi daha fazla kimlik doğrulama seçeneği için Azure AI hizmetleri güvenlik makalesine bakın.

Windows

PowerShell, gizli dizileri Gizli Dizi Deposu veya Azure KeyVault gibi platformlarda depolamak için genişletilebilir bir çözüm (Gizli Dizi Yönetimi) içerir.

Güvenli dizeleri barındıracak bir gizli dizi deposu ayarlamak için Gizli dizi depoyu kullanmaya başlama makalesine bakın. Ardından api anahtarlarınızı depolamak için aşağıdaki örnekleri kullanın.

Set-Secret -Name COGNITIVE_SERVICE_KEY -value your-key

Test ortamları için PowerShell'in $Env: söz dizimini kullanarak yalnızca geçerli oturum için bir ortam değişkeni ayarlayabilir veya setx değişkeni oturumlar arasında tutmak için komutunu kullanabilirsiniz. Bu değerlerin Windows kayıt defteri anahtarlarında düz metinde depolandığını unutmayın.

$Env:COGNITIVE_SERVICE_KEY = your-key

setx COGNITIVE_SERVICE_KEY your-key

kullanarak setxortam değişkenini ekledikten sonra, ortam değişkenini okuması gereken tüm çalışan konsolları veya diğer programları yeniden başlatmanız gerekebilir. Örneğin, düzenleyici olarak Visual Studio kullanıyorsanız, örneği çalıştırmadan önce Visual Studio'yu yeniden başlatın.

Linux

export COGNITIVE_SERVICE_KEY=your-key

Ortam değişkenini ekledikten sonra değişiklikleri uygulamak için konsol pencerenizden source ~/.bashrc çalıştırın.

macOS

Bash

.bash_profile dosyanızı düzenleyin ve ortam değişkenini ekleyin:

export COGNITIVE_SERVICE_KEY=your-key

Ortam değişkenini ekledikten sonra değişiklikleri uygulamak için konsol pencerenizden source ~/.bash_profile çalıştırın.

Xcode

iOS ve macOS geliştirme için ortam değişkenlerini Xcode'da ayarlarsınız. Örneğin, Xcode 13.4.1'de ortam değişkenini ayarlamak için bu adımları izleyin.

1. Ürün>Şeması Düzenleme>şemasını seçin
2. Çalıştırma (Hata Ayıklama Çalıştırması) sayfasında Bağımsız Değişkenler'i seçin
3. Ortam Değişkenleri'nin altında artı (+) işaretini seçerek yeni bir ortam değişkeni ekleyin.
4. COGNITIVE_SERVICE_KEY Ad alanına girin ve Değer için kaynak anahtarınızı girin.

Daha fazla yapılandırma seçeneği için Xcode belgelerine bakın.

Konuşma kaynak bölgenizin ortam değişkenini ayarlamak için aynı adımları izleyin. Kaynağınızın bölgesine ayarlayın COGNITIVE_SERVICE_REGION . Örneğin, westus.

Kaynakları temizleme

Azure AI hizmetleri aboneliğini 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ı seçerek kaynak gruplarınızın listesini görüntüleyin.
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 Azure AI hizmetleri 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 Azure AI hizmetleri kaynağı oluşturmak için bu hızlı başlangıcı kullanın. Kaynağı oluşturduktan sonra, uygulamalarınızın kimliğini doğrulamak için sizin için oluşturulan anahtarları ve uç noktayı kullanın.

Azure AI hizmetleri, geliştiricilerin doğrudan yapay zeka veya veri bilimi becerilerine veya bilgisine sahip olmadan uygulamalara bilişsel zeka oluşturmasına yardımcı olan bulut tabanlı yapay zeka (AI) hizmetleridir. Popüler geliştirme dillerindeki REST API'ler ve istemci kitaplığı SDK'ları aracılığıyla kullanılabilirler. Azure yapay zeka hizmetleri, geliştiricilerin görebilen, duyabilen, konuşabilen ve analiz eden bilişsel çözümlerle uygulamalarına kolayca bilişsel özellikler eklemesini sağlar.

Önkoşullar

• Geçerli bir Azure aboneliği - Ücretsiz bir abonelik oluşturun.
• Azure CLI
• Sorumlu yapay zeka koşullarını kabul edebilmeniz ve kaynak oluşturabilmeniz için Azure hesabınızın atanmış bir Cognitive Services Contributor rolü olmalıdır. Bu rolün hesabınıza atanmasını sağlamak için Rol atama belgelerindeki adımları izleyin veya yöneticinize başvurun.
• Azure Yapay Zeka Görüntü İşleme'de Uzamsal Analizi veya Azure Yapay Zeka Dilinde Sistem Durumu için Metin Analizi kullanmayı planlıyorsanız, hüküm ve koşulları gözden geçirip kabul edebilmeniz için Azure portalından ilk Görüntü İşleme veya Dil kaynaklarınızı oluşturmanız gerekir. Bunu burada yapabilirsiniz: Azure AI Language, Azure AI Vision. Bundan sonra, aynı Azure aboneliği altındaki herhangi bir dağıtım aracını (örneğin SDK, CLI veya ARM şablonu) kullanarak sonraki kaynakları oluşturabilirsiniz.

Azure CLI'yi yükleme ve oturum açma

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

az login

Bu komutları tarayıcınızda çalıştırmak için yeşil Deneyin düğmesini de kullanabilirsiniz.

Yeni bir Azure AI hizmetleri kaynak grubu oluşturma

Azure AI hizmetleri 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 grubu konumunuzu seçin

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. Azure AI hizmetlerinin ç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 AI hizmetleri kaynaklarını çağırırken ihtiyacınız olacağı için Azure konumunuzu unutmayın.
• Bazı Azure yapay zeka hizmetlerinin 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

Azure AI hizmetleri kaynağı oluşturma

Hizmet ve fiyatlandırma katmanı seçme

Yeni bir kaynak oluşturduğunuzda, kullanmak istediğiniz hizmet türünü ve istediğiniz fiyatlandırma katmanını (veya SKU'yu) bilmeniz gerekir. Kaynağı oluştururken parametre olarak bu ve diğer bilgileri kullanacaksınız.

Aşağıdaki tablolarda, Azure AI hizmetleri için ürünler ve fiyatlandırma hakkında bilgi sağlanır.

Çoklu hizmet

Hizmet	Tip
Birden çok hizmet. Daha fazla bilgi için bkz. fiyatlandırma sayfası.	CognitiveServices

Görsel

Hizmet	Tip
Görsel	ComputerVision
Özel Görüntü İşleme - Tahmin	CustomVision.Prediction
Özel Görüntü İşleme - Eğitim	CustomVision.Training
Yüz Tanıma	Face
Belge Yönetim Bilgileri	FormRecognizer

Konuşma

Hizmet	Tip
Konuşma	SpeechServices

Dil

Hizmet	Tip
Language Understanding (LUIS)	LUIS
QnA Maker	QnAMaker
Dil	TextAnalytics
Metin Çevirisi	TextTranslation

Karar

Hizmet	Tip
Anomali Algılayıcısı	AnomalyDetector
Content Moderator	ContentModerator
Kişiselleştirme	Personalizer

Azure OpenAI

Hizmet	Tip
Azure OpenAI	OpenAI

Fiyatlandırma katmanları ve faturalama

Fiyatlandırma katmanları (ve faturalandırılan tutar), kimlik doğrulama bilgilerinizi kullanarak gönderdiğiniz işlem sayısına bağlıdır. Her fiyatlandırma katmanı aşağıdakileri belirtir:

• Saniye başına izin verilen en fazla işlem sayısı (TPS).
• Fiyatlandırma katmanında etkinleştirilen hizmet özellikleri.
• Önceden tanımlanmış işlem sayısı için maliyet. Hizmetinizin fiyatlandırma ayrıntılarında belirtildiği gibi bu sayinin üzerine çıkarılırsa ek ücret tahsil edilir.

Not

Azure AI hizmetlerinin birçoğu, hizmeti denemek için kullanabileceğiniz ücretsiz bir katmana sahiptir. Ücretsiz katmanı kullanmak için kaynağınızın fiyatlandırma katmanı olarak kullanın F0 .

az cognitiveservices account list-kinds komutuyla kullanılabilir Azure AI hizmetlerinin "türleri " listesini bulabilirsiniz:

az cognitiveservices account list-kinds

Kaynak grubunuza yeni kaynak ekleme

Yeni bir Azure AI hizmetleri 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:

Aşağıdaki komutla adlı multi-service-resource bir Standart S0 çok hizmetli kaynak oluşturabilirsiniz.

az cognitiveservices account create --name multi-service-resource --resource-group ai-services-resource-group  --kind CognitiveServices --sku F0 --location westus2 --yes

İpucu

Aboneliğiniz bir Azure AI hizmetleri kaynağı oluşturmanıza izin vermiyorsa Azure portalı, PowerShell komutunu veya Azure CLI komutunu kullanarak bu Azure kaynak sağlayıcısınınayrıcalığını etkinleştirmeniz gerekebilir. Aboneliğin sahibi değilseniz, Abonelik Sahibinden veya yönetici rolüne sahip olan birinden sizin için kaydı tamamlamasını isteyin ya da hesabınıza /register/action ayrıcalıkları verilmesini isteyin.

Kaynağınızın anahtarlarını alma

Komut Satırı Arabirimi(CLI) yerel yüklemenizde oturum açmak için az login komutunu kullanın.

az login

Kaynağınızın anahtarlarını almak için az cognitiveservices account keys list komutunu kullanın.

az cognitiveservices account keys list  --name multi-service-resource --resource-group ai-services-resource-group

Kimlik doğrulaması için ortam değişkeni yapılandırma

Azure AI hizmetleri kaynaklarına erişmek için uygulamanızın kimliğinin doğrulanması gerekir. Kaynak anahtarınızın ortam değişkenini ayarlamak için bir konsol penceresi açın ve işletim sisteminizle geliştirme ortamınıza yönelik yönergeleri izleyin. Ortam değişkenini COGNITIVE_SERVICE_KEY ayarlamak için değerini kaynağınızın anahtarlarından biriyle değiştirin your-key .

Üretim için parola korumalı gizli dizi kasası gibi kimlik bilgilerinizi depolamanın ve bunlara erişmenin güvenli bir yolunu kullanın. Test için ortam değişkenine yazmak standart bir uygulamadır, ancak ortam değişkenlerinin yerel makinede düz metinde depolandığını unutmayın.

İpucu

Anahtarı doğrudan kodunuz içinde eklemeyin ve asla herkese açık olarak göndermeyin. Azure Key Vault gibi daha fazla kimlik doğrulama seçeneği için Azure AI hizmetleri güvenlik makalesine bakın.

Windows

PowerShell, gizli dizileri Gizli Dizi Deposu veya Azure KeyVault gibi platformlarda depolamak için genişletilebilir bir çözüm (Gizli Dizi Yönetimi) içerir.

Güvenli dizeleri barındıracak bir gizli dizi deposu ayarlamak için Gizli dizi depoyu kullanmaya başlama makalesine bakın. Ardından api anahtarlarınızı depolamak için aşağıdaki örnekleri kullanın.

Set-Secret -Name COGNITIVE_SERVICE_KEY -value your-key

Test ortamları için PowerShell'in $Env: söz dizimini kullanarak yalnızca geçerli oturum için bir ortam değişkeni ayarlayabilir veya setx değişkeni oturumlar arasında tutmak için komutunu kullanabilirsiniz. Bu değerlerin Windows kayıt defteri anahtarlarında düz metinde depolandığını unutmayın.

$Env:COGNITIVE_SERVICE_KEY = your-key

setx COGNITIVE_SERVICE_KEY your-key

kullanarak setxortam değişkenini ekledikten sonra, ortam değişkenini okuması gereken tüm çalışan konsolları veya diğer programları yeniden başlatmanız gerekebilir. Örneğin, düzenleyici olarak Visual Studio kullanıyorsanız, örneği çalıştırmadan önce Visual Studio'yu yeniden başlatın.

Linux

export COGNITIVE_SERVICE_KEY=your-key

Ortam değişkenini ekledikten sonra değişiklikleri uygulamak için konsol pencerenizden source ~/.bashrc çalıştırın.

macOS

Bash

.bash_profile dosyanızı düzenleyin ve ortam değişkenini ekleyin:

export COGNITIVE_SERVICE_KEY=your-key

Ortam değişkenini ekledikten sonra değişiklikleri uygulamak için konsol pencerenizden source ~/.bash_profile çalıştırın.

Xcode

iOS ve macOS geliştirme için ortam değişkenlerini Xcode'da ayarlarsınız. Örneğin, Xcode 13.4.1'de ortam değişkenini ayarlamak için bu adımları izleyin.

1. Ürün>Şeması Düzenleme>şemasını seçin
2. Çalıştırma (Hata Ayıklama Çalıştırması) sayfasında Bağımsız Değişkenler'i seçin
3. Ortam Değişkenleri'nin altında artı (+) işaretini seçerek yeni bir ortam değişkeni ekleyin.
4. COGNITIVE_SERVICE_KEY Ad alanına girin ve Değer için kaynak anahtarınızı girin.

Daha fazla yapılandırma seçeneği için Xcode belgelerine bakın.

Konuşma kaynak bölgenizin ortam değişkenini ayarlamak için aynı adımları izleyin. Kaynağınızın bölgesine ayarlayın COGNITIVE_SERVICE_REGION . Örneğin, westus.

Fiyatlandırma katmanları ve faturalama

Fiyatlandırma katmanları (ve faturalandırılan tutar), kimlik doğrulama bilgilerinizi kullanarak gönderdiğiniz işlem sayısına bağlıdır. Her fiyatlandırma katmanı aşağıdakileri belirtir:

• saniye başına izin verilen en fazla işlem sayısı (TPS).
• fiyatlandırma katmanında etkinleştirilen hizmet özellikleri.
• Önceden tanımlanmış işlem sayısının maliyeti. Bu tutarın üzerine gitmek, hizmetinizin fiyatlandırma ayrıntılarında belirtilen ek ücrete neden olur.

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 multi-service-resource --resource-group ai-services-resource-group --subscription subscription-name

Kaynakları temizleme

Azure AI hizmetleri 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 az group delete komutunu kullanın.

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

Azure PowerShell komutlarını kullanarak bir Azure AI hizmetleri kaynağı oluşturmak için bu hızlı başlangıcı kullanın. Kaynağı oluşturduktan sonra, uygulamalarınızın kimliğini doğrulamak için sizin için oluşturulan anahtarları ve uç noktayı kullanın.

Azure AI hizmetleri, geliştiricilerin doğrudan yapay zeka veya veri bilimi becerilerine veya bilgisine sahip olmadan uygulamalara bilişsel zeka oluşturmasına yardımcı olan bulut tabanlı yapay zeka (AI) hizmetleridir. Popüler geliştirme dillerindeki REST API'ler ve istemci kitaplığı SDK'ları aracılığıyla kullanılabilirler. Azure yapay zeka hizmetleri, geliştiricilerin görebilen, duyabilen, konuşabilen ve analiz eden bilişsel çözümlerle uygulamalarına kolayca bilişsel özellikler eklemesini sağlar.

Önkoşullar

• Geçerli bir Azure aboneliği - Ücretsiz bir abonelik oluşturun.
• Azure PowerShell
• Sorumlu yapay zeka koşullarını kabul edebilmeniz ve kaynak oluşturabilmeniz için Azure hesabınızın atanmış bir Cognitive Services Contributor rolü olmalıdır. Bu rolün hesabınıza atanmasını sağlamak için Rol atama belgelerindeki adımları izleyin veya yöneticinize başvurun.
• Azure Yapay Zeka Görüntü İşleme'de Uzamsal Analizi veya Azure Yapay Zeka Dilinde Sistem Durumu için Metin Analizi kullanmayı planlıyorsanız, hüküm ve koşulları gözden geçirip kabul edebilmeniz için Azure portalından ilk Görüntü İşleme veya Dil kaynaklarınızı oluşturmanız gerekir. Bunu burada yapabilirsiniz: Azure AI Language, Azure AI Vision. Bundan sonra, aynı Azure aboneliği altındaki herhangi bir dağıtım aracını (örneğin SDK, CLI veya ARM şablonu) kullanarak sonraki kaynakları oluşturabilirsiniz.

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

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

Connect-AzAccount

Bu komutları tarayıcınızda çalıştırmak için yeşil Deneyin düğmesini de kullanabilirsiniz.

Yeni bir Azure AI hizmetleri kaynak grubu oluşturma

Azure AI hizmetleri 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 grubu konumunuzu seçin

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. Azure AI hizmetlerinin ç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 AI hizmetleri kaynaklarını çağırırken ihtiyacınız olacağı için Azure konumunuzu unutmayın.
• Bazı Azure yapay zeka hizmetlerinin 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

Azure AI hizmetleri kaynağı oluşturma

Hizmet ve fiyatlandırma katmanı seçme

Yeni bir kaynak oluşturduğunuzda, kullanmak istediğiniz hizmet türünü ve istediğiniz fiyatlandırma katmanını (veya SKU'yu) bilmeniz gerekir. Kaynağı oluştururken parametre olarak bu ve diğer bilgileri kullanacaksınız.

Aşağıdaki tablolarda, Azure AI hizmetleri için ürünler ve fiyatlandırma hakkında bilgi sağlanır.

Çoklu hizmet

Hizmet	Tip
Birden çok hizmet. Daha fazla bilgi için bkz. fiyatlandırma sayfası.	CognitiveServices

Görsel

Hizmet	Tip
Görsel	ComputerVision
Özel Görüntü İşleme - Tahmin	CustomVision.Prediction
Özel Görüntü İşleme - Eğitim	CustomVision.Training
Yüz Tanıma	Face
Belge Yönetim Bilgileri	FormRecognizer

Konuşma

Hizmet	Tip
Konuşma	SpeechServices

Dil

Hizmet	Tip
Language Understanding (LUIS)	LUIS
QnA Maker	QnAMaker
Dil	TextAnalytics
Metin Çevirisi	TextTranslation

Karar

Hizmet	Tip
Anomali Algılayıcısı	AnomalyDetector
Content Moderator	ContentModerator
Kişiselleştirme	Personalizer

Azure OpenAI

Hizmet	Tip
Azure OpenAI	OpenAI

Fiyatlandırma katmanları ve faturalama

Fiyatlandırma katmanları (ve faturalandırılan tutar), kimlik doğrulama bilgilerinizi kullanarak gönderdiğiniz işlem sayısına bağlıdır. Her fiyatlandırma katmanı aşağıdakileri belirtir:

• Saniye başına izin verilen en fazla işlem sayısı (TPS).
• Fiyatlandırma katmanında etkinleştirilen hizmet özellikleri.
• Önceden tanımlanmış işlem sayısı için maliyet. Hizmetinizin fiyatlandırma ayrıntılarında belirtildiği gibi bu sayinin üzerine çıkarılırsa ek ücret tahsil edilir.

Not

Azure AI hizmetlerinin birçoğu, hizmeti denemek için kullanabileceğiniz ücretsiz bir katmana sahiptir. Ücretsiz katmanı kullanmak için kaynağınızın fiyatlandırma katmanı olarak kullanın F0 .

Get-AzCognitiveServicesAccountType komutuyla kullanılabilir Azure AI hizmetlerinin "türleri" listesini bulabilirsiniz:

Get-AzCognitiveServicesAccountType

Kaynak grubunuza yeni kaynak ekleme

Yeni bir Azure AI hizmetleri 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:

Aşağıdaki komutla adlı multi-service-resource bir Standart S0 çok hizmetli kaynak oluşturabilirsiniz.

New-AzCognitiveServicesAccount -ResourceGroupName ai-services-resource-group -Name multi-service-resource -Type CognitiveServices -SkuName F0 -Location westus2

İpucu

Aboneliğiniz bir Azure AI hizmetleri kaynağı oluşturmanıza izin vermiyorsa Azure portalı, Azure PowerShell komutunu veya Azure CLI komutunu kullanarak bu Azure kaynak sağlayıcısının ayrıcalığını etkinleştirmeniz gerekebilir. Aboneliğin sahibi değilseniz, Abonelik Sahibinden veya yönetici rolüne sahip olan birinden sizin için kaydı tamamlamasını isteyin ya da hesabınıza /register/action ayrıcalıkları verilmesini isteyin.

Kaynağınızın anahtarlarını alma

Kaynağınızın anahtarlarını almak için Get-AzCognitiveServicesAccountKey komutunu kullanın.

Get-AzCognitiveServicesAccountKey -Name multi-service-resource -ResourceGroupName ai-services-resource-group

Kimlik doğrulaması için ortam değişkeni yapılandırma

Azure AI hizmetleri kaynaklarına erişmek için uygulamanızın kimliğinin doğrulanması gerekir. Kaynak anahtarınızın ortam değişkenini ayarlamak için bir konsol penceresi açın ve işletim sisteminizle geliştirme ortamınıza yönelik yönergeleri izleyin. Ortam değişkenini COGNITIVE_SERVICE_KEY ayarlamak için değerini kaynağınızın anahtarlarından biriyle değiştirin your-key .

Üretim için parola korumalı gizli dizi kasası gibi kimlik bilgilerinizi depolamanın ve bunlara erişmenin güvenli bir yolunu kullanın. Test için ortam değişkenine yazmak standart bir uygulamadır, ancak ortam değişkenlerinin yerel makinede düz metinde depolandığını unutmayın.

İpucu

Anahtarı doğrudan kodunuz içinde eklemeyin ve asla herkese açık olarak göndermeyin. Azure Key Vault gibi daha fazla kimlik doğrulama seçeneği için Azure AI hizmetleri güvenlik makalesine bakın.

Windows

PowerShell, gizli dizileri Gizli Dizi Deposu veya Azure KeyVault gibi platformlarda depolamak için genişletilebilir bir çözüm (Gizli Dizi Yönetimi) içerir.

Güvenli dizeleri barındıracak bir gizli dizi deposu ayarlamak için Gizli dizi depoyu kullanmaya başlama makalesine bakın. Ardından api anahtarlarınızı depolamak için aşağıdaki örnekleri kullanın.

Set-Secret -Name COGNITIVE_SERVICE_KEY -value your-key

Test ortamları için PowerShell'in $Env: söz dizimini kullanarak yalnızca geçerli oturum için bir ortam değişkeni ayarlayabilir veya setx değişkeni oturumlar arasında tutmak için komutunu kullanabilirsiniz. Bu değerlerin Windows kayıt defteri anahtarlarında düz metinde depolandığını unutmayın.

$Env:COGNITIVE_SERVICE_KEY = your-key

setx COGNITIVE_SERVICE_KEY your-key

kullanarak setxortam değişkenini ekledikten sonra, ortam değişkenini okuması gereken tüm çalışan konsolları veya diğer programları yeniden başlatmanız gerekebilir. Örneğin, düzenleyici olarak Visual Studio kullanıyorsanız, örneği çalıştırmadan önce Visual Studio'yu yeniden başlatın.

Linux

export COGNITIVE_SERVICE_KEY=your-key

Ortam değişkenini ekledikten sonra değişiklikleri uygulamak için konsol pencerenizden source ~/.bashrc çalıştırın.

macOS

Bash

.bash_profile dosyanızı düzenleyin ve ortam değişkenini ekleyin:

export COGNITIVE_SERVICE_KEY=your-key

Ortam değişkenini ekledikten sonra değişiklikleri uygulamak için konsol pencerenizden source ~/.bash_profile çalıştırın.

Xcode

iOS ve macOS geliştirme için ortam değişkenlerini Xcode'da ayarlarsınız. Örneğin, Xcode 13.4.1'de ortam değişkenini ayarlamak için bu adımları izleyin.

1. Ürün>Şeması Düzenleme>şemasını seçin
2. Çalıştırma (Hata Ayıklama Çalıştırması) sayfasında Bağımsız Değişkenler'i seçin
3. Ortam Değişkenleri'nin altında artı (+) işaretini seçerek yeni bir ortam değişkeni ekleyin.
4. COGNITIVE_SERVICE_KEY Ad alanına girin ve Değer için kaynak anahtarınızı girin.

Daha fazla yapılandırma seçeneği için Xcode belgelerine bakın.

Konuşma kaynak bölgenizin ortam değişkenini ayarlamak için aynı adımları izleyin. Kaynağınızın bölgesine ayarlayın COGNITIVE_SERVICE_REGION . Örneğin, westus.

Fiyatlandırma katmanları ve faturalama

Fiyatlandırma katmanları (ve faturalandırılan tutar), kimlik doğrulama bilgilerinizi kullanarak gönderdiğiniz işlem sayısına bağlıdır. Her fiyatlandırma katmanı aşağıdakileri belirtir:

• saniye başına izin verilen en fazla işlem sayısı (TPS).
• fiyatlandırma katmanında etkinleştirilen hizmet özellikleri.
• Önceden tanımlanmış işlem sayısının maliyeti. Bu tutarın üzerine gitmek, hizmetinizin fiyatlandırma ayrıntılarında belirtilen ek ücrete neden olur.

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 multi-service-resource

Kaynakları temizleme

Azure AI hizmetleri 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

Başvuru belgeleri | Kitaplık kaynak kodu | Paketi (NuGet)Örnekleri |

C# önkoşulları

• Geçerli bir Azure aboneliği - Ücretsiz bir abonelik oluşturun.
• .NET Core'un geçerli sürümü.
• Sorumlu yapay zeka koşullarını kabul edebilmeniz ve kaynak oluşturabilmeniz için Azure hesabınızın atanmış bir Cognitive Services Contributor rolü olmalıdır. Bu rolün hesabınıza atanmasını sağlamak için Rol atama belgelerindeki adımları izleyin veya yöneticinize başvurun.
• Azure Yapay Zeka Görüntü İşleme'de Uzamsal Analizi veya Azure Yapay Zeka Dilinde Sistem Durumu için Metin Analizi kullanmayı planlıyorsanız, hüküm ve koşulları gözden geçirip kabul edebilmeniz için Azure portalından ilk Görüntü İşleme veya Dil kaynaklarınızı oluşturmanız gerekir. Bunu burada yapabilirsiniz: Azure AI Language, Azure AI Vision. Bundan sonra, aynı Azure aboneliği altındaki herhangi bir dağıtım aracını (örneğin SDK, CLI veya ARM şablonu) kullanarak sonraki kaynakları oluşturabilirsiniz.

Azure Hizmet Sorumlusu oluşturma

Uygulamanızın Azure hesabınızla etkileşim kurmasını sağlamak için izinleri yönetmek için bir Azure hizmet sorumlusuna ihtiyacınız vardır. Azure hizmet sorumlusu oluşturma başlığındaki yönergeleri izleyin.

Hizmet sorumlusu oluşturduğunuzda gizli dizi değeri, kimlik ve uygulama kimliği olduğunu görürsünüz. Uygulama kimliğini ve gizli diziyi sonraki adımlar için geçici bir konuma kaydedin.

Kaynak grubu oluşturma

Azure AI hizmetleri kaynağı oluşturmadan önce, hesabınızın kaynağı içerecek bir Azure kaynak grubuna sahip olması gerekir. Henüz bir kaynak grubunuz yoksa devam etmeden önce Azure portalında bir kaynak grubu oluşturun.

Yeni bir C# uygulaması oluşturma

Yeni bir .NET Core uygulaması oluşturun. Bir konsol penceresinde (cmd, PowerShell veya Bash gibi), adlı azure-management-quickstartyeni bir konsol uygulaması oluşturmak için komutunu kullanındotnet new. Bu komut, tek bir kaynak dosyayla basit bir "Merhaba Dünya" C# projesi oluşturur: program.cs.

dotnet new console -n azure-management-quickstart

Dizininizi yeni oluşturulan uygulama klasörüyle değiştirin. Uygulamayı şu şekilde oluşturabilirsiniz:

dotnet build

Derleme çıkışı hiçbir uyarı veya hata içermemelidir.

...
Build succeeded.
 0 Warning(s)
 0 Error(s)
...

İstemci kitaplığını yükleme

Uygulama dizininde aşağıdaki komutla .NET için Azure Management istemci kitaplığını yükleyin:

dotnet add package Azure.ResourceManager.CognitiveServices
dotnet add package Microsoft.Azure.Management.Fluent
dotnet add package Microsoft.Azure.Management.ResourceManager.Fluent

Visual Studio IDE kullanıyorsanız, istemci kitaplığı indirilebilir bir NuGet paketi olarak kullanılabilir.

Kitaplıkları içeri aktarma

program.cs açın ve dosyanın en üstüne aşağıdaki using deyimleri ekleyin:

using System;
using Microsoft.Azure.Management.Fluent;
using Microsoft.Azure.Management.ResourceManager.Fluent;
using Microsoft.Azure.Management.ResourceManager.Fluent.Authentication;
using Microsoft.Azure.Management.CognitiveServices;
using Microsoft.Azure.Management.CognitiveServices.Models;

İstemcinin kimliğini doğrulama

Oluşturduğunuz hizmet sorumlusunu ve Azure hesap bilgilerinizi kullanarak aşağıdaki alanları program.cs köküne ekleyin ve değerlerini doldurun.

const string  service_principal_application_id = "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE";
const string  service_principal_secret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE";

/* The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions. */
const string  subscription_id = "PASTE_YOUR_SUBSCRIPTION_ID_HERE";

/* The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory. */
const string  tenant_id = "PASTE_YOUR_TENANT_ID_HERE";

/* The name of the Azure resource group in which you want to create the resource.
You can find resource groups in the Azure Dashboard under Home > Resource groups. */
const string  resource_group_name = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE";

/* The name of the custom subdomain to use when you create the resource. This is optional.
For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
Note not all Cognitive Services allow custom subdomain names. */
const string subdomain_name = "PASTE_YOUR_SUBDOMAIN_NAME_HERE";

Ardından Main yönteminizde bu değerleri kullanarak bir CognitiveServicesManagementClient nesnesi oluşturun. Bu nesne tüm Azure yönetim işlemleriniz için gereklidir.

var service_principal_credentials = new ServicePrincipalLoginInformation ();
service_principal_credentials.ClientId = service_principal_application_id;
service_principal_credentials.ClientSecret = service_principal_secret;

var credentials = SdkContext.AzureCredentialsFactory.FromServicePrincipal(service_principal_application_id, service_principal_secret, tenant_id, AzureEnvironment.AzureGlobalCloud);
var client = new CognitiveServicesManagementClient(credentials);
client.SubscriptionId = subscription_id;

Çağrı yönetimi yöntemleri

Kullanılabilir kaynakları listelemek, örnek bir kaynak oluşturmak, sahip olunan kaynakları listelemek ve ardından örnek kaynağı silmek için Main yönteminize aşağıdaki kodu ekleyin. Sonraki adımlarda bu yöntemleri tanımlayacaksınız.

    // Uncomment to list all available resource kinds, SKUs, and locations for your Azure account:
    //list_available_kinds_skus_locations(client);

    // Create a resource with kind TextTranslation, F0 (free tier), location global.
    create_resource(client, "test_resource", "TextTranslation", "F0", "Global");

    // List all resources for your Azure account and resource group:
    list_resources(client);

    // Delete the resource.
    delete_resource(client, "test_resource");

    Console.WriteLine("Press any key to exit.");
    Console.ReadKey();

Azure AI hizmetleri kaynağı oluşturma (C#)

Yeni bir Azure AI hizmetleri kaynağı oluşturmak ve abone olmak için Create yöntemini kullanın. Bu yöntem, geçirdiğiniz 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. Aşağıdaki yöntem, bunların tümünü bağımsız değişken olarak alır ve bir kaynak oluşturur.

static void create_resource(CognitiveServicesManagementClient client, string resource_name, string kind, string account_tier, string location)
{
    Console.WriteLine("Creating resource: " + resource_name + "...");
    /* NOTE If you do not want to use a custom subdomain name, remove the customSubDomainName
    property from CognitiveServicesAccountProperties. */
    CognitiveServicesAccount parameters = 
        new CognitiveServicesAccount(null, null, kind, location, resource_name, new CognitiveServicesAccountProperties(customSubDomainName : subdomain_name), new Sku(account_tier));
    var result = client.Accounts.Create(resource_group_name, resource_name, parameters);
    Console.WriteLine("Resource created.");
    Console.WriteLine("ID: " + result.Id);
    Console.WriteLine("Kind: " + result.Kind);
    Console.WriteLine();
}

Hizmet ve fiyatlandırma katmanı seçme

Yeni bir kaynak oluşturduğunuzda, kullanmak istediğiniz "hizmet türünü" ve istediğiniz fiyatlandırma katmanını (veya SKU'yu) bilmeniz gerekir. Kaynağı oluştururken parametre olarak bu ve diğer bilgileri kullanacaksınız. Betiğinizde aşağıdaki yöntemi çağırarak kullanılabilir Azure AI hizmetlerinin "türleri" listesini bulabilirsiniz:

static void list_available_kinds_skus_locations(CognitiveServicesManagementClient client)
{

    Console.WriteLine("Available SKUs:");
    var result = client.ResourceSkus.List();
    Console.WriteLine("Kind\tSKU Name\tSKU Tier\tLocations");
    foreach (var x in result) {
        var locations = "";
        foreach (var region in x.Locations)
        {
            locations += region;
        }
        Console.WriteLine(x.Kind + "\t" + x.Name + "\t" + x.Tier + "\t" + locations);
    };
}

Aşağıdaki tablolarda, Azure AI hizmetleri için ürünler ve fiyatlandırma hakkında bilgi sağlanır.

Çoklu hizmet

Hizmet	Tip
Birden çok hizmet. Daha fazla bilgi için bkz. fiyatlandırma sayfası.	CognitiveServices

Görsel

Hizmet	Tip
Görsel	ComputerVision
Özel Görüntü İşleme - Tahmin	CustomVision.Prediction
Özel Görüntü İşleme - Eğitim	CustomVision.Training
Yüz Tanıma	Face
Belge Yönetim Bilgileri	FormRecognizer

Konuşma

Hizmet	Tip
Konuşma	SpeechServices

Dil

Hizmet	Tip
Language Understanding (LUIS)	LUIS
QnA Maker	QnAMaker
Dil	TextAnalytics
Metin Çevirisi	TextTranslation

Karar

Hizmet	Tip
Anomali Algılayıcısı	AnomalyDetector
Content Moderator	ContentModerator
Kişiselleştirme	Personalizer

Azure OpenAI

Hizmet	Tip
Azure OpenAI	OpenAI

Fiyatlandırma katmanları ve faturalama

Fiyatlandırma katmanları (ve faturalandırılan tutar), kimlik doğrulama bilgilerinizi kullanarak gönderdiğiniz işlem sayısına bağlıdır. Her fiyatlandırma katmanı aşağıdakileri belirtir:

• Saniye başına izin verilen en fazla işlem sayısı (TPS).
• Fiyatlandırma katmanında etkinleştirilen hizmet özellikleri.
• Önceden tanımlanmış işlem sayısı için maliyet. Hizmetinizin fiyatlandırma ayrıntılarında belirtildiği gibi bu sayinin üzerine çıkarılırsa ek ücret tahsil edilir.

Not

Azure AI hizmetlerinin birçoğu, hizmeti denemek için kullanabileceğiniz ücretsiz bir katmana sahiptir. Ücretsiz katmanı kullanmak için kaynağınızın fiyatlandırma katmanı olarak kullanın F0 .

Kaynaklarınızı görüntüleme

Azure hesabınızın altındaki tüm kaynakları (tüm kaynak gruplarında) görüntülemek için aşağıdaki yöntemi kullanın:

static void list_resources(CognitiveServicesManagementClient client)
{
    Console.WriteLine("Resources in resource group: " + resource_group_name);
    var result = client.Accounts.ListByResourceGroup(resource_group_name);
    foreach (var x in result)
    {
        Console.WriteLine("ID: " + x.Id);
        Console.WriteLine("Name: " + x.Name);
        Console.WriteLine("Type: " + x.Type);
        Console.WriteLine("Kind: " + x.Kind);
        Console.WriteLine();
    }
}

Kaynak silme

Aşağıdaki yöntem belirtilen kaynağı belirtilen kaynak grubundan siler.

static void delete_resource(CognitiveServicesManagementClient client, string resource_name)
{
    Console.WriteLine("Deleting resource: " + resource_name + "...");
    client.Accounts.Delete (resource_group_name, resource_name);

    Console.WriteLine("Resource deleted.");
    Console.WriteLine();
}

Uygulamayı çalıştırma

komutunu kullanarak dotnet run uygulamayı uygulama dizininizden çalıştırın.

dotnet run

Başvuru belgeleri | Kitaplık kaynak kodu | Paketi (Maven)

Java önkoşulları

• Geçerli bir Azure aboneliği - Ücretsiz bir abonelik oluşturun.
• Java Development Kit'in (JDK) geçerli sürümü
• Gradle derleme aracı veya başka bir bağımlılık yöneticisi.
• Sorumlu yapay zeka koşullarını kabul edebilmeniz ve kaynak oluşturabilmeniz için Azure hesabınızın atanmış bir Cognitive Services Contributor rolü olmalıdır. Bu rolün hesabınıza atanmasını sağlamak için Rol atama belgelerindeki adımları izleyin veya yöneticinize başvurun.
• Azure Yapay Zeka Görüntü İşleme'de Uzamsal Analizi veya Azure Yapay Zeka Dilinde Sistem Durumu için Metin Analizi kullanmayı planlıyorsanız, hüküm ve koşulları gözden geçirip kabul edebilmeniz için Azure portalından ilk Görüntü İşleme veya Dil kaynaklarınızı oluşturmanız gerekir. Bunu burada yapabilirsiniz: Azure AI Language, Azure AI Vision. Bundan sonra, aynı Azure aboneliği altındaki herhangi bir dağıtım aracını (örneğin SDK, CLI veya ARM şablonu) kullanarak sonraki kaynakları oluşturabilirsiniz.

Azure Hizmet Sorumlusu oluşturma

Uygulamanızın Azure hesabınızla etkileşim kurmasını sağlamak için izinleri yönetmek için bir Azure hizmet sorumlusuna ihtiyacınız vardır. Azure hizmet sorumlusu oluşturma başlığındaki yönergeleri izleyin.

Hizmet sorumlusu oluşturduğunuzda gizli dizi değeri, kimlik ve uygulama kimliği olduğunu görürsünüz. Uygulama kimliğini ve gizli diziyi sonraki adımlar için geçici bir konuma kaydedin.

Kaynak grubu oluşturma

Azure AI hizmetleri kaynağı oluşturmadan önce, hesabınızın kaynağı içerecek bir Azure kaynak grubuna sahip olması gerekir. Henüz bir kaynak grubunuz yoksa devam etmeden önce Azure portalında bir kaynak grubu oluşturun.

Yeni java uygulaması oluşturma

Konsol penceresinde (cmd, PowerShell veya Bash gibi), uygulamanız için yeni bir dizin oluşturun ve bu dizine gidin.

mkdir myapp && cd myapp

gradle init Komutunu çalışma dizininizden çalıştırın. Bu komut, uygulamanızı oluşturmak ve yapılandırmak için çalışma zamanında kullanılan build.gradle.kts de dahil olmak üzere Gradle için temel derleme dosyaları oluşturur.

gradle init --type basic

DSL seçmeniz istendiğinde Kotlin'i seçin.

Çalışma dizininizden aşağıdaki komutu çalıştırın:

mkdir -p src/main/java

İstemci kitaplığını yükleme

Bu hızlı başlangıçta Gradle bağımlılık yöneticisi kullanılır. Maven Central Repository'de diğer bağımlılık yöneticilerinin istemci kitaplığını ve bilgilerini bulabilirsiniz.

Projenizin build.gradle.kts dosyasında, istemci kitaplığını gerekli eklentiler ve ayarlarla birlikte bir implementation deyim olarak ekleyin.

plugins {
    java
    application
}
application {
    mainClass.set("FormRecognizer")
}
repositories {
    mavenCentral()
}
dependencies {
    implementation(group = "com.microsoft.azure", name = "azure-mgmt-cognitiveservices", version = "1.10.0-beta")
}

Kitaplıkları içeri aktarma

Yeni src/main/java klasörüne gidin ve Management.java adlı bir dosya oluşturun. Tercih ettiğiniz düzenleyicide veya IDE'de açın ve aşağıdaki import deyimleri ekleyin:

import com.azure.core.management.*;
import com.azure.core.management.profile.*;
import com.azure.identity.*;
import com.azure.resourcemanager.cognitiveservices.*;
import com.azure.resourcemanager.cognitiveservices.implementation.*;
import com.azure.resourcemanager.cognitiveservices.models.*;

import java.io.*;
import java.lang.Object.*;
import java.util.*;
import java.net.*;

İstemcinin kimliğini doğrulama

Management.java bir sınıf ekleyin ve ardından aşağıdaki alanları ve değerlerini içine ekleyin. Oluşturduğunuz hizmet sorumlusunu ve diğer Azure hesap bilgilerinizi kullanarak değerlerini doldurun.

/*
Be sure to use the service pricipal application ID, not simply the ID. 
*/

private static String applicationId = "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE";
private static String applicationSecret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE";

/* The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions. */
private static String subscriptionId = "PASTE_YOUR_SUBSCRIPTION_ID_HERE";

/* The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory. */
private static String tenantId = "PASTE_YOUR_TENANT_ID_HERE";

/* The name of the Azure resource group in which you want to create the resource.
You can find resource groups in the Azure Dashboard under Home > Resource groups. */
private static String resourceGroupName = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE";

/* The name of the custom subdomain to use when you create the resource. This is optional.
For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
Note not all Cognitive Services allow custom subdomain names. */
private static String subDomainName = "PASTE_YOUR_SUBDOMAIN_NAME_HERE";

Ardından, ana yönteminizde bu değerleri kullanarak bir CognitiveServicesManager nesnesi oluşturun. Bu nesne tüm Azure yönetim işlemleriniz için gereklidir.

/* For more information see:
https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md
*/

ClientSecretCredential credential = new ClientSecretCredentialBuilder()
    .clientId(applicationId)
    .clientSecret(applicationSecret)
    .tenantId(tenantId)
    .build();
AzureProfile profile = new AzureProfile(tenantId, subscriptionId, AzureEnvironment.AZURE);

CognitiveServicesManager client = CognitiveServicesManager.authenticate(credential, profile);

Çağrı yönetimi yöntemleri

Kullanılabilir kaynakları listelemek, örnek bir kaynak oluşturmak, sahip olunan kaynakları listelemek ve ardından örnek kaynağı silmek için Main yönteminize aşağıdaki kodu ekleyin. Sonraki adımlarda bu yöntemleri tanımlayacaksınız.

String resourceName = "test_resource";
String resourceKind = "TextTranslation";
String resourceSku = "F0";
Region resourceRegion = Region.US_WEST;

// Uncomment to list all available resource kinds, SKUs, and locations for your Azure account.
// list_available_kinds_skus_locations (client);

// Create a resource with kind Text Translation, SKU F0 (free tier), location US West.
String resourceId = create_resource (client, resourceName, resourceGroupName, resourceKind, resourceSku, resourceRegion);

// Uncomment this to list all resources for your Azure account.
// list_resources (client, resourceGroupName);

// Delete the resource.
delete_resource (client, resourceId);

/* NOTE: When you delete a resource, it is only soft-deleted. You must also purge it. Otherwise, if you try to create another
resource with the same name or custom subdomain, you will receive an error stating that such a resource already exists. */
purge_resource (client, resourceName, resourceGroupName, resourceRegion);

Azure AI hizmetleri kaynağı oluşturma (Java)

Yeni bir Azure AI hizmetleri kaynağı oluşturmak ve abone olmak için create yöntemini kullanın. Bu yöntem, geçirdiğiniz 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. Aşağıdaki yöntem, bunların tümünü bağımsız değişken olarak alır ve bir kaynak oluşturur.

public static String create_resource (CognitiveServicesManager client, String resourceName, String resourceGroupName, String resourceKind, String resourceSku, Region resourceRegion) {
    System.out.println ("Creating resource: " + resourceName + "...");

    /* NOTE: If you do not want to use a custom subdomain name, remove the withCustomSubDomainName
    setter from the AccountProperties object. */
    Account result = client.accounts().define(resourceName)
        .withExistingResourceGroup(resourceGroupName)
        // Note: Do not call withRegion() first, as it does not exist on the Blank interface returned by define().
        .withRegion(resourceRegion)
        .withKind(resourceKind)
        .withSku(new Sku().withName(resourceSku))
        .withProperties(new AccountProperties().withCustomSubDomainName(subDomainName))
        .create();

    System.out.println ("Resource created.");
    System.out.println ("ID: " + result.id());
    System.out.println ("Provisioning state: " + result.properties().provisioningState().toString());
    System.out.println ();

    return result.id();
}

Hizmet ve fiyatlandırma katmanı seçme

Yeni bir kaynak oluşturduğunuzda, kullanmak istediğiniz "hizmet türünü" ve istediğiniz fiyatlandırma katmanını (veya SKU'yu) bilmeniz gerekir. Kaynağı oluştururken parametre olarak bu ve diğer bilgileri kullanacaksınız. Aşağıdaki yöntemi çağırarak kullanılabilir Azure AI hizmetlerinin "türleri" listesini bulabilirsiniz:

public static void list_available_kinds_skus_locations (CognitiveServicesManager client) {
    System.out.println ("Available SKUs:");
    System.out.println("Kind\tSKU Name\tSKU Tier\tLocations");
    ResourceSkus skus = client.resourceSkus();
    for (ResourceSku sku : skus.list()) {
        String locations = String.join (",", sku.locations());
        System.out.println (sku.kind() + "\t" + sku.name() + "\t" + sku.tier() + "\t" + locations);
    }
}

Aşağıdaki tablolarda, Azure AI hizmetleri için ürünler ve fiyatlandırma hakkında bilgi sağlanır.

Çoklu hizmet

Hizmet	Tip
Birden çok hizmet. Daha fazla bilgi için bkz. fiyatlandırma sayfası.	CognitiveServices

Görsel

Hizmet	Tip
Görsel	ComputerVision
Özel Görüntü İşleme - Tahmin	CustomVision.Prediction
Özel Görüntü İşleme - Eğitim	CustomVision.Training
Yüz Tanıma	Face
Belge Yönetim Bilgileri	FormRecognizer

Konuşma

Hizmet	Tip
Konuşma	SpeechServices

Dil

Hizmet	Tip
Language Understanding (LUIS)	LUIS
QnA Maker	QnAMaker
Dil	TextAnalytics
Metin Çevirisi	TextTranslation

Karar

Hizmet	Tip
Anomali Algılayıcısı	AnomalyDetector
Content Moderator	ContentModerator
Kişiselleştirme	Personalizer

Azure OpenAI

Hizmet	Tip
Azure OpenAI	OpenAI

Fiyatlandırma katmanları ve faturalama

Fiyatlandırma katmanları (ve faturalandırılan tutar), kimlik doğrulama bilgilerinizi kullanarak gönderdiğiniz işlem sayısına bağlıdır. Her fiyatlandırma katmanı aşağıdakileri belirtir:

• Saniye başına izin verilen en fazla işlem sayısı (TPS).
• Fiyatlandırma katmanında etkinleştirilen hizmet özellikleri.
• Önceden tanımlanmış işlem sayısı için maliyet. Hizmetinizin fiyatlandırma ayrıntılarında belirtildiği gibi bu sayinin üzerine çıkarılırsa ek ücret tahsil edilir.

Not

Azure AI hizmetlerinin birçoğu, hizmeti denemek için kullanabileceğiniz ücretsiz bir katmana sahiptir. Ücretsiz katmanı kullanmak için kaynağınızın fiyatlandırma katmanı olarak kullanın F0 .

Kaynaklarınızı görüntüleme

Azure hesabınızın altındaki tüm kaynakları (tüm kaynak gruplarında) görüntülemek için aşağıdaki yöntemi kullanın:

public static void list_resources (CognitiveServicesManager client, String resourceGroupName) {
    System.out.println ("Resources in resource group: " + resourceGroupName);
    // Note Azure resources are also sometimes referred to as accounts.
    Accounts accounts = client.accounts();
    for (Account account : accounts.listByResourceGroup(resourceGroupName)) {
        System.out.println ("ID: " + account.id());
        System.out.println ("Kind: " + account.kind ());
        System.out.println ("SKU Name: " + account.sku().name());
        System.out.println ("Custom subdomain name: " + account.properties().customSubDomainName());
        System.out.println ();
    }
}

Kaynak silme

Aşağıdaki yöntem belirtilen kaynağı belirtilen kaynak grubundan siler.

public static void delete_resource (CognitiveServicesManager client, String resourceId) {
    System.out.println ("Deleting resource: " + resourceId + "...");
    client.accounts().deleteById (resourceId);
    System.out.println ("Resource deleted.");
    System.out.println ();
}

Başvuru belgeleri | Kitaplık kaynak kodu | Paketi (npm)Örnekler |

JavaScript önkoşulları

• Geçerli bir Azure aboneliği - Ücretsiz bir abonelik oluşturun.
• Node.js'in geçerli sürümü
• Sorumlu yapay zeka koşullarını kabul edebilmeniz ve kaynak oluşturabilmeniz için Azure hesabınızın atanmış bir Cognitive Services Contributor rolü olmalıdır. Bu rolün hesabınıza atanmasını sağlamak için Rol atama belgelerindeki adımları izleyin veya yöneticinize başvurun.
• Azure Yapay Zeka Görüntü İşleme'de Uzamsal Analizi veya Azure Yapay Zeka Dilinde Sistem Durumu için Metin Analizi kullanmayı planlıyorsanız, hüküm ve koşulları gözden geçirip kabul edebilmeniz için Azure portalından ilk Görüntü İşleme veya Dil kaynaklarınızı oluşturmanız gerekir. Bunu burada yapabilirsiniz: Azure AI Language, Azure AI Vision. Bundan sonra, aynı Azure aboneliği altındaki herhangi bir dağıtım aracını (örneğin SDK, CLI veya ARM şablonu) kullanarak sonraki kaynakları oluşturabilirsiniz.

Azure Hizmet Sorumlusu oluşturma

Uygulamanızın Azure hesabınızla etkileşim kurmasını sağlamak için izinleri yönetmek için bir Azure hizmet sorumlusuna ihtiyacınız vardır. Azure hizmet sorumlusu oluşturma başlığındaki yönergeleri izleyin.

Hizmet sorumlusu oluşturduğunuzda gizli dizi değeri, kimlik ve uygulama kimliği olduğunu görürsünüz. Uygulama kimliğini ve gizli diziyi sonraki adımlar için geçici bir konuma kaydedin.

Kaynak grubu oluşturma

Azure AI hizmetleri kaynağı oluşturmadan önce, hesabınızın kaynağı içerecek bir Azure kaynak grubuna sahip olması gerekir. Henüz bir kaynak grubunuz yoksa devam etmeden önce Azure portalında bir kaynak grubu oluşturun.

Yeni bir Node.js uygulaması oluşturma

Konsol penceresinde (cmd, PowerShell veya Bash gibi), uygulamanız için yeni bir dizin oluşturun ve bu dizine gidin.

mkdir myapp && cd myapp

Bir package.json dosyası ile bir düğüm uygulaması oluşturmak için init komutunu çalıştırın.

 init

Devam etmeden önce index.js adlı bir dosya oluşturun.

İstemci kitaplığını yükleme

Aşağıdaki npm paketlerini yükleyin:

npm install @azure/arm-cognitiveservices
npm install @azure/identity

Uygulamanızın package.json dosyası bağımlılıklarla güncelleştirilecek.

Kitaplıkları içeri aktarma

index.js betiğinizi açın ve aşağıdaki kitaplıkları içeri aktarın.

"use strict";

/* To run this sample, install the following modules.
 * npm install @azure/arm-cognitiveservices @azure/identity
 */
var Arm = require("@azure/arm-cognitiveservices");
var Identity = require("@azure/identity");

İstemcinin kimliğini doğrulama

Aşağıdaki alanları betiğinizin köküne ekleyin ve oluşturduğunuz hizmet sorumlusunu ve Azure hesap bilgilerinizi kullanarak değerlerini doldurun.

const service_principal_application_id =
  "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE";
const service_principal_secret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE";

/* The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions. */
const subscription_id = "PASTE_YOUR_SUBSCRIPTION_ID_HERE";

/* The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory. */
const tenant_id = "PASTE_YOUR_TENANT_ID_HERE";

/* The name of the Azure resource group in which you want to create the resource.
You can find resource groups in the Azure Dashboard under Home > Resource groups. */
const resource_group_name = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE";

/* The name of the custom subdomain to use when you create the resource. This is optional.
For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
Note not all Cognitive Services allow custom subdomain names.
*/
const subdomain_name = "PASTE_YOUR_SUBDOMAIN_NAME_HERE";

Ardından, programınızın ana çalışmasını işlemek için aşağıdaki quickstart işlevi ekleyin. İlk kod bloğu, yukarıda girdiğiniz kimlik bilgisi değişkenlerini kullanarak bir CognitiveServicesManagementClient nesnesi oluşturur. Bu nesne tüm Azure yönetim işlemleriniz için gereklidir.

async function quickstart() {
  /* For more information see:
https://www.npmjs.com/package/@azure/arm-cognitiveservices/v/6.0.0
https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/identity/identity/samples/AzureIdentityExamples.md#authenticating-a-service-principal-with-a-client-secret
*/
  const credentials = new Identity.ClientSecretCredential(
    tenant_id,
    service_principal_application_id,
    service_principal_secret
  );
  const client = new Arm.CognitiveServicesManagementClient(
    credentials,
    subscription_id
  );
  // Note Azure resources are also sometimes referred to as accounts.
  const accounts_client = client.accounts;
  const resource_skus_client = client.resourceSkus;
  const deleted_accounts_client = client.deletedAccounts;

Çağrı yönetimi işlevleri

Kullanılabilir kaynakları listelemek, örnek bir kaynak oluşturmak, sahip olunan kaynakları listelemek ve ardından örnek kaynağı silmek için işlevinizin quickstart sonuna aşağıdaki kodu ekleyin. Bu işlevleri sonraki adımlarda tanımlayacaksınız.

Azure AI hizmetleri kaynağı oluşturma (Node.js)

Yeni bir Azure AI hizmetleri kaynağı oluşturmak ve abone olmak için Oluştur işlevini kullanın. Bu işlev, geçirdiğiniz 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. Aşağıdaki işlev bu bağımsız değişkenlerin tümünü alır ve bir kaynak oluşturur.

async function create_resource(
  client,
  resource_name,
  resource_kind,
  resource_sku,
  resource_region
) {
  console.log("Creating resource: " + resource_name + "...");
  /* NOTE If you do not want to use a custom subdomain name, remove the customSubDomainName
property from the properties object. */
  var parameters = {
    sku: { name: resource_sku },
    kind: resource_kind,
    location: resource_region,
    properties: { customSubDomainName: subdomain_name },
  };
  return client
    .beginCreateAndWait(resource_group_name, resource_name, parameters)
    .then((result) => {
      console.log("Resource created.");
      console.log();
      console.log("ID: " + result.id);
      console.log("Kind: " + result.kind);
      console.log();
    })
    .catch((err) => {
      console.log(err);
    });
}

Hizmet ve fiyatlandırma katmanı seçme

Yeni bir kaynak oluşturduğunuzda, kullanmak istediğiniz "hizmet türünü" ve istediğiniz fiyatlandırma katmanını (veya SKU'yu) bilmeniz gerekir. Kaynağı oluştururken parametre olarak bu ve diğer bilgileri kullanacaksınız. Aşağıdaki işlev, kullanılabilir Azure AI hizmetlerini "türleri" listeler.

async function list_available_kinds_skus_locations(client) {
  console.log("Available SKUs:");
  var result = client.list();
  console.log("Kind\tSKU Name\tSKU Tier\tLocations");
  for await (let item of result) {
    var locations = item.locations.join(",");
    console.log(item.kind + "\t" + item.name + "\t" + item.tier + "\t" + locations);
  }
}

Aşağıdaki tablolarda, Azure AI hizmetleri için ürünler ve fiyatlandırma hakkında bilgi sağlanır.

Çoklu hizmet

Hizmet	Tip
Birden çok hizmet. Daha fazla bilgi için bkz. fiyatlandırma sayfası.	CognitiveServices

Görsel

Hizmet	Tip
Görsel	ComputerVision
Özel Görüntü İşleme - Tahmin	CustomVision.Prediction
Özel Görüntü İşleme - Eğitim	CustomVision.Training
Yüz Tanıma	Face
Belge Yönetim Bilgileri	FormRecognizer

Konuşma

Hizmet	Tip
Konuşma	SpeechServices

Dil

Hizmet	Tip
Language Understanding (LUIS)	LUIS
QnA Maker	QnAMaker
Dil	TextAnalytics
Metin Çevirisi	TextTranslation

Karar

Hizmet	Tip
Anomali Algılayıcısı	AnomalyDetector
Content Moderator	ContentModerator
Kişiselleştirme	Personalizer

Azure OpenAI

Hizmet	Tip
Azure OpenAI	OpenAI

Fiyatlandırma katmanları ve faturalama

Fiyatlandırma katmanları (ve faturalandırılan tutar), kimlik doğrulama bilgilerinizi kullanarak gönderdiğiniz işlem sayısına bağlıdır. Her fiyatlandırma katmanı aşağıdakileri belirtir:

• Saniye başına izin verilen en fazla işlem sayısı (TPS).
• Fiyatlandırma katmanında etkinleştirilen hizmet özellikleri.
• Önceden tanımlanmış işlem sayısı için maliyet. Hizmetinizin fiyatlandırma ayrıntılarında belirtildiği gibi bu sayinin üzerine çıkarılırsa ek ücret tahsil edilir.

Not

Azure AI hizmetlerinin birçoğu, hizmeti denemek için kullanabileceğiniz ücretsiz bir katmana sahiptir. Ücretsiz katmanı kullanmak için kaynağınızın fiyatlandırma katmanı olarak kullanın F0 .

Kaynaklarınızı görüntüleme

Azure hesabınızın altındaki tüm kaynakları (tüm kaynak gruplarında) görüntülemek için aşağıdaki işlevi kullanın:

async function list_resources(client) {
  console.log("Resources in resource group: " + resource_group_name);
  var result = client.listByResourceGroup(resource_group_name);
  for await (let item of result) {
    console.log(item);
    console.log();
  }
}

Kaynak silme

Aşağıdaki işlev belirtilen kaynağı belirtilen kaynak grubundan siler.

async function delete_resource(client, resource_name) {
  console.log("Deleting resource: " + resource_name + "...");
  await client.beginDeleteAndWait(resource_group_name, resource_name);
  console.log("Resource deleted.");
  console.log();
}

Uygulamayı çalıştırma

Hata işleme ile ana quickstart işlevinizi çağırmak için betiğinizin altına aşağıdaki kodu ekleyin.

try {
  quickstart();
} catch (error) {
  console.log(error);
}

Ardından konsol pencerenizde komutunu kullanarak node uygulamayı çalıştırın.

node index.js

Başvuru belgeleri | Kitaplık kaynak kodu | Paketi (PyPi)Örnekleri |

Python önkoşulları

• Geçerli bir Azure aboneliği - Ücretsiz bir abonelik oluşturun.
• Python 3.x
• Sorumlu yapay zeka koşullarını kabul edebilmeniz ve kaynak oluşturabilmeniz için Azure hesabınızın atanmış bir Cognitive Services Contributor rolü olmalıdır. Bu rolün hesabınıza atanmasını sağlamak için Rol atama belgelerindeki adımları izleyin veya yöneticinize başvurun.
• Azure Yapay Zeka Görüntü İşleme'de Uzamsal Analizi veya Azure Yapay Zeka Dilinde Sistem Durumu için Metin Analizi kullanmayı planlıyorsanız, hüküm ve koşulları gözden geçirip kabul edebilmeniz için Azure portalından ilk Görüntü İşleme veya Dil kaynaklarınızı oluşturmanız gerekir. Bunu burada yapabilirsiniz: Azure AI Language, Azure AI Vision. Bundan sonra, aynı Azure aboneliği altındaki herhangi bir dağıtım aracını (örneğin SDK, CLI veya ARM şablonu) kullanarak sonraki kaynakları oluşturabilirsiniz.

Azure Hizmet Sorumlusu oluşturma

Uygulamanızın Azure hesabınızla etkileşim kurmasını sağlamak için izinleri yönetmek için bir Azure hizmet sorumlusuna ihtiyacınız vardır. Azure hizmet sorumlusu oluşturma başlığındaki yönergeleri izleyin.

Hizmet sorumlusu oluşturduğunuzda gizli dizi değeri, kimlik ve uygulama kimliği olduğunu görürsünüz. Uygulama kimliğini ve gizli diziyi sonraki adımlar için geçici bir konuma kaydedin.

Kaynak grubu oluşturma

Azure AI hizmetleri kaynağı oluşturmadan önce, hesabınızın kaynağı içerecek bir Azure kaynak grubuna sahip olması gerekir. Henüz bir kaynak grubunuz yoksa devam etmeden önce Azure portalında bir kaynak grubu oluşturun.

Yeni Python uygulaması oluşturma

Tercih ettiğiniz düzenleyicide veya IDE'de yeni bir Python uygulaması oluşturun ve konsol penceresinde projenize gidin.

İstemci kitaplığını yükleme

İstemci kitaplığını şu şekilde yükleyebilirsiniz:

pip install azure-mgmt-cognitiveservices

Ayrıca Microsoft Entra belirteci kimlik doğrulaması desteği için Azure Identity kitaplığını da yükleyin.

pip install azure-identity

Kitaplıkları içeri aktarma

Python betiğinizi açın ve aşağıdaki kitaplıkları içeri aktarın.

import time
from azure.identity import ClientSecretCredential
from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
from azure.mgmt.cognitiveservices.models import Account, Sku

İstemcinin kimliğini doğrulama

Aşağıdaki alanları betiğinizin köküne ekleyin ve oluşturduğunuz hizmet sorumlusunu ve Azure hesap bilgilerinizi kullanarak değerlerini doldurun.

# Be sure to use the service pricipal application ID, not simply the ID. 
service_principal_application_id = "PASTE_YOUR_SERVICE_PRINCIPAL_APPLICATION_ID_HERE"
service_principal_secret = "PASTE_YOUR_SERVICE_PRINCIPAL_SECRET_HERE"

# The ID of your Azure subscription. You can find this in the Azure Dashboard under Home > Subscriptions.
subscription_id = "PASTE_YOUR_SUBSCRIPTION_ID_HERE"

# The Active Directory tenant ID. You can find this in the Azure Dashboard under Home > Azure Active Directory.
tenant_id = "PASTE_YOUR_TENANT_ID_HERE"

# The name of the Azure resource group in which you want to create the resource.
# You can find resource groups in the Azure Dashboard under Home > Resource groups.
resource_group_name = "PASTE_YOUR_RESOURCE_GROUP_NAME_HERE"

# The name of the custom subdomain to use when you create the resource. This is optional.
# For example, if you create a Bing Search v7 resource with the custom subdomain name 'my-search-resource',
# your resource would have the endpoint https://my-search-resource.cognitiveservices.azure.com/.
# Note not all Cognitive Services allow custom subdomain names.
subdomain_name = "PASTE_YOUR_SUBDOMAIN_NAME_HERE"

# How many seconds to wait between checking the status of an async operation.
wait_time = 10

Ardından bir CognitiveServicesManagementClient nesnesi oluşturmak için aşağıdaki kodu ekleyin. Bu nesne tüm Azure yönetim işlemleriniz için gereklidir.

credential = ClientSecretCredential(tenant_id, service_principal_application_id, service_principal_secret)
client = CognitiveServicesManagementClient(credential, subscription_id)

Azure AI hizmetleri kaynağı oluşturma (Python)

Yeni bir Azure AI hizmetleri kaynağı oluşturmak ve abone olmak için Oluştur işlevini kullanın. Bu işlev, geçirdiğiniz 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. Aşağıdaki işlev bu bağımsız değişkenlerin tümünü alır ve bir kaynak oluşturur.

def create_resource (resource_name, kind, sku_name, location) :
    print("Creating resource: " + resource_name + "...")

# NOTE If you do not want to use a custom subdomain name, remove the customSubDomainName
# property from the properties object.
    parameters = Account(sku=Sku(name=sku_name), kind=kind, location=location, properties={ 'custom_sub_domain_name' : subdomain_name })

    poller = client.accounts.begin_create(resource_group_name, resource_name, parameters)
    while (False == poller.done ()) :
        print ("Waiting {wait_time} seconds for operation to finish.".format (wait_time = wait_time))
        time.sleep (wait_time)
# This will raise an exception if the server responded with an error.
    result = poller.result ()

    print("Resource created.")
    print()
    print("ID: " + result.id)
    print("Name: " + result.name)
    print("Type: " + result.type)
    print()

Hizmet ve fiyatlandırma katmanı seçme

Yeni bir kaynak oluşturduğunuzda, kullanmak istediğiniz "hizmet türünü" ve istediğiniz fiyatlandırma katmanını (veya SKU'yu) bilmeniz gerekir. Kaynağı oluştururken parametre olarak bu ve diğer bilgileri kullanacaksınız. Aşağıdaki işlev, kullanılabilir Azure AI hizmetlerini "türleri" listeler.

def list_available_kinds_skus_locations():
    print("Available SKUs:")
    result = client.resource_skus.list()
    print("Kind\tSKU Name\tSKU Tier\tLocations")
    for x in result:
        locations = ",".join(x.locations)
        print(x.kind + "\t" + x.name + "\t" + x.tier + "\t" + locations)

Aşağıdaki tablolarda, Azure AI hizmetleri için ürünler ve fiyatlandırma hakkında bilgi sağlanır.

Çoklu hizmet

Hizmet	Tip
Birden çok hizmet. Daha fazla bilgi için bkz. fiyatlandırma sayfası.	CognitiveServices

Görsel

Hizmet	Tip
Görsel	ComputerVision
Özel Görüntü İşleme - Tahmin	CustomVision.Prediction
Özel Görüntü İşleme - Eğitim	CustomVision.Training
Yüz Tanıma	Face
Belge Yönetim Bilgileri	FormRecognizer

Konuşma

Hizmet	Tip
Konuşma	SpeechServices

Dil

Hizmet	Tip
Language Understanding (LUIS)	LUIS
QnA Maker	QnAMaker
Dil	TextAnalytics
Metin Çevirisi	TextTranslation

Karar

Hizmet	Tip
Anomali Algılayıcısı	AnomalyDetector
Content Moderator	ContentModerator
Kişiselleştirme	Personalizer

Azure OpenAI

Hizmet	Tip
Azure OpenAI	OpenAI

Fiyatlandırma katmanları ve faturalama

Fiyatlandırma katmanları (ve faturalandırılan tutar), kimlik doğrulama bilgilerinizi kullanarak gönderdiğiniz işlem sayısına bağlıdır. Her fiyatlandırma katmanı aşağıdakileri belirtir:

• Saniye başına izin verilen en fazla işlem sayısı (TPS).
• Fiyatlandırma katmanında etkinleştirilen hizmet özellikleri.
• Önceden tanımlanmış işlem sayısı için maliyet. Hizmetinizin fiyatlandırma ayrıntılarında belirtildiği gibi bu sayinin üzerine çıkarılırsa ek ücret tahsil edilir.

Not

Azure AI hizmetlerinin birçoğu, hizmeti denemek için kullanabileceğiniz ücretsiz bir katmana sahiptir. Ücretsiz katmanı kullanmak için kaynağınızın fiyatlandırma katmanı olarak kullanın F0 .

Kaynaklarınızı görüntüleme

Azure hesabınızın altındaki tüm kaynakları (tüm kaynak gruplarında) görüntülemek için aşağıdaki işlevi kullanın:

def list_resources():
    print("Resources in resource group: " + resource_group_name)
    result = client.accounts.list_by_resource_group(resource_group_name)
    for x in result:
        print(x.name)
        print(x)
        print()

Kaynak silme

Aşağıdaki işlev belirtilen kaynağı belirtilen kaynak grubundan siler.

def delete_resource(resource_name) :
    print("Deleting resource: " + resource_name + "...")

    poller = client.accounts.begin_delete(resource_group_name, resource_name)
    while (False == poller.done ()) :
        print ("Waiting {wait_time} seconds for operation to finish.".format (wait_time = wait_time))
        time.sleep (wait_time)
# This will raise an exception if the server responded with an error.
    result = poller.result ()

    print("Resource deleted.")

Çağrı yönetimi işlevleri

Yukarıdaki işlevleri çağırmak için betiğinizin altına aşağıdaki kodu ekleyin. Bu kod kullanılabilir kaynakları listeler, örnek bir kaynak oluşturur, sahip olunan kaynaklarınızı listeler ve ardından örnek kaynağı siler.

resource_name = "test_resource"
resource_kind = "TextTranslation"
resource_sku = "F0"
resource_location = "Global"

# Uncomment this to list all available resource kinds, SKUs, and locations for your Azure account.
#list_available_kinds_skus_locations ()

# Create a resource with kind Text Translation, SKU F0 (free tier), location global.
create_resource(resource_name, resource_kind, resource_sku, resource_location)

# Uncomment this to list all resources for your Azure account.
#list_resources()

# Delete the resource.
delete_resource(resource_name)

# NOTE: Deleting a resource only soft-deletes it. To delete it permanently, you must purge it.
# Otherwise, if you later try to create a resource with the same name, you will receive the following error:
# azure.core.exceptions.ResourceExistsError: (FlagMustBeSetForRestore) An existing resource with ID '<your resource ID>' has been soft-deleted. To restore the resource, you must specify 'restore' to be 'true' in the property. If you don't want to restore existing resource, please purge it first.
# Code: FlagMustBeSetForRestore

# Purge the resource.
purge_resource(resource_name, resource_location)

Uygulamayı çalıştırma

komutunu kullanarak uygulamanızı komut satırından python çalıştırın.

python <your-script-name>.py

Sonraki adımlar

• Artık bir kaynağınız olduğuna göre DESTEKLENEN Azure AI hizmetlerinden birinde API isteklerinizin kimliğini doğrulayabilirsiniz.