將自然語言理解新增至您的 Bot

發行項
03/09/2025

適用於： SDK v4

注意

Language Understanding （LUIS）將於 2025 年 10 月 1 日淘汰。從 2023 年 4 月 1 日起，您將無法建立新的 LUIS 資源。新版的語言理解現在已提供作為 Azure AI 語言的一部分。

對話式語言理解（CLU）是 Azure AI 語言的一項功能，是 LUIS 的更新版本。如需 Bot Framework SDK 中語言理解支援的詳細資訊，請參閱自然語言理解。

瞭解使用者在交談中和上下文的意義的能力可能是困難的，但可以讓聊天機器人有更自然的對話感覺。 Language Understanding （LUIS） 是一種雲端式 API 服務，可讓您執行此動作，讓您的 Bot 能夠辨識使用者訊息的意圖、允許使用者使用更自然的語言，以及更妥善地引導對話流程。

本主題會逐步引導您將 LUIS 新增至航班預訂應用程式，以辨識用戶輸入中包含的不同意圖和實體。

注意

Bot Framework JavaScript、C# 和 Python SDK 將會繼續受到支援，不過，Java SDK 即將淘汰，最終長期支援將於 2023 年 11 月結束。

使用 Java SDK 建置的現有 Bot 將繼續運作。

針對新的 Bot 建置，請考慮使用 Microsoft Copilot Studio ，並閱讀選擇正確的 Copilot 解決方案。

如需詳細資訊，請參閱 Bot 建置的未來。

必要條件

LUIS 帳戶。
在 C#、JavaScript、Java 或 Python 中的 Core Bot 範例的複本。
機器人基本概念和自然語言處理的知識。

關於此範例

此核心 Bot 範例顯示機場航班預訂應用程式的範例。它會使用 LUIS 服務來辨識使用者輸入，並傳回最上層可辨識的 LUIS 意圖。

語言模型包含三個意圖： Book Flight、 Cancel和 None。 LUIS 會使用這些意圖來瞭解用戶傳送訊息給 Bot 時的意義。語言模型也會定義 LUIS 可以從使用者的輸入擷取的實體，例如來源或目的地機場。

在每次處理使用者輸入之後，DialogBot會儲存UserState和ConversationState的目前狀態。收集所有必要的資訊之後，程式碼範例會建立示範航班預約。在本文中，我們將涵蓋此範例的 LUIS 層面。不過，範例的一般流程如下：

OnMembersAddedAsync 當新的使用者連線並顯示歡迎卡片時，就會呼叫。
每當收到使用者輸入時，會呼叫 OnMessageActivityAsync。

類別圖表概述 C# 範例的結構。

模組 OnMessageActivityAsync 會透過 Run 對話框擴充方法執行適當的對話框。然後，主要對話框會呼叫 LUIS 協助程式，以尋找評分最高的用戶意圖。如果使用者輸入的最上層意圖是「BookFlight」，協助程式會使用 LUIS 傳回的使用者資訊來填寫表單。之後，主要對話框會啟動 BookingDialog，這會視需要從使用者取得其他資訊，例如：

Origin 起源城市
TravelDate 預訂航班的日期
Destination 目的地城市

在每次處理使用者輸入之後，dialogBot 會儲存 userState 和 conversationState 的目前狀態。收集所有必要的資訊之後，程式碼範例會建立示範航班預定。在本文中，我們將涵蓋此範例的 LUIS 層面。不過，範例的一般流程如下：

onMembersAdded 當新的使用者連線並顯示歡迎卡片時，就會呼叫。
收到每個使用者輸入後，會呼叫OnMessage。

類別圖表會概述 JavaScript 範例的結構。

這個模組運行onMessage，執行mainDialog，收集使用者輸入。然後，主要對話框會呼叫 LUIS 協助程式 FlightBookingRecognizer ，以尋找評分最高的用戶意圖。如果使用者輸入的最高意圖回傳「BookFlight」，助手會根據 LUIS 回傳的資料為使用者填寫資訊。在回應回復時， mainDialog 保留 LUIS 傳回之使用者的資訊，並啟動 bookingDialog。 bookingDialog 視需要從使用者取得其他資訊，例如

destination 目的地城市。
origin 出發城市。
travelDate 預訂航班的日期。

在每次處理使用者輸入之後，DialogBot會儲存UserState和ConversationState的目前狀態。
收集所有必要的資訊之後，程式碼範例會建立航班預訂。
在本文中，我們將涵蓋此範例的 LUIS 層面。不過，範例的一般流程如下：

