LUSıS Docker kapsayıcılarını yükleyip çalıştırınInstall and run LUIS docker containers

Language Understanding (LUSıS) kapsayıcısı, eğitilen veya yayımlanmış Language Understanding modelinizi yükler.The Language Understanding (LUIS) container loads your trained or published Language Understanding model. Bir lusıs uygulamasıolarak Docker kapsayıcısı, kapsayıcının API uç noktalarından alınan sorgu tahminlere erişim sağlar.As a LUIS app, the docker container provides access to the query predictions from the container's API endpoints. Sorgudan sorgu günlüklerini toplayabilir ve uygulamanın tahmin doğruluğunu artırmak için bunları Language Understanding uygulamasına geri yükleyebilirsiniz.You can collect query logs from the container and upload them back to the Language Understanding app to improve the app's prediction accuracy.

Aşağıdaki videoda Bu kapsayıcının kullanımı gösterilmektedir.The following video demonstrates using this container.

Bilişsel hizmetler için kapsayıcı gösterimiContainer demonstration for Cognitive Services

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.If you don't have an Azure subscription, create a free account before you begin.

ÖnkoşullarPrerequisites

Lusıs kapsayıcısını çalıştırmak için aşağıdaki önkoşullara göz önünde bulunur:To run the LUIS container, note the following prerequisites:

GerekliRequired AmaçPurpose
Docker altyapısıDocker Engine Bir ana bilgisayardaDocker altyapısının yüklü olması gerekir.You need the Docker Engine installed on a host computer. Docker, macOS, Windows ve Linux üzerinde Docker ortamını yapılandıran paketler sağlar.Docker provides packages that configure the Docker environment on macOS, Windows, and Linux. Docker ve kapsayıcı temel bilgileri ile ilgili giriş yapmak için Docker’a genel bakış bölümüne bakın.For a primer on Docker and container basics, see the Docker overview.

Kapsayıcıların Azure 'a bağlanıp faturalandırma verilerini göndermesini sağlamak için Docker yapılandırılmalıdır.Docker must be configured to allow the containers to connect with and send billing data to Azure.

Windows 'daDocker 'ın de Linux kapsayıcılarını destekleyecek şekilde yapılandırılması gerekir.On Windows, Docker must also be configured to support Linux containers.

Docker ile benzerlikFamiliarity with Docker Kayıt defterleri, depolar, kapsayıcılar ve kapsayıcı görüntüleri gibi Docker kavramlarının yanı sıra temel komutlar hakkında bilgi sahibi olmanız gerekir docker .You should have a basic understanding of Docker concepts, like registries, repositories, containers, and container images, as well as knowledge of basic docker commands.
Azure Cognitive Services Resource ve lusıs paketlenmiş uygulama dosyasıAzure Cognitive Services resource and LUIS packaged app file Kapsayıcısını kullanabilmeniz için şunları yapmanız gerekir:In order to use the container, you must have:

* Bilişsel Hizmetler Azure kaynağı ve ilgili faturalandırma anahtarı faturalandırma uç noktası URI 'si.* A Cognitive Services Azure resource and the associated billing key the billing endpoint URI. Her iki değer de kaynak için genel bakış ve anahtarlar sayfalarında bulunur ve kapsayıcıyı başlatmak için gereklidir.Both values are available on the Overview and Keys pages for the resource and are required to start the container.
* İlişkili uygulama KIMLIĞIYLE kapsayıcıya bağlı giriş olarak paketlenmiş eğitilen veya yayımlanmış bir uygulama.* A trained or published app packaged as a mounted input to the container with its associated App ID. Paketlenmiş dosyayı LUıS portalından veya yazma API 'Lerinden alabilirsiniz.You can get the packaged file from the LUIS portal or the Authoring APIs. Yazma API 'lerindenLUIS paketlenmiş uygulama alıyorsanız, _yazma anahtarınıza_de ihtiyacınız olacaktır.If you are getting LUIS packaged app from the authoring APIs, you will also need your Authoring Key.

Bu gereksinimler komut satırı bağımsız değişkenlerini aşağıdaki değişkenlere iletmek için kullanılır:These requirements are used to pass command-line arguments to the following variables:

{AUTHORING_KEY}: Bu anahtar, paketteki lusıs hizmetinden paketlenmiş uygulamayı almak ve sorgu günlüklerini buluta geri yüklemek için kullanılır.{AUTHORING_KEY}: This key is used to get the packaged app from the LUIS service in the cloud and upload the query logs back to the cloud. Biçim xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx .The format is xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.

{APP_ID}: Bu kimlik, uygulamayı seçmek için kullanılır.{APP_ID}: This ID is used to select the App. Biçim xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx .The format is xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

{API_KEY}: Bu anahtar kapsayıcıyı başlatmak için kullanılır.{API_KEY}: This key is used to start the container. Uç nokta anahtarını iki yerde bulabilirsiniz.You can find the endpoint key in two places. Birincisi, bilişsel Hizmetler kaynağının anahtar listesi içindeki Azure Portal.The first is the Azure portal within the Cognitive Services resource's keys list. Uç nokta anahtarı, anahtarlar ve uç nokta ayarları sayfasındaki LUO portalında da kullanılabilir.The endpoint key is also available in the LUIS portal on the Keys and Endpoint settings page. Başlangıç anahtarını kullanmayın.Do not use the starter key.

