瞭解錯誤碼

發行項
01/08/2025

當代理程式在交談期間遇到問題時，它會回應一則訊息，其中包含所遇到的特定問題的錯誤碼。代理程式的使用者應將此錯誤碼提供給其管理員。

作為代理程式製作者，如果在使用測試窗格測試代理程式時出現問題，除了錯誤碼之外，您還可以看到一則訊息，其中包含有關該問題的更多上下文。或者，您可以使用主題檢查器面板來驗證您的代理程式。

錯誤清單

注意

某些錯誤訊息中使用的術語對話方塊指的是主題。

錯誤碼	Description
ContentError	主題內容中有錯誤。
DataLossPreventionViolation	違反資料外洩防護。
FlowActionException	執行雲端流程時發生錯誤。
FlowActionBadRequest	對雲端工作流程發出的要求格式不正確。
FlowActionTimedOut	雲端流程執行超過 100 秒且逾時。
InvalidContent	將無效內容新增至程式碼編輯器。
InfiniteLoopInBotContent	節點執行次數過多。
LatestPublishedVersionNotFound	無法擷取代理程式的已發佈版本。
RedirectToDisabledDialog	主題正在重新導向至停用的主題。
RedirectToNonExistentDialog	主題正在重新導向至其他已不存在的主題。
SystemError	Copilot Studio 中發生系統錯誤。

ContentError

錯誤訊息：此錯誤會根據錯誤的內容來產生動態訊息。

解決方案：這是一個針對與代理程式內容相關問題的通用錯誤。請參閱錯誤訊息以了解詳細資訊。

常見的問題包括：

節點缺少必要的屬性。
使用程式碼編輯器新增了無效的 YAML。
Power Fx 公式包含錯誤。

DataLossPreventionViolation

錯誤訊息：「此環境要求使用者先登入才能使用代理程式。移至「管理 > 安全性 > 驗證」，然後選取 [要求使用者登入] 選項。」

解決方式：

您環境的資料外洩防護 (DLP) 原則要求該使用者必須登入。請參閱使用「登入系統」主題來新增使用者認證。。
代理程式中使用的一個或多個連接器不在同一資料群組中。請參閱Copilot Studio連接器。
代理程式中使用的一個或多個連接器已被租用戶管理員封鎖。

FlowActionException

錯誤訊息：

「儘管根據代理程式定義需要輸出，但未從流程 {FlowName} ({FlowId}) 收到輸出。」
「回覆資料中缺少流程 {FlowName} ({FlowId}) 上名稱為 {ItemKey} 的輸出參數。重新整理流程，或確認流程傳回此值。」
「輸出結構描述中缺少流程 {FlowName} ({FlowId}) 上名為 {ItemKey} 的輸出參數。請重新整理流程。」

解決方法：檢查流程是否有錯誤。

FlowActionBadRequest

錯誤訊息：

「流程 {FlowName} ({FlowId}) 上名為 {KeyName} 的參數會宣告為 {ItemTypeKind} 類型。叫用 Power Automate 時不支援此作業類型。目前只支援文字、布林值和數字。」
「呼叫流程動作中缺少流程 {FlowName} ({FlowId}) 上名為 {ItemKey} 的參數。」
「流程 {FlowName} ({FlowId}) 上名為 {KeyName} 的參數評估為 {ResolveType} 類型，預期為 {ExpectedType} 類型。」
「流程 {FlowName} ({FlowId}) 無法使用回應碼 {ResponseCode} 執行，錯誤碼：{FlowErrorCode}。」

解決方案：檢查傳遞給流程的任何變數的基底類型是否符合參數的類型。

FlowActionTimedOut

錯誤訊息：「ID 為 {FlowId} 的流程已逾時。錯誤碼：{FlowErrorCode}」

解決方案：檢查流程是否有錯誤，以了解為什麼雲端流程需要超過 100 秒才能執行才返回代理程式。嘗試最佳化查詢和從後端系統傳回的資料。如果某些雲端流程邏輯在結果傳送到代理程式後可以繼續執行，請將這些操作放在雲端流程中的「將值傳回 Copilot Studio」步驟之後。

InvalidContent

錯誤訊息：「代理程式中總共存在 {TotalComponents} 個元件，但沒有一個有效。」

解決方案：打開程式碼編輯器以查看內容的問題。

InfiniteLoopInBotContent

錯誤訊息：「 {DialogId}.{TriggerId}.{ActionId} 動作連續執行超過 {MaxTurnCount} 次。這表示對話方塊執行期間有迴圈，因此對話方塊執行將會終止。」

解決方案：請確定主題正確結束，和連結至其他已正確結束的主題，例如呈報的系統主題。

LatestPublishedVersionNotFound

錯誤訊息：「無法擷取最新發佈的代理程式版本。」

解決方案：發佈代理程式。

RedirectToDisabledDialog

錯誤訊息：「識別碼為 {DialogId} 的對話方塊在定義中已停用。使用對話方塊之前，請先啟用對話方塊。」

解決方案：重新啟用主題或移除重新導向節點。

RedirectToNonExistentDialog

錯誤訊息：「在定義中找不到識別碼為 {DialogId} 的對話方塊。請檢查對話方塊是否存在，以及識別碼是否正確。」

解決方案：建立一個新主題以重新導向，或移除重新導向節點。

SystemError

錯誤訊息：此錯誤不會產生錯誤訊息。

解決方案：聯絡客戶支援。

