設定 Language Understanding 的 Docker 容器
重要
LUIS 將於 2025 年 10 月 1 日淘汰，而自 2023 年 4 月 1 日開始，您將無法建立新的 LUIS 資源。 建議移轉 LUIS 應用程式至交談語言理解，以享有產品持續支援和多語言功能的優點。
Language Understanding (LUIS) 容器執行階段環境可使用 docker run 命令引數來設定。 LUIS 有數個必要的設定，和一些選擇性的設定。 命令有相關範例可供參考。 容器專屬設定包括輸入裝載設定和計費設定。
組態設定
此容器具有下列組態設定：
| 必要 | 設定 | 目的 |
|---|---|---|
| Yes | ApiKey | 用來追蹤帳單資訊。 |
| No | ApplicationInsights | 可讓您將 Azure Application Insights 遙測支援新增至容器。 |
| Yes | Billing | 指定 Azure 上服務資源的端點 URI。 |
| Yes | Eula | 表示您已接受容器的授權。 |
| No | Fluentd | 將記錄 (和選擇性的計量資料) 寫入至 Fluentd 伺服器。 |
| No | HTTP Proxy | 設定 HTTP Proxy 以進行輸出要求。 |
| No | Logging | 提供適用於容器的 ASP.NET Core 記錄支援。 |
| Yes | Mounts | 從主機電腦將資料讀取和寫入至容器，以及從容器將資料讀取和寫回主機電腦。 |
ApiKey 設定
ApiKey 設定會指定用來追蹤容器帳單資訊的 Azure資源金鑰。 您必須指定 ApiKey 的值，而且該值必須是針對 Billing 組態設定所指定之 Azure AI 服務資源的有效金鑰。
此設定可在下列位置找到：
- Azure 入口網站：Azure AI 服務資源管理，位於 [金鑰] 底下
- LUIS 入口網站：[Keys and Endpoint settings] \(金鑰和端點設定\) 頁面。
請勿使用入門金鑰或撰寫金鑰。
ApplicationInsights 設定
ApplicationInsights 設定可讓您將 Azure Application Insights 遙測支援新增至容器。 Application Insights 可提供深入容器監視。 您可輕鬆監視容器的可用性、效能和使用情形。 您也可以快速識別並診斷容器中的錯誤。
下表說明 ApplicationInsights 區段下所支援的組態設定。
| 必要 | 名稱 | 資料類型 | 描述 |
|---|---|---|---|
| No | InstrumentationKey |
String | Application Insights 執行個體的檢測金鑰，容器的遙測資料會傳送到這裡。 如需詳細資訊，請參閱 ASP.NET Core 的 Application Insights。 範例： InstrumentationKey=123456789 |
帳單支援
Billing 設定會指定 Azure 上用來對容器計算計費資訊之 Azure AI 服務資源的端點 URI。 您必須指定此組態設定的值，而且該值必須是 Azure 上 Azure AI 服務資源的有效端點 URI。 容器會每隔 10 到 15 分鐘回報使用量。
此設定可在下列位置找到：
- Azure 入口網站：Azure AI 服務概觀，標示為
Endpoint - LUIS 入口網站：[Keys and Endpoint settings] \(金鑰和端點設定\) 頁面，包含在端點 URI 中。
| 必要 | 名稱 | 資料類型 | 描述 |
|---|---|---|---|
| Yes | Billing |
string | 計費端點 URI。 如需有關取得計費 URI 的詳細資訊，請參閱收集必要參數。 如需詳細資訊和完整的區域端點清單，請參閱 Azure AI 服務的自訂子網域名稱。 |
Eula 設定
Eula 設定可指出您已接受容器的授權。 您必須為此組態設定指定值，且該值必須設定為 accept。
| 必要 | 名稱 | 資料類型 | 描述 |
|---|---|---|---|
| Yes | Eula |
String | 接受授權 範例： Eula=accept |
Azure AI 服務容器是在您的合約 (控管您對於 Azure 的使用) 底下獲得授權。 如果您沒有可控管您使用 Azure 的現有合約，您同意控管使用 Azure 的合約是 Microsoft 線上訂閱合約 (其中包含線上服務條款)。 對於預覽版，您也同意 Microsoft Azure 預覽專用的補充使用條款。 使用容器即表示您同意這些條款。
Fluentd 設定
Fluentd 是適用於統一記錄的開放原始碼資料收集器。 Fluentd 設定可管理容器對 Fluentd 伺服器的連線。 容器包含 Fluentd 記錄提供者，可讓您的容器將記錄 (及選擇性的計量資料) 寫入至 Fluentd 伺服器。
下表說明 Fluentd 區段下所支援的組態設定。
| 名稱 | 資料類型 | 描述 |
|---|---|---|
Host |
String | Fluentd 伺服器的 IP 位址或 DNS 主機名稱。 |
Port |
整數 | Fluentd 伺服器的連接埠。 預設值為 24224。 |
HeartbeatMs |
整數 | 活動訊號間隔，以毫秒為單位。 如果在此間隔到期之前未傳送任何事件流量，系統便會將活動訊號傳送至 Fluentd 伺服器。 預設值為 60000 毫秒 (1 分鐘)。 |
SendBufferSize |
整數 | 針對傳送作業所配置的網路緩衝空間，以位元組為單位。 預設值為 32768 個位元組 (32 KB)。 |
TlsConnectionEstablishmentTimeoutMs |
整數 | 向 Fluentd 伺服器建立 SSL/TLS 連線的逾時，以毫秒為單位。 預設值是 10000 毫秒 (10 秒)。 如果將 UseTLS 設定為 false，便會忽略此值。 |
UseTLS |
布林值 | 指出容器是否應使用 SSL/TLS 來與 Fluentd 伺服器通訊。 預設值為 false。 |
HTTP Proxy 認證設定
如果您需要設定 HTTP Proxy 以進行輸出要求，請使用以下兩個引數：
| 名稱 | 資料類型 | 描述 |
|---|---|---|
| HTTP_PROXY | string | 要使用的 Proxy，例如 http://proxy:8888<proxy-url> |
| HTTP_PROXY_CREDS | string | 對 Proxy 進行驗證所需的任何認證，例如 username:password。 此值必須是小寫。 |
<proxy-user> |
string | Proxy 的使用者。 |
<proxy-password> |
string | 對於 Proxy 與 <proxy-user> 相關聯的密碼。 |
docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type=bind,src=/home/azureuser/output,target=/output \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
HTTP_PROXY=<proxy-url> \
HTTP_PROXY_CREDS=<proxy-user>:<proxy-password> \
記錄設定
Logging 設定可管理適用於容器的 ASP.NET Core 記錄支援。 對於您用於 ASP.NET Core 應用程式的容器，您可以使用相同的組態設定和值。
容器支援下列記錄提供者：
| Provider | 目的 |
|---|---|
| 主控台 | ASP.NET Core Console 記錄提供者。 支援此記錄提供者的所有 ASP.NET Core 組態設定和預設值。 |
| 偵錯 | ASP.NET Core Debug 記錄提供者。 支援此記錄提供者的所有 ASP.NET Core 組態設定和預設值。 |
| 磁碟 | JSON 記錄提供者。 此記錄提供者會將記錄資料寫入至輸出裝載。 |
此容器命令會以 JSON 格式，將記錄資訊儲存於輸出裝載中：
docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type=bind,src=/home/azureuser/output,target=/output \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Disk:Format=json \
Mounts:Output=/output
此容器命令會在容器執行時顯示偵錯資訊 (前面加上 dbug)：
docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Console:LogLevel:Default=Debug
磁碟記錄
Disk 記錄提供者支援下列組態設定：
| 名稱 | 資料類型 | 描述 |
|---|---|---|
Format |
String | 適用於記錄檔的輸出格式。 注意：此值必須設定為 json 以啟用記錄提供者。 如果在具現化期間指定此值，但沒有同時指定輸出裝載，便會發生錯誤。 |
MaxFileSize |
整數 | 記錄檔的大小上限，以 MB 為單位。 當目前記錄檔的大小符合或超過此值時，記錄提供者便會建立新的記錄檔。 如果指定 -1，記錄檔的大小便只會受限於輸出裝載的檔案大小上限 (若有的話)。 預設值是 1。 |
如需設定 ASP.NET Core 記錄支援的詳細資訊，請參閱設定檔案組態。
裝載設定
使用繫結裝載將資料讀取和寫入至容器，及從中讀取和寫入。 您可以在 docker run 命令中指定 --mount 選項，以指定輸入裝載或輸出裝載。
LUIS 容器不會使用輸入或輸出裝載來儲存訓練或服務資料。
主機裝載位置的正確語法會隨著主機作業系統而有所不同。 此外，主機電腦的裝載位置可能會因為 Docker 服務帳戶所使用的權限與主機裝載位置的權限互相衝突，而無法存取。
下表說明支援的設定。
| 必要 | 名稱 | 資料類型 | 描述 |
|---|---|---|---|
| Yes | Input |
String | 輸入裝載的目標。 預設值是 /input。 這是 LUIS 套件檔案的位置。 範例： --mount type=bind,src=c:\input,target=/input |
| No | Output |
String | 輸出裝載的目標。 預設值是 /output。 這是記錄的位置。 其中包括 LUIS 查詢記錄和容器記錄。 範例： --mount type=bind,src=c:\output,target=/output |
範例 docker run 命令
下列範例會使用組態設定來說明如何撰寫和使用 docker run 命令。 開始執行後，容器就會持續執行，直到您加以停止。
- 這些範例均會使用
C:磁碟機的目錄，以避免在 Windows 上發生任何權限衝突。 如果您需要使用特定目錄作為輸入目錄，您可能需要授與 Docker 服務權限。 - 若非十分熟悉 Docker 容器，請勿變更引數的順序。
- 如果您使用不同的作業系統，請使用正確的主控台/終端、用於掛接的資料夾語法，以及適用於您系統的行接續字元。 這些範例皆是以使用行接續字元
^的 Windows 主控台為準。 因容器為 Linux 作業系統，所以目標裝載會使用 Linux 樣式的資料夾語法。
請將 {argument_name} 取代為您自己的值：
| 預留位置 | 值 | 格式或範例 |
|---|---|---|
| {API_KEY} | Azure [LUIS 金鑰] 頁面上的 LUIS 資源端點金鑰。 |
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
| {ENDPOINT_URI} | 帳單端點值可在 Azure [LUIS 概觀] 頁面上取得。 |
如需明確的範例，請參閱收集必要參數。 |
注意
2019 年 7 月 1 日之後建立的新資源會使用自訂的子網域名稱。 如需詳細資訊和完整的區域端點清單，請參閱 Azure AI 服務的自訂子網域名稱。
重要
必須指定 Eula、Billing 及 ApiKey 選項以執行容器，否則容器將不會啟動。 如需詳細資訊，請參閱帳單。
ApiKey 值是 LUIS 入口網站中 [Keys and Endpoints] \(金鑰和端點\) 頁面上的 [Key] \(金鑰\)，此值也可在 Azure Azure AI services 資源金鑰頁面上取得。
基本範例
下列範例會以最少的引數來執行容器：
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:latest ^
Eula=accept ^
Billing={ENDPOINT_URL} ^
ApiKey={API_KEY}
ApplicationInsights 範例
下列範例會設定 ApplicationInsights 引數，以在容器執行時將遙測資料傳送至 Application Insights：
docker run --rm -it -p 5000:5000 --memory 6g --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:latest ^
Eula=accept ^
Billing={ENDPOINT_URL} ^
ApiKey={API_KEY} ^
InstrumentationKey={INSTRUMENTATION_KEY}
記錄範例
下列命令會設定記錄層級 Logging:Console:LogLevel，以將記錄層級設定為 Information。
docker run --rm -it -p 5000:5000 --memory 6g --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:latest ^
Eula=accept ^
Billing={ENDPOINT_URL} ^
ApiKey={API_KEY} ^
Logging:Console:LogLevel:Default=Information
下一步
- 檢閱如何安裝及執行容器
- 請參閱疑難排解來解決與 LUIS 功能相關的問題。
- 使用更多 Azure AI 容器