Yükleme ve LUIS docker kapsayıcılarını çalıştırınInstall and run LUIS docker containers

Language Understanding (LUIS) kapsayıcı eğitilen veya yayımlanmış Language Understanding modelinizi yüklendiğinde, ayrıca olarak bilmeniz bir LUIS uygulaması, docker kapsayıcısı ve erişim için sorgu Öngörüler kapsayıcının API'SİNDEN sağlar. uç noktaları.The Language Understanding (LUIS) container loads your trained or published Language Understanding model, also know as a LUIS app, into a docker container and provides access to the query predictions from the container's API endpoints. Kapsayıcıdan sorgu günlükleri toplayıp, uygulamanın tahmin doğruluğunu artırmak için Language Understanding uygulamasına bu geri yükleyin.You can collect query logs from the container and upload these back to the Language Understanding app to improve the app's prediction accuracy.

Aşağıdaki video, bu kapsayıcı kullanmayı gösterir.The following video demonstrates using this container.

Bilişsel hizmetler için kapsayıcı TanıtımıContainer 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

LUIS kapsayıcıyı çalıştırmak için aşağıdakilere sahip olmanız gerekir:In order to run the LUIS container, you must have the following:

GerekliRequired AmaçPurpose
Docker altyapısıDocker Engine Docker Altyapısı'nın kurulu ihtiyacınız bir ana bilgisayar.You need the Docker Engine installed on a host computer. Docker üzerinde Docker ortamını yapılandıran paketler sağlar macOS, Windows, ve Linux.Docker provides packages that configure the Docker environment on macOS, Windows, and Linux. Docker ve kapsayıcı temelleri hakkında bilgi için bkz: Docker'a genel bakış.For a primer on Docker and container basics, see the Docker overview.

Docker, kapsayıcılar ile bağlanma ve faturalama verileri Azure'a göndermek izin verecek şekilde yapılandırılmalıdır.Docker must be configured to allow the containers to connect with and send billing data to Azure.

Windows üzerinde, Docker de Linux kapsayıcıları destekler şekilde yapılandırılmalıdır.On Windows, Docker must also be configured to support Linux containers.

Docker ile aşinalıkFamiliarity with Docker Bir temel kavramlarını Docker kayıt defterleri, havuzları, kapsayıcılar ve kapsayıcı görüntülerinin yanı sıra temel bilgi gibi olmalıdır docker komutları.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 kaynak ve LUIS paket uygulama dosyasıAzure Cognitive Services resource and LUIS packaged app file Kapsayıcı kullanabilmeniz için şunlara sahip olmalısınız:In order to use the container, you must have:

* A Bilişsel Hizmetler anahtar Azure kaynak ve ilişkili faturalama, fatura uç noktası URI'si.* A Cognitive Services Azure resource and the associated billing key the billing endpoint URI. Her iki değer kaynağın genel bakış ve anahtarları sayfalarında kullanılabilir ve kapsayıcı başlatma için gereklidir.Both values are available on the Overview and Keys pages for the resource and are required to start the container. Eklemenize gerek luis/v2.0 BILLING_ENDPOINT_URI aşağıda gösterildiği gibi uç nokta URI'si yönlendirme.You need to add the luis/v2.0 routing to the endpoint URI as shown in the following BILLING_ENDPOINT_URI example.
* Kapsayıcı ile ilişkili uygulama kimliğini bağlı bir giriş olarak paketlenmiş bir eğitilen veya yayımlanan uygulama* A trained or published app packaged as a mounted input to the container with its associated App ID. LUIS portalı ya da yazma API'leri paket dosyası elde edebilirsiniz.You can get the packaged file from the LUIS portal or the Authoring APIs. LUIS paketlenmiş uygulamadan alıyorsanız yazma API'leri, ayrıca gerekir, yazma anahtar.If you are getting LUIS packaged app from the authoring APIs, you will also need your Authoring Key.

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

{AUTHORING_KEY} : Bu anahtar, paketlenmiş uygulamayı bulutta LUIS hizmetten alma 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.

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

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

{BILLING_ENDPOINT} : Bir örnek verilmiştir: https://westus.api.cognitive.microsoft.com/luis/v2.0.{BILLING_ENDPOINT}: An example is: https://westus.api.cognitive.microsoft.com/luis/v2.0.

Anahtarını ve uç noktası anahtarı yazma farklı amaçları olan.The authoring key and endpoint key have different purposes. Bunları birbirinin yerine kullanmayın.Do not use them interchangeably.

Paket dosyası için API geliştirmeAuthoring APIs for package file

Paketlenmiş uygulamalar için API geliştirme:Authoring APIs for packaged apps:

