快速入門：在 LUIS 入口網站中建置您的應用程式

發行項
02/14/2024

重要

LUIS 將於 2025 年 10 月 1 日淘汰，從 2023 年 4 月 1 日起，您將無法建立新的 LUIS 資源。建議您將 LUIS 應用程式移轉至對話式語言理解，以受益於持續的產品支援和多語系功能。

在本快速入門中，使用預先建置的家庭自動化網域建立 LUIS 應用程式，以開啟和關閉燈光和電器。這個預先建置的網域會為您提供意圖、實體和範例語句。接下來，嘗試藉由新增更多意圖和實體來自定義您的應用程式。完成時，您會在雲端中執行 LUIS 端點。

LUIS 的新使用者必須遵循此程式：

登入 LUIS 入口網站，選取您的國家/地區，並同意使用規定。如果您改為看到 我的應用程式，LUIS 資源已經存在，您應該直接跳到建立應用程式。如果沒有，請從使用 Azure 資源開始，這可讓您將 LUIS 帳戶與新的或現有的 Azure Authoring 資源連結。

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

當您建立新的撰寫資源時，請提供下列資訊：
- 租使用者名稱 - 您的 Azure 訂用帳戶相關聯的租使用者。
- Azure 訂用帳戶名稱 - 將針對資源計費的訂用帳戶。
- Azure 資源群組名稱 - 您選擇的自訂資源群組名稱或建立。資源群組可讓您將 Azure 資源分組以進行存取和管理。
- Azure 資源名稱 - 您選擇的自訂名稱，用來作為撰寫和預測端點查詢 URL 的一部分。
- 定價層 - 定價層 會決定每秒和月份的最大交易數。

選取訂用帳戶和撰寫資源

當您選取特定的訂用帳戶和撰寫資源時，您會看到與其相關聯的應用程式清單。

建立新的應用程式

您可以在我的應用程式上建立和管理應用程式。

建立應用程式

若要建立應用程式，請按兩下 [ + 新增應用程式]。

在出現的視窗中，輸入下列資訊：

名稱	描述
Name	應用程式的名稱。例如，「家庭自動化」。
文化特性	您的應用程式了解和說話的語言。
描述	應用程式的描述。
預測資源	將接收查詢的預測資源。

選取完成。

注意

建立應用程式之後，就無法變更文化特性。

新增預先建置的網域

LUIS 提供一組預先建置的網域，可協助您開始使用應用程式。預先建置的網域應用程式已填入意圖、實體和語句。

在左側導覽中，選取 [預先建置的網域]。
搜尋 HomeAutomation。
選取 HomeAutomation 卡片上的 [新增網域 ]。

成功新增網域時，預先建置的網域方塊會顯示 [ 移除網域 ] 按鈕。

查看意圖和實體

選取 左側導覽功能表中的 [意圖 ]，以查看 HomeAutomation 網域意圖。它有範例語句，例如 HomeAutomation.QueryState 和 HomeAutomation.SetDevice。

注意

None 是所有 LUIS 應用程式所提供的意圖。您可以使用它來處理未對應至應用程式所提供的功能的語句。
選取 HomeAutomation.TurnOff 意圖。意圖包含以實體標示的範例語句清單。
如果您想要檢視應用程式的實體，請選取 [ 實體]。如果您選取其中一個實體 (例如 HomeAutomation.DeviceName)，您會看到其相關值的清單。

訓練 LUIS 應用程式

在應用程式填入意圖、實體和語句之後，您必須將應用程式定型，以便反映您所做的變更。

在 LUIS 網站的右上角，選取 [ 訓練] 按鈕。
停用 [ 訓練] 按鈕時，就會完成定 型。

測試您的應用程式

訓練應用程式之後，您就可以進行測試。

從右上方導覽中選取 [測試 ]。
在互動式測試窗格中輸入測試語句，然後按 Enter。例如， 關閉燈光。

在此範例中，將燈正確識別為 HomeAutomation.TurnOff 的最高評分意圖。
選取 [ 檢查 ] 以檢視有關預測的詳細資訊。
關閉測試窗格。

自訂應用程式

除了預先建置的網域，LUIS 還可讓您建立自己的自定義應用程式，或自定義預先建置的應用程式。

建立意圖

若要將更多意圖新增至您的應用程式

選取 左側導覽功能表中的 [意圖 ]。
選取 [建立]
輸入意圖名稱， HomeAutomation.AddDeviceAlias然後選取 [完成]。

建立實體

將更多實體新增至您的應用程式

選取 左側導覽功能表中的 [實體 ]。
選取 [建立]
輸入實體名稱， HomeAutomation.DeviceAlias然後選取 [從類型學習的機器學習]，然後選取 [ 建立]。

新增範例語句

範例語句是使用者在聊天機器人或其他用戶端應用程式中輸入的文字。他們會將使用者的文字意圖對應至 LUIS 意圖。

在的 HomeAutomation.AddDeviceAlias[意圖] 頁面上，於 [範例語句] 底下新增下列範例語句：

#	表達範例
1	`Add alias to my fan to be wind machine`
2	`Alias lights to illumination`
3	`nickname living room speakers to our speakers a new fan`
4	`rename living room tv to main tv`

