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

發行項
05/02/2024

適用於： SDK v4

注意

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

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

瞭解使用者在交談和內容上的意義的能力可能是一項困難的工作，但可以提供 Bot 更自然的對話感覺。 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 基本概念和自然語言處理的知識。

關於此範例

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

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

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

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

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

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

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

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

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

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

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

destination 目的地城市。
origin 原始城市。
travelDate 預訂航班的日期。

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

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

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

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

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

在每次處理使用者輸入之後，DialogBot儲存和 conversation_state的user_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 存取它。您必須記錄數個值，才能從 Bot 記憶體取 LUIS 應用程式。您可以使用 LUIS 入口網站來擷取該資訊。

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

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

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

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

更新 settings 檔案

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

appsetting.json

{
  "MicrosoftAppType": "",
  "MicrosoftAppId": "",
  "MicrosoftAppPassword": "",
  "MicrosoftAppTenantId": "",
  "LuisAppId": "",
  "LuisAPIKey": "",
  "LuisAPIHostName": ""
}

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

.env

MicrosoftAppType=
MicrosoftAppId=
MicrosoftAppPassword=
MicrosoftAppTenantId=
LuisAppId=
LuisAPIKey=
LuisAPIHostName=

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

application.properties

MicrosoftAppId=
MicrosoftAppPassword=
LuisAppId=
LuisAPIKey=
LuisAPIHostName=
server.port=3978

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

config.py

APP_ID = os.environ.get("MicrosoftAppId", "")
APP_PASSWORD = os.environ.get("MicrosoftAppPassword", "")
APP_TYPE = os.environ.get("MicrosoftAppType", "MultiTenant")
APP_TENANTID = os.environ.get("MicrosoftAppTenantId", "")
LUIS_APP_ID = os.environ.get("LuisAppId", "")
LUIS_API_KEY = os.environ.get("LuisAPIKey", "")

設定 Bot 以使用 LUIS 應用程式

請確定 已為您的專案安裝 Microsoft.Bot.Builder.AI.Luis NuGet 套件。

若要連線到 LUIS 服務，Bot 會提取您新增至appsetting.json檔案的資訊。類別 FlightBookingRecognizer 包含程序代碼，其中包含來自 appsetting.json 檔案的程序代碼，並藉由呼叫 RecognizeAsync 方法來查詢 LUIS 服務。

FlightBookingRecognizer.cs

public class FlightBookingRecognizer : IRecognizer
{
    private readonly LuisRecognizer _recognizer;

    public FlightBookingRecognizer(IConfiguration configuration)
    {
        var luisIsConfigured = !string.IsNullOrEmpty(configuration["LuisAppId"]) && !string.IsNullOrEmpty(configuration["LuisAPIKey"]) && !string.IsNullOrEmpty(configuration["LuisAPIHostName"]);
        if (luisIsConfigured)
        {
            var luisApplication = new LuisApplication(
                configuration["LuisAppId"],
                configuration["LuisAPIKey"],
                "https://" + configuration["LuisAPIHostName"]);
            // Set the recognizer options depending on which endpoint version you want to use.
            // More details can be found in https://docs.microsoft.com/en-gb/azure/cognitive-services/luis/luis-migration-api-v3
            var recognizerOptions = new LuisRecognizerOptionsV3(luisApplication)
            {
                PredictionOptions = new Bot.Builder.AI.LuisV3.LuisPredictionOptions
                {
                    IncludeInstanceData = true,
                }
            };

            _recognizer = new LuisRecognizer(recognizerOptions);
        }
    }

    // Returns true if luis is configured in the appsettings.json and initialized.
    public virtual bool IsConfigured => _recognizer != null;

    public virtual async Task<RecognizerResult> RecognizeAsync(ITurnContext turnContext, CancellationToken cancellationToken)
        => await _recognizer.RecognizeAsync(turnContext, cancellationToken);

    public virtual async Task<T> RecognizeAsync<T>(ITurnContext turnContext, CancellationToken cancellationToken)
        where T : IRecognizerConvert, new()
        => await _recognizer.RecognizeAsync<T>(turnContext, cancellationToken);
}

FlightBookingEx.cs包含擷取 From、To 和 TravelDate 的邏輯;它會擴充從呼叫 FlightBookingRecognizer.RecognizeAsync<FlightBooking> MainDialog.cs時用來儲存 LUIS 結果的部分類別FlightBooking.cs。

CognitiveModels\FlightBookingEx.cs