Ana bilgisayarThe host computer

Konak, Docker kapsayıcısı çalıştıran bir x64 tabanlı bir bilgisayardır.The host is a x64-based computer that runs the Docker container. Bir bilgisayarda şirket içinde veya azure'da Docker barındırma hizmeti gibi olabilir: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

Bu kapsayıcı için ayarları en düşük ve önerilen değerlerini destekler:This container supports minimum and recommended values for the settings:

KapsayıcıContainer MinimumMinimum ÖnerilenRecommended TPSTPS
(Minimum, maksimum)(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 çekirdeğe en az 2.6 gigahertz (GHz) olması ya da daha hızlı.Each core must be at least 2.6 gigahertz (GHz) or faster.
  • TPS - saniye başına işlemTPS - transactions per second

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

İle kapsayıcı görüntüsünü Al docker pullGet the container image with docker pull

Kullanım docker pull bir kapsayıcı görüntüsünü indirmek için komut mcr.microsoft.com/azure-cognitive-services/luis depo: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

Kullanım docker pull komutu, kapsayıcı görüntüsü indirilemedi.Use the docker pull command to download a container image.

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

İpucu

Kullanabileceğiniz docker görüntüleri indirilen kapsayıcı görüntülerinizi listelemek için komutu.You can use the docker images command to list your downloaded container images. Örneğin, aşağıdaki komut kimliği, havuz ve tablo olarak biçimlendirilmiş her indirilen kapsayıcı görüntüsünün etiketi listeler: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ı kullanmaHow to use the container

Kapsayıcı açıldığında ana bilgisayar, kapsayıcı ile ç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 (LUIS) kapsayıcı kullanma işlemini

  1. Paketi dışarı aktar LUIS portalını veya API'lerini LUIS kapsayıcısından için.Export package for container from LUIS portal or LUIS APIs.
  2. Paket dosyası gerekli Taşı giriş dizininde ana bilgisayar.Move package file into the required input directory on the host computer. Yeniden adlandırmayın, alter, üzerine veya LUIS paket dosyası açılamadı.Do not rename, alter, overwrite, or decompress LUIS package file.
  3. Kapsayıcıyı çalıştırmak, gerekli olan giriş bağlama ve faturalama ayarları.Run the container, with the required input mount and billing settings. Daha fazla örnekler , docker run komutu kullanılabilir.More examples of the docker run command are available.
  4. Kapsayıcının tahmini uç nokta sorgulama.Querying the container's prediction endpoint.
  5. Kapsayıcıyla işiniz bittiğinde uç nokta günlükleri içeri aktarma çıktısı LUIS Portalı'nda bağlama ve Durdur kapsayıcı.When you are done with the container, import the endpoint logs from the output mount in the LUIS portal and stop the container.
  6. Kullanım LUIS portal'ın etkin olarak öğrenmeye üzerinde gözden geçirin, konuşma uç noktası uygulama geliştirmek için sayfa.Use LUIS portal's active learning on the Review endpoint utterances page to improve the app.

Kapsayıcı içinde çalışan uygulama değiştirilemez.The app running in the container can't be altered. İçinde kapsayıcı uygulamada değişiklik sipariş, hizmet LUIS kullanarak uygulamayı değiştirmeniz gerekir LUIS portalı veya kullanım LUIS yazma API'leri.In order the 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. Ardından eğitmek ve/veya yayımlama, ardından yeni bir paket indirip kapsayıcı yeniden çalıştırın.Then train and/or publish, then download a new package and run the container again.

Kapsayıcı içinde LUIS uygulaması LUIS hizmetine dışarı aktarılamaz.The LUIS app inside the container can't be exported back to the LUIS service. Yalnızca sorgu günlüklerini karşıya yüklenebilir.Only the query logs can be uploaded.

Paket uygulama LUIS ' dışarı aktarmaExport packaged app from LUIS

LUIS kapsayıcı kullanıcı konuşma tahmin sorguları yanıtlamak için eğitilen veya yayımlanmış LUIS uygulaması gerektirir.The LUIS container requires a trained or published LUIS app to answer prediction queries of user utterances. LUIS uygulaması alabilmek için ya da eğitilen veya yayımlanan paket API kullanın.In order to get the LUIS app, use either the trained or published package API.

Varsayılan konum input çalıştırdığınız ile ilgili alt docker run komutu.The default location is the input subdirectory in relation to where you run the docker run command.

Paket dosyası bir dizine yerleştirin ve docker kapsayıcısı'nı çalıştırdığınızda bu dizin giriş bağlama 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 directory içerebilir üretim, hazırlama, ve Trained uygulamasının sürümleri aynı anda.The input mount directory can contain the Production, Staging, and Trained versions of the app simultaneously. Tüm paketleri bağlanır.All the packages are mounted.

Paket türüPackage Type Sorgu uç API'siQuery Endpoint API Sorgu kullanılabilirlikQuery availability Paket dosya adı biçimiPackage filename format
EğitimTrained GET, PostGet, Post Kapsayıcı yalnızcaContainer only {APPLICATION_ID}_v{APPLICATION_VERSION}.gz
StagingStaging GET, PostGet, Post Azure ve kapsayıcıAzure and container {APPLICATION_ID}_STAGING.gz
ÜretimProduction GET, PostGet, Post Azure ve kapsayıcıAzure and container {APPLICATION_ID}_PRODUCTION.gz

Önemli

Yeniden adlandırmayın, alter, üzerine veya LUIS paket dosyaları açılamadı.Do not rename, alter, overwrite, or decompress the LUIS package files.

Paketleme önkoşullarıPackaging prerequisites

Bir LUIS uygulaması paketleme ö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ölgeleri içerirSupported 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ımlanmış LUIS uygulamasıTrained or published LUIS app Olmadan desteklenmeyen bağımlılıkları.With no unsupported dependencies.
Erişim ana bilgisayarait dosya sistemiAccess to the host computer's file system Ana bilgisayar izin vermelidir bir giriş bağlama.The host computer must allow an input mount.

LUIS Portalı'ndan uygulama paketini Dışarı AktarExport app package from LUIS portal

LUIS portalı eğitilen veya yayımlanmış uygulama paketi verme olanağı sağlar.The LUIS portal provides the ability to export the trained or published app's package.

LUIS Portalı'ndan yayımlanan uygulamanın paketini Dışarı AktarExport published app's package from LUIS portal

Yayımlanan uygulamanın paket kullanılabilir uygulamalarım listesi sayfası.The published app's package is available from the My Apps list page.

  1. LUIS için oturum açma portalı.Sign on to the LUIS portal.
  2. Listeden uygulama adının sol tarafındaki onay kutusunu seçin.Select the checkbox to the left of the app name in the list.
  3. Seçin dışarı bağlamsal listesinin üstündeki araç çubuğundan öğesi.Select the Export item from the contextual toolbar above the list.
  4. Seçin dışarı aktarmak için kapsayıcı (GZIP) .Select Export for container (GZIP).
  5. Ortamını seçin üretim yuvasına veya hazırlama yuvası.Select the environment of Production slot or Staging slot.
  6. Paket tarayıcıdan yüklenir.The package is downloaded from the browser.

Yayımlanan paket kapsayıcısı için uygulama sayfanın verme Menüsü'nden dışarı aktarma

LUIS Portalı'ndan eğitilen uygulamanın paketini Dışarı AktarExport trained app's package from LUIS portal

Eğitilen uygulamanın paket kullanılabilir sürümleri listesi sayfası.The trained app's package is available from the Versions list page.

  1. LUIS için oturum açma portalı.Sign on to the LUIS portal.
  2. Uygulamayı listeden seçin.Select the app in the list.
  3. Seçin Yönet uygulamanın Gezinti çubuğundaki.Select Manage in the app's navigation bar.
  4. Seçin sürümleri sol gezinti çubuğundaki.Select Versions in the left navigation bar.
  5. Listeden sürüm adının sol tarafındaki onay kutusunu seçin.Select the checkbox to the left of the version name in the list.
  6. Seçin dışarı bağlamsal listesinin üstündeki araç çubuğundan öğesi.Select the Export item from the contextual toolbar above the list.
  7. Seçin dışarı aktarmak için kapsayıcı (GZIP) .Select Export for container (GZIP).
  8. Paket tarayıcıdan yüklenir.The package is downloaded from the browser.

Kapsayıcı için eğitilen paket sürümleri sayfanın verme Menüsü'nden dışarı aktarma

API'SİNDEN yayımlanan uygulamanın paketini Dışarı AktarExport published app's package from API

Aşağıdaki REST API yöntemi, seçtiğiniz bir LUIS uygulaması paketi kullanılacağını zaten yayımlanan.Use the following REST API method, to package a LUIS app that you've already published. İçin HTTP belirtimini aşağıdaki tabloyu kullanarak API çağrısı içindeki yer tutucuları kendi uygun değerleri değiştirerek.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/{APPLICATION_ID}/slot/{APPLICATION_ENVIRONMENT}/gzip HTTP/1.1
Host: {AZURE_REGION}.api.cognitive.microsoft.com
Ocp-Apim-Subscription-Key: {AUTHORING_KEY}
Yer tutucuPlaceholder DeğerValue
{APPLICATION_ID}{APPLICATION_ID} Yayımlanan LUIS uygulaması uygulama kimliği.The application ID of the published LUIS app.
{APPLICATION_ENVIRONMENT}{APPLICATION_ENVIRONMENT} Yayımlanan LUIS uygulaması 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} LUIS hesabı yayımlanan LUIS uygulaması için geliştirme anahtarı.The authoring key of the LUIS account for the published LUIS app.
Yazma anahtarınızdan alabilirsiniz kullanıcı ayarları LUIS portalı sayfasında.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ımlanan paket indirmek için lütfen başvurmak API belgelerine.To download the published package, please refer to the API documentation here. Başarıyla indirildi, yanıt bir LUIS paket dosyası olur.If successfully downloaded, the response is a LUIS package file. Kapsayıcının giriş bağlaması için belirtilen depolama konumunda dosyayı kaydedin.Save the file in the storage location specified for the input mount of the container.

