Anahtar İfade Ayıklama kapsayıcılarını yükleme ve çalıştırma

Kapsayıcılar, Anahtar İfade Ayıklama API'sini kendi altyapınızda barındırmanıza olanak tanır. Anahtar İfade Ayıklama uzaktan çağrılarak karşılanamaz güvenlik veya veri idaresi gereksinimleriniz varsa kapsayıcılar iyi bir seçenek olabilir.

Not

Kapsayıcılar, Anahtar İfade Ayıklama API'lerini kendi ortamınızda çalıştırmanıza olanak tanır ve özel güvenlik ve veri idaresi gereksinimleriniz için mükemmeldir. Anahtar İfade Ayıklama kapsayıcıları ham metin üzerinde gelişmiş doğal dil işleme sağlar ve üç ana işlev içerir: yaklaşım analizi, Anahtar İfade Ayıklama ve dil algılama.

Önkoşullar

  • Azure aboneliğiniz yoksa ücretsiz bir hesap oluşturun.
  • Docker bir konak bilgisayara yüklendi. Docker, kapsayıcıların Azure'a bağlanmasına ve faturalama verileri göndermesine izin verecek şekilde yapılandırılmalıdır.
    • Windows'da Docker,Linux kapsayıcılarını destekleyecek şekilde de yapılandırılmalıdır.
    • Docker kavramları hakkında temel bilgilere sahip olmanız gerekir.
  • Ücretsiz (F0) veya standart (S) fiyatlandırma katmanıyla.

Gerekli parametreleri toplama

Tüm Azure AI kapsayıcıları için üç birincil parametre gereklidir. Microsoft Yazılımı Lisans Koşulları kabul değeriyle birlikte mevcut olmalıdır. Bir Uç Nokta URI'si ve API anahtarı da gereklidir.

Uç nokta URI'si

Bu {ENDPOINT_URI} değere karşılık gelen Azure AI hizmetleri kaynağının Azure portal Genel Bakış sayfasından ulaşabilirsiniz. Genel Bakış sayfasına gidin, uç noktanın üzerine gelin ve Panoya kopyala simgesi görüntülenir. Gerektiğinde uç noktayı kopyalayın ve kullanın.

Uç nokta URI'sini daha sonra kullanmak üzere toplamayı gösteren ekran görüntüsü.

Anahtarlar

{API_KEY} Değer kapsayıcıyı başlatmak için kullanılır ve ilgili Azure AI hizmetleri kaynağının Azure portal Anahtarlar sayfasında kullanılabilir. Anahtarlar sayfasına gidin ve Panoya kopyala simgesini seçin.

Daha sonra kullanmak üzere iki anahtardan birini almayı gösteren ekran görüntüsü.

Önemli

Bu abonelik anahtarları Azure AI hizmetleri API'nize erişmek için kullanılır. Anahtarlarınızı paylaşmayın. Bunları güvenli bir şekilde depolayın. Örneğin Azure Key Vault kullanın. Ayrıca bu anahtarları düzenli olarak yeniden oluşturmanızı öneririz. API çağrısı yapmak için yalnızca bir anahtar gereklidir. İlk anahtarı yeniden oluştururken, hizmete sürekli erişim için ikinci anahtarı kullanabilirsiniz.

Konak bilgisayar gereksinimleri ve önerileri

Konak, Docker kapsayıcısını çalıştıran x64 tabanlı bir bilgisayardır. Şirket içi bir bilgisayar veya Azure'da Docker barındırma hizmeti olabilir, örneğin:

Aşağıdaki tabloda, kullanılabilir Anahtar İfade Ayıklama kapsayıcıları için en düşük ve önerilen belirtimler açıklanmaktadır. Her CPU çekirdeği en az 2,6 gigahertz (GHz) veya daha hızlı olmalıdır. Saniye Başına İzin Verilebilen İşlemler (TPS) de listelenir.

En düşük konak belirtimleri Önerilen konak özellikleri En Düşük TPS En fazla TPS
Anahtar İfade Ayıklama 1 çekirdek, 2 GB bellek 1 çekirdek, 4 GB bellek 15 30

