> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moda.app/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Agent Troubleshooting

> Common issues with the AI agent and how to resolve them.

## Design stuck on "Building — please wait"

If your design has been generating for a long time:

* **Wait up to 5–7 minutes** for complex multi-page designs — this is normal, especially for slide decks with research or image generation
* **Check the chat panel**: the agent's progress and thinking are shown there. If it's still actively working, give it more time
* **Refresh the page**: your work is auto-saved, so refreshing won't lose progress. The agent may resume or you can start a new generation
* **Try a simpler prompt**: very complex or vague prompts can cause the agent to take longer. Be more specific about what you want

## Agent seems stuck in a loop or not responding

* **Refresh the page** and check if the design was partially completed
* **Start a new chat**: sometimes starting fresh with a clearer prompt works better than continuing a stuck conversation
* **Check your internet connection**: the agent communicates via WebSocket, so an unstable connection can cause issues

## Output doesn't match my prompt

* **Be more specific**: vague prompts give the agent more room for interpretation. Include specific content, structure, and style details
* **Use reference images or URLs**: visual references help the agent understand what you're looking for
* **Iterate**: use follow-up messages to guide the agent toward what you want. "Make the layout more like \[description]" or "Change the color scheme to \[specifics]"
* **Try a different model**: the Pro model (available on Pro and Ultra plans) handles complex design requests better than Lite or Standard

## "Connection to server lost" errors

This typically means the WebSocket connection between your browser and the server was interrupted:

* **Check your internet connection**
* **Refresh the page**: the connection will be re-established
* **Try a different network**: some corporate firewalls or VPNs may interfere with WebSocket connections
* Your work is auto-saved, so you won't lose progress when reconnecting