API'SİNDEN eğitilen uygulamanın paketini Dışarı AktarExport trained app's package from API

Seçtiğiniz bir LUIS uygulama paketi için aşağıdaki REST API yöntemi kullanın zaten eğitilen.Use the following REST API method, to package a LUIS application that you've already trained. İçin HTTP belirtimini aşağıdaki tabloyu kullanarak API çağrısı içindeki yer tutucuları kendi uygun değerleri değiştirerek.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/{APPLICATION_ID}/versions/{APPLICATION_VERSION}/gzip HTTP/1.1
Host: {AZURE_REGION}.api.cognitive.microsoft.com
Ocp-Apim-Subscription-Key: {AUTHORING_KEY}
Yer tutucuPlaceholder DeğerValue
{APPLICATION_ID}{APPLICATION_ID} Eğitilen LUIS uygulamasının uygulama kimliği.The application ID of the trained LUIS application.
{APPLICATION_VERSION}{APPLICATION_VERSION} Eğitilen LUIS uygulamasının uygulama sürümü.The application version of the trained LUIS application.
{AUTHORING_KEY}{AUTHORING_KEY} LUIS hesabı yayımlanan LUIS uygulaması için geliştirme anahtarı.The authoring key of the LUIS account for the published LUIS app.
Yazma anahtarınızdan alabilirsiniz kullanıcı ayarları LUIS portalı sayfasında.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