CPU çekirdeği ve bellek, komutun --cpus bir parçası olarak kullanılan ve --memory ayarlarına docker run karşılık gelir.

ile kapsayıcı görüntüsünü alma docker pull

Anahtar ifade ayıklama kapsayıcı görüntüsü, kapsayıcı kayıt defteri dağıtımında mcr.microsoft.com bulunabilir. Depoda azure-cognitive-services/textanalytics/ bulunur ve olarak adlandırılır keyphrase. Tam kapsayıcı görüntüsü adı, şeklindedir mcr.microsoft.com/azure-cognitive-services/textanalytics/keyphrase.

Kapsayıcının en son sürümünü kullanmak için etiketini kullanabilirsiniz latest . McR'de etiketlerin tam listesini de bulabilirsiniz.

docker pull Microsoft Container Registry'den kapsayıcı görüntüsü indirmek için komutunu kullanın.

docker pull mcr.microsoft.com/azure-cognitive-services/textanalytics/keyphrase:latest

İpucu

İndirilen kapsayıcı görüntülerinizi listelemek için docker images komutunu kullanabilirsiniz. Örneğin, aşağıdaki komut indirilen her kapsayıcı görüntüsünün kimliğini, deposunu ve etiketini tablo olarak biçimlendirilmiş olarak listeler:

docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"

IMAGE ID         REPOSITORY                TAG
<image-id>       <repository-path/name>    <tag-name>

Kapsayıcıyı ile çalıştırma docker run

Kapsayıcı konak bilgisayara yüklendikten sonra kapsayıcıları çalıştırmak için docker run komutunu kullanın. Kapsayıcı, siz durdurana kadar çalışmaya devam eder.

Önemli

  • Aşağıdaki bölümlerdeki docker komutları, \satır devamı karakteri olarak ters eğik çizgi kullanır. Konak işletim sisteminizin gereksinimlerine göre bunu değiştirin veya kaldırın.
  • Kapsayıcıyı Eulaçalıştırmak için , Billingve ApiKey seçenekleri belirtilmelidir; aksi takdirde kapsayıcı başlatılmaz. Daha fazla bilgi için bkz . Faturalama.
  • Yaklaşım analizi ve dil algılama kapsayıcıları API'nin v3 sürümünü kullanır ve genel kullanıma sunulmuştur. Anahtar İfade Ayıklama kapsayıcısı API'nin v2'sini kullanır ve önizleme aşamasındadır.

Anahtar İfade Ayıklama kapsayıcısını çalıştırmak için aşağıdaki docker run komutu yürütür. Aşağıdaki yer tutucuları kendi değerlerinizle değiştirin:

Yer tutucu Değer Biçim veya örnek
{API_KEY} Anahtar İfade Ayıklama kaynağınızın anahtarı. Bunu kaynağınızın Anahtar ve uç nokta sayfasında, Azure portal bulabilirsiniz. xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
{ENDPOINT_URI} Anahtar İfade Ayıklama API'sine erişmek için uç nokta. Bunu kaynağınızın Anahtar ve uç nokta sayfasında, Azure portal bulabilirsiniz. https://<your-custom-subdomain>.cognitiveservices.azure.com
docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 \
mcr.microsoft.com/azure-cognitive-services/textanalytics/keyphrase \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

Şu komut:

  • Kapsayıcı görüntüsünden Anahtar İfade Ayıklama kapsayıcısı çalıştırır
  • Bir CPU çekirdeği ve 4 gigabayt (GB) bellek ayırır
  • TCP bağlantı noktası 5000'i kullanıma sunar ve kapsayıcı için sahte bir TTY ayırır
  • Kapsayıcı çıktıktan sonra otomatik olarak kaldırılır. Kapsayıcı görüntüsü ana bilgisayarda hala kullanılabilir.

Aynı konakta birden çok kapsayıcı çalıştırma

