自訂命令概念和定義
重要
自定義命令將於 2026 年 4 月 30 日淘汰。 自 2023 年 10 月 30 日起，您無法在 Speech Studio 中建立新的自定義命令應用程式。 與此變更相關， LUIS 將於 2025 年 10 月 1 日淘汰。 自 2023 年 4 月 1 日起，您無法建立新的 LUIS 資源。
本文可作為自定義命令應用程式概念和定義的參考。
命令組態
命令是自定義命令應用程式的基本建置組塊。 命令是一組完成使用者所定義特定工作所需的組態。
範例句子
範例語句是使用者可以說來觸發特定命令的集合範例。 您只需要提供語句的範例，而不是詳盡的清單。
參數
參數是命令完成工作所需的資訊。 在複雜的案例中，參數也可以用來定義觸發自定義動作的條件。
完成規則
完成規則是一系列規則，可在命令準備好完成之後執行，例如，滿足規則的所有條件時。
互動規則
互動規則是處理更特定或複雜情況的額外規則。 您可以新增更多驗證或設定進階功能，例如確認或單步驟更正。 您也可以建置自己的自定義互動規則。
參陣組態
參數是命令完成工作所需的資訊。 在複雜的案例中，參數也可以用來定義觸發自定義動作的條件。
名稱
參數是由 name 屬性所識別。 您應該一律為參數提供描述性名稱。 您可以跨不同區段參考參數，例如，當您建構條件、語音回應或其他動作時。
必要
此複選框表示此命令履行或完成是否需要此參數的值。 如果參數標示為必要，您必須設定回應，以提示使用者提供值。
如果您將必要參數設定為具有預設值，系統仍會提示輸入參數的值。
類型
自訂命令支援下列參數類型：
- 年齡
- 貨幣
- Datetime
- 維度
- 電子郵件
- 地理位置
- 數值
- 序數
- 百分比
- PersonName
- PhoneNumber
- String
- 溫度
- Url
每個地區設定都支援 「String」 參數類型，但所有其他類型的可用性會因地區設定而異。 自定義命令會使用 LUIS 預先建置的實體解析，因此地區設定中的參數類型可用性取決於 LUIS 在該地區設定中預先建置的實體支援。 您可以在每個地區設定中找到 LUIS 預先建置實體支援的詳細數據。 目前不支援自定義 LUIS 實體（例如機器學習實體）。
某些參數類型，例如 Number、String 和 DateTime 支援預設值組態，您可以從入口網站進行設定。
組態
組態是只針對 String 類型定義的參數屬性。 支援下列值：
- None：
- 接受完整輸入：啟用時，參數會接受任何輸入語句。 當使用者需要具有完整語句的參數時，此選項很有用。 例如，郵政位址。
- 接受外部目錄的預先定義輸入值：這個值可用來設定可假設各種值的參數。 例如銷售目錄。 在此情況下，目錄裝載於外部 Web 端點上，而且可以獨立設定。
- 接受來自內部目錄的預先定義輸入值：這個值可用來設定可以假設幾個值的參數。 在此情況下，必須在Speech Studio中設定值。
驗證
驗證是適用於特定參數類型的建構，可讓您設定參數值的條件約束。 目前，自定義命令支援下列參數類型的驗證：
- Datetime
- 數值
規則設定
自訂命令中的規則是由一組符合時執行動作的條件所定義。 規則也可讓您設定 下一回合的執行后狀態 和 預期 。
類型
自訂命令支援下列規則類別：
- 完成規則：這些規則必須在命令履行時執行。 本節中設定的所有規則，其中條件為 true 將會執行。
- 互動規則：這些規則可用來設定額外的自定義驗證、確認和單步驟更正，或完成任何其他自定義對話邏輯。 互動規則會在處理的每個回合進行評估，並可用來觸發完成規則。
設定為規則一部分的不同動作會依撰寫入口網站中出現的順序來執行。
條件
條件是執行規則所必須符合的需求。 規則條件可以是下列型態：
- 參數值等於：已設定的參數值等於特定值。
- 沒有參數值：已設定的參數不應該有任何值。
- 必要參數：已設定的參數具有值。
- 所有必要的參數：標示為必要的所有參數都有值。
- 更新的參數：由於處理目前的輸入（語句或活動）而更新了一或多個參數值。
- 確認成功：輸入語句或活動是成功的確認（是）。
- 確認遭到拒絕：輸入語句或活動不是成功的確認（否）。
- 需要更新先前的命令：當您想要擷取否定的確認以及更新時，此條件會在實例中使用。 在幕後，當對話引擎偵測到意圖與上一回合相同，且使用者已回應更新時，就會設定此條件。
動作
- 傳送語音回應：將語音回應傳送回用戶端。
- 更新參數值：將命令參數的值更新為指定的值。
- 清除參數值：清除命令參數值。
- 呼叫 Web 端點：呼叫 Web 端點。
- 將活動傳送至用戶端：將自定義活動傳送至用戶端。
期望
預期可用來設定下一個使用者輸入處理的提示。 支援下列類型：
- 預期使用者確認：此預期會指定應用程式預期下一個使用者輸入的確認 （是/否）。
- 預期來自使用者的參數輸入：此預期會指定應用程式預期來自使用者輸入的一或多個命令參數。
執行后狀態
執行后狀態是處理目前輸入 （語句或活動） 之後的對話狀態。 其為下列類型：
- 保留目前狀態：只保留目前狀態。
- 完成命令：完成命令，而且不會再處理命令的規則。
- 執行完成規則：執行所有有效的完成規則。
- 等候使用者的輸入：等候下一個用戶輸入。