{ENDPOINT_URI}: Genel Bakış sayfasında belirtilen bitiş noktası.{ENDPOINT_URI}: The endpoint as provided on the Overview page.

Yazma anahtarı ve uç nokta anahtarının farklı amaçları vardır.The authoring key and endpoint key have different purposes. Bunları birbirlerinin yerine kullanmayın.Do not use them interchangeably.

Gerekli parametreler toplanıyorGathering required parameters

Gerekli olan tüm bilişsel hizmetler için üç birincil parametre vardır.There are three primary parameters for all Cognitive Services' containers that are required. Son Kullanıcı Lisans Sözleşmesi 'nin accept(EULA) değeri ile mevcut olması gerekir.The end-user license agreement (EULA) must be present with a value of accept. Ayrıca, hem bir uç nokta URL 'SI hem de API anahtarı gereklidir.Additionally, both an Endpoint URL and API Key are needed.

Uç nokta URI 'SI{ENDPOINT_URI}Endpoint URI {ENDPOINT_URI}

Uç nokta URI değeri, karşılık gelen bilişsel hizmet kaynağının Azure Portal genel bakış sayfasında bulunur.The Endpoint URI value is available on the Azure portal Overview page of the corresponding Cognitive Service resource. Genel bakış sayfasına gidin, uç noktanın üzerine gelin ve bir Copy to clipboard simge görüntülenir.Navigate to the Overview page, hover over the Endpoint, and a Copy to clipboard icon will appear. Gerektiğinde kopyalayın ve kullanın.Copy and use where needed.

Uç nokta URI 'sini daha sonra kullanılmak üzere toplayın

Belirlenmesine{API_KEY}Keys {API_KEY}

Bu anahtar, kapsayıcıyı başlatmak için kullanılır ve ilgili bilişsel hizmet kaynağının Azure portal tuşları sayfasında kullanılabilir.This key is used to start the container, and is available on the Azure portal's Keys page of the corresponding Cognitive Service resource. Anahtarlar sayfasına gidin ve Copy to clipboard simgesine tıklayın.Navigate to the Keys page, and click on the Copy to clipboard icon.

Daha sonra kullanmak üzere iki anahtardan birini al

Önemli

Bu abonelik anahtarları bilişsel hizmet API 'nize erişmek için kullanılır.These subscription keys are used to access your Cognitive Service API. Anahtarlarınızı paylaşmayın.Do not share your keys. Azure Key Vault kullanarak güvenli bir şekilde depolayın.Store them securely, for example, using Azure Key Vault. Ayrıca, bu anahtarların düzenli olarak yeniden oluşturulması önerilir.We also recommend regenerating these keys regularly. API çağrısı yapmak için yalnızca bir anahtar gereklidir.Only one key is necessary to make an API call. İlk anahtarı yeniden oluştururken, hizmete devam eden erişim için ikinci anahtarı kullanabilirsiniz.When regenerating the first key, you can use the second key for continued access to the service.

Paket dosyası için yazma API 'LeriAuthoring APIs for package file

Paketlenmiş uygulamalar için yazma API 'Leri:Authoring APIs for packaged apps:

Ana bilgisayarThe host computer

Ana bilgisayar, Docker kapsayıcısını çalıştıran x64 tabanlı bir bilgisayardır.The host is a x64-based computer that runs the Docker container. Şirket içinde veya Azure 'da bir Docker barındırma hizmeti olan bir bilgisayar olabilir; Örneğin:It can be a computer on your premises or a Docker hosting service in Azure, such as:

Kapsayıcı gereksinimleri ve önerileriContainer requirements and recommendations

Aşağıdaki tabloda kapsayıcı ana bilgisayarı için en düşük ve önerilen değerler listelenmiştir.The below table lists minimum and recommended values for the container host. Gereksinimleriniz, trafik hacmine bağlı olarak değişebilir.Your requirements may change depending on traffic volume.

KapsayıcıContainer MinimumMinimum ÖnerilenRecommended TPSTPS
(En düşük, en yüksek)(Minimum, Maximum)
LUISLUIS 1 çekirdek, 2 GB bellek1 core, 2-GB memory 1 çekirdek, 4 GB bellek1 core, 4-GB memory 20, 4020, 40
  • Her çekirdek en az 2,6 gigahertz (GHz) veya daha hızlı olmalıdır.Each core must be at least 2.6 gigahertz (GHz) or faster.
  • TPS-saniye başına işlemTPS - transactions per second

Çekirdek ve bellek, --cpus --memory komutunun bir parçası olarak kullanılan ve ayarlarına karşılık gelir docker run .Core and memory correspond to the --cpus and --memory settings, which are used as part of the docker run command.

Kapsayıcı görüntüsünü aldocker pullGet the container image with docker pull

docker pullDepodan bir kapsayıcı görüntüsü indirmek için komutunu kullanın mcr.microsoft.com/azure-cognitive-services/luis :Use the docker pull command to download a container image from the mcr.microsoft.com/azure-cognitive-services/luis repository:

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

Yukarıdaki komutta kullanılan gibi kullanılabilir etiketlerin tam bir açıklaması için latest bkz. Docker Hub üzerinde Luis .For a full description of available tags, such as latest used in the preceding command, see LUIS on Docker Hub.

İpucu