Eğitilen paketini indirmek için lütfen başvurmak API belgelerine.To download the trained package, please refer to the API documentation here. Başarıyla indirildi, yanıt bir LUIS paket dosyası olur.If successfully downloaded, the response is a LUIS package file. Kapsayıcının giriş bağlaması için belirtilen depolama konumunda dosyayı kaydedin.Save the file in the storage location specified for the input mount of the container.

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

Kullanım docker run kapsayıcıyı çalıştırmak için komutu.Use the docker run command to run the container. Komutu şu parametreleri kullanır:The command uses the following parameters:

Yer tutucuPlaceholder DeğerValue
{ENDPOINT_KEY}{ENDPOINT_KEY} Bu anahtar kapsayıcısı başlatmak için kullanılır.This key is used to start the container. Başlangıç anahtarı kullanmayın.Do not use the starter key.
{BILLING_ENDPOINT}{BILLING_ENDPOINT} Azure portal üzerinde fatura uç nokta değerinde kullanılabilir Cognitive Services genel bakış sayfası.The billing endpoint value is available on the Azure portal's Cognitive Services Overview page. Eklemenize gerek luis/v2.0 aşağıdaki örnekte gösterildiği gibi uç nokta URI'si yönlendirme: https://westus.api.cognitive.microsoft.com/luis/v2.0.You need to add the luis/v2.0 routing to the endpoint URI as shown in the following example: https://westus.api.cognitive.microsoft.com/luis/v2.0.

Bu parametreleri aşağıdaki örnekte kendi değerlerinizle değiştirin docker run komutu.Replace these parameters with your own values in the following example docker run command. Komutu Windows konsolunda çalıştırın.Run the command in the Windows console.

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={BILLING_ENDPOINT} ^
ApiKey={ENDPOINT_KEY}
  • Bu örnek dizin aracınızdan C: sürücü Windows üzerinde hiçbir izni çakışmalarını önlemek için.This example uses the directory off the C: drive to avoid any permission conflicts on Windows. Giriş dizini belirli bir dizini kullanmak istiyorsanız, docker vermeniz gerekebilir hizmet izni.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ı ile çok iyi bilmiyorsanız, bağımsız değişkenlerin sırası değiştirmeyin.Do not change the order of the arguments unless you are very familiar with docker containers.
  • Farklı bir işletim sistemi kullanıyorsanız, başlatmalar ve satır devamı karakteri sisteminiz için doğru konsol/terminal, klasörü söz dizimi 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 örnekler bir satır devamı karakteri ile bir Windows konsol varsayar ^.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özdizimini kullanır.Because the container is a Linux operating system, the target mount uses a Linux-style folder syntax.

