MazeGraph sends model requests through WordPress’s AI Client and the connector you configured. First check whether WordPress can see a provider and text model; then check the model selected for this session and the error shown in chat. A connector can be connected while a particular model, credential, or provider request is still unavailable.
Read the connection status
Open MazeGraph → Settings → About and review the connection status. It summarizes whether WordPress has AI support, whether a provider is connected, and whether a text model is available.
| Status or message | What it means | What to check |
|---|---|---|
| AI unavailable | This WordPress site does not currently expose the AI features MazeGraph needs. MazeGraph requires WordPress 7.0 or later. | Confirm the WordPress version. If the site is current, ask its administrator or host whether AI support has been disabled by site configuration. |
| Connect an AI provider to start | WordPress has AI support, but no provider connector is configured. | Open WordPress Settings → Connectors and install and configure a compatible provider. |
| The connected provider has no chat model | A provider is present, but WordPress has not made a text-generation model available to MazeGraph. | Check that connector’s setup and account status, or connect another provider that offers a text model. |
| A text model is available | WordPress reports at least one model MazeGraph can use. A session can still fail if it has an old model selection or the provider rejects a request. | Check the selected session model and the specific error message below. |
Check the connector and provider
- In WordPress, open Settings → Connectors. You can also visit
/wp-admin/options-connectors.phpon your site. - Confirm that the provider connector you intend to use is installed and configured. Follow its own setup message if it reports a connection or credential problem.
- Check that the provider account and selected model are enabled for API use. Provider quotas, billing, model access, and service status are controlled by the provider.
- Return to MazeGraph → Settings → General and confirm the provider appears under Connected providers.
MazeGraph does not read or store provider keys. Enter, replace, or check a key only in the connector’s WordPress settings; do not paste it into chat or a support request. For connector installation and setup instructions, see Connect an AI provider.
Confirm the model for this session
In MazeGraph → Settings → General, review Default model. New sessions start with this model, unless you choose a different one in the session. Open the affected session and check its model in the chat composer too; changing the default does not replace an explicit model selection in an existing session.
Choose a currently available text model. If you prefer WordPress to pick one, set Default model to Let WordPress choose. Then start a new session or select the current model in the session that failed. See Assistants and models for session-level model selection.
Match the error to the next step
| Message in chat | Next step |
|---|---|
| “The AI provider refused the credentials.” | Recheck the connector’s credentials and account setup in Settings → Connectors. If the connector gives a specific error, follow its instructions. |
| “The AI provider could not be reached.” | Try again after a short wait. If it continues, check the provider’s service status and ask your host or network administrator whether the WordPress server can reach it. |
| “The AI provider is limiting requests right now.” | Wait before retrying. Check the provider account’s rate limits or quota, and avoid repeatedly resending the same request. |
| “The selected model is no longer available. No request was sent.” | Select a current text model in the session or update Default model in MazeGraph settings. |
| “The AI provider returned an error:” followed by a provider message. | Read the sanitized provider message. Check the connector’s setup and the provider account for model access, request limits, or service issues. |
If a short text-only question works but a request that uses a tool fails, the provider connection may be fine. Follow A tool is missing or refused to check tool access and policy.
If MazeGraph has stopped new replies
In MazeGraph → Settings → General, check Allow new replies. When it is off, MazeGraph stops new requests to the provider while saved sessions remain readable. If About reports that MazeGraph is disabled by site configuration, ask a site manager to review the setting that forces the workspace off.
If the status looks ready but replies are slow, see request timings and About and installation diagnostics. For broader troubleshooting steps and safe diagnostic details, see the Troubleshooting overview.
Example: a model stopped being available
What happened: A session reports that its selected model is no longer available. Reason: The connector’s model list can change, and the session may still hold a model that WordPress no longer offers. Solution: Choose a currently available text model in the chat composer, or set a new Default model for future sessions. MazeGraph does not send the failed request when it detects that the explicitly selected model is unavailable. Learning: Recheck model selections after changing provider connectors or when a provider retires a model.