Skip to content

Commit 46e27ae

Browse files
committed
DocuMentor updates
1 parent 7fa3625 commit 46e27ae

1 file changed

Lines changed: 30 additions & 30 deletions

File tree

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

Lines changed: 30 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,9 @@ ms.custom: sap:Authoring
1111

1212
# Understand error codes
1313

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

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).
1717

1818
## Error list
1919

@@ -76,14 +76,14 @@ As an agent maker, if a problem occurs when you're using the test pane to [test
7676
Common problems include:
7777

7878
- 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).
8080
- A [Power Fx formula](/microsoft-copilot-studio/advanced-power-fx) contains an error.
8181

8282
#### ConsentNotProvidedByUser
8383

8484
**Error message**: No consent provided for SSO connection.
8585

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

8888
#### DataLossPreventionViolation
8989

@@ -92,14 +92,14 @@ Common problems include:
9292
**Resolution**:
9393

9494
- 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.
9797

9898
#### EnforcementMessageC2
9999

100100
**Error message**: This agent is currently unavailable. It has reached its usage limit. Please try again later.
101101

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).
103103

104104
#### FlowActionBadRequest
105105

@@ -110,7 +110,7 @@ Common problems include:
110110
- The parameter with name {KeyName} on flow {FlowName} ({FlowId}) evaluated to type {ResolveType}, expected type {ExpectedType}.
111111
- The flow {FlowName} ({FlowId}) failed to run with response code {ResponseCode}, error code: {FlowErrorCode}.
112112

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

115115
#### FlowActionException
116116

@@ -138,13 +138,13 @@ Common problems include:
138138

139139
**Error message**: The usage limit for search and summarize has been reached. Please try again later.
140140

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).
142142

143143
#### GenAIToolPlannerRateLimitReached
144144

145145
**Error message**: The usage limit for generative orchestration has been reached. Please try again later.
146146

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).
148148

149149
#### InfiniteLoopInBotContent
150150

@@ -156,7 +156,7 @@ Common problems include:
156156

157157
**Error message**: A total of {TotalComponents} component(s) exist in the agent, but none are valid.
158158

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

161161
#### LatestPublishedVersionNotFound
162162

@@ -168,9 +168,9 @@ Common problems include:
168168

169169
**Error message**: The content was filtered due to Responsible AI restrictions.
170170

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

173-
This includes, but isn't limited to:
173+
This restriction includes, but isn't limited to, content about:
174174

175175
- Race, ethnicity, nationality
176176
- Gender identity groups and expression
@@ -180,21 +180,21 @@ This includes, but isn't limited to:
180180
- Disability status
181181
- Harassment and bullying
182182

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

185185
#### OpenAIJailBreak
186186

187187
**Error message**: The content was filtered due to Responsible AI restrictions.
188188

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).
190190

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

193193
#### OpenAIndirectAttack
194194

195195
**Error message**: The content was filtered due to Responsible AI restrictions.
196196

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:
198198

199199
- Manipulating content
200200
- Intrusion
@@ -205,36 +205,36 @@ There was an attack detected from information not directly supplied by the agent
205205

206206
For more information, see [Prompt Shields for documents](/azure/ai-services/content-safety/concepts/jailbreak-detection#prompt-shields-for-documents).
207207

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

210210
#### OpenAISelfHarm
211211

212212
**Error message**: The content was filtered due to Responsible AI restrictions.
213213

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

216-
This includes, but isn't limited to:
216+
This restriction includes, but isn't limited to, content about:
217217

218218
- Eating disorder
219219
- Bullying and intimidation
220220

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

223223
#### OpenAISexual
224224

225225
**Error message**: The content was filtered due to Responsible AI restrictions.
226226

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

229-
This includes, but isn't limited to:
229+
This restriction includes, but isn't limited to, content about:
230230

231231
- Vulgar content
232232
- Prostitution
233233
- Nudity and pornography
234234
- Abuse
235235
- Child exploitation, child abuse, child grooming
236236

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

239239
#### OpenAIRateLimitReached
240240

@@ -246,24 +246,24 @@ This includes, but isn't limited to:
246246

247247
**Error message**: The content was filtered due to Responsible AI restrictions.
248248

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

251-
This includes, but isn't limited to:
251+
This restriction includes, but isn't limited to, content about:
252252

253253
- Weapons
254254
- Bullying and intimidation
255255
- Terrorist and violent extremism
256256
- Stalking
257257

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

260260
#### OutgoingMessageSizeTooBig
261261

262262
**Error message**: Outgoing message size too big.
263263

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

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

268268
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).
269269

@@ -289,7 +289,7 @@ For more information, see [Maximum channel data message size limits when using C
289289

290290
**Error message**: The request is resulting in too much data to handle, please evaluate the amount of data being returned by your actions.
291291

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).
293293

294294
# [Classic/Teams](#tab/classic+teams)
295295

0 commit comments

Comments
 (0)