Bu komut:This command:

  • Bir kapsayıcı LUIS kapsayıcı görüntüsünü çalıştırır.Runs a container from the LUIS container image
  • LUIS uygulaması c:\input, kapsayıcı konağı üzerinde bulunan, giriş bağlama yüklerLoads LUIS app from input mount at c:\input, located on container host
  • İki CPU çekirdek ve 4 gigabayt (GB) bellek ayırır.Allocates two CPU cores and 4 gigabytes (GB) of memory
  • 5000 numaralı TCP bağlantı noktasını kullanıma sunar ve sahte TTY için kapsayıcı ayırır.Exposes TCP port 5000 and allocates a pseudo-TTY for the container
  • Kapsayıcı ve LUIS bağlama c:\output, kapsayıcı konağı üzerinde bulunan, çıkış günlüklerini kaydeder.Saves container and LUIS logs to output mount at c:\output, located on container host
  • Bunu çıktıktan sonra kapsayıcı otomatik olarak kaldırır.Automatically removes the container after it exits. Kapsayıcı görüntüsü ana bilgisayarda kullanılabilir durumda kalır.The container image is still available on the host computer.

Daha fazla örnekler , docker run komutu kullanılabilir.More examples of the docker run command are available.

Önemli

Eula, Billing, Ve ApiKey kapsayıcıyı çalıştırmak için seçenekler belirtilmelidir; Aksi takdirde, kapsayıcı başlatılamıyor.The Eula, Billing, and ApiKey options must be specified to run the container; otherwise, the container won't start. Daha fazla bilgi için faturalama.For more information, see Billing. ApiKey değer anahtarı anahtarları ve uç noktaları sayfasında LUIS portalda ve Azure üzerinde kullanılabilir Cognitive Services kaynak anahtarlar sayfasında.The ApiKey value is the Key from the Keys and Endpoints page in the LUIS portal and is also available on the Azure Cognitive Services resource keys page.

Aynı ana bilgisayarda birden çok kapsayıcı çalıştırmaRun multiple containers on the same host

Kullanıma sunulan bağlantı noktası olan birden çok kapsayıcı çalıştırmak istiyorsanız, her kapsayıcı farklı bir kullanıma sunulan bağlantı noktası ile çalıştırmak 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, ilk kapsayıcı bağlantı noktası 5000 ve ikinci kapsayıcıyı 5001 bağlantı noktası üzerinde çalıştırın.For example, run the first container on port 5000 and the second container on port 5001.

Bu kapsayıcı ve KONAKTA birlikte çalışan farklı Azure Bilişsel hizmetler kapsayıcı olabilir.You can have this container and a different Azure Cognitive Services container running on the HOST together. Aynı Bilişsel hizmetler kapsayıcıyı, birden çok kapsayıcı da olabilir.You also can have multiple containers of the same Cognitive Services container running.

Kapsayıcı tarafından desteklenen API uç noktasıEndpoint APIs supported by the container

Her iki V2 ve V3 (Önizleme) kapsayıcı ile API sürümlerinde kullanılabilir.Both V2 and V3 (Preview) versions of the API are available with the container.

Sorgu kapsayıcının tahmini uç noktasıQuery the container's prediction endpoint

Kapsayıcı, REST tabanlı sorgu tahmin uç nokta API'leri sağlar.The container provides REST-based query prediction endpoint APIs. Uç noktaları (hazırlık veya üretim) yayımlanan uygulamalar için bir farklı daha eğitilen uygulamalar için uç nokta yolu.Endpoints for published (staging or production) apps have a different route than endpoints for trained apps.

Ana bilgisayarını kullanmak https://localhost:5000, kapsayıcı API'leri için.Use the host, https://localhost:5000, for container APIs.

Paket türüPackage type YöntemMethod YolRoute Sorgu parametreleriQuery parameters
YayımlanmışPublished Alma, sonrasıGet, Post /luis/v2.0/apps/{appId}?/luis/v2.0/apps/{appId}? q={q}q={q}
& hazırlama&staging
[& timezoneOffset][&timezoneOffset]
[& ayrıntılı][&verbose]
[& günlük][&log]
EğitimTrained GET, PostGet, Post /luis/v2.0/apps/{appId}/versions/{versionId}?/luis/v2.0/apps/{appId}/versions/{versionId}? q={q}q={q}
[& timezoneOffset][&timezoneOffset]
[& ayrıntılı][&verbose]
[& günlük][&log]