İndirilen kapsayıcı görüntülerinizi listelemek için Docker görüntüleri komutunu kullanabilirsiniz.You can use the docker images command to list your downloaded container images. Örneğin, aşağıdaki komut, indirilen her bir kapsayıcı görüntüsünün KIMLIĞINI, deposunu ve etiketini listeler ve tablo olarak biçimlendirilir:For example, the following command lists the ID, repository, and tag of each downloaded container image, formatted as a table:

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

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

Kapsayıcıyı kullanmaHow to use the container

Kapsayıcı ana bilgisayardanolduktan sonra, kapsayıcında çalışmak için aşağıdaki işlemi kullanın.Once the container is on the host computer, use the following process to work with the container.

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

  1. LUıS portalından veya LUıS API 'Lerinden kapsayıcı için paket dışarı aktarma .Export package for container from LUIS portal or LUIS APIs.
  2. Paket dosyasını, ana bilgisayardagerekli giriş dizinine taşıyın.Move package file into the required input directory on the host computer. LUSıS paket dosyasını yeniden adlandırmayın, değiştirmeyin, üzerine yazmaz veya sıkıştırmasını açın.Do not rename, alter, overwrite, or decompress the LUIS package file.
  3. Kapsayıcıyı, gerekli giriş bağlama ve faturalandırma ayarlarıyla çalıştırın.Run the container, with the required input mount and billing settings. Komuta examples daha fazla örnek docker run kullanılabilir.More examples of the docker run command are available.
  4. Kapsayıcının tahmin uç noktası sorgulanıyor.Querying the container's prediction endpoint.
  5. Kapsayıcı ile işiniz bittiğinde, Halu portalındaki çıkış bağlamasından uç nokta günlüklerini içeri aktarın ve kapsayıcıyı durdurun .When you are done with the container, import the endpoint logs from the output mount in the LUIS portal and stop the container.
  6. Uygulamayı geliştirmek için, Gözden geçirme uç noktası sıralayıcısı sayfasında Luo portalının etkin öğrenimini kullanın.Use LUIS portal's active learning on the Review endpoint utterances page to improve the app.

Kapsayıcıda çalışan uygulama değiştirilemez.The app running in the container can't be altered. Kapsayıcıda uygulamayı değiştirmek için , LUIS portalını kullanarak LUIS hizmetinde uygulamayı DEĞIŞTIRMENIZ veya LUIS yazma API 'lerinikullanmanız gerekir.In order to change the app in the container, you need to change the app in the LUIS service using the LUIS portal or use the LUIS authoring APIs. Daha sonra eğitme ve/veya Yayımla, sonra yeni bir paket indirip kapsayıcıyı yeniden çalıştırın.Then train and/or publish, then download a new package and run the container again.

Kapsayıcının içindeki LUO uygulaması, LUSıS hizmetine geri verilemez.The LUIS app inside the container can't be exported back to the LUIS service. Yalnızca sorgu günlükleri karşıya yüklenebilir.Only the query logs can be uploaded.

Paketlenmiş uygulamayı LUSıS 'den dışarı aktarmaExport packaged app from LUIS

LUSıS kapsayıcısı, Kullanıcı sorusunun tahmin sorgularını yanıtlamak için eğitilen veya yayınlanmış bir LUO uygulaması gerektirir.The LUIS container requires a trained or published LUIS app to answer prediction queries of user utterances. LUıN uygulamasını almak için, eğitilen veya yayımlanmış paket API 'sini kullanın.In order to get the LUIS app, use either the trained or published package API.

Varsayılan konum, input komutu çalıştırdığınız konuma göre alt dizindir docker run .The default location is the input subdirectory in relation to where you run the docker run command.

Paket dosyasını bir dizine yerleştirin ve Docker kapsayıcısını çalıştırdığınızda giriş bağlama olarak bu dizine başvurun.Place the package file in a directory and reference this directory as the input mount when you run the docker container.

Paket türleriPackage types

Giriş bağlama dizini, uygulamanın Üretim, hazırlamave Sürümlenmiş modellerini eşzamanlı olarak içerebilir.The input mount directory can contain the Production, Staging, and Versioned models of the app simultaneously. Tüm paketler bağlanır.All the packages are mounted.

Paket türüPackage Type Sorgu uç noktası API 'SIQuery Endpoint API Sorgu kullanılabilirliğiQuery availability Paket dosya adı biçimiPackage filename format
SürümüVersioned AL, POSTALAGET, POST Yalnızca kapsayıcıContainer only {APP_ID}_v{APP_VERSION}.gz
HazırlamaStaging AL, POSTALAGET, POST Azure ve kapsayıcıAzure and container {APP_ID}_STAGING.gz
ÜretimProduction AL, POSTALAGET, POST Azure ve kapsayıcıAzure and container {APP_ID}_PRODUCTION.gz

Önemli

LUSıS paket dosyalarını yeniden adlandırmayın, değiştirmeyin, üzerine yazmaz veya sıkıştırmasını açın.Do not rename, alter, overwrite, or decompress the LUIS package files.

Paketleme önkoşullarıPackaging prerequisites

Bir LUSıS uygulamasını paketlemeden önce aşağıdakilere sahip olmanız gerekir:Before packaging a LUIS application, you must have the following:

Paketleme gereksinimleriPackaging Requirements AyrıntılarDetails
Azure bilişsel Hizmetler kaynak örneğiAzure Cognitive Services resource instance Desteklenen bölgeler şunlardırSupported regions include

