11---
22title : Understand Error Codes
33description : Understand error codes so that you can troubleshoot issues in your agent design by using Microsoft Copilot Studio.
4- ms.date : 01/21 /2026
4+ ms.date : 01/28 /2026
55ms.reviewer :
66 - jameslew
77 - erickinser
@@ -22,44 +22,45 @@ As an agent maker, if a problem occurs when you use the test pane to [test your
2222> [ !NOTE]
2323> The term _ dialog_ is used in some error messages to refer to a _ topic_ .
2424
25- | Error code | Description |
26- | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
27- | [ AIModelActionBadRequest] ( #aimodelactionbadrequest ) | There's a mismatch between the prompt action types. |
28- | [ AIModelActionRequestTimeout] ( #aimodelactionrequesttimeout ) | There's a timeout error that's related to a call to an AI Builder model. |
29- | [ AsyncResponsePayloadTooLarge] ( #asyncresponsepayloadtoolarge ) | There's an error that's related to the output of a connector. |
30- | [ AuthenticationNotConfigured] ( #authenticationnotconfigured ) | Authentication is required but wasn't configured. |
31- | [ ConnectedAgentAuthMismatch] ( #connectedagentauthmismatch ) | There's an authentication mismatch between the orchestrator and sub-agent. |
32- | [ ConnectedAgentBotNotFound] ( #connectedagentbotnotfound ) | A sub-agent in a multi-agent orchestration configuration wasn't found. |
33- | [ ConnectedAgentBotNotPublished] ( #connectedagentbotnotpublished ) | A sub-agent in a multi-agent orchestration configuration wasn't published. |
34- | [ ConnectedAgentChainingNotSupported] ( #connectedagentchainingnotsupported ) | Multi-level agent chaining isn't supported. |
35- | [ ConnectedAgentGptComponentNotFound] ( #connectedagentgptcomponentnotfound ) | A connected agent is missing descriptions or instructions. |
36- | [ ConnectorPowerFxError] ( #connectorpowerfxerror ) | There's an error in the Power Fx expression evaluation in connector actions. |
37- | [ ContentError] ( #contenterror ) | There's an error in the topic content. |
38- | [ ConsentNotProvidedByUser] ( #consentnotprovidedbyuser ) | A user interacting with an agent rejected the agent's SSO request. |
39- | [ ConversationStateTooLarge] ( #conversationstatetoolarge ) | The conversation state exceeds the size limits. |
40- | [ DataLossPreventionViolation] ( #datalosspreventionviolation ) | There's a data policy violation. |
41- | [ EnforcementMessageC2] ( #enforcementmessagec2 ) | Not enough prepaid capacity is available. |
42- | [ FlowActionBadRequest] ( #flowactionbadrequest ) | A request that was made to an [ agent flow] [ 1 ] is malformed. |
43- | [ FlowActionException] ( #flowactionexception ) | An error occurred while executing an [ agent flow] [ 1 ] . |
44- | [ FlowActionTimedOut] ( #flowactiontimedout ) | An [ agent flow] [ 1 ] took more than 100 seconds to run and timed out. |
45- | [ FlowMakerConnectionBlocked] ( #flowmakerconnectionblocked ) | An [ agent flow] [ 1 ] invoked with unauthorized maker credentials in connection. |
46- | [ GenAISearchandSummarizeRateLimitReached] ( #genaisearchandsummarizeratelimitreached ) | The usage limit for generative AI was reached. |
47- | [ GenAIToolPlannerRateLimitReached] ( #genaitoolplannerratelimitreached ) | The usage limit for generative orchestration was reached. |
48- | [ InfiniteLoopInBotContent] ( #infiniteloopinbotcontent ) | A node was executed too many times. |
49- | [ InvalidContent] ( #invalidcontent ) | Invalid content was added to the code editor. |
50- | [ LatestPublishedVersionNotFound] ( #latestpublishedversionnotfound ) | Unable to retrieve the published version of the agent. |
51- | [ OpenAIHate] ( #openaihate ) | Hate content was detected. |
52- | [ OpenAIJailBreak] ( #openaijailbreak ) | Jailbreak content was detected. |
53- | [ OpenAIndirectAttack] ( #openaindirectattack ) | Indirect attack content was detected. |
54- | [ OpenAISelfHarm] ( #openaiselfharm ) | Self-harm content was detected. |
55- | [ OpenAISexual] ( #openaisexual ) | Sexual content was detected. |
56- | [ OpenAIRateLimitReached] ( #openairatelimitreached ) | The capacity limit of the agent was reached. |
57- | [ OpenAIViolence] ( #openaiviolence ) | Violence content was detected. |
58- | [ OutgoingMessageSizeTooBig] ( #outgoingmessagesizetoobig ) | A message sent by an agent was too large to process. |
59- | [ RedirectToDisabledDialog] ( #redirecttodisableddialog ) | A topic was [ redirecting] [ 2 ] to a disabled topic. |
60- | [ RedirectToNonExistentDialog] ( #redirecttononexistentdialog ) | A topic was [ redirecting] [ 2 ] to another topic that no longer exists. |
61- | [ SystemError] ( #systemerror ) | A system error occurred in Copilot Studio. |
62- | [ TooMuchDataToHandle] ( #toomuchdatatohandle ) | The request that was made by the user is too large to process. |
25+ | Error code | Description |
26+ | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
27+ | [ AIModelActionBadRequest] ( #aimodelactionbadrequest ) | There's a mismatch between the prompt action types. |
28+ | [ AIModelActionRequestTimeout] ( #aimodelactionrequesttimeout ) | There's a timeout error that's related to a call to an AI Builder model. |
29+ | [ AsyncResponsePayloadTooLarge] ( #asyncresponsepayloadtoolarge ) | There's an error that's related to the output of a connector. |
30+ | [ AuthenticationNotConfigured] ( #authenticationnotconfigured ) | Authentication is required but wasn't configured. |
31+ | [ BindingKeyNotFoundError] ( #bindingkeynotfounderror ) | One or more inputs have changed on the agent flow (added, removed, or renamed). The agent flow needs to be removed and re-added to ensure Copilot Studio has the correct list of inputs. |
32+ | [ ConnectedAgentAuthMismatch] ( #connectedagentauthmismatch ) | There's an authentication mismatch between the orchestrator and sub-agent. |
33+ | [ ConnectedAgentBotNotFound] ( #connectedagentbotnotfound ) | A sub-agent in a multi-agent orchestration configuration wasn't found. |
34+ | [ ConnectedAgentBotNotPublished] ( #connectedagentbotnotpublished ) | A sub-agent in a multi-agent orchestration configuration wasn't published. |
35+ | [ ConnectedAgentChainingNotSupported] ( #connectedagentchainingnotsupported ) | Multi-level agent chaining isn't supported. |
36+ | [ ConnectedAgentGptComponentNotFound] ( #connectedagentgptcomponentnotfound ) | A connected agent is missing descriptions or instructions. |
37+ | [ ConnectorPowerFxError] ( #connectorpowerfxerror ) | There's an error in the Power Fx expression evaluation in connector actions. |
38+ | [ ContentError] ( #contenterror ) | There's an error in the topic content. |
39+ | [ ConsentNotProvidedByUser] ( #consentnotprovidedbyuser ) | A user interacting with an agent rejected the agent's SSO request. |
40+ | [ ConversationStateTooLarge] ( #conversationstatetoolarge ) | The conversation state exceeds the size limits. |
41+ | [ DataLossPreventionViolation] ( #datalosspreventionviolation ) | There's a data policy violation. |
42+ | [ EnforcementMessageC2] ( #enforcementmessagec2 ) | Not enough prepaid capacity is available. |
43+ | [ FlowActionBadRequest] ( #flowactionbadrequest ) | A request that was made to an [ agent flow] [ 1 ] is malformed. |
44+ | [ FlowActionException] ( #flowactionexception ) | An error occurred while executing an [ agent flow] [ 1 ] . |
45+ | [ FlowActionTimedOut] ( #flowactiontimedout ) | An [ agent flow] [ 1 ] took more than 100 seconds to run and timed out. |
46+ | [ FlowMakerConnectionBlocked] ( #flowmakerconnectionblocked ) | An [ agent flow] [ 1 ] invoked with unauthorized maker credentials in connection. |
47+ | [ GenAISearchandSummarizeRateLimitReached] ( #genaisearchandsummarizeratelimitreached ) | The usage limit for generative AI was reached. |
48+ | [ GenAIToolPlannerRateLimitReached] ( #genaitoolplannerratelimitreached ) | The usage limit for generative orchestration was reached. |
49+ | [ InfiniteLoopInBotContent] ( #infiniteloopinbotcontent ) | A node was executed too many times. |
50+ | [ InvalidContent] ( #invalidcontent ) | Invalid content was added to the code editor. |
51+ | [ LatestPublishedVersionNotFound] ( #latestpublishedversionnotfound ) | Unable to retrieve the published version of the agent. |
52+ | [ OpenAIHate] ( #openaihate ) | Hate content was detected. |
53+ | [ OpenAIJailBreak] ( #openaijailbreak ) | Jailbreak content was detected. |
54+ | [ OpenAIndirectAttack] ( #openaindirectattack ) | Indirect attack content was detected. |
55+ | [ OpenAISelfHarm] ( #openaiselfharm ) | Self-harm content was detected. |
56+ | [ OpenAISexual] ( #openaisexual ) | Sexual content was detected. |
57+ | [ OpenAIRateLimitReached] ( #openairatelimitreached ) | The capacity limit of the agent was reached. |
58+ | [ OpenAIViolence] ( #openaiviolence ) | Violence content was detected. |
59+ | [ OutgoingMessageSizeTooBig] ( #outgoingmessagesizetoobig ) | A message sent by an agent was too large to process. |
60+ | [ RedirectToDisabledDialog] ( #redirecttodisableddialog ) | A topic was [ redirecting] [ 2 ] to a disabled topic. |
61+ | [ RedirectToNonExistentDialog] ( #redirecttononexistentdialog ) | A topic was [ redirecting] [ 2 ] to another topic that no longer exists. |
62+ | [ SystemError] ( #systemerror ) | A system error occurred in Copilot Studio. |
63+ | [ TooMuchDataToHandle] ( #toomuchdatatohandle ) | The request that was made by the user is too large to process. |
6364
6465[ 1 ] : /microsoft-copilot-studio/advanced-flow
6566[ 2 ] : /microsoft-copilot-studio/authoring-topic-management#redirect-to-another-topic
@@ -114,6 +115,18 @@ For more information, see [Create a prompt action](/ai-builder/use-a-custom-prom
114115
115116For more information, see [ Configure user authentication] ( /microsoft-copilot-studio/configuration-end-user-authentication ) .
116117
118+ #### BindingKeyNotFoundError
119+
120+ ** Error messages** :
121+
122+ - Binding '{0}' is not found, refresh this flow to get the latest bindings
123+ - Input binding '{0}' is not found, refresh this flow to get the latest bindings
124+ - Output binding '{0}' is not found, refresh this flow to get the latest bindings
125+
126+ ** Resolution** : Check that the agent flow inputs and outputs are set up correctly. Try refreshing the inputs or outputs to resolve this issue. If that doesn't work, try setting up the agent flow again.
127+
128+ To get the latest inputs and outputs, remove and readd the agent flow.
129+
117130#### ConnectedAgentAuthMismatch
118131
119132** Error message:** Your connected agent with schema name ` {AgentSchemaName} ` has an authentication mismatch with the main agent.
0 commit comments