如何建立和管理 LUIS 資源

重要

LUIS 將於 2025 年 10 月 1 日淘汰，而自 2023 年 4 月 1 日開始，您將無法建立新的 LUIS 資源。 建議移轉 LUIS 應用程式至交談語言理解，以享有產品持續支援和多語言功能的優點。

使用本文來瞭解您可以搭配 LUIS 使用的 Azure 資源類型，以及如何管理它們。

製作資源

撰寫資源可讓您建立、管理、定型、測試及發佈應用程式。 LUIS 撰寫資源提供一個 定價層 - 免費 （F0） 層，可提供您：

• 100 萬筆撰寫交易
• 每月 1,000 個測試預測端點要求。

您可以使用 v3.0 預覽版 LUIS 程式設計 API 來管理撰寫資源。

預測資源

預測資源可讓您查詢預測端點，超過撰寫資源所提供的 1,000 個要求。 預測資源可使用兩 個 定價層：

• 免費 （F0） 預測資源，每月提供10,000個預測端點要求。
• 標準 （S0） 預測資源，這是付費層。

您可以使用 v3.0-preview LUIS 端點 API 來管理預測資源。

注意

• 您也可以使用多服務資源來取得可用於多個 Azure AI 服務的單一端點。
• LUIS 提供兩種類型的 F0 （免費層） 資源：一種用於撰寫交易，另一種用於預測交易。 如果您用盡了預測交易的免費配額，請確定您使用的是 F0 預測資源，其每月提供 10,000 筆免費交易，而不是撰寫資源，這會每月提供 1,000 筆預測交易。
• 您應該在想要發佈和查詢的區域撰寫 LUIS 應用程式。

建立 LUIS 資源

若要建立 LUIS 資源，您可以使用 LUIS 入口網站、Azure 入口網站 或 Azure CLI。 建立資源之後，您必須將它們指派給您的應用程式，供其使用。

LUIS 入口網站

使用 LUIS 入口網站建立 LUIS 撰寫資源

1. 登入 LUIS 入口網站，選取您的國家/地區，並同意使用規定。 如果您在入口網站中看到 [我的應用程式] 區段，則已存在 LUIS 資源，您可以略過下一個步驟。

2. 在出現的 [ 選擇撰寫 ] 視窗中，尋找您的 Azure 訂用帳戶和 LUIS 撰寫資源。 如果您沒有資源，您可以建立新的資源。

   

   當您建立新的撰寫資源時，請提供下列資訊：

   • 租用戶名稱：您的 Azure 訂用帳戶相關聯的租使用者。
   • Azure 訂用帳戶名稱：將針對資源計費的訂用帳戶。
   • Azure 資源組名：您選擇的自訂資源組名或建立。 資源群組可讓您將 Azure 資源分組以方便存取和管理。
   • Azure 資源名稱：您選擇的自定義名稱，用來作為撰寫和預測端點查詢 URL 的一部分。
   • 定價層：定價層會決定每秒和月份的交易上限。

使用 LUIS 入口網站建立 LUIS 預測資源

1. 移至應用程式中的 [管理] 索引標籤。

2. 在左側導覽中，選取 [Azure 資源]。

3. 選取 [新增預測資源] 按鈕。

   

   如果您已經有預測資源，請加以新增。 否則，請選取 [建立新的預測資源]。

   

沒有 LUIS 入口網站

不使用 LUIS 入口網站建立 LUIS 資源

使用 Azure CLI 個別建立每個資源。

提示

• 撰寫資源 kind 為 LUIS.Authoring
• 預測資源 kind 為 LUIS

1. 登入 Azure CLI：

   az login
   

   此命令會開啟瀏覽器，讓您可以選取正確的帳戶並提供驗證。

2. 建立類型 LUIS.Authoring為的 LUIS 撰寫資源，名為 my-luis-authoring-resource。 在針對區域命名my-resource-group的現有資源群組中westus建立它。

   az cognitiveservices account create -n my-luis-authoring-resource -g my-resource-group --kind LUIS.Authoring --sku F0 -l westus --yes
   

3. 建立類型 LUIS為的 LUIS 預測端點資源，名為 my-luis-prediction-resource。 在針對區域命名my-resource-group的現有資源群組中westus建立它。 如果您要比免費層提供的輸送量更高，請將 變更 F0 為 S0。 深入瞭解定價層和輸送量。

   az cognitiveservices account create -n my-luis-prediction-resource -g my-resource-group --kind LUIS --sku F0 -l westus --yes
   