Sorgu parametrelerini yapılandırma nasıl ve ne sorgu yanıtına döndürülür:The query parameters configure how and what is returned in the query response:

Sorgu parametresiQuery parameter TürType AmaçPurpose
q stringstring Kullanıcının utterance.The user's utterance.
timezoneOffset numbernumber TimezoneOffset sağlar saat dilimini değiştirme önceden oluşturulmuş varlık datetimeV2 tarafından kullanılır.The timezoneOffset allows you to change the timezone used by the prebuilt entity datetimeV2.
verbose booleanboolean Tüm amaçlar ve ayarlandığında puanlarını döndürür true.Returns all intents and their scores when set to true. Yalnızca üst hedefini döndüren varsayılan false değeridir.Default is false, which returns only the top intent.
staging booleanboolean Ortam sonuçları, hazırlama alanından döndürür sorgu ayarlamak true.Returns query from staging environment results if set to true.
log booleanboolean Sorgular, daha sonra için kullanılabilir günlükleri etkin olarak öğrenmeye.Logs queries, which can be used later for active learning. Varsayılan değer True'dur.Default is true.

Sorgu yayımlanan uygulamaQuery published app

Yayımlanan uygulama için kapsayıcı sorgulamak için CURL komutu bir örnek verilmiştir:An example CURL command for querying the container for a published app is:

curl -X GET \
"http://localhost:5000/luis/v2.0/apps/{APPLICATION_ID}?q=turn%20on%20the%20lights&staging=false&timezoneOffset=0&verbose=false&log=true" \
-H "accept: application/json"

Sorgular için hazırlama ortamı, değişiklik hazırlama sorgu dizesi parametresinin değerini true:To make queries to the Staging environment, change the staging query string parameter value to true:

staging=true

Sorgu eğitilen uygulamaQuery trained app

Eğitilen bir uygulaması için kapsayıcı sorgulamak için CURL komutu bir örnek verilmiştir:An example CURL command for querying the container for a trained app is:

curl -X GET \
"http://localhost:5000/luis/v2.0/apps/{APPLICATION_ID}/versions/{APPLICATION_VERSION}?q=turn%20on%20the%20lights&timezoneOffset=0&verbose=false&log=true" \
-H "accept: application/json"

Sürüm adı en fazla 10 karakter sahiptir ve yalnızca bir URL'de izin verilen karakterler içeriyor.The version name has a maximum of 10 characters and contains only characters allowed in a URL.

Etkin öğrenme için uç nokta günlüklerini almaImport the endpoint logs for active learning

LUIS kapsayıcı için çıktı bağlama belirtilirse, uygulama sorgu günlük dosyaları burada kapsayıcı kimliği {INSTANCE_ID}, çıkış dizinine kaydedilirIf 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üğü sorgu, yanıt ve LUIS kapsayıcıya gönderilen her tahmin sorgusu zaman içerir.The app query log contains the query, response, and timestamps for each prediction query submitted to the LUIS container.

Şu konuma kapsayıcının günlük dosyaları için iç içe geçmiş dizin yapısını gösterir.The following location shows the nested directory structure for the container's log files.

/output/luis/{INSTANCE_ID}/

LUIS Portalı'ndan uygulamanızı seçip içe uç nokta günlükleri Bu günlükleri karşıya yüklemek için.From the LUIS portal, select your app, then select Import endpoint logs to upload these logs.

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

Günlük karşıya yüklendikten sonra uç nokta gözden LUIS portalında konuşma.After the log is uploaded, review the endpoint utterances in the LUIS portal.

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

Kapsayıcının çalışır durumda olduğunu doğrulamak için birkaç yolu vardır.There are several ways to validate that the container is running.

İstekRequest AmaçPurpose
http://localhost:5000/ Kapsayıcı, bir giriş sayfası sağlar.The container provides a home page.
http://localhost:5000/status Bir uç nokta sorgu neden olmadan kapsayıcının çalışır durumda olduğunu doğrulamak için GET ile istedi.Requested with GET, to validate that the container is running without causing an endpoint query. Bu istek için Kubernetes kullanılabilir canlılık ve hazırlık araştırmaları.This request can be used for Kubernetes liveness and readiness probes.
http://localhost:5000/swagger Kapsayıcı uç noktaları için tam kümesi sağlar ve bir Try it now özelliği.The container provides a full set of documentation for the endpoints and a Try it now feature. Bu özellik, web tabanlı bir HTML formuna ayarlarınızı girdikten ve herhangi bir kod yazmak zorunda kalmadan sorgunun sağlayın.With this feature, you can enter your settings into a web-based HTML form and make the query without having to write any code. Sorgunun döndürdüğü sonra HTTP üst bilgileri ve gövdesini biçiminde göstermek için gerekli olan bir örnek CURL komutu 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 giriş sayfası

