安裝和執行適用於 LUIS 的 Docker 容器
重要
LUIS 將於 2025 年 10 月 1 日淘汰，而自 2023 年 4 月 1 日開始，您將無法建立新的 LUIS 資源。 建議移轉 LUIS 應用程式至交談語言理解，以享有產品持續支援和多語言功能的優點。
注意
容器映像位置已在近期變更。 請閱讀本文以查看此容器的更新位置。
容器可讓您在自己的環境中使用 LUIS。 容器非常適合用於特定的安全性和資料控管需求。 在本文中，您將了解如何下載、安裝及執行 LUIS 容器。
語言理解 (LUIS) 容器會載入您已定型或已發佈的語言理解模型。 做為一個 LUIS 應用程式 \(英文\)，Docker 容器能提供從容器 API 端點存取查詢預測。 您可以從這個容器收集查詢記錄，並將其重新上傳至 語言理解語言理解模型，以改善應用程式的預測精確度。
以下影片將示範如何使用此容器。
如果您沒有 Azure 訂用帳戶，請在開始前建立免費帳戶。
必要條件
若要執行 LUIS 容器，請注意下列必要條件：
- 主機電腦上已安裝 Docker \(英文\)。 Docker 必須設定為允許容器與 Azure 連線，以及傳送帳單資料至 Azure。
- 在 Windows 上，也必須將 Docker 設定為支援 Linux 容器。
- 您應該對 Docker 概念有基本的了解。
- 以免費 (F0) 標準 (S) 定價層LUIS 資源。
- 已定型或發佈的應用程式，並封裝為掛接形式連同相關聯的應用程式識別碼輸入容器中。 您可以從「LUIS 入口網站」或「編寫 API」中取得封裝的檔案。 如果您是從編寫API 中取得 LUIS 封裝應用程式，您同時將也需要編寫金鑰。
收集必要參數
所有 Azure AI 容器都需要三個主要參數。 Microsoft 軟體授權條款必須具有「接受」值。 也需要端點 URI 和 API 金鑰。
端點 URI
{ENDPOINT_URI} 值可在相對應 Azure AI 服務資源的 Azure 入口網站 [概觀] 頁面上取得。 移至 [概觀] 頁面，並將滑鼠停留在端點上方，然後會出現 [複製至剪貼簿] 圖示。 複製端點，並將其用在需要之處。
索引鍵
{API_KEY} 值可用來啟動容器，並可在相對應 Azure AI 服務資源的 Azure 入口網站 [金鑰] 頁面上取得。 移至 [金鑰] 頁面，然後選取 [複製至剪貼簿] 圖示。
重要
這些訂用帳戶金鑰可用於存取 Azure AI 服務 API。 請不要共用您的金鑰。 安全地儲存金鑰。 例如，使用 Azure Key Vault。 我們也建議您定期重新產生這些金鑰。 呼叫 API 只需一把金鑰。 重新產生第一個金鑰時，您可以使用第二個金鑰繼續存取服務。
應用程式識別碼 {APP_ID}
此識別碼可用來選取應用程式。 您可以在 LUIS 入口網站 \(英文\) 中，按一下應用程式畫面頂端的 [管理]，接著前往 [設定] 來尋找應用程式識別碼。
索引碼 {AUTHORING_KEY}
此金鑰可用來從雲端中的 LUIS 服務取得已封裝的應用程式，並將查詢記錄重新上傳至雲端。 如果您使用 REST API 來匯出您的應用程式，您將需要編寫金鑰。本文稍後會再詳細敘述。
您可以從 LUIS 入口網站 \(英文\) 中，按一下應用程式畫面頂端的 [管理]，接著前往 [Azure 資源] 來取得編寫金鑰。
適用於套件檔案的編寫 API
適用於套件應用程式的編寫 API：
- 已發佈的套件 API \(英文\)
- 未發佈、已定型的套件 API \(英文\)
主機電腦
主機是執行 Docker 容器的 x64 型電腦。 它可以是您內部部署的電腦，或是在 Azure 中裝載服務的 Docker，例如：
- Azure Kubernetes Service。
- Azure 容器執行個體。
- 部署至 Azure Stack 的 Kubernetes \(英文\) 叢集。 如需詳細資訊，請參閱將 Kubernetes 部署至 Azure Stack。
容器的需求和建議
下表列出容器主機的最小值和建議值。 您的需求可能會根據流量大小而變更。
| 容器 | 最小值 | 建議需求 | TPS (最小值、最大值) |
|---|---|---|---|
| LUIS | 1 核心，2 GB 記憶體 | 單核心，4 GB 記憶體 | 20，40 |
- 每個核心必須至少 2.6 GHz 或更快。
- TPS - 每秒的交易數
核心和記憶體會對應至 --cpus 和 --memory 設定，用來作為 docker run 命令的一部分。
使用 docker pull 取得容器映像
您可以在 mcr.microsoft.com 容器登錄聯盟上找到 LUIS 容器映像。 其位於 azure-cognitive-services/language 存放庫內，並命名為 luis。 完整的容器映像名稱為 mcr.microsoft.com/azure-cognitive-services/language/luis。
若要使用最新版本的容器，您可以使用 latest 標記。 您也可以在 MCR 上找到標籤的完整清單。
使用 docker pull 命令從 mcr.microsoft.com/azure-cognitive-services/language/luis 存放庫下載容器映像：
docker pull mcr.microsoft.com/azure-cognitive-services/language/luis:latest
如需可用標記 (例如在前述命令中使用的 latest) 的完整說明，請參閱 Docker Hub 上的 LUIS。
提示
您可以使用 docker images \(英文\) 命令來列出已下載的容器映像。 例如，下列命令會列出每個已下載之容器映像的識別碼、存放庫和標籤，並將它格式化為表格：
docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"
IMAGE ID REPOSITORY TAG
<image-id> <repository-path/name> <tag-name>
如何使用容器
容器位於主機電腦上時，請透過下列程序來使用容器。
- 從 LUIS 入口網站或 LUIS API 為容器匯出套件。
- 將套件檔案移至主機電腦上所需的輸入目錄中。 請勿將 LUIS 套件檔案重新命名、更改、覆寫或解壓縮。
- 使用所需的輸入掛接和計費設定執行容器。
docker run命令有相關範例可供參考。 - 查詢容器的預測端點。
- 容器使用完畢後，請從 LUIS 入口網站中的輸出掛接匯入端點記錄，並停止容器。
- 從 LUIS 入口網站使用 [檢閱端點語句] 頁面上的主動式學習，來改善應用程式。
在容器中執行的應用程式無法變更。 若要變更容器中的應用程式，您必須使用 LUIS 入口網站或 LUIS 撰寫 API 來變更 LUIS 服務中的應用程式。 接著，請進行定型和 (或) 發佈，然後下載新套件並重新執行容器。
容器內的 LUIS 應用程式無法重新匯出至 LUIS 服務。 只有查詢記錄可供上傳。
從 LUIS 匯出已封裝的應用程式
LUIS 容器需要以已定型或發佈的 LUIS 應用程式來回應使用者語句的預測查詢。 若要取得 LUIS 應用程式，請使用已定型或發佈的套件 API。
預設位置是相對於執行 docker run 命令所在之處的 input 子目錄。
將套件檔案放入目錄中，並在執行 Docker 容器時以輸入掛接的形式參考此目錄。
套件類型
輸入掛接目錄可同時包含生產、預備和已設定版本模型的應用程式。 所有套件都會掛接。
| 套件類型 | 查詢端點 API | 查詢可用性 | 套件檔案名稱格式 |
|---|---|---|---|
| 已設定版本 | GET、POST | 僅限容器 | {APP_ID}_v{APP_VERSION}.gz |
| 預備 | GET、POST | Azure 和容器 | {APP_ID}_STAGING.gz |
| Production | GET、POST | Azure 和容器 | {APP_ID}_PRODUCTION.gz |
重要
請勿將 LUIS 套件檔案重新命名、更改、覆寫或解壓縮。
封裝必要條件
在封裝 LUIS 應用程式之前，您必須符合下列需求：
| 封裝需求 | 詳細資料 |
|---|---|
| Azure Azure AI 服務資源執行個體 | 支援的區域包括 美國西部 ( westus)西歐 ( westeurope)澳大利亞東部 ( australiaeast) |
| 已定型或發佈的 LUIS 應用程式 | 不含不支援的相依性。 |
| 可存取主機電腦的檔案系統 | 主機電腦必須允許輸入掛接。 |
從 LUIS 入口網站匯出應用程式套件
LUIS Azure 入口網站可讓您匯出已定型或發佈的應用程式套件。
從 LUIS 入口網站匯出已發佈的應用程式套件
已發佈的應用程式套件可從 [我的應用程式] 清單頁面取得。
- 登入 LUIS Azure 入口網站。
- 選取清單中位於應用程式名稱左側的核取方塊。
- 從清單上方的內容相關工具列中選取 [匯出] 項目。
- 選取 [匯出容器 (GZIP)]。
- 選取 [生產位置] 或 [預備位置] 的環境。
- 從瀏覽器下載套件。
![從 [應用程式] 頁面的 [匯出] 功能表為容器匯出已發佈的套件](media/luis-container-how-to/export-published-package-for-container.png)
從 LUIS 入口網站匯出已設定版本的應用程式套件
已設定版本的應用程式套件可從「版本」清單頁面取得。
- 登入 LUIS Azure 入口網站。
- 選取清單中的應用程式。
- 在應用程式的導覽列中選取 [管理]。
- 在左側導覽列中選取 [版本]。
- 選取清單中位於版本名稱左側的核取方塊。
- 從清單上方的內容相關工具列中選取 [匯出] 項目。
- 選取 [匯出容器 (GZIP)]。
- 從瀏覽器下載套件。
![從 [版本] 頁面的 [匯出] 功能表為容器匯出已定型的套件](media/luis-container-how-to/export-trained-package-for-container.png)
從 API 匯出已發佈的應用程式套件
使用下列 REST API 方法，封裝您已發佈的 LUIS 應用程式。 使用 HTTP 規格下方的表格，以您自己的適當值取代 API 呼叫中的預留位置。
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}
| 預留位置 | 值 |
|---|---|
| {APP_ID} | 已發佈 LUIS 應用程式的應用程式識別碼。 |
| {SLOT_NAME} | 已發佈 LUIS 應用程式的環境。 請使用下列其中一個值：PRODUCTIONSTAGING |
| {AUTHORING_KEY} | 已發佈 LUIS 應用程式的 LUIS 帳戶所適用的撰寫金鑰。 您可以從 LUIS 入口網站中的 [使用者設定] 頁面取得撰寫金鑰。 |
| {AZURE_REGION} | 適當的 Azure 區域：westus - 美國西部westeurope - 西歐australiaeast - 澳大利亞東部 |
若要下載已發佈的套件，請參閱此處的 API 文件 \(英文\)。 若是下載成功，回應將會是一個 LUIS 套件檔案。 請將此檔案儲存在為容器的輸入掛接指定的儲存位置中。
從 API 匯出已設定版本的應用程式套件
使用下列 REST API 方法，封裝您已定型的 LUIS 應用程式。 使用 HTTP 規格下方的表格，以您自己的適當值取代 API 呼叫中的預留位置。
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}
| 預留位置 | 值 |
|---|---|
| {APP_ID} | 已定型 LUIS 應用程式的應用程式識別碼。 |
| {APP_VERSION} | 已定型 LUIS 應用程式的應用程式版本。 |
| {AUTHORING_KEY} | 已發佈 LUIS 應用程式的 LUIS 帳戶所適用的撰寫金鑰。 您可以從 LUIS 入口網站中的 [使用者設定] 頁面取得撰寫金鑰。 |
| {AZURE_REGION} | 適當的 Azure 區域：westus - 美國西部westeurope - 西歐australiaeast - 澳大利亞東部 |
若要下載已設定版本的套件，請參閱此處的 API 文件 \(英文\)。 若是下載成功，回應將會是一個 LUIS 套件檔案。 請將此檔案儲存在為容器的輸入掛接指定的儲存位置中。
透過 docker run 執行容器
將 docker run 命令執行容器。 請參閱收集必要參數來了解如何獲得 {ENDPOINT_URI} 與 {API_KEY} 值的具體細節。
有關於 docker run 命令的範例可供使用。
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}
- 此範例使用
C:磁碟機中的目錄，以避免在 Windows 上發生任何權限衝突。 如果您需要使用特定目錄作為輸入目錄，您可能需要授與 Docker 服務權限。 - 若不熟悉 Docker 容器，請勿變更引數順序。
- 如果您使用不同的作業系統，請使用正確的主控台/終端、用於掛接的資料夾語法，以及適用於您系統的行接續字元。 這些範例皆是以使用行接續字元
^的 Windows 主控台為準。 因容器為 Linux 作業系統，所以目標裝載會使用 Linux 樣式的資料夾語法。
此命令：
- 從 LUIS 容器映像執行容器
- 從 C:\input 上的輸入掛接 (位於容器主機上) 載入 LUIS 應用程式
- 配置兩個 CPU 核心和 4 GB 的記憶體
- 公開 TCP 連接埠 5000，並為容器配置虛擬 TTY
- 將容器和 LUIS 記錄儲存到 C:\output 上的輸出掛接 (位於容器主機上)
- 在容器結束之後自動將其移除。 容器映像仍可在主機電腦上使用。
docker run 命令有相關範例可供參考。
重要
必須指定 Eula、Billing 及 ApiKey 選項以執行容器，否則容器將不會啟動。 如需詳細資訊，請參閱帳單。
ApiKey 值是 LUIS 入口網站中的「Azure 資源」 頁面所包含的金鑰，此值也可以在 Azure Azure AI services 資源的金鑰頁面上取得。
在相同主機上執行多個容器
如果您打算使用公開的連接埠執行多個容器，請務必使用不同的公開連接埠來執行每個容器。 例如，在連接埠 5000 上執行第一個容器，以及在連接埠 5001 上執行第二個容器。
您可以讓此容器和不同的 Azure AI 服務容器在主機上一起執行。 您也可以針對相同的 Azure AI 服務容器執行多個容器。
容器支援的端點 API
API 的 V2 和 V3 版本都可供容器使用。
查詢容器的預測端點
容器會提供以 REST 為基礎的查詢預測端點 API。 已發佈 (預備或生產) 應用程式的端點具有與已設定版本應用程式的端點不同的路由。
請對容器 API 使用主機 http://localhost:5000。
| 套件類型 | HTTP 指令動詞 | 路由 | 查詢參數 |
|---|---|---|---|
| 已發行 | 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] |
| 已設定版本 | 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] |
查詢參數會設定傳回查詢回應的方式和內容：
| 查詢參數 | 類型 | 用途 |
|---|---|---|
query |
string | 使用者的語句。 |
verbose |
boolean | 布林值，能指出是否傳回預測模型的所有中繼資料。 預設為 False。 |
log |
boolean | 記錄查詢，可供後續的主動式學習使用。 預設為 False。 |
show-all-intents |
boolean | 布林值，能指出是否傳回所有意圖，或只傳回最高評分意圖。 預設為 False。 |
查詢 LUIS 應用程式
對容器查詢已發佈應用程式的範例 CURL 命令為：
若要查詢位置中的模型，請使用以下 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"
若要對 [預備] 環境進行查詢，請在路由中使用 staging 取代 production：
http://localhost:5000/luis/v3.0/apps/{APP_ID}/slots/staging/predict
若要查詢已設定版本的模型，請使用下列 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"
匯入用於主動式學習的端點記錄
如果已指定 LUIS 容器的輸出掛接，則應用程式查詢記錄檔會儲存在 {INSTANCE_ID} 為容器識別碼的輸出目錄中。 應用程式查詢記錄中包含已提交至 LUIS 容器的每個預測查詢的查詢、回應和時間戳記。
下列位置會顯示容器記錄檔的巢狀目錄結構。
/output/luis/{INSTANCE_ID}/
在 LUIS 入口網站中選取您的應用程式，然後選取 [匯入端點記錄] 以上傳這些記錄。
在上傳記錄後，在 LUIS 入口網站中檢閱端點語句。
驗證容器正在執行
有數種方式可驗證容器正在執行。 找出有問題容器的外部 IP 位址和公開的連接埠，然後開啟您最愛的網頁瀏覽器。 使用下列各項要求 URL，以驗證容器是否正在執行。 此處列出的範例要求 URL 為 http://localhost:5000，但您的特定容器可能會有所不同。 請務必依賴您容器的「外部 IP」 位址和公開的連接埠。
| 要求 URL | 目的 |
|---|---|
http://localhost:5000/ |
容器會提供首頁。 |
http://localhost:5000/ready |
以 GET 提出要求，此 URL 將會驗證容器是否已準備好接受對模型的查詢。 此要求可用來進行 Kubernetes 活躍度和整備度探查 \(英文\)。 |
http://localhost:5000/status |
也會以 GET 提出要求，此 URL 會在不需進行端點查詢的同時，確認用來啟動容器的 API 金鑰是否有效。 此要求可用來進行 Kubernetes 活躍度和整備度探查 \(英文\)。 |
http://localhost:5000/swagger |
容器會為端點提供一組完整的文件和立即試用功能。 使用此功能，您可以將自己的設定輸入至以 Web 為基礎的 HTML 表單並進行查詢，而無須撰寫任何程式碼。 當查詢傳回時，會提供範例 CURL 命令來示範所需的 HTTP 標頭和本文格式。 |
執行與網際網路中斷連線的容器
若要使用此與網際網路中斷連線的容器，您必須先填寫申請表並購買承諾用量方案來要求存取權。 如需詳細資訊，請參閱「在中斷連線環境中使用 Docker 容器」。
如果您已獲核准執行與網際網路中斷連線的容器，請使用下列範例顯示您會使用之 docker run 命令的格式設定以及預留位置值。 以您自己的值取代這些預留位置值。
您 docker run 命令中的 DownloadLicense=True 參數會下載授權檔案，讓您的 Docker 容器可在未連線至網際網路時執行。 其也包含到期日，在此日期之後，授權檔案將無效，以致無法執行容器。 您只能搭配已獲核准的適當容器使用授權檔案。 例如，您無法將語音轉換文字容器的授權檔案和文件智慧容器搭配使用。
| 預留位置 | 值 | 格式或範例 |
|---|---|---|
{IMAGE} |
您想要使用的容器映像。 | mcr.microsoft.com/azure-cognitive-services/form-recognizer/invoice |
{LICENSE_MOUNT} |
將下載並掛接授權的路徑。 | /host/license:/path/to/license/directory |
{ENDPOINT_URI} |
用於驗證服務要求的端點。 在 Azure 入口網站上，您可以在資源的 [金鑰和端點] 頁面上找到金鑰。 | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{API_KEY} |
文字分析資源的索引鍵。 在 Azure 入口網站上，您可以在資源的 [金鑰和端點] 頁面上找到金鑰。 | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
{CONTAINER_LICENSE_DIRECTORY} |
容器本機檔案系統上的授權資料夾位置。 | /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}
一旦下載了授權檔案，您就可以在已中斷連線的環境中執行容器。 下列範例會顯示您將使用的 docker run 命令格式，以及預留位置值。 以您自己的值取代這些預留位置值。
無論在何處執行容器，授權檔案都必須掛接到該容器，而且授權資料夾在該容器本機檔案系統上的位置必須是使用 Mounts:License= 指定的。 也須指定輸出掛接，才能寫入帳單使用記錄。
| 預留位置 | 值 | 格式或範例 |
|---|---|---|
{IMAGE} |
您想要使用的容器映像。 | mcr.microsoft.com/azure-cognitive-services/form-recognizer/invoice |
{MEMORY_SIZE} |
要為您容器配置的適當記憶體大小。 | 4g |
{NUMBER_CPUS} |
要為您容器配置的適當 CPU 數目。 | 4 |
{LICENSE_MOUNT} |
將尋找並掛接授權的路徑。 | /host/license:/path/to/license/directory |
{OUTPUT_PATH} |
用於記錄使用量記錄的輸出路徑。 | /host/output:/path/to/output/directory |
{CONTAINER_LICENSE_DIRECTORY} |
容器本機檔案系統上的授權資料夾位置。 | /path/to/license/directory |
{CONTAINER_OUTPUT_DIRECTORY} |
容器本機檔案系統上的輸出資料夾位置。 | /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}
停止容器
若要關閉容器，請在正在執行容器的命令列環境中按 Ctrl+C。
疑難排解
如果您在啟用輸出掛接和記錄的情況下執行容器，容器將會產生記錄檔，有助於排解在啟動或執行容器時所發生的問題。
提示
如需疑難排解的詳細資訊和指導，請參閱 Azure AI 容器常見問題集 (FAQ)。
如果您在執行 Azure AI 服務容器時遇到問題，可以嘗試使用 Microsoft 診斷容器。 您可以使用此容器來診斷部署環境中的常見錯誤，這些錯誤可能會導致 Azure AI 容器無法如預期般運作。
若要取得容器，請使用下列 docker pull 命令：
docker pull mcr.microsoft.com/azure-cognitive-services/diagnostic
接著執行該容器。 將 {ENDPOINT_URI} 取代為您的端點，並將 {API_KEY} 取代為您資源的金鑰：
docker run --rm mcr.microsoft.com/azure-cognitive-services/diagnostic \
eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}
容器會測試帳單端點的網路連線能力。
計費
LUIS 容器會使用您 Azure 帳戶上的 Azure AI 服務資源來將帳單資訊傳送至 Azure。
針對容器的查詢，會以 ApiKey 參數使用的 Azure 資源定價層來計費。
Azure AI 服務容器若未連線至計量或計費端點，即無法獲得執行的授權。 您必須讓容器隨時都能與計量端點進行帳單資訊的通訊。 Azure AI 服務容器不會將客戶資料 (例如正在分析的影像或文字) 傳送給 Microsoft。
連接到 Azure
容器需要計費引數值才能執行。 這些值讓容器能夠連線到計費端點。 容器會每隔 10 到 15 分鐘回報使用量。 如果容器未在允許的時間範圍內連線到 Azure，容器會繼續執行，但在還原計費端點之前不會提供查詢。 以 10 到 15 分鐘的相同時間間隔嘗試連線 10 次。 如果無法在 10 次嘗試內連線到計費端點，容器會停止處理要求。 請參閱「Azure AI 服務容器常見問題集」，以獲得需傳送哪些資訊給 Microsoft 以供計費的範例。
計費引數
當下列三個選項都填入了有效值時，docker run 命令將會啟動容器：
| 選項 | 描述 |
|---|---|
ApiKey |
Azure AI 服務資源的 API 金鑰，用於追蹤計費資訊。 此選項值必須設定為已佈建 Billing 指定資源的 API 金鑰。 |
Billing |
Azure AI 服務資源的端點，用於追蹤計費資訊。 此選項的值必須設定為已佈建 Azure 資源的端點 URI。 |
Eula |
表示您接受容器的授權。 此選項的值必須設定為接受。 |
如需這些選項的詳細資訊，請參閱設定容器。
摘要
在本文中，您已了解下載、安裝及執行 Language Understanding (LUIS) 容器的概念和工作流程。 摘要中：
- Language Understanding (LUIS) 提供了一個適用於 Docker 的 Linux 容器，具備端點語句查詢預測的功能。
- 容器映像可從 Microsoft Container Registry (MCR) 下載取得。
- 容器映像是在 Docker 中執行。
- 您可以使用 REST API，藉由指定容器的主機 URI 來查詢容器端點。
- 將容器具現化時，您必須指定帳單資訊。
重要
Azure AI 容器若未連線至用於計量的 Azure，即無法獲得執行的授權。 客戶必須啟用容器以持續與計量服務進行帳單資訊的通訊。 Azure AI 容器不會將客戶資料 (例如正在分析的影像或文字) 傳送至 Microsoft。
下一步
- 檢閱設定容器以了解組態設定。
- 請參閱 LUIS 容器限制來了解已知功能限制。
- 請參閱疑難排解來解決與 LUIS 功能相關的問題。
- 使用更多 Azure AI 容器