指派 LUIS 資源

建立資源不一定表示它已投入使用，您必須將它指派給您的應用程式。 您可以為單一應用程式或 LUIS 中的所有應用程式指派撰寫資源。

LUIS 入口網站

使用 LUIS 入口網站指派資源

將撰寫資源指派給所有應用程式

下列程式會將撰寫資源指派給所有應用程式。

1. 登入 LUIS 入口網站。
2. 在右上角，選取您的用戶帳戶，然後選取 [設定]。
3. 在 [使用者 設定] 頁面上，選取 [新增撰寫資源]，然後選取現有的撰寫資源。 選取 [儲存]。

將資源指派給特定應用程式

下列程式會將資源指派給特定應用程式。

1. 登入 LUIS 入口網站。 從 [我的應用程式] 清單中選取應用程式。

2. 移至管理>Azure 資源：

   

3. 在 [預測資源] 或 [撰寫資源] 索引標籤上，選取 [新增預測資源] 或 [新增撰寫資源] 按鈕。

4. 使用表單中的欄位來尋找正確的資源，然後選取 [ 儲存]。

沒有 LUIS 入口網站

不使用 LUIS 入口網站指派預測資源

針對 CI/CD 管線等自動化程式，您可以使用下列步驟，將 LUIS 資源指派自動化至 LUIS 應用程式：

1. 取得 Azure Resource Manager 令牌，這是英數位元字串。 此令牌會過期，因此請立即使用它。 您也可以使用下列 Azure CLI 命令。

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. 使用令牌來要求跨訂用帳戶的 LUIS 運行時間資源。 使用 API 取得 使用者帳戶可存取的 LUIS Azure 帳戶 。

   此 POST API 需要下列值：

   標頭	值
   Authorization	Authorization 的值是 Bearer {token}。 標記值前面必須加上一個字 Bearer 和一個空格。
   Ocp-Apim-Subscription-Key	您的撰寫金鑰。

   API 會傳回代表 LUIS 訂用帳戶的 JSON 物件數位。 傳回的值包括以 傳回的 AccountName訂用帳戶標識碼、資源群組和資源名稱。 在陣列中尋找您要指派給LUIS應用程式的LUIS資源專案。

3. 使用 將 LUIS Azure 帳戶指派給應用程式 API，將令牌指派給 LUIS 資源。

   此 POST API 需要下列值：

   類型	設定	值
   頁首	Authorization	Authorization 的值是 Bearer {token}。 標記值前面必須加上一個字 Bearer 和一個空格。
   頁首	Ocp-Apim-Subscription-Key	您的撰寫金鑰。
   頁首	Content-type	application/json
   Querystring	appid	LUIS 應用程式識別碼。
   本文		{AzureSubscriptionId： 您的訂用帳戶標識碼， ResourceGroup：具有預測資源的資源組名， AccountName：預測資源的名稱}

   當此 API 成功時，它會傳 201 - created status回 。

取消指派資源

當您取消指派資源時，不會從 Azure 中刪除。 它只會從 LUIS 取消連結。

LUIS 入口網站

使用 LUIS 入口網站取消指派資源

1. 登入 LUIS 入口網站，然後從 [ 我的應用程式 ] 清單中選取應用程式。
2. 移至管理>Azure 資源。
3. 選取資源的 [ 取消指派資源 ] 按鈕。

沒有 LUIS 入口網站

不使用 LUIS 入口網站取消指派預測資源

1. 取得 Azure Resource Manager 令牌，這是英數位元字串。 此令牌會過期，因此請立即使用它。 您也可以使用下列 Azure CLI 命令。

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. 使用令牌來要求跨訂用帳戶的 LUIS 運行時間資源。 使用您的用戶帳戶可存取的取得 LUIS Azure 帳戶 API。

   此 POST API 需要下列值：

   標頭	值
   Authorization	Authorization 的值是 Bearer {token}。 標記值前面必須加上一個字 Bearer 和一個空格。
   Ocp-Apim-Subscription-Key	您的撰寫金鑰。

   API 會傳回代表 LUIS 訂用帳戶的 JSON 物件數位。 傳回的值包括以 傳回的 AccountName訂用帳戶標識碼、資源群組和資源名稱。 在陣列中尋找您要指派給LUIS應用程式的LUIS資源專案。