Batı ABD ( westus )West US (westus)
Batı Avrupa ( westeurope )West Europe (westeurope)
Avustralya Doğu ( australiaeast )Australia East (australiaeast)
Eğitilen veya yayınlanan LUO uygulamasıTrained or published LUIS app , Desteklenmeyen bağımlılıklaryok.With no unsupported dependencies.
Ana bilgisayarındosya sistemine erişimAccess to the host computer's file system Ana bilgisayar bir giriş bağlamayaizin vermelidir.The host computer must allow an input mount.

Uygulama paketini LUSıS portalından dışarı aktarmaExport app package from LUIS portal

Lua portalı , eğitilen veya yayınlanan uygulamanın paketini dışarı aktarma olanağını sağlar.The LUIS portal provides the ability to export the trained or published app's package.

Yayınlanan uygulamanın paketini LUSıS portalından dışarı aktarExport published app's package from LUIS portal

Yayınlanan uygulamanın paketine, uygulamalar listesi sayfasından ulaşılabilir.The published app's package is available from the My Apps list page.

  1. LUI portalındaoturum açın.Sign on to the LUIS portal.
  2. Listedeki uygulama adının solundaki onay kutusunu seçin.Select the checkbox to the left of the app name in the list.
  3. Listenin üzerindeki bağlam araç çubuğundan dışarı aktarma öğesini seçin.Select the Export item from the contextual toolbar above the list.
  4. Kapsayıcı (GZIP) Için dışarı aktar' ı seçin.Select Export for container (GZIP).
  5. Üretim yuvası veya hazırlama yuvasıortamını seçin.Select the environment of Production slot or Staging slot.
  6. Paket tarayıcıdan indirilir.The package is downloaded from the browser.

Uygulama sayfasının dışarı aktarma menüsünden, kapsayıcı için yayımlanmış paketi dışarı aktarma

Sürümü tutulan uygulamanın paketini LUSıS portalından dışarı aktarExport versioned app's package from LUIS portal

Sürümlenmiş uygulamanın paketine sürümler listesi sayfasından ulaşılabilir.The versioned app's package is available from the Versions list page.

  1. LUI portalındaoturum açın.Sign on to the LUIS portal.
  2. Listeden uygulamaya tıklayın.Select the app in the list.
  3. Uygulamanın gezinti çubuğunda Yönet ' i seçin.Select Manage in the app's navigation bar.
  4. Sol gezinti çubuğundaki sürümler ' i seçin.Select Versions in the left navigation bar.
  5. Listedeki sürüm adının solundaki onay kutusunu seçin.Select the checkbox to the left of the version name in the list.
  6. Listenin üzerindeki bağlam araç çubuğundan dışarı aktarma öğesini seçin.Select the Export item from the contextual toolbar above the list.
  7. Kapsayıcı (GZIP) Için dışarı aktar' ı seçin.Select Export for container (GZIP).
  8. Paket tarayıcıdan indirilir.The package is downloaded from the browser.

Sürümler sayfasının dışa aktarma menüsünde, kapsayıcı için eğitilen paketi dışarı aktarma

Yayınlanan uygulamanın paketini API 'den dışarı aktarExport published app's package from API

Zaten yayımlamışolduğunuz bir Luo uygulamasını paketlemek için aşağıdaki REST API yöntemini kullanın.Use the following REST API method, to package a LUIS app that you've already published. HTTP belirtiminin altındaki tabloyu kullanarak API çağrısındaki yer tutucular için kendi uygun değerlerinizi değiştirme.Substituting your own appropriate values for the placeholders in the API call, using the table below the HTTP specification.

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 tutucuPlaceholder DeğerValue
{APP_ID}{APP_ID} Yayınlanan LUSıS uygulamasının uygulama KIMLIĞI.The application ID of the published LUIS app.
{SLOT_NAME}{SLOT_NAME} Yayınlanan LUSıS uygulamasının ortamı.The environment of the published LUIS app. Aşağıdaki değerlerden birini kullanın:Use one of the following values:
PRODUCTION
STAGING
{AUTHORING_KEY}{AUTHORING_KEY} Yayımlanan LUO uygulaması için Luo hesabının yazma anahtarı.The authoring key of the LUIS account for the published LUIS app.
Yazma anahtarınızı, Lua portalındaki Kullanıcı ayarları sayfasından edinebilirsiniz.You can get your authoring key from the User Settings page on the LUIS portal.
{AZURE_REGION}{AZURE_REGION} Uygun Azure bölgesi:The appropriate Azure region:

westus-Batı ABDwestus - West US
westeurope-Batı Avrupawesteurope - West Europe
australiaeast-Avustralya Doğuaustraliaeast - Australia East

Yayınlanan paketi indirmek için buradaki API belgelerinebaşvurun.To download the published package, refer to the API documentation here. Başarılı bir şekilde indirildiyse, yanıt bir LUSıS paket dosyasıdır.If successfully downloaded, the response is a LUIS package file. Dosyayı kapsayıcının giriş bağlaması için belirtilen depolama konumuna kaydedin.Save the file in the storage location specified for the input mount of the container.

Sürümlü uygulamanın paketini API 'den dışarı aktarExport versioned app's package from API