// Extends the partial FlightBooking class with methods and properties that simplify accessing entities in the luis results
public partial class FlightBooking
{
    public (string From, string Airport) FromEntities
    {
        get
        {
            var fromValue = Entities?._instance?.From?.FirstOrDefault()?.Text;
            var fromAirportValue = Entities?.From?.FirstOrDefault()?.Airport?.FirstOrDefault()?.FirstOrDefault();
            return (fromValue, fromAirportValue);
        }
    }

    public (string To, string Airport) ToEntities
    {
        get
        {
            var toValue = Entities?._instance?.To?.FirstOrDefault()?.Text;
            var toAirportValue = Entities?.To?.FirstOrDefault()?.Airport?.FirstOrDefault()?.FirstOrDefault();
            return (toValue, toAirportValue);
        }
    }

    // This value will be a TIMEX. And we are only interested in a Date so grab the first result and drop the Time part.
    // TIMEX is a format that represents DateTime expressions that include some ambiguity. e.g. missing a Year.
    public string TravelDate
        => Entities.datetime?.FirstOrDefault()?.Expressions.FirstOrDefault()?.Split('T')[0];
}

若要使用 LUIS，您的項目必須安裝 botbuilder-ai npm 套件。

若要連線到 LUIS 服務，Bot 會使用您新增至 .env 檔案的資訊。類別 flightBookingRecognizer.js 包含從檔案匯入設定 .env 的程式代碼，並藉由呼叫 recognize() 方法來查詢 LUIS 服務。

dialogs/flightBookingRecognizer.js

class FlightBookingRecognizer {
    constructor(config) {
        const luisIsConfigured = config && config.applicationId && config.endpointKey && config.endpoint;
        if (luisIsConfigured) {
            // Set the recognizer options depending on which endpoint version you want to use e.g v2 or v3.
            // More details can be found in https://docs.microsoft.com/en-gb/azure/cognitive-services/luis/luis-migration-api-v3
            const recognizerOptions = {
                apiVersion: 'v3'
            };

            this.recognizer = new LuisRecognizer(config, recognizerOptions);
        }
    }

    get isConfigured() {
        return (this.recognizer !== undefined);
    }

    /**
     * Returns an object with preformatted LUIS results for the bot's dialogs to consume.
     * @param {TurnContext} context
     */
    async executeLuisQuery(context) {
        return await this.recognizer.recognize(context);
    }

    getFromEntities(result) {
        let fromValue, fromAirportValue;
        if (result.entities.$instance.From) {
            fromValue = result.entities.$instance.From[0].text;
        }
        if (fromValue && result.entities.From[0].Airport) {
            fromAirportValue = result.entities.From[0].Airport[0][0];
        }

        return { from: fromValue, airport: fromAirportValue };
    }

    getToEntities(result) {
        let toValue, toAirportValue;
        if (result.entities.$instance.To) {
            toValue = result.entities.$instance.To[0].text;
        }
        if (toValue && result.entities.To[0].Airport) {
            toAirportValue = result.entities.To[0].Airport[0][0];
        }

        return { to: toValue, airport: toAirportValue };
    }

    /**
     * This value will be a TIMEX. And we are only interested in a Date so grab the first result and drop the Time part.
     * TIMEX is a format that represents DateTime expressions that include some ambiguity. e.g. missing a Year.
     */
    getTravelDate(result) {
        const datetimeEntity = result.entities.datetime;
        if (!datetimeEntity || !datetimeEntity[0]) return undefined;

        const timex = datetimeEntity[0].timex;
        if (!timex || !timex[0]) return undefined;

        const datetime = timex[0].split('T')[0];
        return datetime;
    }
}

擷取From、To和 TravelDate 的邏輯會在內 flightBookingRecognizer.js實作為協助程式方法。從呼叫 flightBookingRecognizer.executeLuisQuery() 之後，會使用這些方法 mainDialog.js

請確定 com.microsoft.bot.bot-ai-luis-v3 套件已新增至您的pom.xml檔案。

<dependency>
  <groupId>com.microsoft.bot</groupId>
  <artifactId>bot-ai-luis-v3</artifactId>
  <version>4.14.1</version>
</dependency>

若要連線到 LUIS 服務，Bot 會提取您新增至 application.properties 檔案的資訊。類別 FlightBookingRecognizer 包含來自 application.properties 檔案之設定的程式代碼，並藉由呼叫 recognize 方法來查詢 LUIS 服務。

FlightBookingRecognizer.java

/**
 * The constructor of the FlightBookingRecognizer class.
 *
 * @param configuration The Configuration object to use.
 */