Kullanıma sunulan bağlantı noktalarıyla birden çok kapsayıcı çalıştırmak istiyorsanız, her kapsayıcıyı farklı bir kullanıma sunulan bağlantı noktasıyla çalıştırdığınızdan emin olun. Örneğin, ilk kapsayıcıyı 5000 numaralı bağlantı noktasında, ikinci kapsayıcıyı da 5001 numaralı bağlantı noktasında çalıştırın.

Bu kapsayıcıyı ve HOST üzerinde çalışan farklı bir Azure AI hizmetleri kapsayıcısını birlikte kullanabilirsiniz. Ayrıca, aynı Azure AI hizmetleri kapsayıcısının birden çok kapsayıcısını çalıştırabilirsiniz.

Kapsayıcının tahmin uç noktasını sorgulama

Kapsayıcı REST tabanlı sorgu tahmin uç noktası API’lerini sağlar.

Kapsayıcı API’leri için http://localhost:5000 konağını kullanın.

Kapsayıcının çalıştığını doğrulama

Kapsayıcının çalıştığını doğrulamanın çeşitli yolları vardır. Söz konusu kapsayıcının Dış IP adresini ve kullanıma sunulan bağlantı noktasını bulun ve sık kullandığınız web tarayıcısını açın. Kapsayıcının çalıştığını doğrulamak için aşağıdaki çeşitli istek URL'lerini kullanın. Burada listelenen örnek istek URL'leri şunlardır http://localhost:5000: ancak kapsayıcınız farklılık gösterebilir. Kapsayıcınızın Dış IP adresine ve kullanıma sunulan bağlantı noktasına bağlı olduğundan emin olun.

İstek URL’si Amaç
http://localhost:5000/ Kapsayıcı bir giriş sayfası sağlar.
http://localhost:5000/ready GET ile istenen bu URL, kapsayıcının modele yönelik bir sorguyu kabul etmeye hazır olduğuna ilişkin bir doğrulama sağlar. Bu istek Kubernetes canlılığı ve hazırlık yoklamaları için kullanılabilir.
http://localhost:5000/status Get ile de istenen bu URL, kapsayıcıyı başlatmak için kullanılan api anahtarının bir uç nokta sorgusuna neden olmadan geçerli olup olmadığını doğrular. Bu istek Kubernetes canlılığı ve hazırlık yoklamaları için kullanılabilir.
http://localhost:5000/swagger Kapsayıcı uç noktalar için tüm belgeleri ve bir de Deneyin özelliği sağlar. Bu özellik sayesinde, ayarlarınızı web tabanlı bir HTML formuna girebilir ve herhangi bir kod yazmak zorunda kalmadan sorguyu yapabilirsiniz. Sorgu döndükten sonra, gerekli HTTP üst bilgilerini ve gövde biçimini göstermek için örnek bir CURL komutu sağlanır.

Kapsayıcının giriş sayfası

İnternet bağlantısı kesilmiş kapsayıcıyı çalıştırma

İnternet bağlantısı kesilmiş bu kapsayıcıyı kullanmak için, önce bir uygulamayı doldurarak ve bir taahhüt planı satın alarak erişim istemeniz gerekir. Daha fazla bilgi için bkz. Bağlantısız ortamlarda Docker kapsayıcılarını kullanma .

Kapsayıcıyı İnternet bağlantısı kesilmiş olarak çalıştırmanız onaylandıysa, aşağıdaki örnekte kullanacağınız komutun biçimlendirmesi docker run ve yer tutucu değerleri gösterilir. Bu yer tutucu değerleri kendi değerlerinizle değiştirin.

DownloadLicense=True Komutunuzdaki docker run parametresi, Docker kapsayıcınızın İnternet'e bağlı olmadığında çalışmasını sağlayacak bir lisans dosyası indirir. Ayrıca, lisans dosyasının kapsayıcıyı çalıştırmak için geçersiz olacağı bir son kullanma tarihi de içerir. Lisans dosyasını yalnızca onayladığınız uygun kapsayıcıyla kullanabilirsiniz. Örneğin, Belge Yönetim Bilgileri kapsayıcısı ile konuşmayı metne dönüştürme kapsayıcısı için lisans dosyası kullanamazsınız.