3. 使用 從應用程式 API 取消指派 LUIS Azure 帳戶，將令牌指派給 LUIS 資源。

   此 DELETE API 需要下列值：

   類型	設定	值
   頁首	Authorization	Authorization 的值是 Bearer {token}。 標記值前面必須加上一個字 Bearer 和一個空格。
   頁首	Ocp-Apim-Subscription-Key	您的撰寫金鑰。
   頁首	Content-type	application/json
   Querystring	appid	LUIS 應用程式識別碼。
   本文		{AzureSubscriptionId： 您的訂用帳戶標識碼， ResourceGroup：具有預測資源的資源組名， AccountName：預測資源的名稱}

   當此 API 成功時，它會傳 200 - OK status回 。

資源擁有權

Azure 資源，例如 LUIS 資源，是由包含資源的訂用帳戶所擁有。

若要變更資源的擁有權，您可以採取下列其中一個動作：

• 轉移訂用帳戶的擁有權。
• 將 LUIS 應用程式匯出為檔案，然後在不同的訂用帳戶上匯入應用程式。 匯出可在 LUIS 入口網站的 [我的應用程式] 頁面上取得。

資源限制

撰寫金鑰建立限制

每個區域每個訂用帳戶可以建立多達10個撰寫密鑰。 發佈區域與撰寫區域不同。 請務必在撰寫區域中建立應用程式，以對應至您想要用戶端應用程式所在的發佈區域。 如需撰寫區域如何對應至發佈區域的資訊，請參閱 撰寫和發佈區域。

如需詳細資訊，請參閱資源限制。

金鑰使用限制的錯誤

使用量限制是以定價層為基礎。

如果您超出每秒交易 (TPS) 配額，就會收到 HTTP 429 錯誤。 如果您超過每月交易 （TPM） 配額，您會收到 HTTP 403 錯誤。

變更定價層

1. 在 Azure 入口網站 中，移至 [所有資源]，然後選取您的資源

   

2. 從左側功能表中，選取 [定價層 ] 以查看可用的定價層

3. 選取您想要的定價層，然後按下 [ 選取 ] 以儲存您的變更。 當定價變更完成時，定價層更新會出現右上方的通知。

檢視 Azure 資源計量

檢視 Azure 資源使用量的摘要

您可以在 Azure 入口網站 中檢視 LUIS 使用方式資訊。 [概觀] 頁面會顯示摘要，包括最近的呼叫和錯誤。 如果您提出 LUIS 端點要求，最多允許顯示變更五分鐘。

自訂 Azure 資源使用量圖表

[ 計量] 頁面提供更詳細的數據檢視。 您可以針對特定 時間週期 和 計量設定計量圖表。

交易閾值警示總計

如果您想要知道何時達到特定交易閾值，例如 10,000 筆交易，您可以建立警示：

1. 從左側功能表中，選取 [ 警示]

2. 從頂端功能表中選取 [新增警示規則]

   

3. 選取 [新增條件]

   

4. 選取 [通話總數]

   

5. 向下捲動至 [警示邏輯 ] 區段，並視需要設定屬性，然後按兩下 [ 完成]

   

6. 當警示規則觸發程式移至 [動作 ] 區段並新增您的動作群組時，傳送通知或叫用動作。

   

重設製作金鑰

針對已移轉的撰寫資源應用程式：如果您的撰寫密鑰遭到入侵，請在撰寫資源的 [金鑰] 頁面上重設 Azure 入口網站 中的密鑰。

對於尚未移轉的應用程式：金鑰會在 LUIS 入口網站中的所有應用程式上重設。 如果您透過撰寫 API 撰寫應用程式，則必須將的值 Ocp-Apim-Subscription-Key 變更為新的密鑰。

重新產生 Azure 金鑰

您可以從 Azure 入口網站 中的 [金鑰] 頁面重新產生 Azure 金鑰。

應用程式擁有權、存取和安全性

應用程式是由其 Azure 資源所定義，由擁有者的訂用帳戶決定。

您可以移動 LUIS 應用程式。 使用下列資源來協助您使用 Azure 入口網站 或 Azure CLI 來執行此動作：

• 將資源移至新的資源群組或訂用帳戶
• 在相同訂用帳戶內或跨訂用帳戶移動資源

下一步

• 了解如何使用版本來控制應用程式生命週期。