The docs in this section are rather intricate and technical, and they focus mainly on how Ana works as opposed to how to set up TextQL or work with Ana. TextQL users without technical knowledge should feel free to skip this section, as the information here won’t contribute to a better usage experience.
1XX - Expected Errors
These errors occur during normal operation and usually indicate temporary conditions.
| Code | Name | Description | Solution |
|---|
| 101 | AT_CAPACITY | System is currently at maximum capacity. | Please try again in a few minutes. |
| 103 | SANDBOX_GONE | This chat session has expired. | Start a new chat session. |
| 104 | PREVIOUS_ERROR | Chat is locked due to a previous error. | Start a new chat session. |
| 105 | SANDBOX_OOM | Python environment is out of memory. | Try with a smaller dataset. |
2XX - Unexpected Errors
These errors indicate unexpected conditions that require attention.
| Code | Name | Description | Solution |
|---|
| 201 | UNKNOWN | An unexpected error occurred. | Try again or contact support if the issue persists. |
| 202 | UNEXPECTED | An unexpected error occurred. | Try again or contact support if the issue persists. |
| 203 | INVALID_STATE | Chat is in an invalid state. | Start a new chat session. |
| 205 | YOU_ARE_OFFLINE | No internet connection detected. | Check your internet connection and try again. |
| 206 | FE_HEARTBEAT_TIMEOUT | Lost connection to TextQL. | Check your connection and try again. |
| 207 | MISSING_RECENT_DFS | Recent data frames are unavailable. | Try again or contact support if the issue persists. |
| 208 | SANDBOX_ERROR | Python environment error occurred. | Try again or contact support if the issue persists. |
| 209 | TIMEOUT | Request timed out. | Try again or contact support if the issue persists. |
3XX - System Reliability Errors
System Components (31X)
| Code | Name | Description | Solution |
|---|
| 312 | SANDBOX_UNAVAILABLE | Python environment is offline. | Try again in a few minutes. |
| 314 | ONTOLOGY_UNAVAILABLE | Ontology service is offline. | Try again in a few minutes. |
Third-Party Dependencies (32X)
| Code | Name | Description | Solution |
|---|
| 321 | LLM_PROVIDER_UNAVAILABLE | Ana lost connection to the language model mid-response. This can also be triggered by uploading .xlsx files with complex templates or a large number of sheets. | Start a new chat and try again. If you were uploading a file, try simplifying it (remove extra sheets or formatting) or split your request into smaller steps. Contact support if the issue persists. |