為了獲得最佳結果，請確定範例語句會以下列方式有所不同：

語句長度
標點符號
文字選擇
動詞緊張（是，是，將是）
文字順序

卷標範例語句

因為您新增了 ML 實體，因此需要標記語句。您的應用程式會使用標籤來瞭解如何擷取您所建立的ML實體。

若要標記語句，您有兩個選項：實體選擇區卷標和內嵌標籤標。

實體選擇區標籤

選取右上方的 @ 圖示，實體選擇區即會在頁面右側開啟。

選取您要開始標記的實體。
反白顯示您想要為此實體加上標籤的文字。

內嵌標籤

反白顯示您想要加上標籤的文字。
從快顯的功能表中，選取您要標記文字的實體。

建立預測資源

此時，您已完成撰寫應用程式。您必須建立預測資源來發佈您的應用程式，才能透過預測端點在聊天機器人或其他用戶端應用程式中接收預測

從 LUIS 入口網站建立預測資源

移至應用程式中的 [管理] 索引標籤。
在左側導覽中，選取 [Azure 資源]。
選取 [新增預測資源] 按鈕。

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

發佈應用程式以取得端點 URL

若要在聊天機器人或其他用戶端應用程式中接收 LUIS 預測，您必須將應用程式發佈至預測端點。

選取 右上方導覽中的 [發佈 ]。
選取 [ 生產位置]，然後選取 [ 完成]。
選取 [存取通知中的端點 URL ] 以移至 [Azure 資源 ] 頁面。如果您擁有與應用程式相關聯的預測資源，您才能看到URL。您也可以按下 [管理] 來尋找 [Azure 資源] 頁面。

查詢 V3 API 預測端點

在 LUIS 入口網站的 [管理] 區段（右上方功能表）、在 [Azure 資源] 頁面（左側功能表）的 [預測資源] 索引卷標上，複製頁面底部的 [範例查詢]。 URL 具有您的應用程式識別碼、金鑰和位置名稱。 V3 預測端點 URL 的格式如下： https://YOUR-RESOURCE-NAME.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/APP-ID/slots/SLOT-NAME/predict?subscription-key=YOUR-PREDICTION-KEY&<optional-name-value-pairs>&query=YOUR_QUERY_HERE

將 URL 貼到新的瀏覽器索引標籤中。如果您沒有看到 URL，則沒有預測資源，而且必須建立一個。

在瀏覽器網址列中，針對查詢字串，請確定下列值位於URL中。如果它們不在查詢字串中，請新增它們：
- verbose=true
- show-all-intents=true

在瀏覽器網址列中，移至 URL 的結尾，然後輸入 關閉查詢字串的客廳燈 ，然後按 Enter 鍵。

{
    "query": "turn off the living room light",
    "prediction": {
        "topIntent": "HomeAutomation.TurnOff",
        "intents": {
            "HomeAutomation.TurnOff": {
                "score": 0.969448864
            },
            "HomeAutomation.QueryState": {
                "score": 0.0122336326
            },
            "HomeAutomation.TurnUp": {
                "score": 0.006547436
            },
            "HomeAutomation.TurnDown": {
                "score": 0.0050634006
            },
            "HomeAutomation.SetDevice": {
                "score": 0.004951761
            },
            "HomeAutomation.TurnOn": {
                "score": 0.00312553928
            },
            "None": {
                "score": 0.000552945654
            }
        },
        "entities": {
            "HomeAutomation.Location": [
                "living room"
            ],
            "HomeAutomation.DeviceName": [
                [
                    "living room light"
                ]
            ],
            "HomeAutomation.DeviceType": [
                [
                    "light"
                ]
            ],
            "$instance": {
                "HomeAutomation.Location": [
                    {
                        "type": "HomeAutomation.Location",
                        "text": "living room",
                        "startIndex": 13,
                        "length": 11,
                        "score": 0.902181149,
                        "modelTypeId": 1,
                        "modelType": "Entity Extractor",
                        "recognitionSources": [
                            "model"
                        ]
                    }
                ],
                "HomeAutomation.DeviceName": [
                    {
                        "type": "HomeAutomation.DeviceName",
                        "text": "living room light",
                        "startIndex": 13,
                        "length": 17,
                        "modelTypeId": 5,
                        "modelType": "List Entity Extractor",
                        "recognitionSources": [
                            "model"
                        ]
                    }
                ],
                "HomeAutomation.DeviceType": [
                    {
                        "type": "HomeAutomation.DeviceType",
                        "text": "light",
                        "startIndex": 25,
                        "length": 5,
                        "modelTypeId": 5,
                        "modelType": "List Entity Extractor",
                        "recognitionSources": [
                            "model"
                        ]
                    }
                ]
            }
        }
    }
}

清除資源

不再需要時，請刪除 LUIS 應用程式。若要這樣做，請從左上方功能表選取 [我的應用程式 ]。選取應用程式清單中應用程式名稱右邊的省略號（...），然後選取 [ 刪除]。在快顯對話框 [刪除應用程式？] 上，選取 [ 確定]。

快速入門：在 LUIS 入口網站中建置您的應用程式

選取訂用帳戶和撰寫資源