Zaten eğitilenbir Luo uygulamasını paketlemek için aşağıdaki REST API yöntemini kullanın.Use the following REST API method, to package a LUIS application that you've already trained. HTTP belirtiminin altındaki tabloyu kullanarak API çağrısındaki yer tutucular için kendi uygun değerlerinizi değiştirme.Substituting your own appropriate values for the placeholders in the API call, using the table below the HTTP specification.

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 tutucuPlaceholder DeğerValue
{APP_ID}{APP_ID} Eğitilen LUO uygulamasının uygulama KIMLIĞI.The application ID of the trained LUIS app.
{APP_VERSION}{APP_VERSION} Eğitilen LUIN uygulamasının uygulama sürümü.The application version of the trained LUIS app.
{AUTHORING_KEY}{AUTHORING_KEY} Yayımlanan LUO uygulaması için Luo hesabının yazma anahtarı.The authoring key of the LUIS account for the published LUIS app.
Yazma anahtarınızı, Lua portalındaki Kullanıcı ayarları sayfasından edinebilirsiniz.You can get your authoring key from the User Settings page on the LUIS portal.
{AZURE_REGION}{AZURE_REGION} Uygun Azure bölgesi:The appropriate Azure region:

westus-Batı ABDwestus - West US
westeurope-Batı Avrupawesteurope - West Europe
australiaeast-Avustralya Doğuaustraliaeast - Australia East

Sürümlenmiş paketi indirmek için buradaki API belgelerinebaşvurun.To download the versioned package, refer to the API documentation here. Başarılı bir şekilde indirildiyse, yanıt bir LUSıS paket dosyasıdır.If successfully downloaded, the response is a LUIS package file. Dosyayı kapsayıcının giriş bağlaması için belirtilen depolama konumuna kaydedin.Save the file in the storage location specified for the input mount of the container.

Kapsayıcıyı ile çalıştırmadocker runRun the container with docker run

Kapsayıcıyı çalıştırmak için Docker Run komutunu kullanın.Use the docker run command to run the container. Ve değerlerini alma hakkında ayrıntılar için gerekli parametreleri toplama bölümüne bakın {ENDPOINT_URI} {API_KEY} .Refer to gathering required parameters for details on how to get the {ENDPOINT_URI} and {API_KEY} values.

Komut örnekleri docker run mevcuttur.Examples of the docker run command are available.

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/luis ^
Eula=accept ^
Billing={ENDPOINT_URI} ^
ApiKey={API_KEY}
  • Bu örnek, C: Windows 'da herhangi bir izin çakışmasını önlemek için dizini sürücüden kullanır.This example uses the directory off the C: drive to avoid any permission conflicts on Windows. Giriş dizini olarak belirli bir dizin kullanmanız gerekiyorsa, Docker hizmeti iznini vermeniz gerekebilir.If you need to use a specific directory as the input directory, you may need to grant the docker service permission.
  • Docker Kapsayıcıları hakkında bilginiz yoksa bağımsız değişkenlerin sırasını değiştirmeyin.Do not change the order of the arguments unless you are familiar with docker containers.
  • Farklı bir işletim sistemi kullanıyorsanız, sistem için doğru konsol/Terminal, bağlama için klasör söz dizimi ve satır devamlılık karakteri kullanın.If you are using a different operating system, use the correct console/terminal, folder syntax for mounts, and line continuation character for your system. Bu örneklerde bir Windows konsolunun satır devamlılık karakteriyle birlikte varsayılmaktadır ^ .These examples assume a Windows console with a line continuation character ^. Kapsayıcı bir Linux işletim sistemi olduğundan, hedef bağlama bir Linux stili klasör söz dizimini kullanır.Because the container is a Linux operating system, the target mount uses a Linux-style folder syntax.

Şu komut:This command:

  • LUSıS kapsayıcı görüntüsünden bir kapsayıcı çalıştırırRuns a container from the LUIS container image
  • Kapsayıcı konağında bulunan c:\ınputkonumundaki giriş BAĞLAMASıNDAN Luo uygulamasını yüklerLoads LUIS app from input mount at C:\input, located on container host
  • İki CPU çekirdeği ve 4 gigabayt (GB) bellek ayırırAllocates two CPU cores and 4 gigabytes (GB) of memory
  • TCP bağlantı noktası 5000 ' i kullanıma sunar ve kapsayıcı için bir sözde TTY ayırırExposes TCP port 5000 and allocates a pseudo-TTY for the container
  • Kapsayıcı ana bilgisayarında bulunan c:\Outputkonumundaki çıkış bağlamasındaki KAPSAYıCıYı ve Lua günlüklerini kaydederSaves container and LUIS logs to output mount at C:\output, located on container host
  • Kapsayıcıyı çıktıktan sonra otomatik olarak kaldırır.Automatically removes the container after it exits. Kapsayıcı görüntüsü hala ana bilgisayarda kullanılabilir.The container image is still available on the host computer.

Komuta examples daha fazla örnek docker run kullanılabilir.More examples of the docker run command are available.

Önemli

Eula Billing ApiKey Kapsayıcıyı çalıştırmak için, ve seçenekleri belirtilmelidir; Aksi takdirde kapsayıcı başlatılmaz.The Eula, Billing, and ApiKey options must be specified to run the container; otherwise, the container won't start. Daha fazla bilgi için bkz. faturalandırma.For more information, see Billing. ApiKey değeri, LUO portalındaki Azure kaynakları sayfasının anahtarıdır ve Azure Cognitive Services kaynak anahtarları sayfasında da kullanılabilir.The ApiKey value is the Key from the Azure Resources page in the LUIS portal and is also available on the Azure Cognitive Services resource keys page.

