在撰寫自訂命令應用程式時進行偵錯

重要

自訂命令將于 2026 年 4 月 30 日淘汰,自 2023 年 10 月 30 日起,您將無法在 Speech Studio 中建立新的自訂命令應用程式。 與這項變更有關, LUIS 將于 2025 年 10 月 1 日淘汰,從 2023 年 4 月 1 日開始,您將無法建立新的 LUIS 資源。

此文章描述如何在於建置自訂命令應用程式期間發現錯誤時進行偵錯。

建立應用程式時發生的錯誤

建立自訂命令應用程式時,自訂命令也會在 LUIS 中建立應用程式。

LUIS 針對每個撰寫資源具有 500 個應用程式的限制。 如果您使用的撰寫資源已經有 500 個應用程式,建立 LUIS 應用程式可能會失敗。

請確定所選 LUIS 撰寫資源的應用程式少於 500 個。 否則,您可以建立新的 LUIS 撰寫資源、切換至另一個資源,或嘗試清除您的 LUIS 應用程式。

刪除應用程式時發生的錯誤

無法刪除 LUIS 應用程式

刪除自訂命令應用程式時,自訂命令也可能會嘗試刪除與自訂命令應用程式相關聯的 LUIS 應用程式。

如果 LUIS 應用程式刪除失敗,請移至您的 LUIS \(英文\) 帳戶以手動將其刪除。

TooManyRequests

當您嘗試一次刪除大量的應用程式時,可能會看到 'TooManyRequests' 錯誤。 這些錯誤表示 Azure 已對您的刪除要求進行節流。

請重新整理您的頁面,並嘗試刪除較少的應用程式。

修改應用程式時發生的錯誤

無法刪除參數或 Web 端點

您無法刪除正在使用的參數。 請移除任何語音回應、範例句子、條件和動作中針對該參數的參考,然後再試一次。

無法刪除 Web 端點

您無法刪除正在使用的 Web 端點。 移除 Web 端點之前,請先移除使用此 Web 端點的任何呼叫 Web 端點動作。

對應用程式進行定型時發生的錯誤

內建意圖

LUIS 具有內建的 Yes/No 意圖。 使用只有 "yes"、"no" 的範例句子時,將會導致定型失敗。

關鍵字 變化
Yes Sure、OK
No Nope、Not

常見的範例句子

自訂命令不允許在不同的命令之間共用常見的範例句子。 如果某個命令中的某些範例句子已經在另一個命令中定義,則應用程式的定型可能會失敗。

請確定您沒有在不同命令之間共用常見的範例句子。

如需在不同命令之間於範例句子上取得平衡的最佳做法,請參閱 LUIS 最佳做法

空白的範例句子

每個命令都必須至少有一個範例句子。

範例句子中具有未定義的參數

範例句子中使用一或多個未定義的參數。

定型所需的時間太長

LUIS 定型旨在透過較少的範例快速學習。 請勿新增太多範例句子。

如果您有許多類似的範例句子,請定義參數、將其抽象化為模式,然後將其新增至範例句子。

例如,您可以為下列範例句子定義參數 {vehicle},並只將 "Book a {vehicle}" (預訂 {vehicle}) 新增至範例句子。

範例句子 模式
Book a car (預訂汽車) Book a {vehicle} (預訂 {vehicle})
預訂班機 Book a {vehicle} (預訂 {vehicle})
Book a taxi (預訂計程車) Book a {vehicle} (預訂 {vehicle})

如需 LUIS 定型的最佳做法,請參閱 LUIS 最佳做法

無法更新 LUIS 金鑰

重新指派給 E0 撰寫資源

LUIS 不支援將 LUIS 應用程式重新指派給 E0 撰寫資源。

如果您需要將撰寫資源從 F0 變更為 E0,或變更為不同的 E0 資源,請重新建立應用程式。

若要快速匯出現有的應用程式,並將其匯入新的應用程式,請參閱使用 Azure DevOps 進行持續部署

[Save] \(儲存\) 按鈕已停用

如果您從未將 LUIS 預測資源指派給您的應用程式,則當您嘗試在不新增預測資源的情況下變更撰寫資源時,系統將會停用 [Save] \(儲存\) 按鈕。

下一步