Kapsayıcı DurdurStop the container

Burada kapsayıcı çalışıyor, komut satırı ortamında kapsayıcı kapatmak için basın Ctrl + C.To shut down the container, in the command-line environment where the container is running, press Ctrl+C.

Sorun gidermeTroubleshooting

Kapsayıcı içeren bir çıktı çalıştırırsanız bağlama ve günlüğe kaydetme etkin, kapsayıcı başlatma veya kapsayıcı çalıştırma sırasında gerçekleşen sorunları gidermek yararlı olan günlük dosyalarını 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.

FaturalandırmaBilling

Fatura bilgilerini azure'a, kullanarak LUIS kapsayıcı gönderen bir Bilişsel Hizmetler Azure hesabınız kaynaktaki.The LUIS container sends billing information to Azure, using a Cognitive Services resource on your Azure account.

Kapsayıcıya sorguları için kullanılan bir Azure kaynak fiyatlandırma katmanını faturalandırılır <ApiKey>.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ı, kullanım ölçümü için fatura uç noktasına bağlı olmadan çalıştırmak için lisanslı değil.Azure Cognitive Services containers aren't licensed to run without being connected to the billing endpoint for metering. Kapsayıcılar, her zaman faturalandırma bilgileri fatura uç noktası ile iletişim kurmak 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ı analiz ediliyor, metin ve görüntü gibi müşteri verilerini Microsoft'a gönderme.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ıyı çalıştırmak için fatura bağımsız değişken değerlerini gerekir.The container needs the billing argument values to run. Bu değerler, fatura uç noktaya bağlanmak kapsayıcı sağlar.These values allow the container to connect to the billing endpoint. Kapsayıcı yaklaşık her 10 ila 15 dakika kullanım raporları.The container reports usage about every 10 to 15 minutes. Kapsayıcı izin verilen zaman penceresi içinde Azure'a bağlanamazsa kapsayıcı çalışmaya devam eder, ancak fatura uç noktayı geri yüklenene kadar sorgular görmese.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 kez aynı zaman aralığında 10-15 dakika denenir.The connection is attempted 10 times at the same time interval of 10 to 15 minutes. Bağlantı kurulamıyor fatura uç nokta 10 içinde çalışır, kapsayıcı çalışmayı durdurur.If it can't connect to the billing endpoint within the 10 tries, the container stops running.

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

İçin docker run kapsayıcı başlatmak için komut geçerli değerlerle şunlardan üçünü belirtilmesi gerekir:For the docker run command to start the container, all three of the following options must be specified with valid values:

SeçenekOption AçıklamaDescription
ApiKey Fatura bilgileri izlemek için kullanılan Bilişsel hizmetler kaynağı API anahtarı.The API key of the Cognitive Services resource that's used to track billing information.
Bu seçeneğin değeri, belirtilen sağlanan kaynak için bir API anahtarı ayarlanmalıdır Billing.The value of this option must be set to an API key for the provisioned resource that's specified in Billing.
Billing Bilişsel hizmetler kaynağın faturalandırma bilgileri izlemek için kullanılan uç nokta.The endpoint of the Cognitive Services resource that's used to track billing information.
Bu seçeneğin değeri, sağlanan bir Azure kaynak URI'sini uç noktasına ayarlamanız gerekir.The value of this option must be set to the endpoint URI of a provisioned Azure resource.
Eula Kapsayıcı lisansını kabul gösterir.Indicates that you accepted the license for the container.
Bu seçenek değeri ayarlanmalıdır kabul.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.

Bağımlılıklar için desteklenen latest kapsayıcıSupported dependencies for latest container

2019 yayımlanan en son kapsayıcının / / derleme, destekler:The latest container, released at 2019 //Build, will support:

  • Bing yazım denetimi: Sorgu tahmin noktayla isteklerine &spellCheck=true&bing-spell-check-subscription-key={bingKey} sorgu dizesi parametreleri.Bing spell check: requests to the query prediction endpoint with the &spellCheck=true&bing-spell-check-subscription-key={bingKey} query string parameters. Kullanım Bing yazım denetimi v7 öğretici daha fazla bilgi için.Use the Bing Spell Check v7 tutorial to learn more. Bu özellik kullandıysanız, kapsayıcı utterance Bing yazım denetimi V7 kaynağınıza gönderir.If this feature is used, the container sends the utterance to your Bing Spell Check V7 resource.
  • Yeni bir önceden oluşturulmuş etki alanları: varlıklar, örnek konuşma ve desenleri Kurumsal odaklı bu etki alanları içerir.New prebuilt domains: these enterprise-focused domains include entities, example utterances, and patterns. Bu etki alanlarına kendi kullanımınız için genişletin.Extend these domains for your own use.