Error	機器人回應	解決方法
2000	「使用者會受困在無限迴圈。請檢查以確認 `{Topic Name}` 達到邏輯結論。」	確保主題正確結束，或連結到正確結束的其他主題，例如上呈系統主題。
2001	「此機器人內容無效。」	檢查主題是否有錯誤。
2002	「使用 CDS 時遇到問題。」	存取Dataverse時發生問題。請檢查您的設定是否有錯。否則請稍後再試一次，因為可能會發生服務問題。
2003	「`{Topic Name}` 中的 `{Flow Name}` 發生問題。請檢查您的內容。」	檢查流程是否有錯誤，並在流程執行歷程記錄中尋找失敗的執行。
2004	「`{Topic Name}` 中的 `{Skill Name}` 發生問題。請檢查您的內容。」	您的技能發生問題。檢查技能和主題是否有錯誤。
2005	「發生問題。請檢查您的內容。」	您的 Power Automate 流程範本發生問題。檢查流程是否有錯誤。
2006	「我們找不到您的機器人。」	找不到你的機器人，因為已刪除機器人或其環境。若要設定新機器人，請參閱建立和刪除代理程式。若要設定新的環境，請參閱使用 Power Platform 環境。
2007	「此機器人包含的內容因過多而無法運作。」	請減少訊息長度或主題數目，然後再試一次。瞭解更多關於內容限制的資訊。
2008	「找不到使用者的代用文字。」	檢查您的機器人授權設定是否有錯。
2009	「若要使用此機器人，請在 Copilot Studio 中發佈。」	若要使用此機器人，請在 Copilot Studio 中發佈。
2010	「無法擷取您的 Bot 內容。」	找不到內容，因為它已被刪除。若要設定新代理程式，請參閱建立和刪除代理程式。若要設定新的環境，請參閱使用 Power Platform 環境。
2011	「我們在 `{Topic Name}` 中找不到您的 `{Skill Name}`。請檢查您的內容。」	找不到技能，因為它已被刪除。若要建立新的技能，請參閱設定 Bot Framework 技能。
2012	「我們在 `{Topic Name}` 中找不到您的 `{Flow Name}`。請檢查您的內容。」	找不到您的 Power Automate Flow，因為它已被刪除。若要建立新流程，請參閱建立流程。
2014	「翻譯服務未回應。」	請稍後再試一次。如果問題持續發生，請聯絡客戶服務。
2015	「您無權叫用 `{Skill Name}`。請檢查技能及其使用情況以查看任何問題。」	請檢查您技能設定，並確定您的機器人已新增至技能的允許清單。
2016	「抱歉，找不到您的 Bot。」	Azure Bot 服務通道發生問題。頻道可能已被刪除或設定不正確。
2017	「抱歉，無法存取您的 Bot。」	無法存取 Azure Bot 服務通道。檢查通道設定中是否有驗證問題。
2018	「使用者輸入太快。」	您送出的訊息太快。深入了解 Copilot Studio 中的配額和限制。
2019	「找不到您的環境。這可能已刪除。」	已刪除您的環境。若要設定新的環境，請參閱使用 Power Platform 環境。
2020	「發生問題，`{Flow Name}` 無法在 `{Topic Name}` 中運作。請稍後再試一次。如果問題仍然存在，請檢查您的流程設定並執行歷程記錄。」	您的 Power Automate 流程無法運作。請稍後再試一次。如果問題仍然存在，請檢查流程是否有錯。
2021	「目前回合執行的對話方塊數目超過了最大值 `{Dialog Limit}` 個。」	根據預設，最大主題數為 50。請減少主題數目，然後再試一次。
2022	「機器人在此回合中傳送了超過 `{Message Limit}` 則訊息。」	將訊息限制為每次都不要超過 30。
2023	「執行編輯器對話方塊時遇到問題。」	檢查 Composer 對話方塊是否有錯誤。
2024	「這個環境需要使用者先登入，然後才能使用 Bot。移至「管理 > 安全性 > 驗證」，然後選取 [要求使用者登入] 選項。」	您環境的資料外洩防護 (DLP) 原則需要使用者登入。若要了解如何要求使用者登入，請參閱設定使用者驗證。
2025	「主題 `{Topic Name}` 中有一個或多個空白節點。請檢查您的內容。」	將內容新增至空白節點，或從主題移除它們。
2025	「`{Topic Name}` 正在重新導向已關閉的主題。返回 `{Topic Name}` 並檢查您的內容。」	您的主題正在重新導向至其他主題。請返回並檢查您的內容。重新啟用主題或移除重新導向節點。
2025	「您嘗試重新導向的主題已經不存在。返回 `{Topic Name}` 並檢查您的內容。」	您嘗試重新導向的主題已經不存在。建立新主題以重新導向至或移除重新導向節點。
2026	「設定 Power Automate Flow 時發生問題。請檢查您的內容。」	檢查流程是否有錯誤。
2030	「查看 Power Automate 流程執行歷史記錄並確保流程成功運行。」
2101	「使用者與 Bot 的交談時間太長，或使用者的訊息太長。」	嘗試重新開始與機器人的對話，或使用較短的訊息。
2102	「使用者傳送的訊息太大，無法處理。」	您傳送的訊息太大，無法處理。請縮短訊息，然後再試一次。
3000	「未預期的錯誤」	發生系統錯誤。連絡客戶支援團隊以了解詳細資訊。
3001	「Power Automate 目前不適用於您的流程 `{Flow Name}`。請稍後再試一次。」	Power Automate 未回應。重新開始與您的機器人對話，然後再試一次。如果問題持續發生，請連絡客戶服務。
3002	「Power Automate 發生問題，未接受您對流程 `{Flow Name}` 的要求。請稍後再試一次。」	Power Automate 發生錯誤，未接受對您流程的要求。您的流程可能已花費超過 2 分鐘的時間來回應。
3003	「連線到流程 `{Flow Name}` 時發生網路問題。請稍後再試一次。」	請稍後再試一次。如果問題持續發生，請連絡客戶服務。

共用方式為