Birden çok kapsayıcıyı aynı konakta ÇalıştırRun multiple containers on the same host

Açığa çıkarılan bağlantı noktalarıyla birden çok kapsayıcı çalıştırmak istiyorsanız, her kapsayıcıyı farklı bir açığa çıkarılan bağlantı noktasıyla çalıştırdığınızdan emin olun.If you intend to run multiple containers with exposed ports, make sure to run each container with a different exposed port. Örneğin, bağlantı noktası 5000 ' deki ilk kapsayıcıyı ve bağlantı noktası 5001 üzerindeki ikinci kapsayıcıyı çalıştırın.For example, run the first container on port 5000 and the second container on port 5001.

Bu kapsayıcınızı ve KONAKTA çalışan farklı bir Azure bilişsel Hizmetler kapsayıcısını birlikte kullanabilirsiniz.You can have this container and a different Azure Cognitive Services container running on the HOST together. Aynı bilişsel Hizmetler kapsayıcısının çalışan birden fazla kapsayıcınızı da kullanabilirsiniz.You also can have multiple containers of the same Cognitive Services container running.

Kapsayıcı tarafından desteklenen uç nokta API 'LeriEndpoint APIs supported by the container

Kapsayıcı ile birlikte API 'nin v2 ve v3 sürümleri mevcuttur.Both V2 and V3 versions of the API are available with the container.

Kapsayıcının tahmin uç noktasını sorgulamaQuery the container's prediction endpoint

Kapsayıcı REST tabanlı sorgu tahmin uç noktası API’lerini sağlar.The container provides REST-based query prediction endpoint APIs. Yayımlanan (hazırlama veya üretim) uygulamalarının uç noktaları, sürümlü uygulamalar için uç noktalardan farklı bir rotaya sahiptir.Endpoints for published (staging or production) apps have a different route than endpoints for versioned apps.

Kapsayıcı API’leri için http://localhost:5000 konağını kullanın.Use the host, http://localhost:5000, for container APIs.

Paket türüPackage type HTTP fiiliHTTP verb YolRoute Sorgu parametreleriQuery parameters
YayımlanmışPublished AL, POSTALAGET, POST /luis/v3.0/apps/{appId}/slots/{slotName}/predict? query={query}
[&verbose][&verbose]
[&log][&log]
[&show-all-intents][&show-all-intents]
SürümüVersioned AL, POSTALAGET, POST /luis/v3.0/apps/{appId}/versions/{versionId}/predict? query={query}
[&verbose][&verbose]
[&log][&log]
[&show-all-intents][&show-all-intents]

Sorgu parametreleri, sorgu yanıtında nasıl ve neyin döndürüleceğini yapılandırır:The query parameters configure how and what is returned in the query response:

Sorgu parametresiQuery parameter TürType AmaçPurpose
query stringstring Kullanıcının utterliği.The user's utterance.
verbose booleanboolean Tahmin edilen modeller için tüm meta verilerin döndürülüp döndürülmeyeceğini belirten bir Boole değeri.A boolean value indicating whether to return all the metadata for the predicted models. Varsayılan değer false’tur.Default is false.
log booleanboolean Daha sonra etkin öğrenmeiçin kullanılabilen sorguları günlüğe kaydeder.Logs queries, which can be used later for active learning. Varsayılan değer false’tur.Default is false.
show-all-intents booleanboolean Yalnızca tüm amaçlar veya en üst Puanlama hedefinin döndürülüp döndürülmeyeceğini belirten bir Boole değeri.A boolean value indicating whether to return all the intents or the top scoring intent only. Varsayılan değer false’tur.Default is false.

LUSıS uygulamasını sorgulamaQuery the LUIS app

Yayımlanmış bir uygulama için kapsayıcıyı sorgulamak üzere örnek bir KıVRıMLı komutu:An example CURL command for querying the container for a published app is:

Bir yuvada bir modeli sorgulamak için aşağıdaki API 'yi kullanın:To query a model in a slot, use the following API:

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 sorgu yapmak için, production rotada şunu ile değiştirin staging :To make queries to the Staging environment, replace production in the route with staging:

http://localhost:5000/luis/v3.0/apps/{APP_ID}/slots/staging/predict

Sürümlü bir modeli sorgulamak için aşağıdaki API 'yi kullanın:To query a versioned model, use the following API:

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 aktarmaImport the endpoint logs for active learning

LUSıS kapsayıcısı için bir çıkış bağlaması belirtilmişse, uygulama sorgusu günlük dosyaları çıkış dizinine kaydedilir; burada {INSTANCE_ID} KAPSAYıCı kimliği olur.If an output mount is specified for the LUIS container, app query log files are saved in the output directory, where {INSTANCE_ID} is the container ID. Uygulama sorgu günlüğü, LUO kapsayıcısına gönderilen her bir tahmin sorgusunun sorgusunu, yanıtını ve zaman damgalarını içerir.The app query log contains the query, response, and timestamps for each prediction query submitted to the LUIS container.