Bağımlılıklar için desteklenmeyen latest kapsayıcıUnsupported dependencies for latest container

LUIS uygulamanızı bağımlılıklar desteklenmiyor, şunları yapamaz dışarı aktarmak için kapsayıcı desteklenmeyen özellikler kaldırana kadar.If your LUIS app has unsupported dependencies, you won't be able to export for container until you remove the unsupported features. Kapsayıcı için dışarı aktarmak denediğinizde, kaldırmanız gereken desteklenmeyen özellikler LUIS portalı bildirir.When you attempt to export for container, the LUIS portal reports the unsupported features you need to remove.

Bir LUIS uygulaması, kullanabilir, içermez herhangi birini aşağıdaki bağımlılıkları:You can use a LUIS application if it doesn't include any of the following dependencies:

Desteklenmeyen uygulama yapılandırmalarıUnsupported app configurations AyrıntılarDetails
Desteklenmeyen kapsayıcı kültürlerUnsupported container cultures Felemenkçe (nl-NL)Dutch (nl-NL)
Japonca (ja-JP)Japanese (ja-JP)
Almanca ile desteklenen yalnızca 1.0.2 simgeleştirici.German is only supported with the 1.0.2 tokenizer.
Tüm kültürler için desteklenmeyen varlıklarUnsupported entities for all cultures Anahtar cümlesi tüm kültürler için önceden oluşturulmuş varlıkKeyPhrase prebuilt entity for all cultures
İngilizce (en-US) kültürü için desteklenmeyen varlıklarUnsupported entities for English (en-US) culture GeographyV2 önceden oluşturulmuş varlıklarGeographyV2 prebuilt entities
Konuşma Hazırlama işlemiSpeech priming Dış bağımlılıklar kapsayıcıda desteklenmez.External dependencies are not supported in the container.
Yaklaşım analiziSentiment analysis Dış bağımlılıklar kapsayıcıda desteklenmez.External dependencies are not supported in the container.

Blog yazılarıBlog posts

Geliştirici örnekleriDeveloper samples

Geliştirici Örnekleri kullanıma sunduğumuz GitHub deposu.Developer samples are available at our GitHub repository.

Web seminerini izleyinView webinar

Birleştirme Web Semineri hakkında bilgi edinmek için:Join the webinar to learn about:

  • Bilişsel hizmetler, Docker kullanan herhangi bir makineye dağıtmaHow to deploy Cognitive Services to any machine using Docker
  • Bilişsel hizmetler AKS'ye dağıtmaHow to deploy Cognitive Services to AKS

ÖzetSummary

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

  • Language Understanding (LUIS) Docker sağlayan uç noktası sorgu tahminler konuşma için bir Linux kapsayıcı sağlar.Language Understanding (LUIS) provides one Linux container for Docker providing endpoint query predictions of utterances.
  • Kapsayıcı görüntülerini Microsoft kapsayıcı kayıt defteri (MCR) alanından indirilir.Container images are downloaded from the Microsoft Container Registry (MCR).
  • Docker kapsayıcı görüntüleri çalıştırın.Container images run in Docker.
  • REST API konak kapsayıcısının URI belirterek kapsayıcı uç noktalarını sorgulamak için kullanabilirsiniz.You can use REST API to query the container endpoints by specifying the host URI of the container.
  • Bir kapsayıcı örneği oluşturulurken, fatura bilgilerini belirtmeniz gerekir.You must specify billing information when instantiating a container.

Önemli

Bilişsel hizmetler kapsayıcıları, kullanım ölçümü için Azure'a bağlanmadan çalıştırmak için lisanslanmaz.Cognitive Services containers are not licensed to run without being connected to Azure for metering. Müşteriler, her zaman faturalandırma bilgileri ölçüm hizmeti ile iletişim kurmak kapsayıcıları etkinleştirmeniz gerekiyor.Customers need to enable the containers to communicate billing information with the metering service at all times. Bilişsel hizmetler kapsayıcılar, Microsoft müşteri verilerini (örneğin, görüntü veya metin analiz edilen) göndermeyin.Cognitive Services containers do not send customer data (for example, the image or text that is being analyzed) to Microsoft.

Sonraki adımlarNext steps