public FlightBookingRecognizer(Configuration configuration) {
    Boolean luisIsConfigured = StringUtils.isNotBlank(configuration.getProperty("LuisAppId"))
        && StringUtils.isNotBlank(configuration.getProperty("LuisAPIKey"))
        && StringUtils.isNotBlank(configuration.getProperty("LuisAPIHostName"));
    if (luisIsConfigured) {
        LuisApplication luisApplication = new LuisApplication(
            configuration.getProperty("LuisAppId"),
            configuration.getProperty("LuisAPIKey"),
            String.format("https://%s", configuration.getProperty("LuisAPIHostName"))
        );
        // Set the recognizer options depending on which endpoint version you want to use.
        // More details can be found in
        // https://docs.microsoft.com/en-gb/azure/cognitive-services/luis/luis-migration-api-v3
        LuisRecognizerOptionsV3 recognizerOptions = new LuisRecognizerOptionsV3(luisApplication);
        recognizerOptions.setIncludeInstanceData(true);

        this.recognizer = new LuisRecognizer(recognizerOptions);
    }
}

/**
 * Runs an utterance through a recognizer and returns a generic recognizer result.
 *
 * @param turnContext Turn context.
 * @return Analysis of utterance.
 */
@Override
public CompletableFuture<RecognizerResult> recognize(TurnContext turnContext) {
    return this.recognizer.recognize(turnContext);
}

FlightBookingRecognizer.cs包含要擷取 From、To 和 TravelDate 的邏輯;而且會從 MainDialog.java 呼叫以譯碼 Luis 查詢結果的結果。

FlightBookingRecognizer.java

/**
 * Gets the From data from the entities which is part of the result.
 *
 * @param result The recognizer result.
 * @return The object node representing the From data.
 */
public ObjectNode getFromEntities(RecognizerResult result) {
    String fromValue = "", fromAirportValue = "";
    if (result.getEntities().get("$instance").get("From") != null) {
        fromValue = result.getEntities().get("$instance").get("From").get(0).get("text")
            .asText();
    }
    if (!fromValue.isEmpty()
        && result.getEntities().get("From").get(0).get("Airport") != null) {
        fromAirportValue = result.getEntities().get("From").get(0).get("Airport").get(0).get(0)
            .asText();
    }

    ObjectMapper mapper = new ObjectMapper().findAndRegisterModules();
    ObjectNode entitiesNode = mapper.createObjectNode();
    entitiesNode.put("from", fromValue);
    entitiesNode.put("airport", fromAirportValue);
    return entitiesNode;
}

/**
 * Gets the To data from the entities which is part of the result.
 *
 * @param result The recognizer result.
 * @return The object node representing the To data.
 */
public ObjectNode getToEntities(RecognizerResult result) {
    String toValue = "", toAirportValue = "";
    if (result.getEntities().get("$instance").get("To") != null) {
        toValue = result.getEntities().get("$instance").get("To").get(0).get("text").asText();
    }
    if (!toValue.isEmpty() && result.getEntities().get("To").get(0).get("Airport") != null) {
        toAirportValue = result.getEntities().get("To").get(0).get("Airport").get(0).get(0)
            .asText();
    }

    ObjectMapper mapper = new ObjectMapper().findAndRegisterModules();
    ObjectNode entitiesNode = mapper.createObjectNode();
    entitiesNode.put("to", toValue);
    entitiesNode.put("airport", toAirportValue);
    return entitiesNode;
}

/**
 * This value will be a TIMEX. And we are only interested in a Date so grab the first result and
 * drop the Time part. TIMEX is a format that represents DateTime expressions that include some
 * ambiguity. e.g. missing a Year.
 *
 * @param result A {link RecognizerResult}
 * @return The Timex value without the Time model
 */
public String getTravelDate(RecognizerResult result) {
    JsonNode datetimeEntity = result.getEntities().get("datetime");
    if (datetimeEntity == null || datetimeEntity.get(0) == null) {
        return null;
    }

    JsonNode timex = datetimeEntity.get(0).get("timex");
    if (timex == null || timex.get(0) == null) {
        return null;
    }

    String datetime = timex.get(0).asText().split("T")[0];
    return datetime;
}

請確定 已為您的專案安裝 botbuilder-ai PyPI 套件。

若要連線到 LUIS 服務，Bot 會使用您新增至 config.py 檔案的資訊。類別 FlightBookingRecognizer 包含從檔案匯入設定 config.py 的程式代碼，並藉由呼叫 recognize() 方法來查詢 LUIS 服務。