Aşağıdaki konum kapsayıcının günlük dosyaları için iç içe dizin yapısını gösterir.The following location shows the nested directory structure for the container's log files.

/output/luis/{INSTANCE_ID}/

LUU portalından, uygulamanızı seçin ve ardından bu günlükleri karşıya yüklemek için uç nokta günlüklerini Içeri aktar ' ı seçin.From the LUIS portal, select your app, then select Import endpoint logs to upload these logs.

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

Günlük karşıya yüklendikten sonra, LUı portalındaki uç nokta utslerini gözden geçirin .After the log is uploaded, review the endpoint utterances in the LUIS portal.

Bir kapsayıcının çalıştığını doğrulamaValidate that a container is running

Kapsayıcının çalıştığını doğrulamak için birkaç yol vardır.There are several ways to validate that the container is running. Dış IP adresini ve söz konusu kapsayıcının bağlantı noktasını bulun ve en sevdiğiniz web tarayıcınızı açın.Locate the External IP address and exposed port of the container in question, and open your favorite web browser. Kapsayıcının çalıştığını doğrulamak için aşağıdaki çeşitli istek URL 'Lerini kullanın.Use the various request URLs below to validate the container is running. Aşağıda listelenen örnek URL 'Ler aşağıda verilmiştir http://localhost:5000 ancak belirli Kapsayıcınız farklılık gösterebilir.The example request URLs listed below are http://localhost:5000, but your specific container may vary. Kapsayıcının dış IP adresine ve açığa çıkarılan bağlantı noktasına güvendiğini aklınızda bulundurun.Keep in mind that you're to rely on your container's External IP address and exposed port.

İstek URL’siRequest URL AmaçPurpose
http://localhost:5000/ Kapsayıcı bir giriş sayfası sağlar.The container provides a home page.
http://localhost:5000/ready GET ile istendi, bu, kapsayıcının modelde bir sorgu kabul etmeye hazırlandığından emin olmak için bir doğrulama sağlar.Requested with GET, this provides a verification that the container is ready to accept a query against the model. Bu istek, Kubernetes limize ve hazırlık araştırmalarıiçin kullanılabilir.This request can be used for Kubernetes liveness and readiness probes.
http://localhost:5000/status GET ile de istenirse, bu, 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.Also requested with GET, this verifies if the api-key used to start the container is valid without causing an endpoint query. Bu istek, Kubernetes limize ve hazırlık araştırmalarıiçin kullanılabilir.This request can be used for Kubernetes liveness and readiness probes.
http://localhost:5000/swagger Kapsayıcı, uç noktalar ve bir deneyin özelliği için tam bir belge kümesi sağlar.The container provides a full set of documentation for the endpoints and a Try it out feature. Bu özellikle, ayarlarınızı bir Web tabanlı HTML biçiminde girebilir ve herhangi bir kod yazmak zorunda kalmadan sorguyu oluşturabilirsiniz.With this feature, you can enter your settings into a web-based HTML form and make the query without having to write any code. Sorgu çağrıldıktan sonra, gereken HTTP üst bilgilerini ve gövde biçimini göstermek için örnek bir KıVRıMLı komut sağlanır.After the query returns, an example CURL command is provided to demonstrate the HTTP headers and body format that's required.

Kapsayıcının ana sayfası

Kapsayıcıyı durdurmaStop the container

Kapsayıcıyı kapatmak için kapsayıcının çalıştığı komut satırı ortamında CTRL + Ctuşlarına basın.To shut down the container, in the command-line environment where the container is running, press Ctrl+C.

Sorun gidermeTroubleshooting

Kapsayıcıyı bir çıkış bağlaması ve günlüğü etkin olarak çalıştırırsanız kapsayıcı, kapsayıcıyı başlatırken veya çalıştırırken oluşan sorunları gidermek için yararlı olan günlük dosyaları oluşturur.If you run the container with an output mount and logging enabled, the container generates log files that are helpful to troubleshoot issues that happen while starting or running the container.

İpucu

Daha fazla sorun giderme bilgisi ve Kılavuzu için bkz. bilişsel Hizmetler kapsayıcıları hakkında sık sorulan sorular (SSS).For more troubleshooting information and guidance, see Cognitive Services containers frequently asked questions (FAQ).

FaturalandırmaBilling

LUSıS kapsayıcısı, Azure hesabınızdaki bilişsel Hizmetler kaynağını kullanarak faturalandırma bilgilerini Azure 'a gönderir.The LUIS container sends billing information to Azure, using a Cognitive Services resource on your Azure account.

Kapsayıcıya yönelik sorgular, ApiKeyIçin kullanılan Azure kaynağının fiyatlandırma katmanında faturalandırılır.Queries to the container are billed at the pricing tier of the Azure resource that's used for the ApiKey.

Azure bilişsel hizmetler kapsayıcıları, ölçüm/faturalandırma uç noktasına bağlı kalmadan çalıştırılmak üzere lisanslanmaz.Azure Cognitive Services containers aren't licensed to run without being connected to the metering / billing endpoint. Her zaman Faturalandırma bitiş noktasıyla faturalandırma bilgilerini iletmek için kapsayıcıları etkinleştirmeniz gerekir.You must enable the containers to communicate billing information with the billing endpoint at all times. Bilişsel hizmetler kapsayıcıları, müşteri verilerini (örneğin, çözümlenen resim veya metin gibi) Microsoft 'a göndermez.Cognitive Services containers don't send customer data, such as the image or text that's being analyzed, to Microsoft.

