You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: support/power-platform/copilot-studio/authoring/error-codes.md
+30-30Lines changed: 30 additions & 30 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,9 +11,9 @@ ms.custom: sap:Authoring
11
11
12
12
# Understand error codes
13
13
14
-
When an agent encounters a problem during a conversation, it responds with a message that includes an error code for the specific problem that was encountered. Users of the agent should give this error code to their administrator.
14
+
When an agent encounters a problem during a conversation, it responds with a message that includes an error code for the specific problem. Users of the agent should give this error code to their administrator.
15
15
16
-
As an agent maker, if a problem occurs when you're using the test pane to [test your agent](/microsoft-copilot-studio/authoring-test-bot), you can see a message with more context about the problem, in addition to the error code. Alternatively, you can use the **Topic checker** panel to [validate your agent](/microsoft-copilot-studio/authoring-topic-management#view-topic-errors).
16
+
As an agent maker, if a problem occurs when you're using the test pane to [test your agent](/microsoft-copilot-studio/authoring-test-bot), you see a message with more context about the problem, in addition to the error code. Alternatively, you can use the **Topic checker** panel to [validate your agent](/microsoft-copilot-studio/authoring-topic-management#view-topic-errors).
17
17
18
18
## Error list
19
19
@@ -76,14 +76,14 @@ As an agent maker, if a problem occurs when you're using the test pane to [test
76
76
Common problems include:
77
77
78
78
- A node is missing required properties.
79
-
- Invalid YAML was added with the [code editor](/microsoft-copilot-studio/authoring-create-edit-topics#edit-topics-with-the-code-editor).
79
+
- Invalid YAML was added by using the [code editor](/microsoft-copilot-studio/authoring-create-edit-topics#edit-topics-with-the-code-editor).
80
80
- A [Power Fx formula](/microsoft-copilot-studio/advanced-power-fx) contains an error.
81
81
82
82
#### ConsentNotProvidedByUser
83
83
84
84
**Error message**: No consent provided for SSO connection.
85
85
86
-
**Resolution**: The user interacting with the agent must confirm the connection using the agent's single sign-on connection prompt.
86
+
**Resolution**: The user interacting with the agent must confirm the connection by using the agent's single sign-on connection prompt.
87
87
88
88
#### DataLossPreventionViolation
89
89
@@ -92,14 +92,14 @@ Common problems include:
92
92
**Resolution**:
93
93
94
94
- Your environment's data policies require that users sign in. See [Add user authentication with the Sign in system topic](/microsoft-copilot-studio/advanced-end-user-authentication#add-user-authentication-with-the-sign-in-system-topic).
95
-
- One or more connectors that are used in the agent aren't in the same data group. See [Copilot Studio connectors](/microsoft-copilot-studio/admin-data-loss-prevention#copilot-studio-connectors-and-data-groups).
96
-
- One or more connectors that are used in the agent were blocked by the tenant administrator.
95
+
- One or more connectors that you use in the agent aren't in the same data group. See [Copilot Studio connectors](/microsoft-copilot-studio/admin-data-loss-prevention#copilot-studio-connectors-and-data-groups).
96
+
- One or more connectors that you use in the agent were blocked by the tenant administrator.
97
97
98
98
#### EnforcementMessageC2
99
99
100
100
**Error message**: This agent is currently unavailable. It has reached its usage limit. Please try again later.
101
101
102
-
**Resolution**: This message is returned when an agent has reached its message capacity or the pay-as-you-go meter has reached its limit. To resolve the issue, add more prepaid capacity or create a pay-as-you-go billing plan. The agent chat should then resume working within 5 minutes. For more information, see [Overage Enforcement](/microsoft-copilot-studio/requirements-messages-management#overage-enforcement).
102
+
**Resolution**: This message appears when an agent reaches its message capacity or the pay-as-you-go meter reaches its limit. To resolve the issue, add more prepaid capacity or create a pay-as-you-go billing plan. The agent chat should then resume working within five minutes. For more information, see [Overage Enforcement](/microsoft-copilot-studio/requirements-messages-management#overage-enforcement).
103
103
104
104
#### FlowActionBadRequest
105
105
@@ -110,7 +110,7 @@ Common problems include:
110
110
- The parameter with name {KeyName} on flow {FlowName} ({FlowId}) evaluated to type {ResolveType}, expected type {ExpectedType}.
111
111
- The flow {FlowName} ({FlowId}) failed to run with response code {ResponseCode}, error code: {FlowErrorCode}.
112
112
113
-
**Resolution**: Check that the [base type](/microsoft-copilot-studio/authoring-variables-about#variable-types) of any variables you pass to the flow match the parameter's type.
113
+
**Resolution**: Check that the [base type](/microsoft-copilot-studio/authoring-variables-about#variable-types) of any variables you pass to the flow matches the parameter's type.
114
114
115
115
#### FlowActionException
116
116
@@ -138,13 +138,13 @@ Common problems include:
138
138
139
139
**Error message**: The usage limit for search and summarize has been reached. Please try again later.
140
140
141
-
**Resolution**: This message is returned when the agent reaches its [generative AI limit](/microsoft-copilot-studio/requirements-quotas#generative-ai-messages-to-an-agent) to search and summarize sources. For more information, see [Resolve throttling errors in agents](../licensing/throttling-errors-agents.md).
141
+
**Resolution**: The agent returns this message when it reaches its [generative AI limit](/microsoft-copilot-studio/requirements-quotas#generative-ai-messages-to-an-agent) to search and summarize sources. For more information, see [Resolve throttling errors in agents](../licensing/throttling-errors-agents.md).
142
142
143
143
#### GenAIToolPlannerRateLimitReached
144
144
145
145
**Error message**: The usage limit for generative orchestration has been reached. Please try again later.
146
146
147
-
**Resolution**: This message is returned when the agent reaches its [generative orchestration limit](/microsoft-copilot-studio/requirements-quotas#generative-ai-messages-to-an-agent). For more information, see [Resolve throttling errors in agents](../licensing/throttling-errors-agents.md).
147
+
**Resolution**: The agent returns this message when it reaches its [generative orchestration limit](/microsoft-copilot-studio/requirements-quotas#generative-ai-messages-to-an-agent). For more information, see [Resolve throttling errors in agents](../licensing/throttling-errors-agents.md).
148
148
149
149
#### InfiniteLoopInBotContent
150
150
@@ -156,7 +156,7 @@ Common problems include:
156
156
157
157
**Error message**: A total of {TotalComponents} component(s) exist in the agent, but none are valid.
158
158
159
-
**Resolution**: [Open the code editor](/microsoft-copilot-studio/authoring-create-edit-topics#edit-topics-with-the-code-editor) to review issues with the content.
159
+
**Resolution**: [Open the code editor](/microsoft-copilot-studio/authoring-create-edit-topics#edit-topics-with-the-code-editor) to review problems with the content.
160
160
161
161
#### LatestPublishedVersionNotFound
162
162
@@ -168,9 +168,9 @@ Common problems include:
168
168
169
169
**Error message**: The content was filtered due to Responsible AI restrictions.
170
170
171
-
The content was blocked by a Responsible AI check for hateful content. Hateful content refer to any content that attacks or uses discriminatory language with reference to a person or identity group based on certain differentiating attributes of these groups.
171
+
A Responsible AI check blocks the content for hateful content. Hateful content refers to any content that attacks or uses discriminatory language with reference to a person or identity group based on certain differentiating attributes of these groups.
172
172
173
-
This includes, but isn't limited to:
173
+
This restriction includes, but isn't limited to, content about:
174
174
175
175
- Race, ethnicity, nationality
176
176
- Gender identity groups and expression
@@ -180,21 +180,21 @@ This includes, but isn't limited to:
180
180
- Disability status
181
181
- Harassment and bullying
182
182
183
-
**Resolution**: You can reinforce responsible AI guidelines with your agent users to avoid this situation. Optionally, you can also update the agent [content moderation](/microsoft-copilot-studio/knowledge-copilot-studio#content-moderation) policies.
183
+
**Resolution**: To avoid this situation, reinforce responsible AI guidelines with your agent users. You can also update the agent [content moderation](/microsoft-copilot-studio/knowledge-copilot-studio#content-moderation) policies.
184
184
185
185
#### OpenAIJailBreak
186
186
187
187
**Error message**: The content was filtered due to Responsible AI restrictions.
188
188
189
-
The content was blocked by a security check for a jailbreak attempt. A jailbreak attempt is a user prompt attack that ignores system prompts with the goal of altering the intended agent behavior. These attacks include attempts to change system rules, embedding a conversation mockup to confuse the model, role-play, or encoding attacks. For more information, see [Prompt Shields in Azure AI Content Safety](/azure/ai-services/content-safety/concepts/jailbreak-detection).
189
+
A security check blocks the content for a jailbreak attempt. A jailbreak attempt is a user prompt attack that ignores system prompts with the goal of altering the intended agent behavior. These attacks include attempts to change system rules, embedding a conversation mockup to confuse the model, role-play, or encoding attacks. For more information, see [Prompt Shields in Azure AI Content Safety](/azure/ai-services/content-safety/concepts/jailbreak-detection).
190
190
191
-
**Resolution**: You can reinforce responsible AI guidelines with your agent users to avoid this situation. Optionally, you can also update the agent [content moderation](/microsoft-copilot-studio/knowledge-copilot-studio#content-moderation) policies.
191
+
**Resolution**: To avoid this situation, reinforce responsible AI guidelines with your agent users. You can also update the agent [content moderation](/microsoft-copilot-studio/knowledge-copilot-studio#content-moderation) policies.
192
192
193
193
#### OpenAIndirectAttack
194
194
195
195
**Error message**: The content was filtered due to Responsible AI restrictions.
196
196
197
-
There was an attack detected from information not directly supplied by the agent author or the end user, such as external documents. Attackers attempts to embed instructions in grounded data provided by the user to maliciously gain control of the system by:
197
+
An attack was detected from information not directly supplied by the agent author or the end user, such as external documents. Attackers attempt to embed instructions in grounded data provided by the user to maliciously gain control of the system by:
198
198
199
199
- Manipulating content
200
200
- Intrusion
@@ -205,36 +205,36 @@ There was an attack detected from information not directly supplied by the agent
205
205
206
206
For more information, see [Prompt Shields for documents](/azure/ai-services/content-safety/concepts/jailbreak-detection#prompt-shields-for-documents).
207
207
208
-
**Resolution**: If you're testing and didn't mean it to be an attack, make sure your instructions are in line with what you want the agent to be able to do. Otherwise, you can reinforce responsible AI guidelines with your agent users to avoid this situation.
208
+
**Resolution**: If you're testing and didn't intend it to be an attack, make sure your instructions align with what you want the agent to be able to do. Otherwise, reinforce responsible AI guidelines with your agent users to avoid this situation.
209
209
210
210
#### OpenAISelfHarm
211
211
212
212
**Error message**: The content was filtered due to Responsible AI restrictions.
213
213
214
-
The content was blocked by a Responsible AI check for content related to self-harm. Self-harm describes language related to physical actions intended to purposely hurt, injure, damage one's body, or kill oneself.
214
+
A Responsible AI check blocked content related to self-harm. Self-harm describes language related to physical actions intended to purposely hurt, injure, damage one's body, or kill oneself.
215
215
216
-
This includes, but isn't limited to:
216
+
This restriction includes, but isn't limited to, content about:
217
217
218
218
- Eating disorder
219
219
- Bullying and intimidation
220
220
221
-
**Resolution**: You can reinforce responsible AI guidelines with your agent users to avoid this situation. Optionally, you can also update the agent [content moderation](/microsoft-copilot-studio/knowledge-copilot-studio#content-moderation) policies.
221
+
**Resolution**: To avoid this situation, reinforce responsible AI guidelines with your agent users. You can also update the agent [content moderation](/microsoft-copilot-studio/knowledge-copilot-studio#content-moderation) policies.
222
222
223
223
#### OpenAISexual
224
224
225
225
**Error message**: The content was filtered due to Responsible AI restrictions.
226
226
227
-
The content was blocked by a Responsible AI check for sexual content. Sexual content describes language related to anatomical organs and genitals, romantic relationships, sexual acts, and acts portrayed in erotic or affectionate terms, including those portrayed as an assault or a forced sexual violent act against one's will.
227
+
A Responsible AI check blocked content for sexual content. Sexual content describes language related to anatomical organs and genitals, romantic relationships, sexual acts, and acts portrayed in erotic or affectionate terms, including those portrayed as an assault or a forced sexual violent act against one's will.
228
228
229
-
This includes, but isn't limited to:
229
+
This restriction includes, but isn't limited to, content about:
230
230
231
231
- Vulgar content
232
232
- Prostitution
233
233
- Nudity and pornography
234
234
- Abuse
235
235
- Child exploitation, child abuse, child grooming
236
236
237
-
**Resolution**: You can reinforce responsible AI guidelines with your agent users to avoid this situation. Optionally, you can also update the agent [content moderation](/microsoft-copilot-studio/knowledge-copilot-studio#content-moderation) policies.
237
+
**Resolution**: To avoid this situation, reinforce responsible AI guidelines with your agent users. You can also update the agent [content moderation](/microsoft-copilot-studio/knowledge-copilot-studio#content-moderation) policies.
238
238
239
239
#### OpenAIRateLimitReached
240
240
@@ -246,24 +246,24 @@ This includes, but isn't limited to:
246
246
247
247
**Error message**: The content was filtered due to Responsible AI restrictions.
248
248
249
-
The content was blocked by a Responsible AI check for violent content. Violent content describes language related to physical actions intended to hurt, injure, damage, or kill someone or something; describes weapons, guns, and related entities.
249
+
A Responsible AI check blocked content for violent content. Violent content describes language related to physical actions intended to hurt, injure, damage, or kill someone or something. It also describes weapons, guns, and related entities.
250
250
251
-
This includes, but isn't limited to:
251
+
This restriction includes, but isn't limited to, content about:
252
252
253
253
- Weapons
254
254
- Bullying and intimidation
255
255
- Terrorist and violent extremism
256
256
- Stalking
257
257
258
-
**Resolution**: You can reinforce responsible AI guidelines with your agent users to avoid this situation. Optionally, you can also update the agent [content moderation](/microsoft-copilot-studio/knowledge-copilot-studio#content-moderation) policies.
258
+
**Resolution**: To avoid this situation, reinforce responsible AI guidelines with your agent users. You can also update the agent [content moderation](/microsoft-copilot-studio/knowledge-copilot-studio#content-moderation) policies.
259
259
260
260
#### OutgoingMessageSizeTooBig
261
261
262
262
**Error message**: Outgoing message size too big.
263
263
264
-
**Resolution**: Depending on the channel, such as Direct Line or Facebook, being used to transfer files, you might receive the following error message: "The request content length exceeded limit of 262,144 bytes." These limits are imposed by the [channel](/azure/bot-service/bot-service-resources-faq-general?azure-bot-service-4.0#what-is-the-size-limit-of-a-file-transferred-using-channels&preserve-view=true), and not Copilot Studio.
264
+
**Resolution**: Depending on the channel you're using to transfer files, such as Direct Line or Facebook, you might receive the following error message: "The request content length exceeded limit of 262,144 bytes." These limits are imposed by the [channel](/azure/bot-service/bot-service-resources-faq-general?azure-bot-service-4.0#what-is-the-size-limit-of-a-file-transferred-using-channels&preserve-view=true), and not Copilot Studio.
265
265
266
-
In this scenario, there are a few options. One option is to provide a link to the resource as an internet attachment. Another option is to review your nodes to ensure that none of them are using a variable that contains a large volume of text, such as a `JSON.stringify()` static method. If you use this method or a variable that contains a large volume of text, modify the node to only pass the portion of text that's necessary. For example, if you use an Adaptive Card to pass data to another topic, update the variable to only pass the necessary property.
266
+
In this scenario, consider a few options. One option is to provide a link to the resource as an internet attachment. Another option is to review your nodes to ensure that none of them use a variable that contains a large volume of text, such as a `JSON.stringify()` static method. If you use this method or a variable that contains a large volume of text, modify the node to only pass the portion of text that's necessary. For example, if you use an Adaptive Card to pass data to another topic, update the variable to only pass the necessary property.
267
267
268
268
For more information, see [Maximum channel data message size limits when using Copilot Studio in Omnichannel](/microsoft-copilot-studio/requirements-quotas#maximum-channel-data-message-size-limits-when-using-copilot-studio-in-omnichannel).
269
269
@@ -289,7 +289,7 @@ For more information, see [Maximum channel data message size limits when using C
289
289
290
290
**Error message**: The request is resulting in too much data to handle, please evaluate the amount of data being returned by your actions.
291
291
292
-
**Resolution**: This indicates the request being sent to OpenAI is exceeding the maximum request size allowed. There are a number of things that make up the request including the user input, output from previous actions, tools called, and conversation history. Review the tools you're using, and, where possible, scope down their output to only the necessary fields. For more information, see [Create a Power Automate flow](/microsoft-copilot-studio/advanced-flow-create) and [Call a Power Automate flow as an action](/microsoft-copilot-studio/advanced-use-flow).
292
+
**Resolution**: This error indicates the request sent to OpenAI exceeds the maximum request size allowed. The request includes the user input, output from previous actions, tools called, and conversation history. Review the tools you're using, and, where possible, scope down their output to only the necessary fields. For more information, see [Create a Power Automate flow](/microsoft-copilot-studio/advanced-flow-create) and [Call a Power Automate flow as an action](/microsoft-copilot-studio/advanced-use-flow).
0 commit comments