LUIS için Docker kapsayıcılarını yükleme ve çalıştırma
Önemli
LUIS 1 Ekim 2025'te kullanımdan kaldırılacak ve 1 Nisan 2023'den itibaren yeni LUIS kaynakları oluşturamayacaksınız. Devam eden ürün desteği ve çok dilli özelliklerden yararlanmak için LUIS uygulamalarınızıkonuşma dili anlayışına geçirmenizi öneririz.
Not
Kapsayıcı görüntüsü konumu yakın zamanda değiştirildi. Bu kapsayıcının güncelleştirilmiş konumunu görmek için bu makaleyi okuyun.
Kapsayıcılar LUIS'i kendi ortamınızda kullanmanızı sağlar. Kapsayıcılar, belirli güvenlik ve veri idare gereksinimleri için çok kullanışlıdır. Bu makalede luis kapsayıcısını indirmeyi, yüklemeyi ve çalıştırmayı öğreneceksiniz.
Language Understanding (LUIS) kapsayıcısı eğitilen veya yayımlanan Language Understanding modelinizi yükler. Bir LUIS uygulaması olarak docker kapsayıcısı, kapsayıcının API uç noktalarındaki sorgu tahminlerine erişim sağlar. Uygulamanın tahmin doğruluğunu geliştirmek için kapsayıcıdan sorgu günlüklerini toplayabilir ve Language Understanding uygulamasına geri yükleyebilirsiniz.
Aşağıdaki videoda bu kapsayıcının kullanımı gösterilmektedir.
Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
Önkoşullar
LUIS kapsayıcısını çalıştırmak için aşağıdaki önkoşullara dikkat edin:
-
Docker bir ana 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ına sahip bir LUIS kaynağı.
- İlişkili Uygulama Kimliği ile kapsayıcıya bağlı giriş olarak paketlenmiş, eğitilmiş veya yayımlanmış bir uygulama. Paketlenmiş dosyayı LUIS portalından veya Yazma API'lerinden alabilirsiniz. YAZMA API'lerinden LUIS paketli uygulama alıyorsanız, Yazma Anahtarınıza da ihtiyacınız olacaktır.
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. 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.
Anahtarlar
Bu {API_KEY}
değer kapsayıcıyı başlatmak için kullanılır ve ilgili Azure AI hizmetleri kaynağının Azure portalının Anahtarlar sayfasında kullanılabilir.
Anahtarlar sayfasına gidin ve Panoya kopyala simgesini seçin.
Ö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 gerekir. İlk anahtarı yeniden oluştururken hizmete sürekli erişim için ikinci anahtarı kullanabilirsiniz.
Uygulama Kimliği {APP_ID}
Bu kimlik, uygulamayı seçmek için kullanılır. Uygulamanızın ekranın üst kısmındaki Yönet'e ve ardından Ayarlar'a tıklayarak LUIS portalında uygulama kimliğini bulabilirsiniz.
Yazma anahtarı {AUTHORING_KEY}
Bu anahtar, paketlenmiş uygulamayı buluttaki LUIS hizmetinden almak ve sorgu günlüklerini buluta geri yüklemek için kullanılır. Uygulamanızı makalenin ilerleyen bölümlerinde açıklanan REST API'yi kullanarak dışarı aktarıyorsanız yazma anahtarınıza ihtiyacınız olacaktır.
Uygulamanızın ekranın üst kısmındaki Yönet'e ve ardından Azure Kaynakları'na tıklayarak YAZMA anahtarınızı LUIS portalından alabilirsiniz.
Paket dosyası için YAZMA API'leri
Paketlenmiş uygulamalar için YAZMA API'leri:
Ana bilgisayar
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:
- Azure Kubernetes Service.
- Azure Container Instances.
- Azure Stack'e dağıtılan bir Kubernetes kümesi. Daha fazla bilgi için bkz . Kubernetes'i Azure Stack'e dağıtma.
Kapsayıcı gereksinimleri ve önerileri
Aşağıdaki tabloda kapsayıcı konağı için en düşük ve önerilen değerler listelenmiştir. Gereksinimleriniz trafik hacmine bağlı olarak değişebilir.
Kapsayıcı | En Küçük | Önerilen | TPS (En Az, En Fazla) |
---|---|---|---|
LUIS | 1 çekirdek, 2 GB bellek | 1 çekirdek, 4 GB bellek | 20, 40 |
- Her çekirdek en az 2,6 gigahertz (GHz) veya daha hızlı olmalıdır.
- TPS - saniye başına işlemler
Çekirdek 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
LUIS kapsayıcı görüntüsü kapsayıcı kayıt defteri dağıtımında mcr.microsoft.com
bulunabilir. Depoda azure-cognitive-services/language
bulunur ve olarak adlandırılır luis
. Tam kapsayıcı görüntüsü adı: mcr.microsoft.com/azure-cognitive-services/language/luis
.
Kapsayıcının en son sürümünü kullanmak için etiketini kullanabilirsiniz latest
. McR'de etiketlerin tam listesini de bulabilirsiniz.
Depodan docker pull
mcr.microsoft.com/azure-cognitive-services/language/luis
bir kapsayıcı görüntüsü indirmek için komutunu kullanın:
docker pull mcr.microsoft.com/azure-cognitive-services/language/luis:latest
Önceki komutta kullanılan gibi latest
kullanılabilir etiketlerin tam açıklaması için bkz . Docker Hub'da LUIS .
İpucu
İndirdiğiniz kapsayıcı görüntülerini 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ı kullanma
Kapsayıcı konak bilgisayarda olduğunda, kapsayıcıyla çalışmak için aşağıdaki işlemi kullanın.
- KAPSAYıCı paketini LUIS portalından veya LUIS API'lerinden dışarı aktarın.
- Paket dosyasını konak bilgisayardaki gerekli giriş dizinine taşıyın. LUIS paket dosyasını yeniden adlandırmayın, değiştirmeyin, üzerine yazmayın veya sıkıştırmasını açmayın.
-
Gerekli giriş bağlama ve faturalama ayarlarıyla kapsayıcıyı çalıştırın. Komutun
docker run
diğer örnekleri mevcuttur. - Kapsayıcının tahmin uç noktasını sorgulama.
- Kapsayıcıyla işiniz bittiğinde, LUIS portalındaki çıkış bağlamasından uç nokta günlüklerini içeri aktarın ve kapsayıcıyı durdurun .
- Uygulamayı geliştirmek için UÇ nokta ifadelerini gözden geçirme sayfasında LUIS portalının etkin öğrenmesinikullanın.
Kapsayıcıda çalışan uygulama değiştirilemez. Kapsayıcıdaki uygulamayı değiştirmek için LUIS portalını kullanarak LUIS hizmetinde uygulamayı değiştirmeniz veya LUISyazma API'lerini kullanmanız gerekir. Ardından eğitin ve/veya yayımlayın, ardından yeni bir paket indirin ve kapsayıcıyı yeniden çalıştırın.
Kapsayıcı içindeki LUIS uygulaması LUIS hizmetine geri aktarılamaz. Yalnızca sorgu günlükleri karşıya yüklenebilir.
Paketlenmiş uygulamayı LUIS'ten dışarı aktarma
LUIS kapsayıcısı, kullanıcı konuşmalarının tahmin sorgularını yanıtlamak için eğitilmiş veya yayımlanmış bir LUIS uygulaması gerektirir. LUIS uygulamasını almak için eğitilen veya yayımlanan paket API'sini kullanın.
Varsayılan konum, komutu çalıştırdığınız yere göre alt dizindir input
docker run
.
Paket dosyasını bir dizine yerleştirin ve docker kapsayıcısını çalıştırdığınızda bu dizine giriş bağlaması olarak başvurun.
Paket türleri
Giriş bağlama dizini aynı anda uygulamanın Üretim, Hazırlama ve Sürümlenmiş modellerini içerebilir. Tüm paketler monte edilir.
Paket Türü | Sorgu Uç Noktası API'si | Sorgu kullanılabilirliği | Paket dosya adı biçimi |
---|---|---|---|
Sürüme Dönüştürülen | GET, POST | Yalnızca kapsayıcı | {APP_ID}_v{APP_VERSION}.gz |
Hazırlama | GET, POST | Azure ve kapsayıcı | {APP_ID}_STAGING.gz |
Üretim | GET, POST | Azure ve kapsayıcı | {APP_ID}_PRODUCTION.gz |
Önemli
LUIS paket dosyalarını yeniden adlandırmayın, değiştirmeyin, üzerine yazmayın veya sıkıştırmasını kaldırmayın.
Paketleme önkoşulları
Bir LUIS uygulamasını paketlemeden önce aşağıdakilere sahip olmanız gerekir:
Paketleme Gereksinimleri | Ayrıntılar |
---|---|
Azure AI hizmetleri kaynak örneği | Desteklenen bölgeler şunlardır: Batı ABD ( westus )Batı Avrupa ( westeurope )Doğu Avustralya ( australiaeast ) |
Eğitilmiş veya yayımlanmış LUIS uygulaması | Desteklenmeyen bağımlılıklar olmadan. |
Konak bilgisayarın dosya sistemine erişim | Ana bilgisayar bir giriş bağlamasına izin vermelidir. |
LUIS portalından uygulama paketini dışarı aktarma
LUIS Azure portalı , eğitilen veya yayımlanan uygulamanın paketini dışarı aktarma olanağı sağlar.
Yayımlanan uygulamanın paketini LUIS portalından dışarı aktarma
Yayımlanan uygulamanın paketine Uygulamalarım liste sayfasından ulaşabilirsiniz.
- LUIS Azure portalında oturum açın.
- Listedeki uygulama adının solundaki onay kutusunu seçin.
- Listenin üstündeki bağlam araç çubuğundan Öğeyi dışarı aktar'ı seçin.
- Kapsayıcı (GZIP) için Dışarı Aktar'ı seçin.
- Üretim yuvasının veya Hazırlama yuvasının ortamını seçin.
- Paket tarayıcıdan indirilir.
Sürüme alınan uygulamanın paketini LUIS portalından dışarı aktarma
Sürüme alınan uygulamanın paketi Sürümler listesi sayfasından kullanılabilir.
- LUIS Azure portalında oturum açın.
- Listeden uygulamayı seçin.
- Uygulamanın gezinti çubuğunda Yönet'i seçin.
- Sol gezinti çubuğunda Sürümler'i seçin.
- Listedeki sürüm adının solundaki onay kutusunu seçin.
- Listenin üstündeki bağlam araç çubuğundan Öğeyi dışarı aktar'ı seçin.
- Kapsayıcı (GZIP) için Dışarı Aktar'ı seçin.
- Paket tarayıcıdan indirilir.
Yayımlanan uygulamanın paketini API'den dışarı aktarma
Daha önce yayımlamış olduğunuz bir LUIS uygulamasını paketlemek için aşağıdaki REST API yöntemini kullanın. HTTP belirtiminin altındaki tabloyu kullanarak API çağrısındaki yer tutucular için kendi uygun değerlerinizi yazın.
GET /luis/api/v2.0/package/{APP_ID}/slot/{SLOT_NAME}/gzip HTTP/1.1
Host: {AZURE_REGION}.api.cognitive.microsoft.com
Ocp-Apim-Subscription-Key: {AUTHORING_KEY}
Yer tutucu | Değer |
---|---|
{APP_ID} | Yayımlanan LUIS uygulamasının uygulama kimliği. |
{SLOT_NAME} | Yayımlanan LUIS uygulamasının ortamı. Aşağıdaki değerlerden birini kullanın:PRODUCTION STAGING |
{AUTHORING_KEY} | Yayımlanan LUIS uygulamasının LUIS hesabının yazma anahtarı. Yazma anahtarınızı LUIS portalındaki Kullanıcı Ayarları sayfasından alabilirsiniz. |
{AZURE_REGION} | Uygun Azure bölgesi:westus - Batı ABDwesteurope - Batı Avrupaaustraliaeast - Doğu Avustralya |
Yayımlanan paketi indirmek için buradaki API belgelerine bakın. Başarıyla indirilirse yanıt bir LUIS paket dosyasıdır. Dosyayı kapsayıcının giriş bağlaması için belirtilen depolama konumuna kaydedin.
Sürüme alınan uygulamanın paketini API'den dışarı aktarma
Eğitmiş olduğunuz bir LUIS uygulamasını paketlemek için aşağıdaki REST API yöntemini kullanın. HTTP belirtiminin altındaki tabloyu kullanarak API çağrısındaki yer tutucular için kendi uygun değerlerinizi yazın.
GET /luis/api/v2.0/package/{APP_ID}/versions/{APP_VERSION}/gzip HTTP/1.1
Host: {AZURE_REGION}.api.cognitive.microsoft.com
Ocp-Apim-Subscription-Key: {AUTHORING_KEY}
Yer tutucu | Değer |
---|---|
{APP_ID} | Eğitilen LUIS uygulamasının uygulama kimliği. |
{APP_VERSION} | Eğitilen LUIS uygulamasının uygulama sürümü. |
{AUTHORING_KEY} | Yayımlanan LUIS uygulamasının LUIS hesabının yazma anahtarı. Yazma anahtarınızı LUIS portalındaki Kullanıcı Ayarları sayfasından alabilirsiniz. |
{AZURE_REGION} | Uygun Azure bölgesi:westus - Batı ABDwesteurope - Batı Avrupaaustraliaeast - Doğu Avustralya |
Sürüme alınan paketi indirmek için buradaki API belgelerine bakın. Başarıyla indirilirse yanıt bir LUIS paket dosyasıdır. Dosyayı kapsayıcının giriş bağlaması için belirtilen depolama konumuna kaydedin.
Kapsayıcıyı ile çalıştırma docker run
Kapsayıcıyı çalıştırmak için docker run komutunu kullanın.
ve {API_KEY}
değerlerini alma hakkında ayrıntılı bilgi için gerekli parametreleri toplama bölümüne {ENDPOINT_URI}
bakın.
docker run
Komut örnekleri mevcuttur.
docker run --rm -it -p 5000:5000 ^
--memory 4g ^
--cpus 2 ^
--mount type=bind,src=c:\input,target=/input ^
--mount type=bind,src=c:\output\,target=/output ^
mcr.microsoft.com/azure-cognitive-services/language/luis ^
Eula=accept ^
Billing={ENDPOINT_URI} ^
ApiKey={API_KEY}
- Bu örnek, Windows'ta herhangi bir izin çakışmasını
C:
önlemek için sürücüdeki dizini kullanır. Giriş dizini olarak belirli bir dizini kullanmanız gerekiyorsa docker hizmeti izni vermeniz gerekebilir. - Docker kapsayıcılarını bilmiyorsanız bağımsız değişkenlerin sırasını değiştirmeyin.
- Farklı bir işletim sistemi kullanıyorsanız doğru konsolu/terminali, bağlamalar için klasör söz dizimini ve sisteminiz için satır devamı karakterini kullanın. Bu örneklerde, satır devamlılığı karakterine
^
sahip bir Windows konsolu varsayılır. Kapsayıcı bir Linux işletim sistemi olduğundan, hedef bağlama Linux stilinde bir klasör söz dizimi kullanır.
Şu komut:
- LUIS kapsayıcı görüntüsünden bir kapsayıcı çalıştırır
- Kapsayıcı konağında bulunan C:\input konumundaki giriş bağlamasından LUIS uygulamasını yükler
- İki 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 TTY ayırır
- Kapsayıcı ve LUIS günlüklerini, kapsayıcı konağında bulunan C:\output konumundaki çıkış bağlamasına kaydeder
- Kapsayıcı çıktıktan sonra otomatik olarak kaldırılır. Kapsayıcı görüntüsü ana bilgisayarda hala kullanılabilir.
Komutun docker run
diğer örnekleri mevcuttur.
Önemli
Kapsayıcıyı Eula
çalıştırmak için , Billing
ve ApiKey
seçenekleri belirtilmelidir; aksi takdirde kapsayıcı başlatılmaz. Daha fazla bilgi için bkz . Faturalama.
ApiKey değeri, LUIS portalındaki Azure Kaynakları sayfasındaki Anahtar'dır ve Azure Azure AI services
kaynak anahtarları sayfasında da kullanılabilir.
Aynı konakta birden çok kapsayıcı çalıştırma
Kullanıma sunulan bağlantı noktalarıyla birden çok kapsayıcı çalıştırmayı planlıyorsanı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. Aynı Azure AI hizmetleri kapsayıcısının birden çok kapsayıcısını da çalıştırabilirsiniz.
Kapsayıcı tarafından desteklenen uç nokta API'leri
Kapsayıcıda API'nin hem V2 hem de V3 sürümleri kullanılabilir.
Kapsayıcının tahmin uç noktasını sorgulama
Kapsayıcı REST tabanlı sorgu tahmin uç noktası API’lerini sağlar. Yayımlanan (hazırlama veya üretim) uygulamaların uç noktalarının, sürümlenmiş uygulamalar için uç noktalardan farklı bir yolu vardır.
Kapsayıcı API’leri için http://localhost:5000
konağını kullanın.
Paket türü | HTTP fiili | Rota | Sorgu parametreleri |
---|---|---|---|
Yayımlanmış | GET, POST |
/luis/v3.0/apps/{appId}/slots/{slotName}/predict?
/luis/prediction/v3.0/apps/{appId}/slots/{slotName}/predict?
|
query={query} [ &verbose ][ &log ][ &show-all-intents ] |
Sürüme Dönüştürülen | GET, POST |
/luis/v3.0/apps/{appId}/versions/{versionId}/predict?
/luis/prediction/v3.0/apps/{appId}/versions/{versionId}/predict
|
query={query} [ &verbose ][ &log ][ &show-all-intents ] |
Sorgu parametreleri, sorgu yanıtında nasıl ve nelerin döndürülür yapılandırılır:
Sorgu parametresi | Tür | Amaç |
---|---|---|
query |
Dize | Kullanıcının konuşması. |
verbose |
boolean | Tahmin edilen modeller için tüm meta verilerin döndürülip döndürülmeyeceğini gösteren boole değeri. Varsayılan değer yanlış'tır. |
log |
boolean | Daha sonra etkin öğrenme için kullanılabilen günlük sorguları. Varsayılan değer yanlış'tır. |
show-all-intents |
boolean | Tüm amaçların mı yoksa yalnızca en iyi puanlama amacının mı döndürüleceğiyle ilgili boole değeri. Varsayılan değer yanlış'tır. |
LUIS uygulamasını sorgulama
Yayımlanmış bir uygulamanın kapsayıcısını sorgulamaya yönelik örnek bir CURL komutu:
Yuvadaki bir modeli sorgulamak için aşağıdaki API'yi kullanın:
curl -G \
-d verbose=false \
-d log=true \
--data-urlencode "query=turn the lights on" \
"http://localhost:5000/luis/v3.0/apps/{APP_ID}/slots/production/predict"
Hazırlama ortamına sorgular yapmak için, yolu ile staging
değiştirinproduction
:
http://localhost:5000/luis/v3.0/apps/{APP_ID}/slots/staging/predict
Sürüm oluşturulmuş bir modeli sorgulamak için aşağıdaki API'yi kullanın:
curl -G \
-d verbose=false \
-d log=false \
--data-urlencode "query=turn the lights on" \
"http://localhost:5000/luis/v3.0/apps/{APP_ID}/versions/{APP_VERSION}/predict"
Etkin öğrenme için uç nokta günlüklerini içeri aktarma
LUIS kapsayıcısı için bir çıkış bağlaması belirtilirse, uygulama sorgusu günlük dosyaları çıkış dizinine kaydedilir ve burada {INSTANCE_ID}
kapsayıcı kimliği bulunur. Uygulama sorgu günlüğü LUIS kapsayıcısına gönderilen her tahmin sorgusu için sorgu, yanıt ve zaman damgalarını içerir.
Aşağıdaki konum, kapsayıcının günlük dosyaları için iç içe dizin yapısını gösterir.
/output/luis/{INSTANCE_ID}/
LUIS portalından uygulamanızı seçin ve ardından Uç nokta günlüklerini içeri aktar'ı seçerek bu günlükleri karşıya yükleyin.
Günlük karşıya yüklendikten sonra LUIS portalında uç nokta konuşmalarını gözden geçirin.
Kapsayıcının çalıştığını doğrulama
Kapsayıcının çalıştığını doğrulamanın çeşitli yolları vardır.
Dış IP adresini ve söz konusu kapsayıcının 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 | Purpose |
---|---|
http://localhost:5000/ |
Kapsayıcı bir giriş sayfası sağlar. |
http://localhost:5000/ready |
GET ile istenen bu URL, kapsayıcının modele karşı sorgu kabul etmeye hazır olduğunu doğrulamayı sağlar. Bu istek Kubernetes canlılığı ve hazır olma 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ır olma 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ürüldikten sonra, gerekli HTTP üst bilgilerini ve gövde biçimini göstermek için örnek bir CURL komutu sağlanır. |
İ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ının İnternet bağlantısı kesilmiş olarak çalıştırılması onaylandıysa, aşağıdaki örnekte kullanacağınız komutun yer tutucu değerleriyle birlikte biçimlendirmesi docker run
gösterilir. Bu yer tutucu değerlerini kendi değerlerinizle değiştirin.
DownloadLicense=True
Komutunuzdaki docker run
parametre, 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 metin kapsayıcısına konuşma 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. Kaynağınızın Anahtar ve uç nokta sayfasında, Azure portalında bulabilirsiniz. | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{API_KEY} |
Metin Analizi kaynağınızın anahtarı. Kaynağınızın Anahtar ve uç nokta sayfasında, Azure portalında 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 örnek, kullanacağınız komutun docker run
yer tutucu değerleriyle biçimlendirmesini gösterir. Bu yer tutucu değerlerini 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 kapsayıcının yerel dosya sistemindeki lisans klasörünün konumu ile Mounts:License=
belirtilmelidir. Faturalama kullanım kayıtlarının yazılabilmesi için bir çı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 bulunacağı 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ına basın.
Sorun giderme
Kapsayıcıyı bir çıkış bağlaması 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 kılavuzu için bkz . Azure AI kapsayıcıları hakkında sık sorulan sorular (SSS).
Azure AI hizmetleri kapsayıcısını çalıştırırken sorun yaşıyorsanız Microsoft tanılama kapsayıcısını kullanmayı deneyebilirsiniz. Dağıtım ortamınızda Azure AI kapsayıcılarının beklendiği gibi çalışmasını engelleyebilecek yaygın hataları tanılamak için bu kapsayıcıyı kullanın.
Kapsayıcıyı almak için aşağıdaki docker pull
komutu kullanın:
docker pull mcr.microsoft.com/azure-cognitive-services/diagnostic
Ardından kapsayıcıyı çalıştırın. değerini {ENDPOINT_URI}
uç noktanızla değiştirin ve değerini kaynağınızın anahtarıyla değiştirin {API_KEY}
:
docker run --rm mcr.microsoft.com/azure-cognitive-services/diagnostic \
eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}
Kapsayıcı, faturalama uç noktasına ağ bağlantısını test eder.
Faturalandırma
LUIS kapsayıcısı, Azure hesabınızdaki bir Azure AI hizmetleri kaynağını kullanarak faturalama bilgilerini Azure'a gönderir.
Kapsayıcıya yönelik sorgular, parametre 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ğlı olmadan çalıştırılma lisansına sahip değildir. Faturalama bilgilerini faturalama uç noktasıyla her zaman iletmek için kapsayıcıları 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 denemede faturalama uç noktasına bağlanamazsa 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ı 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 Billing ayarlanmalı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. |
Bu seçenekler hakkında daha fazla bilgi için bkz . Kapsayıcıları yapılandırma.
Özet
Bu makalede Language Understanding (LUIS) kapsayıcılarını indirmeye, yüklemeye ve çalıştırmaya yönelik kavramları ve iş akışını öğrendiniz. Özet olarak:
- Language Understanding (LUIS), docker için bir Linux kapsayıcısı sağlar ve konuşmaların uç nokta sorgu tahminlerini 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 kapsayıcı uç noktalarını sorgulamak için REST API kullanabilirsiniz.
- Kapsayıcı örneği oluştururken faturalama bilgilerini belirtmeniz gerekir.
Önemli
Azure yapay zeka 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 görüntü veya metin) Microsoft'a göndermez.
Sonraki adımlar
- Yapılandırma ayarları için Kapsayıcıları yapılandırma'ya göz atın.
- Bilinen yetenek kısıtlamaları için bkz. LUIS kapsayıcı sınırlamaları.
- LUIS işlevselliğiyle ilgili sorunları çözmek için sorun giderme konusuna bakın.
- Daha fazla Azure AI kapsayıcısı kullanma