flight_booking_recognizer.py

class FlightBookingRecognizer(Recognizer):
    def __init__(self, configuration: DefaultConfig):
        self._recognizer = None

        luis_is_configured = (
            configuration.LUIS_APP_ID
            and configuration.LUIS_API_KEY
            and configuration.LUIS_API_HOST_NAME
        )
        if luis_is_configured:
            # Set the recognizer options depending on which endpoint version you want to use e.g v2 or v3.
            # More details can be found in https://docs.microsoft.com/azure/cognitive-services/luis/luis-migration-api-v3
            luis_application = LuisApplication(
                configuration.LUIS_APP_ID,
                configuration.LUIS_API_KEY,
                "https://" + configuration.LUIS_API_HOST_NAME,
            )

            self._recognizer = LuisRecognizer(luis_application)

    @property
    def is_configured(self) -> bool:
        # Returns true if luis is configured in the config.py and initialized.
        return self._recognizer is not None

    async def recognize(self, turn_context: TurnContext) -> RecognizerResult:
        return await self._recognizer.recognize(turn_context)

擷取 From、To 和 travel_date 的邏輯會實作為來自類別的LuisHelperluis_helper.py協助程式方法。從呼叫 LuisHelper.execute_luis_query() 之後，會使用這些方法 main_dialog.py

helpers/luis_helper.py

class LuisHelper:
    @staticmethod
    async def execute_luis_query(
        luis_recognizer: LuisRecognizer, turn_context: TurnContext
    ) -> (Intent, object):
        """
        Returns an object with preformatted LUIS results for the bot's dialogs to consume.
        """
        result = None
        intent = None

        try:
            recognizer_result = await luis_recognizer.recognize(turn_context)

            intent = (
                sorted(
                    recognizer_result.intents,
                    key=recognizer_result.intents.get,
                    reverse=True,
                )[:1][0]
                if recognizer_result.intents
                else None
            )

            if intent == Intent.BOOK_FLIGHT.value:
                result = BookingDetails()

                # We need to get the result from the LUIS JSON which at every level returns an array.
                to_entities = recognizer_result.entities.get("$instance", {}).get(
                    "To", []
                )
                if len(to_entities) > 0:
                    if recognizer_result.entities.get("To", [{"$instance": {}}])[0][
                        "$instance"
                    ]:
                        result.destination = to_entities[0]["text"].capitalize()
                    else:
                        result.unsupported_airports.append(
                            to_entities[0]["text"].capitalize()
                        )

                from_entities = recognizer_result.entities.get("$instance", {}).get(
                    "From", []
                )
                if len(from_entities) > 0:
                    if recognizer_result.entities.get("From", [{"$instance": {}}])[0][
                        "$instance"
                    ]:
                        result.origin = from_entities[0]["text"].capitalize()
                    else:
                        result.unsupported_airports.append(
                            from_entities[0]["text"].capitalize()
                        )

                # This value will be a TIMEX. And we are only interested in a Date so grab the first result and drop
                # the Time part. TIMEX is a format that represents DateTime expressions that include some ambiguity.
                # e.g. missing a Year.
                date_entities = recognizer_result.entities.get("datetime", [])
                if date_entities:
                    timex = date_entities[0]["timex"]

                    if timex:
                        datetime = timex[0].split("T")[0]

                        result.travel_date = datetime

                else:
                    result.travel_date = None

        except Exception as exception:
            print(exception)

        return intent, result

LUIS 現在已為您的 Bot 設定並連線。

測試聊天機器人

下載並安裝最新的 Bot Framework 模擬器

在本機電腦上執行範例。如果您需要指示，請參閱 README C# 範例、JS 範例或 Python 範例的檔案。
在模擬器中，輸入訊息，例如「前往巴黎」或「從巴黎前往柏林」。使用檔案中找到的任何語句FlightBooking.json來定型意圖「預訂正式發行前小眾測試版」。

如果 LUIS 傳回的最上層意圖解析為「預訂正式發行前小眾測試版」，您的 Bot 會詢問更多問題，直到其儲存足夠的資訊來建立旅行預約為止。屆時，會將此預訂資訊傳回給您的使用者。

此時，程式代碼 Bot 邏輯將會重設，您可以繼續建立更多預約。

其他資訊

如需 LUIS 的詳細資訊，請參閱 LUIS 檔：

提示

SDK 的不同部分會定義不同的實體類別或元素。如需訊息實體，請參閱實體和活動類型。

共用方式為