ModaDocs
The AI Agent

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

On this page