撰寫自定義命令應用程式時偵錯錯誤

重要

自定義命令將於 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 Nope、Not

常見範例句子

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

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

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

空的範例句子

您需要針對每個命令至少有一個範例句子。

範例句子中的未定義參數

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

訓練時間太長

LUIS 定型的目的是要快速學習,但範例較少。 不要新增太多範例句子。

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

例如,您可以定義下列範例句子的參數 {vehicle},並將 “Book a {vehicle}” 新增至範例句子。

範例句子 模式
預訂汽車 預訂 {vehicle}
預訂正式發行前小眾測試版 預訂 {vehicle}
預訂計程車 預訂 {vehicle}

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

無法更新 LUIS 金鑰

重新指派給 E0 撰寫資源

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

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

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

[儲存] 按鈕已停用

如果您從未將 LUIS 預測資源指派給應用程式,當您嘗試變更撰寫資源而不新增預測資源時,將會停用 [儲存] 按鈕。

下一步