Skip to content

Commit 6b796cc

Browse files
haywoodsloanhaywoodsloan
committed
Edits
1 parent 8dd5d9b commit 6b796cc

1 file changed

Lines changed: 46 additions & 44 deletions

File tree

‎support/power-platform/copilot-studio/authoring/error-codes.md‎

Lines changed: 46 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Understand Error Codes
33
description: 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
55
ms.reviewer:
66
- jameslew
77
- erickinser
@@ -22,45 +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. |
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. |
3131
| [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. |
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. |
6464

6565
[1]: /microsoft-copilot-studio/advanced-flow
6666
[2]: /microsoft-copilot-studio/authoring-topic-management#redirect-to-another-topic
@@ -117,13 +117,15 @@ For more information, see [Configure user authentication](/microsoft-copilot-stu
117117

118118
#### BindingKeyNotFoundError
119119

120-
**Error message**: One of the following error messages appears based on the context of the error:
120+
**Error messages**:
121+
122+
- Binding '\<BindingName>' is not found, refresh this flow to get the latest bindings
123+
- Input binding '\<BindingName>' is not found, refresh this flow to get the latest bindings
124+
- Output binding '\<BindingName>' is not found, refresh this flow to get the latest bindings
121125

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
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.
125127

126-
**Resolution**: Make sure to set up the agent flow input or output correctly. Try refreshing the inputs or outputs to resolve this issue; otherwise, try setting up the agent flow again. You can also remove or re-add the agent flow to get the latest inputs and outputs. If it isn't a custom agent flow, then open a support ticket.
128+
To get the latest inputs and outputs, remove and readd the agent flow. If the agent flow isn't a custom agent flow, open a support ticket.
127129

128130
#### ConnectedAgentAuthMismatch
129131

0 commit comments

Comments
 (0)