-
Improvement
-
Resolution: Unresolved
-
Minor
-
None
-
Future Dev
-
MDL-83147-main
-
-
-
-
6
-
Team Hedgehogs 2025 Sprint 2.1, Team Hedgehogs 2025 Sprint 2.2
Improve the user messages displayed in the placements when an error occurs. Currently, the error message is generic and provides little information on the actual issue.
Improved error messages can help debugging and troubleshooting efforts.
The subsystem handles several different error types and provides specific error feedback. This is returned in the Action response object. Currently the placements only surface this error information in a generic way.
The error displayed should vary based on site debugging settings. So in normal site operations the errors are generic, however, to help with debugging issues site administrators (developers, hosts, etc) can increase the verbosity of the messages by adjusting the debugging level of the site; in the same way as they can currently for other errors.
The table below shows the most common error codes and the frequency of occurrence, based on current AI subsystem usage stats.
Error | 400 | 401 | 404 | 429 |
---|---|---|---|---|
Percentage | 22.67% | 25.33% | 46.67% | 5.33% |
Below is a DRAFT table of messages returned to users based on the level of debugging set for the site. The level that the messages change from "less" to "more" verbose can be confirmed at a later date. The wording/copy of the messages will also need UX review. With the wording of messages we do need to be careful of providing no-admin users information that they can't do anything with or might scare them (yes, this is a real thing).
LMS Debug Level | ||
Error | < "ALL" | >= "ALL" |
Upstream 400 | Something went wrong Try again later |
400: Bad Request <Full upstream error message> |
Upstream 401 | Something went wrong Try again later |
401: Unauthorized <Full upstream error message> |
Upstream 404 | Something went wrong Try again later |
404: Not found <Full upstream error message> |
Upstream 429 | Too many requests The AI service has responded that your request is being rate limited. Try again later |
429: Too many requests <Full upstream error message> |
Internal 429 | Too many requests You have reached the request limit set by your administrator. Try again later |
429: Too many requests You have reached the request limit set by your administrator. Try again later |
Upstream 5xx | Something went wrong Try again later |
<error code>: <error name> <Full upstream error message> |
Internal 5xx | Something went wrong Try again later |
<error code>: <error name> <Full upstream error message> |
Everything else | Something went wrong Try again later |
<error code>: <error name> <Full upstream error message> |
- has a non-specific relationship to
-
MDL-83607 Discovery: MDL-83147 - AI: Placement - Error messages
-
- Closed
-
- has been marked as being related by
-
MDL-83376 Missing function core_ai\provider::is_request_allowed
-
- Closed
-
- is child of
-
IDEA-298 Improve Clarity and Debuggability of AI Error Feedback
-
- In development
-
- links to