Yer tutucu Değer Biçim veya örnek
{IMAGE} Kullanmak istediğiniz kapsayıcı görüntüsü. mcr.microsoft.com/azure-cognitive-services/form-recognizer/invoice
{LICENSE_MOUNT} Lisansın indirileceği ve bağlanacağı yol. /host/license:/path/to/license/directory
{ENDPOINT_URI} Hizmet isteğinizin kimliğini doğrulamak için uç nokta. Bunu kaynağınızın Anahtar ve uç nokta sayfasında, Azure portal bulabilirsiniz. https://<your-custom-subdomain>.cognitiveservices.azure.com
{API_KEY} Metin Analizi kaynağınızın anahtarı. Bunu kaynağınızın Anahtar ve uç nokta sayfasında, Azure portal bulabilirsiniz. xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
{CONTAINER_LICENSE_DIRECTORY} Kapsayıcının yerel dosya sistemindeki lisans klasörünün konumu. /path/to/license/directory
docker run --rm -it -p 5000:5000 \ 
-v {LICENSE_MOUNT} \
{IMAGE} \
eula=accept \
billing={ENDPOINT_URI} \
apikey={API_KEY} \
DownloadLicense=True \
Mounts:License={CONTAINER_LICENSE_DIRECTORY} 

Lisans dosyası indirildikten sonra, kapsayıcıyı bağlantısı kesilmiş bir ortamda çalıştırabilirsiniz. Aşağıdaki örnekte, kullanacağınız komutun docker run yer tutucu değerleriyle birlikte biçimlendirmesi gösterilmektedir. Bu yer tutucu değerleri kendi değerlerinizle değiştirin.

Kapsayıcı nerede çalıştırılırsa çalıştırılsın, lisans dosyası kapsayıcıya bağlanmalıdır ve lisans klasörünün kapsayıcının yerel dosya sistemindeki konumu ile Mounts:License=belirtilmelidir. Faturalama kullanım kayıtlarının yazılabilmesi için çıkış bağlaması da belirtilmelidir.

Yer tutucu Değer Biçim veya örnek
{IMAGE} Kullanmak istediğiniz kapsayıcı görüntüsü. mcr.microsoft.com/azure-cognitive-services/form-recognizer/invoice
{MEMORY_SIZE} Kapsayıcınız için ayrılacak uygun bellek boyutu. 4g
{NUMBER_CPUS} Kapsayıcınız için ayrılacak uygun CPU sayısı. 4
{LICENSE_MOUNT} Lisansın yerleştirileceği ve bağlanacağı yol. /host/license:/path/to/license/directory
{OUTPUT_PATH} Kullanım kayıtlarını günlüğe kaydetmek için çıkış yolu. /host/output:/path/to/output/directory
{CONTAINER_LICENSE_DIRECTORY} Kapsayıcının yerel dosya sistemindeki lisans klasörünün konumu. /path/to/license/directory
{CONTAINER_OUTPUT_DIRECTORY} Kapsayıcının yerel dosya sistemindeki çıkış klasörünün konumu. /path/to/output/directory
docker run --rm -it -p 5000:5000 --memory {MEMORY_SIZE} --cpus {NUMBER_CPUS} \ 
-v {LICENSE_MOUNT} \ 
-v {OUTPUT_PATH} \
{IMAGE} \
eula=accept \
Mounts:License={CONTAINER_LICENSE_DIRECTORY}
Mounts:Output={CONTAINER_OUTPUT_DIRECTORY}

Kapsayıcıyı durdurma

Kapsayıcıyı kapatmak için, kapsayıcının çalıştığı komut satırı ortamında Ctrl+C tuşlarını seçin.

Sorun giderme

Kapsayıcıyı çıkış bağlama ve günlüğe kaydetme etkin olarak çalıştırırsanız kapsayıcı, kapsayıcıyı başlatırken veya çalıştırırken karşılaşılan sorunları gidermeye yardımcı olan günlük dosyaları oluşturur.

