Skip to content

Commit ad80aa6

Browse files
authored
Merge pull request #10604 from MicrosoftDocs/vn-add-missing-error-code
AB#9552: Added missing error code
2 parents bd39543 + 18a081e commit ad80aa6

1 file changed

Lines changed: 52 additions & 39 deletions

File tree

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

Lines changed: 52 additions & 39 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,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

115116
For 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

Comments
 (0)