onMembersAdded 當新的使用者連線並顯示歡迎卡片時，就會呼叫。
針對每次收到的使用者輸入，會呼叫 onMessageActivity。

類別圖表概述 Java 範例的結構。

模組 onMessageActivity 會透過 run 對話框擴充方法執行適當的對話框。然後，主要對話框會呼叫 LUIS 協助程式，以尋找評分最高的用戶意圖。如果使用者輸入的最上層意圖識別為「BookFlight」，協助程式會填寫使用者從 LUIS 傳回的資訊。之後，主要對話框會啟動 BookingDialog，這會視需要從使用者取得其他資訊，例如：

Origin 起始城市
TravelDate 預訂航班的日期
Destination 目的地城市

在每次處理使用者輸入之後，DialogBot 會儲存 user_state和conversation_state的目前狀態。收集所有必要的資訊之後，程式碼範例會建立示範航班預留。在本文中，我們將涵蓋此範例的 LUIS 層面。不過，範例的一般流程如下：

on_members_added_activity 當新的使用者連線並顯示歡迎卡片時，就會呼叫。
on_message_activity 函數會針對收到的每個使用者輸入被呼叫。

概述 Python 範例結構的類別圖表。

模組 on_message_activity 會透過 run_dialog 對話框擴充方法執行適當的對話框。然後，主要對話框會呼叫 LuisHelper 以尋找評分最高的用戶意圖。如果使用者的主要意圖返回「BookFlight」，則協助函數會填寫從使用者輸入中透過 LUIS 獲得的資訊。之後，主要對話框會啟動 BookingDialog，這會視需要從使用者取得其他資訊，例如：

destination 目的地城市。
origin 起源城市。
travel_date 預訂航班的日期。

本文涵蓋如何將 LUIS 新增至 Bot。如需使用對話框或狀態的相關信息，請參閱如何使用對話框提示收集使用者輸入，或分別儲存使用者和交談數據。

在 LUIS 入口網站中建立 LUIS 應用程式

登入 LUIS 入口網站，並視需要建立帳戶和撰寫資源。
在 LUIS 的 交談應用程式 頁面上，選取匯入，然後選取 匯入為 JSON。
在 [ 匯入新的應用程式 ] 對話框中：
1. 在範例的 CognitiveModels 資料夾中，選擇FlightBooking.json檔案。
2. 輸入 FlightBooking 作為應用程式的選擇性名稱，然後選取 [ 完成]。
網站可能會顯示如何建立有效的 LUIS 應用程式和升級複合實體對話方塊。您可以關閉這些對話框並繼續。
訓練您的應用程式，然後將您的應用程式發佈至生產環境。如需詳細資訊，請參閱 LUIS 文件，瞭解如何訓練和發布應用程式。

為何使用實體

LUIS 實體可讓 Bot 瞭解超出標準意圖的事件。這可讓您從使用者收集其他資訊，讓 Bot 可以提出問題並更聰明地回應。除了三個 LUIS 意圖「Book Flight」、「Cancel」和「None」的定義之外，FlightBooking.json 檔案也包含一組實體，例如「From.Airport」和「To.Airport」。這些實體可讓 LUIS 在要求新的旅行預約時，偵測並傳回使用者原始輸入內含的其他資訊。

取得值以連線到 LUIS 應用程式

發佈 LUIS 應用程式之後，您可以從 Bot 存取它。您必須記錄數個值，才能從您的機器人內部存取 LUIS 應用程式。您可以使用 LUIS 入口網站來擷取該資訊。

從 LUIS.ai 入口網站擷取應用程式資訊

配置檔案（appsettings.json.env或config.py）作為匯集所有服務參考的位置。您擷取的資訊將會在下一節中新增至此檔案。

從 luis.ai 選取已發佈的 LUIS 應用程式。
開啟已發佈的 LUIS 應用程式後，選取 [ 管理] 索引標籤。
選取左側的設定索引標籤，並將 應用程式 ID 顯示的值記錄為 <YOUR_APP_ID>。
選取 Azure 資源，然後 預測資源。將位置的值記錄為 <YOUR_REGION>，並將主鍵記錄為 <YOUR_AUTHORING_KEY>。

或者，您可以針對撰寫資源使用區域和主鍵。

更新設定檔案

將存取 LUIS 應用程式所需的資訊，包括應用程式識別碼、撰寫密鑰和區域新增至 appsettings.json 檔案。在上一個步驟中，您已從已發佈的 LUIS 應用程式擷取這些值。 API 主機名稱的格式 <your region>.api.cognitive.microsoft.com應為。

appsetting.json

警告