Azure'a BağlanmaConnect to Azure

Kapsayıcının çalışması için faturalandırma bağımsız değişken değerlerinin olması gerekir.The container needs the billing argument values to run. Bu değerler kapsayıcının faturalandırma uç noktasına bağlanmasına izin verir.These values allow the container to connect to the billing endpoint. Kapsayıcı her 10 ila 15 dakikada bir kullanım raporu sağlar.The container reports usage about every 10 to 15 minutes. Kapsayıcı, izin verilen zaman penceresinde Azure 'a bağlanmazsa, kapsayıcı çalışmaya devam eder, ancak faturalandırma uç noktası geri yüklenene kadar sorgu hizmeti vermez.If the container doesn't connect to Azure within the allowed time window, the container continues to run but doesn't serve queries until the billing endpoint is restored. Bağlantı, 10 ila 15 dakika aynı zaman aralığında 10 kez denenir.The connection is attempted 10 times at the same time interval of 10 to 15 minutes. 10 deneciler içindeki faturalandırma uç noktasına bağlanamıyorsa kapsayıcı, istekleri sunmaya yanıt vermez.If it can't connect to the billing endpoint within the 10 tries, the container stops serving requests.

Faturalandırma bağımsız değişkenleriBilling arguments

Aşağıdaki seçeneklerden üçü de geçerli değerlerle sağlandığında komut kapsayıcıyı başlatır: docker run The docker run command will start the container when all three of the following options are provided with valid values:

SeçenekOption AçıklamaDescription
ApiKey Fatura bilgilerini izlemek için kullanılan bilişsel hizmetler kaynağının API anahtarı.The API key of the Cognitive Services resource that's used to track billing information.
Bu seçeneğin değeri, içinde Billingbelirtilen sağlanan kaynak IÇIN bir API anahtarı olarak ayarlanmalıdır.The value of this option must be set to an API key for the provisioned resource that's specified in Billing.
Billing Fatura bilgilerini izlemek için kullanılan bilişsel hizmetler kaynağının uç noktası.The endpoint of the Cognitive Services resource that's used to track billing information.
Bu seçeneğin değeri, sağlanan bir Azure kaynağının uç nokta URI 'sine ayarlanmalıdır.The value of this option must be set to the endpoint URI of a provisioned Azure resource.
Eula Kapsayıcının lisansını kabul ettiğinizi gösterir.Indicates that you accepted the license for the container.
Bu seçeneğin değeri kabuledilecek şekilde ayarlanmalıdır.The value of this option must be set to accept.

Bu seçenekler hakkında daha fazla bilgi için bkz. kapsayıcıları yapılandırma.For more information about these options, see Configure containers.

Blog yazılarıBlog posts

Geliştirici örnekleriDeveloper samples

Geliştirici örnekleri, GitHub deponuzdabulunabilir.Developer samples are available at our GitHub repository.

Web semineri görüntüleView webinar

Hakkında bilgi edinmek için Web seminerine katılın:Join the webinar to learn about:

  • Bilişsel hizmetler 'i Docker kullanarak herhangi bir makineye dağıtmaHow to deploy Cognitive Services to any machine using Docker
  • Bilişsel hizmetler 'i AKS 'e dağıtmaHow to deploy Cognitive Services to AKS

ÖzetSummary

Bu makalede, Language Understanding (LUSıS) kapsayıcıları indirmek, yüklemek ve çalıştırmak için kavramları ve iş akışını öğrendiniz.In this article, you learned concepts and workflow for downloading, installing, and running Language Understanding (LUIS) containers. Özet:In summary:

  • Language Understanding (LUSıS), Docker için uç nokta sorgu tahminleri sağlayan bir Linux kapsayıcısı sağlar.Language Understanding (LUIS) provides one Linux container for Docker providing endpoint query predictions of utterances.
  • Kapsayıcı görüntüleri Microsoft Container Registry (MCR) ile indirilir.Container images are downloaded from the Microsoft Container Registry (MCR).
  • Kapsayıcı görüntüleri Docker 'da çalışır.Container images run in Docker.
  • Kapsayıcının ana bilgisayar URI 'sini belirterek kapsayıcı uç noktalarını sorgulamak için REST API kullanabilirsiniz.You can use REST API to query the container endpoints by specifying the host URI of the container.
  • Bir kapsayıcıyı örnekledikten sonra faturalandırma bilgilerini belirtmeniz gerekir.You must specify billing information when instantiating a container.

Önemli

Bilişsel hizmetler kapsayıcıları, ölçüm için Azure 'a bağlı kalmadan çalıştırılmak üzere lisanslanmaz.Cognitive Services containers are not licensed to run without being connected to Azure for metering. Müşterilerin, ödeme bilgilerini her zaman ölçüm hizmetiyle iletişimine olanak tanımak için kapsayıcıların etkinleştirilmesi gerekir.Customers need to enable the containers to communicate billing information with the metering service at all times. Bilişsel hizmetler kapsayıcıları, müşteri verilerini (örneğin, çözümlenmekte olan resim veya metin) Microsoft 'a göndermez.Cognitive Services containers do not send customer data (for example, the image or text that is being analyzed) to Microsoft.

Sonraki adımlarNext steps