Aracılığıyla paylaş

LUIS için Docker kapsayıcılarını yükleme ve çalıştırma

  • Makale

Ö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 AI hizmetleri için kapsayıcı gösterimi

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.

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

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.

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 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.

Uygulama kimliğinizi bulma ekranı.

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.

Yazma kaynak anahtarınızı bulma ekranı.

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:

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.

Language Understanding (LUIS) kapsayıcısını kullanma işlemi

  1. KAPSAYıCı paketini LUIS portalından veya LUIS API'lerinden dışarı aktarın.
  2. 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.
  3. Gerekli giriş bağlama ve faturalama ayarlarıyla kapsayıcıyı çalıştırın. Komutun docker run diğer örnekleri mevcuttur.
  4. Kapsayıcının tahmin uç noktasını sorgulama.
  5. 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 .
  6. Uygulamayı geliştirmek için UÇ nokta ifadelerini gözden geçirme sayfasında LUIS portalının etkin öğrenmesini kullanı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 LUIS yazma 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 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.

  1. LUIS portalında oturum açın.
  2. Listedeki uygulama adının solundaki onay kutusunu seçin.
  3. Listenin üstündeki bağlam araç çubuğundan Öğeyi dışarı aktar'ı seçin.
  4. Kapsayıcı (GZIP) için Dışarı Aktar'ı seçin.
  5. Üretim yuvasının veya Hazırlama yuvasının ortamını seçin.
  6. Paket tarayıcıdan indirilir.

Uygulama sayfasının Dışarı Aktar menüsünden kapsayıcı için yayımlanan paketi dışarı aktarma

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.

  1. LUIS portalında oturum açın.
  2. Listeden uygulamayı seçin.
  3. Uygulamanın gezinti çubuğunda Yönet'i seçin.
  4. Sol gezinti çubuğunda Sürümler'i seçin.
  5. Listedeki sürüm adının solundaki onay kutusunu seçin.
  6. Listenin üstündeki bağlam araç çubuğundan Öğeyi dışarı aktar'ı seçin.
  7. Kapsayıcı (GZIP) için Dışarı Aktar'ı seçin.
  8. Paket tarayıcıdan indirilir.

Sürümler sayfasının Dışarı Aktar menüsünden kapsayıcı için eğitilen paketi dışarı aktarma

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ı ABD
westeurope - Batı Avrupa
australiaeast - 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ı ABD
westeurope - Batı Avrupa
australiaeast - 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 , Billingve 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 stagingdeğ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.

Etkin öğrenme için kapsayıcının günlük dosyalarını içeri aktarma

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.

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ı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 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.

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