USER MANUAL · AI
The AI assistant
The Assistant button sits in the bottom-right corner of the canvas. Open it and describe the change — “add a payments container behind the gateway, wire it to Stripe”, “split the monolith into checkout and catalog”, “draw our stack: Next.js on Vercel, Postgres, Redis, Stripe”. It draws on the canvas while it answers — nodes pop in, parents expand, edges connect.
Add a reviews service behind the gateway, wired to the orders DB.
- Everything lands in a draft. Review it, then Save to model (a normal version, labeled AI · your prompt in history) or Discard. The assistant never saves on its own.
- It can answer without drawing. Ask a question, think out loud, or ask it to interview you before it draws: it answers in chat and draws only when you ask for a change. The Talk only switch under the composer pins a reply to chat, whatever you type.
- Follow-ups compose. Keep talking and it appends, adjusts and removes without starting over. The reply says what changed, and the canvas keeps your framing, panning only if something new landed off-screen. Large deletions ask before they land.
- It authors flows. “Show me the checkout flow step by step” creates a playable flow.
- It navigates. Pure “show me X” requests move the camera and expand the right nodes without touching the model.
- Diagram source. A reply that drew something carries its Mermaid under Mermaid source (and Diagram preview for a follow-up edit) — open it, keep it in a repo. A reply can also be prose only, with no diagram at all. To bring Mermaid the other way, use Import Mermaid at the foot of the editor panel (Export & Mermaid).
- Sending. On a keyboard, Enter sends and Shift+Enter adds a line. On a phone, Return adds a line and Send sends.
- Limits. The assistant accepts 8 requests a minute and 200 a day, per account. Each message also spends one AI action from your plan's monthly allowance — see Plans & limits.
In the sequence view it edits the flow you are looking at: “add a step where the gateway validates the token”, “move the payment call before the inventory check”, “add a notification service”. It re-emits that flow with your change and declares the participants in the column order it means, touching the architecture only when a new participant needs a kind or a technology of its own. “Show it as a sequence” switches the drawing without changing anything. On a blank Sequence canvas, describing the interaction draws both: the participants and the flow over them.