İpucu

Daha fazla sorun giderme bilgisi ve rehberlik için bkz. Azure AI kapsayıcıları hakkında sık sorulan sorular (SSS).

Faturalama

Anahtar İfade Ayıklama kapsayıcıları, Azure hesabınızdaki Anahtar İfade Ayıklama kaynağını kullanarak faturalama bilgilerini Azure'a gönderir.

Kapsayıcıya yönelik sorgular, parametresi için kullanılan Azure kaynağının fiyatlandırma katmanında ApiKey faturalandırılır.

Azure AI hizmetleri kapsayıcıları, ölçüm veya faturalama uç noktasına bağlanmadan çalıştırılma lisansına sahip değildir. Kapsayıcıların faturalama bilgilerini faturalama uç noktasıyla her zaman iletmesini etkinleştirmeniz gerekir. Azure AI hizmetleri kapsayıcıları, analiz edilen görüntü veya metin gibi müşteri verilerini Microsoft'a göndermez.

Azure'a Bağlanma

Kapsayıcının çalışması için faturalama bağımsız değişkeni değerleri gerekir. Bu değerler kapsayıcının faturalama uç noktasına bağlanmasına olanak sağlar. Kapsayıcı yaklaşık 10-15 dakikada bir kullanımı bildirir. Kapsayıcı izin verilen zaman penceresinde Azure'a bağlanmazsa, kapsayıcı çalışmaya devam eder ancak faturalama uç noktası geri yüklenene kadar sorgular sunmaz. Bağlantı 10 ile 15 dakika aynı zaman aralığında 10 kez denenir. 10 deneme içinde faturalama uç noktasına bağlanamıyorsa kapsayıcı isteklerin sunulmasını durdurur. Faturalama için Microsoft'a gönderilen bilgilerin bir örneği için bkz. Azure AI hizmetleri kapsayıcısı hakkında SSS .

Faturalama bağımsız değişkenleri

Komut, docker run aşağıdaki seçeneklerin üçü de geçerli değerlerle sağlandığında kapsayıcıyı başlatır:

Seçenek Açıklama
ApiKey Faturalama bilgilerini izlemek için kullanılan Azure AI hizmetleri kaynağının API anahtarı.
Bu seçeneğin değeri, içinde belirtilen sağlanan kaynak için bir API anahtarına Billingayarlanmalıdır.
Billing Faturalama bilgilerini izlemek için kullanılan Azure AI hizmetleri kaynağının uç noktası.
Bu seçeneğin değeri, sağlanan bir Azure kaynağının uç nokta URI'sine ayarlanmalıdır.
Eula Kapsayıcının lisansını kabul ettiğinizi gösterir.
Bu seçeneğin değeri kabul edilecek şekilde ayarlanmalıdır.

\

Özet

Bu makalede Anahtar İfade Ayıklama kapsayıcılarını indirme, yükleme ve çalıştırmaya yönelik kavramları ve iş akışını öğrendiniz. Özet:

  • Anahtar İfade Ayıklama, Docker için Linux kapsayıcıları sağlar.
  • Kapsayıcı görüntüleri Microsoft Container Registry'den (MCR) indirilir.
  • Kapsayıcı görüntüleri Docker'da çalışır.
  • Kapsayıcının konak URI'sini belirterek Anahtar İfade Ayıklama kapsayıcılarındaki işlemleri çağırmak için REST API veya SDK kullanabilirsiniz.
  • Kapsayıcı örneği oluştururken faturalama bilgilerini belirtmeniz gerekir.

Önemli

Azure AI kapsayıcıları, ölçüm için Azure'a bağlanmadan çalıştırılma lisansına sahip değildir. Müşterilerin, kapsayıcıların faturalama bilgilerini ölçüm hizmetiyle her zaman iletmesini sağlaması gerekir. Azure AI kapsayıcıları müşteri verilerini (örneğin analiz edilen metin) Microsoft'a göndermez.

Sonraki adımlar